在 VS Code 中使用 Claude Code：設定、模型與驗證
在 VS Code 安裝 Claude Code 擴充功能，用一把 AI in IDE API Key 接上，幾分鐘內完成第一次請求，不需要 Anthropic 訂閱。
整套設定只有一個擴充功能、一把金鑰和一段 JSON。完整參考（代理、TLS、Remote SSH、WSL）請看在 VS Code 中使用 Claude Code，本篇是精簡版。
快速設定
- 安裝擴充功能。 需要 VS Code 1.94.0 以上。從擴充功能檢視、Visual Studio Marketplace，或市集被封鎖時用 Install from VSIX… 安裝 Claude Code。面板沒出現時執行 Developer: Reload Window。
- 建立 API Key。 打開 API Keys 建立金鑰，渠道選 AWSQ 或 CCMAX。這兩個才是 Claude Code 渠道，Codex 或 Gemini 金鑰會在這裡被拒絕。
- 寫入連線設定。 建立或合併
~/.claude/settings.json（macOS/Linux）或C:/Users/<UserName>/.claude/settings.json（Windows）：
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；結尾帶 /v1 會變成 /v1/v1/messages，得到 404。檔案已存在時請合併 env 物件，保留原本的權限規則與 hooks。
- 關掉 Anthropic 登入提示。 在 VS Code 使用者設定加入
"claudeCode.disableLoginPrompt": true，或在設定搜尋「Claude Code login」。 - 驗證。 用金鑰與
anthropic-version: 2023-06-01標頭呼叫GET /v1/models。HTTP 200 會列出該渠道模型；401 代表金鑰缺少或無效；400 代表金鑰屬於其他渠道。接著開啟檔案，點擊 Spark 圖示或 ✻ Claude Code，執行/status，送出一段短提示。成功的提示會出現在 Usage。
支援模型
| 模型 | 渠道 | 適合 |
|---|---|---|
claude-opus-5-5（別名 claude-opus-5.5） | AWSQ、CCMAX | 高難度重構、長時間自動執行 |
claude-sonnet-5-5（別名 claude-sonnet-5.5） | AWSQ、CCMAX | 日常寫程式，預設首選 |
claude-haiku-4-5-20251001 | AWSQ、CCMAX | 快速修改、便宜的驗證呼叫 |
settings.json 不填 model 就使用擴充功能的選擇器，或在工作階段中用 /model 切換。請使用 GET /v1/models 回傳的完整 ID；拼錯的 claude-* 名稱可能被解析成預設 Claude 模型，並依該模型費率計費。方案、額度與目前費率請看定價。
工作流程重點
- 擴充功能已內建 Claude Code。安裝擴充功能不會把
claude加進 PATH；只有終端機工作階段或claude mcp add才需要另外安裝獨立 CLI。 - 從 Dock 或開始功能表啟動的 VS Code 不會載入 shell profile。連線值請寫進
~/.claude/settings.json，擴充功能與 CLI 都會讀取。 - 在 Remote SSH、WSL 或 dev container 中，設定檔必須存在於遠端環境；改本機檔案對遠端工作階段沒有作用。
- 環境中若匯出
ANTHROPIC_API_KEY，它可能優先於ANTHROPIC_AUTH_TOKEN。請只保留一個來源。
疑難排解重點
API Error: 404—ANTHROPIC_BASE_URL含有/v1。改用https://api.aiinide.com。API Error: 400— 金鑰來自其他渠道，或settings.json無法解析。用 AWSQ 或 CCMAX 重建金鑰並驗證 JSON。- 沒有 Spark 圖示 — 先開啟檔案；圖示只在有開啟檔案時顯示，且 VS Code 必須是 1.94.0 以上。
- 面板沒有反應 — 從命令面板執行 Claude Code: Show Logs；擴充功能可能無法啟動內建 CLI。
常見問題
我還需要 Anthropic 訂閱嗎？
不需要。ANTHROPIC_AUTH_TOKEN 加 AI in IDE 的 Base URL 就取代 claude.ai 登入，claudeCode.disableLoginPrompt 則阻止擴充功能要求登入。
同一把金鑰能給 Cursor 用嗎？
可以。Cursor 執行同一個擴充功能，同一份 settings.json 與 claudeCode.* 設定都適用。請看在 Cursor 中使用 Claude Code。
擴充功能會安裝 claude CLI 嗎？
不會。擴充功能內建自己的 CLI，但不會把 claude 放進 PATH。只有需要終端機工作階段或 claude mcp add 時才安裝獨立 CLI。
要在哪裡改模型？
在 ~/.claude/settings.json 設定 model，或在面板使用 /model。兩者都寫在完整的 VS Code 指南。