在 VS Code 中使用 Claude Code

在 VS Code 裡安裝 Claude Code 擴充功能，用一把 AI in IDE 的 API Key 接上本站。

第一次請求幾分鐘內就能完成，不需要 Anthropic 訂閱。全部設定只有一個擴充功能、一把金鑰、一段 JSON，不需要綁定 Anthropic 信用卡，也不用按人頭買方案。

本篇談 VS Code 本身。Cursor 用的是同一個擴充功能和同一份設定，若你主要在 Cursor 寫程式，直接看在 Cursor 中使用 Claude Code 會更短。JetBrains 則是完全不同的流程：外掛不內建 CLI，請看在 JetBrains 中使用 Claude Code。

版本與前置條件

擴充功能的版本號就是它內建的 Claude Code 版本：擴充功能 2.1.286 內含 Claude Code 2.1.286。安裝擴充功能不會把 claude 加進 PATH，那需要另外安裝獨立 CLI（npm install -g @anthropic-ai/claude-code）。只有要用終端機工作階段或 claude mcp add 才需要 CLI，聊天面板本身不需要。

安裝擴充功能

• 直接安裝：Install for VS Code，會開啟擴充功能檢視並帶入發佈者，仍需要你按下確認才會安裝。
• 手動：Cmd+Shift+X（macOS）或 Ctrl+Shift+X（Windows/Linux），搜尋 Claude Code，按 安裝。
• 離線或市集被封鎖：從 Visual Studio Marketplace 下載 VSIX，再用「從 VSIX 安裝…」。

安裝後面版沒出現，從命令面板執行 Developer: Reload Window。擴充功能市集屬於第三方軟體，全新安裝一律會請你確認。

建立並複製 API Key

1. 在定價頁面選擇方案。一個帳戶可分別建立 Claude、GPT 與 Gemini 專用金鑰，每把金鑰依所選渠道使用對應模型。
2. 打開控制台的 API Keys 建立金鑰。
3. 渠道選 AWSQ 或 CCMAX，這兩個才是 Claude Code 渠道；選成 Codex 或 Gemini 會在這裡被拒。
4. 之後仍可回到 API Keys 清單，顯示或複製完整金鑰。

下方所有範例中的 YOUR_DASHBOARD_API_KEY 都換成這個值。

設定

設定分成兩層，這裡也是多數人卡住的地方。從 Dock 或開始功能表啟動的 VS Code 不會繼承 shell 設定檔，所以 ~/.zshrc 裡的 export ANTHROPIC_BASE_URL=... 在整合終端機有效，聊天面板卻讀不到。請把值寫進 Claude Code 的設定檔，擴充功能和 CLI 都會讀它。

1. Claude Code 設定檔

macOS 與 Linux 是 ~/.claude/settings.json，Windows 是 C:/Users/<UserName>/.claude/settings.json。檔案或目錄不存在就自行建立：

Copy
1
{
2
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
  "env": {
4
    "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
5
    "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",
6
    "API_TIMEOUT_MS": "600000",
7
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
8
  }
9
}

ANTHROPIC_BASE_URL 只到主機名。Claude Code 自己會接上 /v1/messages，寫成 https://api.aiinide.com/v1 會變成送 /v1/v1/messages，直接回 404。若你已經有 settings.json，請把 env 併進去，不要整份覆蓋，否則權限規則和 hooks 會一起消失。

2. 關掉 Anthropic 登入提示

面板原本圍繞 claude.ai 帳號設計，第一次開啟會顯示登入畫面。告訴它不用：

Copy
1
"claudeCode.disableLoginPrompt": true

放進 VS Code 使用者 settings.json（Cmd+, / Ctrl+, → 搜尋 "Claude Code login"），或在擴充功能區塊的 Claude Code 底下設定。

3. 選用：固定模型與逾時

Copy
1
{
2
  "model": "claude-sonnet-5-5",
3
  "env": {
4
    "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
5
    "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY"
6
  }
7
}

不寫 model 就沿用擴充功能的預設選擇，工作階段中也能用 /model 切換。

4. 如果你想用環境變數

shell 設定檔對終端機工作階段仍然有效，尤其你用 code . 從終端機啟動編輯器時。macOS 或 Linux：

Copy
1
export ANTHROPIC_BASE_URL='https://api.aiinide.com'
2
export ANTHROPIC_AUTH_TOKEN="YOUR_DASHBOARD_API_KEY"
3
export API_TIMEOUT_MS=600000
4
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows 用 setx ANTHROPIC_BASE_URL "https://api.aiinide.com"，其餘三個照做，然後重開 VS Code。要注意優先順序：shell 裡匯出的 ANTHROPIC_AUTH_TOKEN 會蓋過設定檔，所以只保留一份來源。

