在 Cursor 中使用 Claude Code:設定、模型與驗證

在 Cursor 裡執行 Claude Code 擴充功能,用一把 AI in IDE API Key,同時讓 Cursor 自己的 AI 功能與計費保持分開。

Cursor 是 VS Code 的分支,擴充功能與設定檔都和 VS Code 相同;差別在 Cursor 自己的擴充功能來源、設定同步與內建 AI。完整參考請看在 Cursor 中使用 Claude Code,本篇是精簡版。

快速設定

  1. 確認 Cursor 版本。 Cursor → About Cursor 會顯示 VS Code 基底版本,必須是 1.94.0 以上。
  2. 安裝擴充功能。 使用直接連結、Cmd+Shift+X / Ctrl+Shift+X 搜尋 Claude Code,或市集檢視被篩選時從 Open VSX Registry 安裝。Spark 圖示沒出現時執行 Developer: Reload Window。
  3. 建立 API Key。 打開 API Keys 建立金鑰,渠道選 AWSQ 或 CCMAX。Codex 或 Gemini 金鑰驗證的是不同端點,在這裡會失敗。
  4. 寫入連線設定。 建立或合併 ~/.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 更新、設定檔切換與視窗重載。

  1. 關掉登入提示。 在 Cursor 使用者 settings.json 加入 "claudeCode.disableLoginPrompt": true。
  2. 驗證。 用金鑰與 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-20251001AWSQ、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 擴充功能是兩個獨立產品,計費也分開。

相關頁面

在 Cursor 中使用 Claude Code:設定、模型與驗證|AI in IDE