編寫代理自定義 API 速查表：複製貼上配置，大幅降低您的 Token 帳單

每個熱門程式開發代理（coding agent）都允許你替換其背後的模型，但每個工具都將設定隱藏在不同的檔案、不同的鍵值名稱，以及不同的網址格式中。因此，人們最後乾脆放棄並繼續支付昂貴的 frontier 模型費用，儘管重度代理使用者在使用預設模型時，平均每天每位開發人員的成本高達 13 美元（CloudZero, 2026）。本頁面旨在解決這個問題。這是一份單一參考指南，包含 Claude Code、OpenClaw、Codex、OpenCode 和 Cursor 的精確自訂 API 設定，並列出區分它們的唯一關鍵差異。 請將此頁面加入書籤，因為這裡的價值在於可直接複製貼上的程式碼區塊與注意事項，而非冗贅的說明。閱讀完畢後，你只需幾分鐘就能將這些代理指向更便宜的模型，並了解為何網址會在不同工具間有所變更。

重點摘要

• 程式開發代理分為兩個協定系列。Claude Code 使用 Anthropic API；OpenClaw、Codex、OpenCode 和 Cursor 使用相容於 OpenAI 的 API。
• 實務上的區別在於網址：相容於 OpenAI 的工具需要 /v1 後綴，而 Claude Code 則不需要。
• 每個設定檔都需要三個相同的要素：基礎網址（base URL）、API 金鑰（API key）和模型 ID（model ID）。只有欄位名稱會變更。
• 開放權重模型（Open-weight models）是獲利關鍵：DeepSeek V4 Flash 的輸入成本約為每百萬代幣 0.14 美元，而 frontier 模型則需數美元（Codersera, 2026）。

為何程式開發代理的自訂 API 速查表物超所值

我們之所以要費心處理，原因在於成本，而根本問題在於架構。代理在每個推理步驟中都會重新發送累計的上下文，因此它們完成相同任務所消耗的代幣量是聊天視窗的 10 到 100 倍（LeanOps, 2026）。這個倍數就是代理帳單膨脹的原因，這也是為什麼針對代幣重新定價，而不是減少使用代理，才是真正有效的做法。 自訂 API 能在不改變你工作方式的情況下，將代理導向更便宜的後端。將日常程式編寫任務導向開放權重模型，每代幣成本將大幅下降，通常可降低 70% 以上，而日常任務的品質落差卻很小。程式開發代理自訂 API 速查表之所以重要，是因為節省的費用是真實的，但設定上的阻力卻是阻礙大多數人的原因，而這些阻力幾乎全都源自於「哪個檔案、哪個欄位、哪個網址」。

程式開發代理自訂 API 速查表運作原理

在進行設定之前，有一個核心概念能讓你融會貫通。程式開發代理分為兩個協定系列，工具所屬的系列決定了設定檔的格式。 Claude Code 與 Anthropic Messages API 溝通，因此它從 ANTHROPIC_BASE_URL 讀取後端，並使用 Anthropic 風格的權杖進行驗證。本速查表中的其他工具（OpenClaw、Codex、OpenCode 和 Cursor）則與相容於 OpenAI 的 Chat Completions API 溝通，因此它們需要 baseURL、OpenAI 風格的金鑰，並預期端點路徑包含 /v1。那個 /v1 的細節是導致設定靜默失敗最常見的原因。 一旦你了解這個區別，下方的每個條目其實都是同一組三個值的不同表現形式：基礎網址、金鑰和模型 ID。範例中使用 Atlas Cloud 作為供應商，因為它在同一個帳戶下同時支援這兩個協定系列，因此在不同工具間改變的只有語法，而非你貼上的金鑰。任何相容的供應商運作方式皆相同；只需替換基礎網址和金鑰即可。

程式開發代理自訂 API 速查表：工具清單

以下首先提供快速參考表，接著是每個工具的完整設定區塊。開始前請準備好你的 API 金鑰。在 Atlas Cloud 上，你可以透過選擇 Coding Plan 作為金鑰類型來建立，這會將其與基於點數的程式編寫額度連結。

