繁中 ▾

OpenAI 替代 Claude Code:編碼代理設定

Claude Code 連接到 Anthropic 自己的 API,因此無法簡單地重新指向 OpenAI 風格的端點。以下是可行的替代方案:接受自訂 OpenAI Base URL 的編碼代理,以及如何將其連接到此 API。

更新

透過發光電纜連接到 API 伺服器立方體的終端機視窗,說明編碼代理使用自訂端點

重點

  • Claude Code 圍繞 Anthropic API 格式建構,而此服務使用 OpenAI 聊天補全格式。
  • Aider、Continue、Cline 和 Cursor 風格的工具接受自訂 OpenAI 相容的 Base URL 和模型名稱。
  • 使用 Base URL https://api.minimaxapikey.com/v1,搭配模型 ID uncensored 和 Bearer 金鑰。
  • 先使用 curl 測試,然後將並行請求保持在 8 次或以下,因為代理會同時發出許多呼叫。

簡短答案

如果你搜尋了 Claude Code 的 OpenAI 替代方案,首先要釐清的是你想取代什麼。Claude Code 是 Anthropic 的終端機編碼代理。它設計用於連接到 Anthropic 自己的 API,該 API 使用與 OpenAI 不同的請求格式。此服務實作 OpenAI 聊天補全格式,因此兩者無法僅透過變更 URL 來互連。

可行的是接受任何 OpenAI 相容端點的大量編碼代理和編輯器插件家族。你只需提供 Base URL、金鑰和模型名稱,它們會發送普通的 POST /v1/chat/completions 請求。Aider、Continue 和 Cline 都屬於此類,許多編輯器都有 OpenAI 模型的 Base URL 覆寫功能。對於此 API,三個值分別是 Base URL https://api.minimaxapikey.com/v1、模型 ID uncensored,以及你的 Bearer token 金鑰。

保持合理的期望。端點後方的模型是由獨立供應商運行的一個開放權重模型,針對合法成人用途調整為無內容拒絕的回答。它不是 Claude,也不是任何模型供應商的官方 API。它是否適合你的儲存庫,需透過你自己的任務來確認,本文將展示如何以低成本進行測試。

為什麼不能僅在 Claude Code 中變更 URL

API 格式不僅僅是位址。Anthropic API 有其自己的訊息結構、表達系統提示詞的方式、工具使用區塊和串流事件。OpenAI 風格的伺服器期望收到帶有 roles 的 messages、帶有函式定義的 tools 陣列,以及帶有 choices[0].delta 的伺服器發送事件。為一種格式設計的客戶端在另一種格式的伺服器上會失敗或行為異常,即使 URL 可達。

有些人會在兩者之間放置翻譯層,即一個小型代理程式來重寫請求和回應。這可以運作,但它是你需要自行運行和除錯的獨立軟體,而工具呼叫和串流行為往往是此類層面出錯的地方。Claude Code 是否提供第三方端點的官方設定,需查看 Anthropic 目前的文件,因為這些選項會變更。

更簡單的路徑是選擇已經支援 OpenAI 格式的代理。在基本循環方面你不會失去任何東西:代理讀取你的檔案、建立提示詞、向模型請求編輯並套用。模型是你替換的部分,該部分只需要相容的端點。

在觸及任何工具之前,先用 curl 測試端點

如果你已經知道原始 API 運作正常,每個整合問題都更容易診斷。在 API 金鑰頁面建立金鑰、匯出它,然後發送一個請求。如果此請求成功,後續的任何失敗都來自工具設定,而非金鑰或網路。

export UNCENSORED_KEY="paste-your-key-here"

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that parses an ISO date string."}
    ]
  }'

你也可以使用 GET /v1/models 列出模型。許多工具在儲存提供者時會呼叫該端點,以確認金鑰有效,因此在設定任何內容之前,看到它返回結果是值得的。文件頁面有完整的請求參考。

每個工具輸入 Base URL 的位置

設定名稱雖不同,但概念在所有地方都相同。表格列出了常見的編碼工具以及你需要填入的欄位。選單在不同版本間會移動,因此請將其視為地圖,並檢查每個工具的文件以獲取目前的版面配置。

工具輸入端點的位置使用的模型名稱
AiderOpenAI Base URL 和金鑰的環境變數或命令列旗標openai/uncensored
Continue其設定檔中的模型項目,提供者為 openai 以及 apiBaseuncensored
Cline提供者清單,選擇 OpenAI 相容選項uncensored
Cursor模型設定,OpenAI API 金鑰區塊帶有 Base URL 覆寫uncensored 作為自訂模型
你自己的腳本任何 OpenAI SDK 的 base_url 參數uncensored

由於此服務僅公開一個模型,因此無需配置模型選擇器。無論工具需要什麼模型名稱,輸入 uncensored。如果工具堅持列出已知模型並拒絕未知名稱,請尋找「自訂模型」或「新增模型」選項。

Aider 範例

