在 Cursor 中使用 Claude Code:設定、模型與驗證
在 Cursor 裡執行 Claude Code 擴充功能,用一把 AI in IDE API Key,同時讓 Cursor 自己的 AI 功能與計費保持分開。
Cursor 是 VS Code 的分支,擴充功能與設定檔都和 VS Code 相同;差別在 Cursor 自己的擴充功能來源、設定同步與內建 AI。完整參考請看在 Cursor 中使用 Claude Code,本篇是精簡版。
快速設定
- 確認 Cursor 版本。 Cursor → About Cursor 會顯示 VS Code 基底版本,必須是 1.94.0 以上。
- 安裝擴充功能。 使用直接連結、
Cmd+Shift+X/Ctrl+Shift+X搜尋 Claude Code,或市集檢視被篩選時從 Open VSX Registry 安裝。Spark 圖示沒出現時執行 Developer: Reload Window。 - 建立 API Key。 打開 API Keys 建立金鑰,渠道選 AWSQ 或 CCMAX。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 }
Base URL 只填主機位址。Cursor 與 CLI 都會讀這份檔案,它也能撐過 Cursor 更新、設定檔切換與視窗重載。
- 關掉登入提示。 在 Cursor 使用者
settings.json加入"claudeCode.disableLoginPrompt": true。 - 驗證。 用金鑰與
anthropic-version: 2023-06-01呼叫GET /v1/models;200 列出模型,401 代表金鑰錯誤,400 代表其他渠道。接著開啟面板、執行/status、送出短提示,並到 Usage 確認該金鑰的用量。
Cursor 內的差異
- 兩個面板、兩套計費。 Cursor 內建的聊天與自動補全是獨立產品,不會共用這把金鑰。Cursor 自己的 Claude 存取由 Cursor 計費;Claude Code 面板由 AI in IDE 依金鑰額度計費。同一項工作請固定用其中一個,否則兩邊的用量資料都會不準。
- 設定檔可能被清掉。 Cursor 把擴充功能設定存在自己的設定檔裡,切換設定檔可能默默移除
claudeCode.*值。切換後請重新確認。 - 代理設定分開。 Cursor 的 HTTP 代理與
HTTPS_PROXY分開設定,可能一個 AI 客戶端正常、另一個失敗。 - 更新可能重設擴充功能。 若 Cursor 更新後擴充功能消失,從擴充功能檢視重新安裝,並補回
claudeCode.*設定。 - 索引會搶資源。 第一次回應很慢、之後恢復正常,通常是 Cursor 索引器佔滿 CPU 與網路。
支援模型
| 模型 | 渠道 | 適合 |
|---|---|---|
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 | 快速修改、便宜的檢查 |
不填 model 就使用選擇器,或用 /model 切換。請使用 GET /v1/models 的完整 ID;拼錯的 claude-* 名稱可能被解析成預設 Claude 模型,並依該模型費率計費。方案與目前費率請看定價。
疑難排解重點
API Error: 404—ANTHROPIC_BASE_URL含有/v1。改用主機位址。API Error: 400— Cursor 安裝了舊版建置,或settings.json格式錯誤。Cursor 不會警告損壞的檔案;請在 Cursor 打開它,讓$schema行顯示驗證錯誤。- 仍出現登入畫面 — 用
/logout登出、設定disableLoginPrompt,再重載。 - 舊權杖優先 — 在 Cursor 整合終端機執行
echo $ANTHROPIC_AUTH_TOKEN。若印出舊值,就是它優先。
常見問題
擴充功能在 Cursor 中受官方支援嗎?
Anthropic 將它發佈到 Visual Studio Marketplace 與 Open VSX,並把 Cursor 列為支援的安裝目標。安裝仍經過 Anthropic 並不營運的市集。
要同時安裝 Cursor 的 Claude 存取與這個擴充功能嗎?
只有想同時保留兩套計費時才需要。若要用量數字一致,同一項工作請擇一使用。
可以沿用 VS Code 的金鑰與設定嗎?
可以。Cursor 執行同一個擴充功能,同一把金鑰、同一份 settings.json 與 claudeCode.* 設定都適用。差異在 Cursor 的設定檔處理與它自己的 AI 功能。
Cursor 的自動補全会用這把金鑰嗎?
不會。Cursor 內建 AI 與 Claude Code 擴充功能是兩個獨立產品,計費也分開。