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 也不夠:擴充功能啟動前的登入檢查讀不到它,所以會一直出現登入畫面。
設定步驟
- 安裝擴充功能。 需要 VS Code 1.94.0 以上。在擴充功能檢視(
Cmd/Ctrl+Shift+X)中搜尋「Claude Code」(發行者:Anthropic)。Cursor 也能安裝同一個擴充功能,VSCodium 等編輯器可以從 Open VSX 取得。 - 開啟使用者設定。 按
Cmd/Ctrl+Shift+P,執行 Preferences: Open User Settings (JSON)。 - 加入設定。 在最外層的
{}裡加入:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
],
"claudeCode.disableLoginPrompt": true
}
- 重新載入。 從命令選擇區執行 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 區塊。