在 VS Code 裡使用

安裝 Claude Code 外掛，與 CLI 共用 ~/.claude/settings.json，並處理首次的登入頁提示。

VS Code 的 Claude Code 擴充套件（擴充套件 ID anthropic.claude-code）把 Claude Code 帶進編輯器面板。它與 CLI 共用同一份 ~/.claude/settings.json，設定一次兩邊都能運作。

安裝

在 VS Code 的擴充套件面板搜尋「Claude Code」（發行者 Anthropic）並安裝。
對應的命令列指令：code --install-extension anthropic.claude-code。
安裝後重新載入視窗：從命令面板（⌘⇧P / Ctrl⇧P）執行 Developer: Reload Window。

設定

與在 Claude Code 裡使用完全相同——在 ~/.claude/settings.json 寫入 env 區塊：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<your-base-url>",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

ANTHROPIC_BASE_URL 只填主機位址（不要加 /v1），ANTHROPIC_AUTH_TOKEN 放你的 OLETOKEN 金鑰。API 金鑰頁上的**「快速介接」**彈窗提供已填好這些數值的指令碼下載——請選擇「VS Code 外掛」分頁。

面板仍要求你登入

使用 OLETOKEN 金鑰時，你不需要 claude.ai 帳戶：

VS Code 設定（⌘, / Ctrl+,）→ 搜尋「Claude Code login」→ 勾選 Disable Login Prompt。
若仍顯示為已登出，通常是 VS Code 沒有繼承你的 shell 環境：請從終端機用 code . 啟動它。照上面寫好 settings.json 也能解決，因為它不依賴環境變數。

第三方閘道下無法使用的功能

依賴 claude.ai 帳戶的功能不適用：用量統計、語音輸入與雲端工作階段（Web 分頁）。本機能力——編輯、差異檢視、內建的 IDE MCP——不受影響。

疑難排解

現象	原因與處理
401	金鑰錯誤或已停用；確認它放在 `ANTHROPIC_AUTH_TOKEN`
404	`ANTHROPIC_BASE_URL` 帶了 `/v1`——拿掉路徑
擴充套件已安裝但沒有 Claude 圖示	請先開啟一個檔案；工具列按鈕會在編輯器作用中時出現，或改用活動列上的圖示
設定變更未生效	重新載入視窗（`Developer: Reload Window`）並重新開啟面板

同一個擴充套件也能安裝在 Cursor（Cursor 接受 VS Code 市集），設定方式相同——見在 Cursor 裡使用。