Claude Code

Claude Code 是 Anthropic 系列的特例，請注意基礎網址沒有 /v1。編輯 macOS 或 Linux 上的 ~/.claude/settings.json，或 Windows 上的 %USERPROFILE%.claude\settings.json：

plaintextCopy
1{
2  "env": {
3    "ANTHROPIC_AUTH_TOKEN": "your-atlas-api-key",
4    "ANTHROPIC_BASE_URL": "https://api.atlascloud.ai",
5    "ANTHROPIC_MODEL": "zai-org/glm-5.1",
6    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "zai-org/glm-5.1",
7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "zai-org/glm-5.1",
8    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
9  }
10}

將 Haiku 和 Sonnet 的預設值設為同一個模型，可以將 Claude Code 的小型背景呼叫也路由到你的模型，避免因預設模型無法使用而失敗。

OpenClaw

OpenClaw 最簡單，因為它有設定嚮導。在終端機中執行 openclaw onboard，然後選擇 Yes、QuickStart 和 Custom Provider。輸入基礎網址 https:​//api.atlascloud.ai/v1，貼上你的金鑰，貼上模型 ID，並選擇 OpenAI-compatible 協定。當它顯示 Verification successful 時，為端點命名即完成。 若你是手動編輯 ~/.openclaw/openclaw.json，請留意：OpenClaw 的設定分為兩步。你需要在 models.providers 下定義供應商，然後必須在 agents.defaults.models 下使用 provider-name/model-name 鍵來將該模型列入白名單，否則代理會拒絕它（OpenClaw docs, 2026）。未列入白名單是導致「模型未被允許（model not allowed）」錯誤的主要原因。設定嚮導會幫你完成這兩個步驟，因此建議使用該方式。

Codex

Codex 使用兩個檔案。將供應商資訊放入 ~/.codex/config.toml：

plaintextCopy
1model_provider = "atlas_coding_plan"
2model = "zai-org/glm-5.1"
3
4[model_providers.atlas_coding_plan]
5name = "atlascloud"
6base_url = "https://api.atlascloud.ai/v1"
7wire_api = "chat"
8requires_openai_auth = true

然後將金鑰放入 ~/.codex/auth.json：

plaintextCopy
1{ "OPENAI_API_KEY": "your-atlas-api-key" }

在終端機執行 codex，跳過更新提示，即可連線。

OpenCode 和 Cursor

OpenCode 讀取 ~/.config/opencode/opencode.json (Windows 上為 \Users\your-name.config\opencode\opencode.json)：

plaintextCopy
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "atlascloud": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "atlascloud",
7      "options": {
8        "baseURL": "https://api.atlascloud.ai/v1",
9        "apiKey": "your-atlas-api-key"
10      },
11      "models": {
12        "zai-org/glm-5.1": { "name": "glm-5.1" }
13      }
14    }
15  }
16}

Cursor 沒有對應的設定檔。開啟 Settings，前往 Models，透過名稱加入你的模型 ID，然後將自訂 OpenAI 基礎網址設為 https:​//api.atlascloud.ai/v1 並貼上金鑰。因為 Cursor 遵循 OpenAI 相容模式，其他工具使用的相同基礎網址與金鑰可直接通用。

模型選擇：程式開發代理自訂 API 速查表的另一半

設定端點只是工作的一半。你選擇的模型決定了節省的成本。有效的模式是預設使用強大且便宜的開放模型來進行日常編寫，並保留一個 frontier 模型以備最困難的推理任務。能力落差小於價格落差：在 SWE-Bench Pro 測試中，領先的開放模型得分高達 70 多分，而頂尖的 frontier 模型約為 91 分（Codersera, 2026），這在日常功能開發與重構中幾乎看不出差異。 在基於點數的供應商上，每個模型都有一個將代幣使用量映射到點數的倍數，因此相對成本很容易閱讀：

