設定指南

三個部分協同運作：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 線上應用程式商店的頁面即將推出。搶先體驗的使用者會透過電子郵件收到安裝說明：加入候補名單。本頁其餘內容供你安裝好兩個部分之後參考。

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。

告訴你的代理何時使用它

審查需要 30 到 180 秒，並會使用你的聊天帳號，所以請告訴你的代理只在高影響或安全敏感的變更時使用，而不是每次編輯都用。把完整資料放進提示詞，絕不要放機密，並把回答視為需要查證的獨立意見，而不是已驗證的發現。如果結果表示提示詞可能已經送出，請不要在未詢問的情況下重送。伺服器儲存庫附有可直接用於你的 CLAUDE.md、AGENTS.md 或 Cursor 規則的現成文字：agent-guide.md。

安全注意事項