安装指南

三个部分协同工作：Chrome 扩展、你自己电脑上的服务器，以及 wcr 命令（CLI 和 MCP 服务器）。一切都在本地运行。

your AI assistant / script ──▶ wcr ──HTTP──▶ local server ◀──WebSocket── Chrome extension ──▶ ChatGPT, Gemini, …
                                          127.0.0.1:8787

抢先体验

WebCodeReview 目前还不能公开安装。wcr 命令行工具（npm 包 @webcodereview/cli）和 Chrome Web Store 页面即将推出。抢先体验用户会通过电子邮件收到安装说明：加入候补名单。本页其余内容是你装好两个部分之后的参考资料。

1. 服务器和 wcr

需要 Node.js 20 或更高版本。服务器只监听 127.0.0.1:8787。首次运行时，它会生成一个配对 token，并保存到 ~/.config/webcodereview/token。wcr 从 WCR_TOKEN 或该文件读取 token，并在后台启动服务器（日志：~/.config/webcodereview/server.log）；触发条件是 WCR_PORT（默认 8787）上没有服务响应，例如运行 wcr status 时。你也可以用 wcr serve 在前台运行它。

2. Chrome 扩展

在你已登录所需 AI 网站的那个 Chrome 配置文件中安装扩展，然后在同一个配置文件中登录每个网站。首次安装时，扩展会打开一个欢迎页。

3. 让扩展与服务器配对

  1. 在终端中运行 wcr setup。它会在需要时启动服务器，并用 Chrome 打开扩展的配对页面。如果它无法替你打开 Chrome，会告诉你该怎么做。
  2. 配对 token 通过页面地址中 # 之后的部分传给扩展，所以绝不会经过网络发送。你不需要复制或粘贴任何内容。
  3. 随后弹窗会显示“已连接本机 wcr”。

如果 token 不再有效，弹窗会显示“配对已失效”：请再次运行 wcr setup。可用以下命令检查连接：

wcr status

同一时间只能连接一个浏览器或配置文件。如果第二个连接进来，第一个会被关闭；它的弹窗会显示“另一个浏览器接管了连接”和一个“改用这个浏览器”按钮。

4. 提问：wcr ask

# one provider
wcr ask claude "Review this function for race conditions: ..."

# several providers in parallel (comma-separated), prompt from a file
wcr ask chatgpt,gemini,claude -f review.md

# prompt from stdin, per-provider timeout in seconds, raw JSON output
git diff | wcr ask chatgpt,deepseek -t 240 --json

提供方：chatgpt、gemini、claude、deepseek 和 grok。默认超时为每个提供方 180 秒。如果某个提供方失败（未登录、人机验证、超时），其他提供方仍会返回结果，且退出码非零。

五个提供方（ChatGPT、Gemini、Claude、DeepSeek 和 Grok）都已于 2026-10-12 在真实网站上验证过。聊天网站经常改动页面，所以某个提供方可能在扩展更新之前失效。

5. 在你的 AI 编程助手中使用（MCP）

wcr mcp 是标准的 stdio MCP 服务器，所以任何 MCP 客户端都能运行它。工具：

工具用途
wcr_review_submit + wcr_review_result发起多提供方评审，然后轮询（每次轮询最多等待 50 秒）。默认使用这个。
wcr_ask, wcr_ask_many阻塞版本，每次调用 30 到 180 秒。仅适用于工具超时较长的客户端。
wcr_automate浏览器自动化；allowDomains 为必填。你必须在扩展中登录 WebCodeReview。
wcr_status扩展是否已连接？

关键在于客户端每次调用的工具超时，因为一次涉及 3 个提供方的评审最多可能需要约 270 秒。评审任务保存在服务器内存中：重启会丢失它们，也无法单独取消。

自动浏览需要登录

代码评审不需要账号，自动浏览是唯一需要登录的功能。打开扩展弹窗，在“自动浏览”一行（登录前会显示“登录后可用”）点击“通过 Google 继续操作”，然后在 Chrome 自己的窗口中选择你的 Google 账号。接着打开“自动浏览”开关；Chrome 会请求访问所有网站的权限。你也可以通过弹窗顶部的“登录”标签开始登录。如果一键登录无法使用，请使用“改用网页登录”，并在 webcodereview.com/device 上批准该浏览器。关闭开关会停止自动化，但不会撤回该权限；若要彻底撤销，请打开 chrome://extensions，选择 WebCodeReview，并更改“网站访问权限”。

Claude Code （已测试）

claude mcp add wcr -- wcr mcp
# add --scope user to make it available in every project

已用真实的工具调用做过端到端测试。一次 330 秒的工具调用正常返回（在 Claude Code v2.1.222 上测得）。

Codex （尚未验证）

codex mcp add wcr -- wcr mcp

或写在 ~/.codex/config.toml 中：

[mcp_servers.wcr]
command = "wcr"
args = ["mcp"]
tool_timeout_sec = 120   # optional: the 60 s default is enough for wcr_review_result (waits <= 50 s)

仅确认了配置能被正确读取；尚未测试通过 Codex 的工具调用。60 秒的默认超时来自其文档，未经实测。多提供方评审请使用 wcr_review_submit 和 wcr_review_result。

Cursor （尚未验证）

添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{ "mcpServers": { "wcr": { "command": "wcr", "args": ["mcp"] } } }

完全未测试。论坛上有报告称 Cursor 会在约 60 秒时切断调用，且无法配置；这一点未经实测。多提供方评审请使用 wcr_review_submit 和 wcr_review_result。

告诉你的 agent 何时使用它

评审需要 30 到 180 秒，并会占用你的聊天账号，所以请让你的 agent 只在高影响或涉及安全的改动时使用，而不是每次编辑都用。把完整材料放进提示词，绝不要放密钥，并把回答当作需要核对的独立意见，而不是已验证的结论。如果结果显示提示词可能已经提交，不要在未询问的情况下重新发送。服务器仓库附带一段现成的文本，可用于你的 CLAUDE.md、AGENTS.md 或 Cursor 规则：agent-guide.md。

安全说明