首頁指南
Cursor 的 Claude Code API:自訂端點設定
正在尋找不依賴單一供應商的 適用於 Cursor 的 Claude Code API 設定?Cursor 可連線至任何 OpenAI 相容的端點,本指南將顯示你需要設定的每個項目。
更新於

你正在設定的內容
Cursor 是一款內建 AI 功能的編輯器。在其模型設定中,有一個欄位可讓你將 OpenAI Base URL 替換為自己的 URL,並有一個地方可輸入自己的金鑰。這使得能夠將聊天請求發送到任何遵循 OpenAI chat-completions 格式的服務。此服務符合該格式,因此 Cursor 可將其用作聊天和內嵌編輯的模型後端。
你將輸入的值是固定的。Base URL:https://api.claudecodeapikey.com/v1。模型名稱:uncensored。金鑰:來自你帳戶的金鑰,以 Bearer token 形式傳送。伺服器端無需其他設定。
請清楚了解這是什麼。端點後端的模型來自獨立供應商的開放權重模型。它不是 Claude 模型,也不是 Anthropic 或其他人的官方 API。如果你期望在 Cursor 中看到 Claude 本身,這是不同的東西,結尾章節將說明如何判斷它是否足以滿足你的工作需求。
開啟 Cursor 之前
先準備好這些,以免中途停止。
- 使用 Google 或電子郵件與密碼建立帳戶。
- 開啟 API 金鑰頁面並建立金鑰。金鑰指南顯示每個按鈕的位置。
- 如果你想免費測試,請領取 $0.50 試用額度。只需點擊一次,無需綁定信用卡,有效期為 7 天。
- 從終端機執行快速檢查,確認金鑰有效,以免歸咎於編輯器。
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
JSON 回覆包含訊息表示金鑰和 URL 正確。HTTP 401 表示金鑰錯誤或含有空白字元。請在此修復,因為 Cursor 的錯誤訊息不如 curl 具體。
Cursor 逐步設定
選單名稱在 Cursor 版本之間會有所變化,因此將下方的標籤視為指南,並尋找最接近的匹配項。
- 開啟 Cursor 設定並前往模型區段。
- 找到 OpenAI API 金鑰欄位,並貼上此服務的金鑰。
- 開啟覆寫 OpenAI Base URL 的選項,並輸入
https://api.claudecodeapikey.com/v1。包含結尾的/v1,並移除任何尾隨路徑,例如/chat/completions。 - 使用新增自訂模型的選項,並精確輸入
uncensored,使用小寫。 - 按下金鑰欄位旁邊的驗證或儲存按鈕。Cursor 會發送一個小型測試請求。
- 開啟聊天面板,在模型下拉選單中選擇
uncensored,然後發送短提示詞。
如果驗證步驟失敗但 curl 檢查通過,請檢查是否將 URL 輸入到 base URL 欄位而非金鑰欄位,以及你的 Cursor 版本是否在更新後重設了覆寫設定。快速入門保留了此編輯器的目前步驟。
一個值得知道的小細節:單一覆寫適用於 OpenAI 供應商槽位。如果你也透過該槽位使用真實的 OpenAI 模型,它們現在也會路由到此端點。許多人保留單獨的 Cursor 設定檔,或在想要切換回來時關閉覆寫。
使用真實程式提示詞測試
問候語證明不了什麼。使用能測試上下文和指令的提示詞。選擇專案中的一個函式,開啟聊天,並要求執行具體任務,例如新增輸入驗證和單元測試。注意三件事。
- 串流輸出。 答案應逐 token 出現。端點透過 SSE 串流輸出,因此長時間等待後出現一大段文字表示代理伺服器或設定正在緩衝它。
- 上下文使用。 附加兩到三個檔案並提出需要所有檔案的問題。上下文視窗為 100,000 token,可容納大量原始碼,但你的編輯器決定實際發送多少內容。
- 指令遵循。 要求僅提供 diff 回覆或嚴格輸出格式,並查看模型是否遵守。開放權重模型在此方面有所不同,你希望第一天就了解它。
保留一個包含五個來自你自己儲存庫的真實任務的短清單,並在更改溫度等設定時重新執行它們。根據你自己的程式碼進行判斷,優於任何一般性聲明,包括我們的聲明。
修復常見錯誤
401 或金鑰無效
金鑰錯誤、從剪貼簿過期,或周圍有空格。重新貼上。確保授權機制為 Bearer,當你在 OpenAI 金鑰欄位中使用時,Cursor 會為你設定。
404 或找不到模型
幾乎總是 Base URL 問題。缺少 /v1 或額外的 /chat/completions 會破壞路徑。模型名稱也必須是 uncensored,無大寫字母或空格。
429 速率限制或並行請求
你達到了限制。試用金鑰允許 2 個並行請求和每分鐘 60 個請求,完整金鑰允許 8 個並行和每分鐘 300 個請求。編輯器可以同時觸發多個請求,例如聊天加上背景編輯,串流會佔用槽位直到結束。錯誤代碼告訴你哪個限制:rate_limited 是每分鐘請求數,concurrency 是同時過多。暫時過載也會回傳 429 與 Retry-After: 5,因此等待五秒後重試是正確的。
回答被截斷
上下文視窗為 100,000 token,包含提示詞和完成內容。非常大的附件會留下很少的空間給回覆。發送較少的檔案,或開始新的聊天。
沒有作用的功能
API 僅支援文字,不提供嵌入。如果 Cursor 功能需要嵌入模型或影像輸入,則無法透過此端點運作。
運作後值得調整的設定
首次成功聊天後,一些調整可使日常使用更順暢。
降低編輯任務的溫度。如果你的編輯器提供該選項,約 0.2 的值可提供更穩定的程式碼。對於腦力激盪,請提高它。接下來,注意你附加的上下文量。視窗很寬鬆,但每個附加檔案都作為輸入計費,因此關閉無關的分頁並排除建置資料夾可降低成本並使答案更集中。
如果你使用代理或多步驟模式,請記住函式呼叫支援:端點接受 tools 和 tool_choice,並串流輸出 tool_calls。特定 Cursor 功能是否使用這些參數取決於版本,因此請先執行一個小型代理任務並觀察結果,再信任它進行大型變更。最後,偶爾在終端機測試中檢查 X-Balance-USD 標頭,以免工作期間餘額不足讓你驚訝。
在腳本中使用相同金鑰
OpenAI 相容端點的一個優勢是,你在 Cursor 中設定的金鑰也可以在程式碼中使用。以下是 Node 範例,對於建置腳本或提交訊息工具很有用。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
將金鑰儲存在環境變數中,不要放在會提交到版本控制系統的檔案裡。每個回應都包含 X-Balance-USD 標頭,讓腳本能在額度不足時向你發出警告。
成本與何時應維持現狀
編輯器的使用屬於輸入密集型,因為每個請求都包含檔案上下文。每 1M 輸入 token 費用為 $0.15,每 1M 輸出 token 為 $0.50。一個包含 15,000 個輸入 token 和 1,000 個輸出 token 的請求,成本為 0.015 x $0.15 + 0.001 x $0.50 = $0.00225 + $0.0005 = $0.00275。一百次這樣的請求總計 $0.275。定價頁面列出了儲值金額,最低 $20 起,$50 以上還有贈額。
如果你依賴特定供應商的模型來進行複雜的重構,或者你的工作流程依賴純聊天端點無法提供的功能,請保留現有設定。當你想要更低的單 token 價格、簡單的 API 以及對合法工作較少的內容拒絕時,請使用此 API。許多開發者會同時設定兩者,並根據任務進行切換。
更多指南
問答
我在 Cursor 中應該輸入什麼 Base URL?
輸入 https://api.claudecodeapikey.com/v1,包含 /v1。不要在末尾加上 /chat/completions。
我應該新增什麼模型名稱?
新增一個名為 uncensored 的自訂模型,請使用小寫字母。這是該 API 提供的唯一模型 ID。
這會讓我在 Cursor 中使用 Claude 模型嗎?
不會。該端點僅提供來自獨立供應商的單一開放權重模型。它不是 Anthropic 或其他任何供應商的官方 API。
為什麼我在編輯器中會收到 429 錯誤?
你已超過每分鐘限制,或同時請求過多。試用金鑰允許 2 個並行請求和每分鐘 60 個請求,完整金鑰則為 8 個和 300 個。
我可以免費試用嗎?
是的。新用戶可在 API 金鑰頁面領取 $0.50 的免費試用額度。它不需要信用卡,且有效期為 7 天。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。