Claude Code VS Code 擴充功能串接第三方 API:environmentVariables 設定

Wokey Team · 2026-09-24

簡短回答: 要讓 Claude Code 的 VS Code 擴充功能串接第三方 API,請在 VS Code 使用者設定的 claudeCode.environmentVariables 中放入 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,並開啟 claudeCode.disableLoginPrompt。在終端機 export 的變數大多傳不到擴充功能。只設定 ~/.claude/settings.json 也不夠:擴充功能啟動前的登入檢查讀不到它,所以會一直出現登入畫面。

設定步驟

  1. 安裝擴充功能。 需要 VS Code 1.94.0 以上。在擴充功能檢視(Cmd/Ctrl+Shift+X)中搜尋「Claude Code」(發行者:Anthropic)。Cursor 也能安裝同一個擴充功能,VSCodium 等編輯器可以從 Open VSX 取得。
  2. 開啟使用者設定。 按 Cmd/Ctrl+Shift+P,執行 Preferences: Open User Settings (JSON)。
  3. 加入設定。 在最外層的 {} 裡加入:
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}
  1. 重新載入。 從命令選擇區執行 Developer: Reload Window,再開啟 Claude Code 面板。

要注意三件事:

  • ANTHROPIC_BASE_URL 只填網域,不加 /v1;/v1/messages 由擴充功能自己接上。
  • 這些要寫在使用者設定中,不要寫進工作區的 .vscode/settings.json,那個檔案常會被提交到儲存庫。
  • disableLoginPrompt 會略過登入提示。官方的說明是 "for third-party provider setups"。

為什麼 export 和 settings.json 不夠

擴充功能在啟動 Claude 程序之前,會先檢查是否有可用的憑證。這個檢查只讀取 claudeCode.environmentVariables:

  • 從 Dock、開始選單或桌面圖示開啟的 VS Code,拿不到你在 ~/.zshrc 中 export 的變數。
  • ~/.claude/settings.json 的 env 區塊會傳到擴充功能啟動的 Claude 程序,但不會傳到擴充功能本身的登入檢查。

所以只設定 settings.json、disableLoginPrompt 又沒開時,典型的症狀就是擴充功能一直要求登入。臨時想用 shell 變數的話,從已設定好變數的終端機執行 code .。日常使用的話,上面的使用者設定比較可靠。

確認請求經過 Wokey

在擴充功能的輸入框中執行 /status(需要 Claude Code v2.1.280 以上)。Status 分頁的 Anthropic base URL 應該是 https://api.wokey.ai。

選擇模型

從命令選單選擇 Switch model…,或點輸入框下方的模型名稱。若要固定 Opus、Sonnet、Haiku 各層級使用哪個模型,把變數加進同一個清單:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

使用第三方 API 時無法使用的功能

使用第三方 API 時,擴充功能不提供需要 claude.ai 帳號的功能:

  • 方案用量條、語音聽寫,以及雲端工作階段用的 Web 分頁。
  • 選單中沒有 Sign out 項目。
  • 送出 /bug 會顯示錯誤,什麼也不會送出。

你之前用 /login 登入過的 claude.ai 帳號會保存著,但不會被使用。

和終端機中的 CLI 相比,擴充功能也只支援部分指令,沒有 ! Bash 快捷方式,也沒有 Tab 自動完成。

排錯

一直出現登入畫面。 claudeCode.environmentVariables 不存在或放錯地方(例如工作區設定),或修改後沒有重新載入視窗。也請確認 disableLoginPrompt 是 true。

invalid x-api-key。 ANTHROPIC_BASE_URL 沒有生效,請求送到了 Anthropic 官方位址。Wokey 從不回傳這句話;詳見 invalid x-api-key 排查指南。

提到 /v1/v1/messages 的 404。 base URL 多了一個 /v1,改成 https://api.wokey.ai。

沒有回覆也沒有錯誤。 官方建議在終端機中執行 claude 以看到更詳細的錯誤。擴充功能內建了自己的 CLI,但不會把 claude 加入你的 PATH,所以請另外安裝 CLI,並依照 Claude Code base URL 設定指南設定變數。

JetBrains 使用者

JetBrains 外掛沒有內建 CLI。它會在 IDE 終端機中執行你已安裝的 claude 指令;路徑可以在 Settings → Tools → Claude Code [Beta] → Claude command 中修改。所以 JetBrains 的設定方式和 CLI 一樣:把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 寫進 ~/.claude/settings.json 的 env 區塊。詳見 Claude Code base URL 設定指南。

常見問題

VS Code 裡的 Claude Code 怎麼設定 base URL?

在 VS Code 使用者設定(JSON)中加入 claudeCode.environmentVariables,填入 ANTHROPIC_BASE_URL(https://api.wokey.ai,不加 /v1)和 ANTHROPIC_AUTH_TOKEN,把 claudeCode.disableLoginPrompt 設為 true,然後執行 Reload Window。

為什麼擴充功能一直要求登入?

擴充功能啟動前的登入檢查只讀取 claudeCode.environmentVariables,不讀 shell 變數,也不讀 ~/.claude/settings.json。把變數寫進使用者設定,開啟 disableLoginPrompt,再重新載入視窗。

可以寫進工作區的 .vscode/settings.json 嗎?

最好不要。工作區設定常會被提交到儲存庫,可能洩漏你的金鑰。使用者設定本來就會套用到所有專案。

JetBrains 外掛怎麼設定?

JetBrains 外掛執行的是你已安裝的 claude 指令,所以設定方式和 CLI 一樣:把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 寫進 ~/.claude/settings.json 的 env 區塊。