Browse documentation

Getting Started

Ide

在 Cursor 中使用 Claude Code

在 Cursor 裡執行 Claude Code 擴充功能，只需要一把 AI in IDE 的 API Key。

Cursor 是 VS Code 的分支，官方擴充功能可以照常安裝、行為一致；但 Cursor 有自己的 AI 功能、自己的擴充功能來源和自己的設定同步機制，這三點改變了疑難排解的重點。

如果你用的是原生 VS Code，請改看在 VS Code 中使用 Claude Code，設定段落完全相同，那邊也涵蓋一般狀況。本篇專講 Cursor 內部的差異。

版本與前置條件

元件	需求	備註
Cursor	基於 VS Code 1.94.0 以上的版本	Cursor → About Cursor 會顯示 VS Code 基底版本
Claude Code 擴充功能	Open VSX 或內建市集的最新版	版本號跟著內建 CLI 走
AI in IDE 金鑰	AWSQ 或 CCMAX 渠道	控制台
Anthropic 帳號	不需要	API Key 取代登入

Cursor 不會把 claude 放進 PATH，擴充功能也不會。只有要用終端機工作階段或 claude mcp add 才需要另外安裝 CLI。

安裝擴充功能

直接安裝：Install for Cursor，Cursor 會解析擴充功能 ID，之後仍會顯示一般確認步驟。
手動：Cmd+Shift+X / Ctrl+Shift+X，搜尋 Claude Code，按安裝。
搜尋不到時：Cursor 的市集檢視可能有篩選。改從 Open VSX Registry 安裝，那是同一份為分支編輯器發佈的建置。

安裝後 Spark 圖示沒出現，執行 Developer: Reload Window。圖示只在有開啟檔案時顯示，只開資料夾不夠。

建立並複製 API Key

打開 API Keys 建立金鑰，渠道選 AWSQ 或 CCMAX。這兩個才是 Claude Code 渠道，Codex 或 Gemini 金鑰驗證的是不同端點，在這裡會失敗。之後仍可回到 API Keys 清單，顯示或複製完整金鑰。

下文所有範例以 YOUR_DASHBOARD_API_KEY 代表這個值。

設定

1. 連線設定

建立或合併 ~/.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。

這份檔案由擴充功能和 CLI 共用，所以是放代理設定的正確位置：它能撐過 Cursor 更新、設定檔切換與視窗重新載入。

2. 關閉登入提示

擴充功能原本是為 claude.ai 帳號設計的。在 Cursor 使用者 settings.json（Cmd+, / Ctrl+,）加入：

1 "claudeCode.disableLoginPrompt": true

少了這行，第一次開面板會出現 Sign in，擴充功能永遠到不了你的 Base URL。

3. 別讓 Cursor 自家的 AI 混淆

Cursor 內建的聊天與 Tab 補全是另一個產品，不共用這把金鑰。兩個實際後果：

兩個面板、兩套計費。Cursor 自家的 Claude 由 Cursor 計費；Claude Code 面板由 AI in IDE 依你的金鑰額度計費。同一件工作請固定用一種，否則兩邊的用量數字都會看不懂。
settings.json 衝突。Cursor 把擴充功能設定存在自己的設定檔裡，切換 Cursor profile 可能悄悄清掉 claudeCode.* 的值。切換後請重新確認。

4. 選用：模型與 shell 一致性

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 }

在 macOS 上，從 Dock 啟動的 Cursor 繼承的是系統環境，不是你的 shell 設定檔，所以 ~/.zshrc 的 export 只對整合終端機有效，聊天面板讀不到。上面那份檔案就是解法。若你確實要靠 shell 匯出值，用終端機執行 cursor . 啟動就能繼承。

驗證

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

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。

面板開啟且不出現登入畫面。點 Spark 圖示開面板；若仍要求登入，代表 disableLoginPrompt 沒寫在使用者設定裡。
在輸入框執行 /status，確認版本與模型。
在編輯器送出一個簡短提問，再到控制台查看該金鑰的用量。
使用已驗證的金鑰直接測試模型呼叫。

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}'

用量。成功的提問會讓用量頁面上這把金鑰的數字增加。

疑難排解

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

`API Error: 404`

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

`API Error: 400`

Cursor 裝到舊版建置：分支專用來源的版本可能落後，到擴充功能檢視更新後重新載入。
settings.json 格式錯誤：Cursor 不會告訴你檔案壞了，只會默默忽略。用 Cursor 打開它，$schema 那行會即時標出驗證錯誤。

金鑰驗證

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

仍在登入流程：先前若登入過 Claude 帳號，先 /logout，設定 disableLoginPrompt，再重新載入。
環境裡有另一個 ANTHROPIC_AUTH_TOKEN：Cursor 的環境可能來自 shell、設定檔或啟動代理。在 Cursor 整合終端機執行 echo $ANTHROPIC_AUTH_TOKEN，若印出舊值，那就是生效的那一個。
金鑰過期或渠道被改過：把金鑰從 CCMAX 改成 Codex 後在這裡一定失敗。請重建而不是改渠道。

Cursor 特有的網路問題

現象	原因	處理方式
面板能用但 Tab 補全失敗（或相反）	兩個 AI 客戶端只有一個設了代理	Cursor 的 HTTP 代理與 `HTTPS_PROXY` 是分開設定的，兩邊都要設
Cursor 更新後擴充功能消失	profile 被重置	從擴充功能檢視重裝，並補回 `claudeCode.*` 設定
第一次回應極慢，之後正常	Cursor 索引器同時吃滿 CPU 與網路	等索引完成，或把大型目錄排除
只有 Cursor 出現 `Certificate is not trusted`	代理做 TLS 解密，而 Cursor 不信任該憑證	在 `settings.json` 的 `env` 加 `NODE_EXTRA_CA_CERTS` 指向代理根憑證
Remote-SSH 視窗請求一直卡到逾時	設定放在本機	改遠端主機內的 `~/.claude/settings.json`

與其他擴充功能衝突

Cursor 環境常同時裝了多個 AI 擴充功能。兩個都會註冊聊天面板或同一組快速鍵的，就會互搶：Cmd+Esc 可能打開 Cursor 自家聊天而不是 Claude Code，工具列的 Spark 圖示也可能被蓋住。先暫時停用另一個確認原因，然後二選一，或在鍵盤快速鍵編輯器重新綁定。

模型與價格

模型	渠道	用途
`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	快速修改、便宜的檢查

Opus 5.5 牌價為每 100 萬 Token 輸入 $4、快取讀取 $0.20、輸出 $20；額度消耗 AWSQ 為 0.8 倍、CCMAX 為 2 倍。上游若以 Fast 模式處理，基礎與快取費率加倍。

方案與額度：定價
金鑰管理：API Keys
端點與費率細節：設定說明
官方擴充功能參考：code.claude.com VS Code（Cursor 支援寫在同一頁）

常見問題

Cursor 算官方支援嗎？ Anthropic 把擴充功能發佈到 Visual Studio Marketplace 與 Open VSX，並在文件裡把 Cursor 列為可安裝的目標。從 Anthropic 的角度，市集本身是它不營運的第三方軟體。

Cursor 自家的 Claude 和這個擴充功能要一起裝嗎？ 只有你想要兩套計費並存時才需要。想要一致的用量數字，就固定用一種。

金鑰可以跟同事共用嗎？ 建議用金鑰上的額度與到期欄位來分配，而不是共用個人金鑰，並在用量頁面按金鑰查看。

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	`}`

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	`}`

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	`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"`