一個 API 金鑰通用於所有程式開發代理

注意速查表所展示的事實：每個設定中使用的金鑰和模型 ID 都是相同的。這就是使用統一供應商的真正理由。如果你將每個工具連結到不同的供應商，最終會得到分散的金鑰、儀表板和帳單，並且無法單一檢視整體支出。將所有工具指向同一個供應商，能將這些整合為一個點數池和一個切換模型的地方。 這也能解決預算控制問題，這在代幣計費模式下確實困難。每日固定點數配額在午夜重置的計畫，可以防止失控的代理迴圈造成災難，而隨用隨付方案則能吸收偶發的流量高峰。Atlas Cloud 的方案每月 10 美元起，隨用隨付套餐提供 41% 折扣，且週期內升級按比例計費，升級只需補足差額。

程式開發代理自訂 API 速查表：常見錯誤

幾乎每個設定失敗都歸因於以下其中之一，且全都容易修復。 /v1 混淆。 這是整份速查表中最常出現的錯誤。相容於 OpenAI 的工具需要 /v1 後綴；Claude Code 則不需要。連線錯誤通常意味著該工具的系列路徑錯誤。 使用錯誤的金鑰類型。 你的供應商金鑰不是你的 Anthropic 金鑰，反之亦然。貼錯金鑰會產生看似複雜實則單純的驗證錯誤。 跳過 OpenClaw 白名單設定。 定義供應商只是 OpenClaw 設定的一半。如果看到「model not allowed」，說明模型不在白名單中，或是 provider-name/model-name 鍵有拼寫錯誤。 在 Claude Code 中未設定背景模型。 如果你只設定了主要模型，而將 Haiku 和 Sonnet 預設指向不可用的模型，小型背景呼叫將會失敗。請務必設定這三個項目。

常見問題：程式開發代理自訂 API 速查表

此速查表是否需要更換工具？

不用。重點在於讓你繼續使用已經慣用的代理，無論是 Claude Code、OpenClaw、Codex、OpenCode 還是 Cursor。自訂 API 是設定檔的調整，而非遷移，因此你的工作流程保持不變，但後端與帳單會改變。

為什麼速查表中的基礎網址會隨工具而異？

這是因為協定系列不同。Claude Code 使用 Anthropic API 並使用裸網域，而相容於 OpenAI 的工具則需要 /v1 路徑。相同的供應商、相同的金鑰，但路徑不同。這個單一差異解釋了大多數設定失敗的原因。

此速查表能為你省下多少錢？

視模型而定，省下非常多。DeepSeek V4 Flash 的每百萬輸入代幣成本約 0.14 美元，而 frontier 模型則需數美元（Codersera, 2026），因此將日常工作交由開放模型處理，通常能在不改變程式編寫方式的情況下，將每代幣帳單削減 70% 以上。

我應該從速查表中選擇哪個模型開始？

針對互動式編寫，GLM-5.1 或 Kimi K2.6 是強大且實惠的預設值。針對高流量或背景任務，DeepSeek V4 Flash 更便宜。僅在開放模型真正無法處理的任務時，才將 frontier 模型備用。

自訂 API 設定是否可逆？

是的，每個設定都可以復原。只需恢復原始的基礎網址或移除供應商區塊，代理就會變回原本的預設值。許多開發人員會保留兩套設定，並根據任務性質進行切換。

結論

值得保留這份程式開發代理自訂 API 速查表的原因在於，最難的部分從來不是概念，而是記住每個工具需要的檔案和路徑。一旦你理解了兩個協定系列，每個設定檔的核心其實都是相同的基礎網址、金鑰和模型 ID，差別僅在語法。選擇一個開放權重模型，貼上對應的區塊，注意 /v1 規則，你就能在保留喜愛代理的同時，僅支付 frontier 模型的一小部分費用。如果你想在所有工具間共用一個金鑰與預算，可以透過 Atlas Cloud Coding Plan 主控台進行設定，並在任務變更時隨時切換模型。