驗證

先列出模型，驗證金鑰及 Claude 渠道。這個請求不消耗額度。

Copy
1
curl --globoff -i 'https://api.aiinide.com/v1/models' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01"

HTTP 200 會傳回模型清單。401 表示缺少金鑰、金鑰無效或已過期，400 表示金鑰渠道不符。下方 Messages 範例請填入清單中的模型 ID。

1. Spark 圖示：開啟一個檔案，點編輯器右上角的 Spark 圖示，或點右下角狀態列的 ✻ Claude Code。不應該出現登入畫面。
2. /status：在輸入框執行 /status，會顯示擴充功能的 Claude Code 版本與目前模型。
3. 在編輯器送出一個簡短提問，再到控制台查看該金鑰的用量。
4. 使用已驗證的金鑰直接測試模型呼叫。

Copy
1
curl --globoff 'https://api.aiinide.com/v1/messages' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "Content-Type: application/json" \
5
  -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

1. 用量：打開用量頁面，成功的提問會以 Token 用量計在這把金鑰上。

疑難排解

請使用 GET /v1/models 傳回的完整 ID。若拼錯 claude-* 名稱，代理可能改用已設定的預設 Claude 模型，並按該模型的費率扣款。

API Error: 404

將 ANTHROPIC_BASE_URL 設為 https://api.aiinide.com。多加 /v1 會讓請求送到 /v1/v1/messages，回傳 404。

API Error: 400：請求格式錯誤

• 渠道不對：Codex 與 Gemini 金鑰驗證的是不同路徑，在這裡會回 400。請用 AWSQ 或 CCMAX 重新建立金鑰。
• settings.json 壞掉：多一個逗號，或值放錯層級，檔案就無法解析，擴充功能會退回預設值。請先驗證內容——加上 $schema 那行後，VS Code 會即時標錯。

金鑰驗證

請依 GET /v1/models 的狀態碼排查金鑰。原生 POST /v1/messages 在金鑰缺失或無效時，也可能回傳 HTTP 200，並將驗證錯誤寫在 content 裡。

• Token 沒被讀到：面板程序沒讀到 settings.json。存檔後執行 Developer: Reload Window；徹底重開 VS Code 最保險。
• ANTHROPIC_API_KEY 搶先：若 shell 同時匯出了 ANTHROPIC_API_KEY，舊的 Anthropic 金鑰可能優先於 ANTHROPIC_AUTH_TOKEN。請取消該變數。
• 金鑰過期：設定過到期時間的金鑰會靜默失效。回控制台確認日期並輪替。

網路、TLS 與逾時

特定視窗的問題

• 受限模式：未信任的工作區會停用擴充功能。信任資料夾後重新載入。
• Remote SSH、WSL、Dev Container：設定必須放在遠端主機上，也就是該環境內的 ~/.claude/settings.json。改本機檔案對遠端工作階段沒有作用。
• 整合終端機顯示 claude: command not found：正常，擴充功能不安裝 CLI。需要就全域安裝，或繼續用聊天面板。
• 找不到 Spark 圖示：它需要有一個開啟的檔案。接著確認版本（1.94.0 以上），並暫時停用其他佔用同一工具列位置的 AI 擴充功能。

模型與價格

Opus 5.5 基礎價為每 100 萬 Token 輸入 $4、快取讀取 $0.20、輸出 $20。AWSQ 按 0.8 倍、CCMAX 按 2 倍消耗額度，同一把金鑰在兩個渠道能換到的實際工作量不同。若上游實際以 Fast 模式處理，基礎與快取費率再翻倍，以回應中的 usage.speed 為準。

• 目前方案價格與額度：定價
• 渠道與額度管理：API Keys
• 完整協議與費率細節：設定說明
• Fast 模式官方說明：Anthropic 文件
• 官方模型設定參考：code.claude.com

常見問題

我還需要另外訂閱 Anthropic 嗎？ 不需要。這套設定的重點就是用 ANTHROPIC_AUTH_TOKEN 加 Base URL 取代 claude.ai 登入，並用 claudeCode.disableLoginPrompt 阻止擴充功能要求登入。

同一把金鑰能給 Cursor 用嗎？ 可以。Cursor 跑的是同一個擴充功能，同一份 settings.json 和同一組 claudeCode.* 設定都適用，詳見在 Cursor 中使用 Claude Code。

擴充功能會讀工作區的 settings.json 嗎？ 部分設定（例如初始權限模式）只認使用者層級。連線設定請放在 ~/.claude/settings.json，這樣每個工作區、每個視窗都會一致。