Aider 在你的終端機中執行,編輯 git 儲存庫中的檔案並提交結果,這使其在精神上最接近 Claude Code。它在底層使用 LiteLLM,因此模型名稱帶有提供者前綴。對於 OpenAI 相容的伺服器,該前綴為 openai/。

pip install aider-chat

export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"

cd your-repo
aider --model openai/uncensored

開始後,在單一檔案中要求小幅修改並觀察差異。先從幾秒內即可驗證的內容開始,例如新增文件字串或重新命名函式,再將多檔案任務交給它。Aider 會在每個回合傳送儲存庫地圖與你加入聊天中的檔案,因此提示詞內容會迅速增長。100,000 token 的上下文視窗(提示詞加補全內容)相當寬鬆,但大型儲存庫仍需要你僅加入重要的檔案。

如果 Aider 警告它不知道模型的上下文大小或價格,這是預期的:它沒有自訂模型名稱的條目。該警告不會阻止其運作。

Continue 範例

Continue 是一個編輯器擴充功能,在 VS Code 和 JetBrains 中新增聊天、編輯和自動完成功能。其設定列出模型,每個模型都有提供者和可選覆寫。此 API 的模型項目如下所示。確切的檔案名稱和結構取決於你安裝的 Continue 版本,因此請與目前的文件進行比較。

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.minimaxapikey.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

聊天與編輯請求適合使用此類端點。Tab 自動完成則是不同的負載:它在幾乎每次輸入暫停時觸發,且需要極低的延遲,這由小型本地模型服務更佳。使用託管的聊天模型進行內聯補全會消耗你每分鐘 300 次請求的限制,卻幾乎沒有成效。

自行構建最小代理

若無現有工具符合需求,函式呼叫支援讓建立小型代理程式變得輕而易舉。API 接受 tools 與 tool_choice,串流輸出 tool_calls,並以 role: "tool" 訊息接收結果。以下迴圈讓模型讀取檔案,然後持續執行直到模型以純文字回答。

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Return the text of a file in the current project.",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "Summarise what main.py does."}]

while True:
    resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = resp.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"], encoding="utf-8") as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

新增寫入函式和執行前的確認提示,你就擁有一個約五十行的編碼代理核心。讀取或寫入前始終驗證路徑:模型可以要求任何路徑。

需要規劃的限制和成本

代理的行為與人類聊天不同。它們發送請求叢集,通常是並行的多個請求。完整金鑰允許 8 個並行請求和每分鐘 300 個請求。試用金鑰允許 2 個並行和每分鐘 60 個,這對代理來說可能很吃緊。當超過限制時,API 會以 HTTP 429 回應,錯誤程式碼為 rate_limited 或 concurrency。在暫時超載時,它也會返回 429 並帶有 Retry-After: 5。大多數良好的客戶端會在 429 時重試,但如果你的客戶端不重試,請降低其並行設定。串流請求會佔用其並行槽位直到串流結束,因此長串流編輯會計入 8 的限制。

費用方面,從預付額度按用量計費,輸入 token 每 1M 為 $0.15,輸出 token 每 1M 為 $0.50。假設一場會話發送 40 次請求,每次攜帶 30,000 個輸入 token,並接收 1,000 個輸出 token。這代表 1,200,000 個輸入 token($0.18)加上 40,000 個輸出 token($0.02),總計 $0.20。失敗或遭拒的請求不計費,且額度永不過期。請見 定價頁面 了解儲值金額與贈金。

新帳戶可以在金鑰頁面以一次點擊領取 $0.50 的免費試用額度,無需信用卡,有效期為 7 天。這足以運行 curl 測試和幾個小型 Aider 編輯。提示詞不會用於訓練。

問答

我可以將 Claude Code 本身指向這個 API 嗎?

無法直接做到。Claude Code 是為 Anthropic 的 API 格式建置的,而此服務實作了 OpenAI 風格的聊天補全。請查看 Anthropic 目前的文件以了解 Claude Code 支援的內容,若要使用此端點,請使用與 OpenAI 相容的代理程式。

哪些編碼工具可與自訂的 OpenAI Base URL 搭配使用?

Aider、Continue 和 Cline 都允許你輸入與 OpenAI 相容的 Base URL、金鑰和模型名稱。Cursor 也提供 OpenAI 風格模型的 Base URL 覆蓋功能,但你應檢查其目前的設定與計畫限制。

此 API 是否支援代理程式的函式呼叫?

支援。你可以傳送工具與 tool_choice、接收串流輸出的 tool_calls,並傳回 role 為 tool 的結果。特定編輯器外掛是否使用這些欄位,則取決於該外掛。

一個編碼工作階段的花費是多少?

定價為每 100 萬個輸入 token $0.15,每 100 萬個輸出 token $0.50。代理會重新傳送大量上下文,因此輸入 token 通常構成帳單主體。

只差一張表單,即可取得金鑰

建立帳號、複製金鑰、更改Base URL。這就是整個設定過程。

取得 API 金鑰