Claude Code 是目前市面上最頂尖的 AI 代理編碼工具之一,但它也是擴展使用時成本最昂貴的工具,重度用戶在使用標準 API 時,每位活躍開發者每天的成本可高達 USD13(CloudZero, 2026)。大多數人忽略了一點:Claude Code 背後的模型是可以更換的。只需設定一個環境變數,你就能將 Claude Code 的體驗指向不同的後端,包括像 GLM、Kimi 和 DeepSeek 等價格更親民的開源權重模型。
本指南是一份完整且無廢話的 Claude Code 第三方 API 設定教學。你將學到重定向的底層運作原理、精確的設定參數、如何選擇模型,以及如何驗證連接是否正確。整個過程只需約五分鐘,且當天就能開始節省成本。
重點摘要
- Claude Code 會從 ANTHROPIC_BASE_URL 環境變數讀取後端設定,因此任何與 Anthropic 相容的端點都可以直接替換預設值,而無需更動應用程式本身(Claude Code 文檔, 2026)。
- 設定方式僅需編輯 ~/.claude/settings.json 一個檔案,基本情況下無需代理伺服器或封裝腳本。
- 開源權重模型可大幅降低 Token 單價:DeepSeek V4 Flash 每百萬輸入 Token 成本約為 USD0.14,遠低於前沿模型的數美元(Codersera, 2026)。
- 使用將多個模型整合在單一端點後的閘道器(Gateway),只需修改一行程式碼即可切換模型,無需針對五家不同的供應商重新註冊金鑰。
為什麼要進行 Claude Code 第三方 API 設定
誠實地說,原因就是成本,而且數據差異巨大。像 Claude Code 這樣的代理工具在每一步推理時都會重新發送累積的上下文,因此它們消耗的 Token 比一般聊天視窗多出 10 到 100 倍(LeanOps, 2026)。正是因為這種 Token 倍數效應,一個複雜的任務可能會在悄無聲息間耗費數美元,導致團隊每位工程師的月帳單飆升至數百美元。
Claude Code 第三方 API 設定從源頭解決了這個帳單問題:Token 單價。你不再需要為每一次編輯、重構和測試運行支付前沿模型的昂貴費用,而是將大部分工作路由到成本僅為其零頭的開源權重模型。在常規編碼任務中,模型間的品質差距遠小於價格差距。此設定的目標不是放棄 Claude Code,而是保留你喜歡的工具,同時以開源模型的價格來支付 Token 費用。
對於 Anthropic 未直接覆蓋地區的開發者來說,還有第二個重要的理由:存取權。第三方端點提供了一種穩定、相容的方式來使用 Claude Code,而無需依賴單一供應商的帳單系統或可用性。

Claude Code 第三方 API 設定的運作原理
在貼上任何設定之前,了解實現這一目標的唯一機制很有幫助。Claude Code 並未硬編碼 Anthropic 的伺服器。在啟動時,它會讀取少數幾個環境變數,其中最重要的是 ANTHROPIC_BASE_URL。預設情況下,它指向 Anthropic 的 API。一旦更改它,Claude Code 發出的每一個請求都會轉向新的位址(Claude Code 文檔, 2026)。
要使此機制運作,第三方端點必須使用 Claude Code 預期的協議,即 Anthropic Messages API 格式。這就是為什麼你不能直接指向原始的 OpenAI 端點。供應商需要提供一個 Anthropic 相容的 URL。許多模型供應商現在都發布了這樣的端點,而聚合多個開放模型的閘道器則會為你進行轉換,確保 GLM、Kimi 或 DeepSeek 都能以 Claude Code 能理解的格式回應。
影響設定的三個核心變數是:
- ANTHROPIC_BASE_URL:Claude Code 發送請求的目的地。
- ANTHROPIC_AUTH_TOKEN:該端點的 API 金鑰,而非你的 Anthropic 金鑰。
- ANTHROPIC_MODEL:端點應運行的模型名稱。
一旦理解該應用程式僅是一個指向特定 URL 的客戶端,剩下的設定就只是操作問題了。
Claude Code 第三方 API 設定:步驟詳解
這是本指南的核心。以下範例使用 Atlas Cloud 作為供應商,因为它提供了一個兼容 Anthropic 的端點,整合了主流開源權重模型,這使設定變得簡潔,且讓你日後切換模型時無需重複操作。同樣的步驟適用於任何相容的供應商,僅需更改基礎 URL 和金鑰。
第 1 步:獲取 API 金鑰和基礎 URL
在此步驟結束時,你將獲得兩個字串:端點 URL 和金鑰。
- 在所選供應商處建立帳號,並開啟 API 金鑰區塊。
- 產生一個針對編碼或代理使用的金鑰。在 Atlas Cloud 上,建立金鑰時選擇 Coding Plan 類型,這會將金鑰與基於積分的編碼額度綁定,而非一般按量計費。
- 將金鑰複製到安全的地方並記下基礎 URL。對於 Claude Code,Atlas Cloud 使用 https://api.atlascloud.ai(注意:Claude Code 端點不需要 /v1 後綴,這是常見的陷阱)。

第 2 步:編輯 settings.json
此步驟完成後,Claude Code 將指向新的後端。打開適用於你作業系統的設定檔:
- macOS / Linux: ~/.claude/settings.json
- Windows: %USERPROFILE%\.claude\settings.json
貼上以下內容,並將金鑰替換為你的真實金鑰:
plaintext1{ 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}
一個能節省許多困擾的細節是:將 ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 設定為與 ANTHROPIC_MODEL 相同的模型,這確保了 Claude Code 的後台任務(例如摘要總結等小型快速呼叫)也能路由到你選定的模型,而不是因預設模型不可用而靜默失敗。
第 3 步:選擇適合任務的模型
此步驟完成後,你將擁有一個合理的預設模型。ANTHROPIC_MODEL 的值僅是供應商識別的模型 ID 字串。使用聚合端點時,切換模型只需一行變動:今天設定為 zai-org/glm-5.1,明天換成 moonshotai/kimi-k2.6,或針對大量後台工作使用 deepseek-ai/deepseek-v4-flash,然後重啟 Claude Code 即可。無需新金鑰,無需新的設定區塊。
第 4 步:驗證 Claude Code 第三方 API 設定
此步驟完成後,你就能確認設定是否生效。在任何專案中開啟終端機並執行:
plaintext1claude
接著給它一個簡單的任務,例如要求它解釋一個檔案或寫一個單行函數。如果它正常回應,說明重定向已生效,你的請求已發送至第三方模型。如果你收到身份驗證錯誤,請檢查金鑰是否正確或是否有多餘的空格。如果你收到連接錯誤,請重新檢查基礎 URL,特別是針對你的特定工具是否需要 /v1 後綴。
為 Claude Code 第三方 API 設定選擇模型
選擇模型是決定省錢效率的關鍵。明智的做法是:日常工作預設使用強大且便宜的開源模型,僅在最困難的推理任務中保留價格較高的模型。其能力確實足夠:在 SWE-Bench Pro 測試中,領先的開源模型得分在 70 分以上,而頂級前沿模型約為 91 分(Codersera, 2026)——這在處理極端難題時是有差距的,但對於日常的功能開發和重構工作來說,這個差距幾乎微不足道。
在基於積分的閘道器上,每個模型都有一個乘數,將 Token 使用量映射為積分,因此你可以一目了然地比較相對成本。以下是幾個熱門編碼模型的比較:
| 模型 ID | 上下文 | 輸入乘數 | 輸出乘數 | 相較官方節省約 |
|---|---|---|---|---|
| deepseek-ai/deepseek-v4-flash | 1M | 0.23 | 0.46 | ~50% |
| deepseek-ai/deepseek-v3.2 | 160K | 0.42 | 0.62 | ~55% |
| minimaxai/minimax-m2.5 | 200K | 0.65 | 2.18 | ~45% |
| moonshotai/kimi-k2.6 | 262K | 1.72 | 7.26 | ~45% |
| zai-org/glm-5.1 | 200K | 2.54 | 7.99 | ~45% |
來源:Atlas Cloud Coding Plan 積分規則。積分成本 = 輸入 Token × 輸入乘數 + 輸出 Token × 輸出乘數。

對於大多數開發者而言,一個實用的預設策略是:互動式編碼使用 GLM-5.1 或 Kimi K2.6,大量或後台工作轉用 DeepSeek V4 Flash,僅在遇到開源模型無法解決的罕見任務時,才調用前沿模型。
一個設定,多種工具:不僅僅是 Claude Code
支援 Claude Code 第三方 API 設定的同一個端點並不限於 Claude Code 使用。大多數開發者會運行多個代理:終端機裡的 Codex、編輯器裡的 Cursor、或是 OpenClaw 和 OpenCode。將它們指向不同的供應商意味著要處理不同的金鑰和帳單。將它們全部指向同一個與 OpenAI 相容的基礎 URL,可以將這些資源整合為一個積分池,並集中管理模型切換。
對於 Codex,類似的 Claude Code 設定位於 ~/.codex/config.toml:
plaintext1model_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
你的金鑰應以 OPENAI_API_KEY 的形式存放在 ~/.codex/auth.json 中。OpenClaw、OpenCode、Cursor 以及 Copilot 風格的客戶端都採用相同的 https://api.atlascloud.ai/v1 基礎 URL 以及與 OpenAI 相容的協議。請記住這點差異:Claude Code 使用不帶路徑的 https://api.atlascloud.ai,而與 OpenAI 相容的工具則使用 /v1 路徑。
這樣的整合也能修復預算管理問題。在午夜重置的固定每日積分配額為失控的代理循環設定了結構性上限,而隨用隨付的方案則能吸收偶發性的用量高峰。如果你在週期內用完了額度,按比例升級只需支付差價,而無需購買全新的方案。

常見的 Claude Code 第三方 API 設定錯誤
大多數設定失敗的原因都可以追溯到少數幾個錯誤,而且幾乎都出現在設定字串中,而非深層問題。
基礎 URL 路徑錯誤。 這是最常見的錯誤。Claude Code 和 OpenAI 相容工具在同一供應商下通常需要不同的路徑。如果 Claude Code 拋出連接錯誤,請檢查你的端點是否需要 /v1 後綴。
誤用 Anthropic 金鑰。 ANTHROPIC_AUTH_TOKEN 必須是第三方供應商的金鑰,而非你的 Anthropic 金鑰。兩者不可互換,使用錯誤的金鑰會產生看起來比實際更神祕的身份驗證錯誤。
遺忘後台模型變數。 如果你只設定了 ANTHROPIC_MODEL,但讓 Haiku 和 Sonnet 的預設值指向不可用的 Anthropic 模型,Claude Code 的小型後台呼叫可能會失敗。請確保將這三個變數都設定為你的端點實際支援的模型。
假設所有功能都能完美轉移。 第三方模型可以很好地處理核心編碼循環,但供應商特有的附加功能以及最新的模型行為可能與 Anthropic 預設值有所不同。在將其用於關鍵任務之前,請先用常規任務確認基本功能。
常見問題解答
Claude Code 第三方 API 設定困難嗎?
不困難。基本設定僅需編輯 ~/.claude/settings.json 中的三到四個環境變數,耗時約五分鐘。除非你想在工作階段中切換模型(這屬於進階選項,而非必要步驟),否則無需代理或封裝腳本。
Claude Code 第三方 API 設定實際能節省多少成本?
這取決於你選擇的模型,但價格差異極大。DeepSeek V4 Flash 每百萬輸入 Token 約為 USD0.14,遠低於前沿模型的數美元(Codersera, 2026)。因此,將大部分日常工作路由到開源模型通常可以減少 70% 以上的 Token 帳單,且無需改變你的編碼習慣。
設定完成後應該使用哪個模型?
對於互動式編碼,強大的通用模型如 GLM-5.1 或 Kimi K2.6 是很好的預設選擇。對於延遲要求較低的大量或後台工作,使用 DeepSeek V4 Flash 等更便宜的模型非常合理。僅保留前沿模型作為後備,用於處理開源模型無法破解的偶發性難題。
設定後所有功能都能運作嗎?
核心的代理編碼循環運作良好,因為它依賴於相容端點實作的標準 Messages API。某些供應商特有功能或最新的模型特定行為可能與 Anthropic 預設值不同,建議先在低風險任務中進行測試。
如果想切換回 Anthropic,我必須撤銷設定嗎?
不需要。保留你的 Anthropic 金鑰,只需在 settings.json 中恢復原始的 ANTHROPIC_BASE_URL(或移除覆蓋設定),即可將 Claude Code 切換回 Anthropic。許多開發者會保留兩套設定,根據當下任務進行切換。
結論
Claude Code 第三方 API 設定是開發者在 2026 年可以做出的最高槓桿率、五分鐘變更之一。工具體驗完全相同,但後端和帳單卻截然不同。將 ANTHROPIC_BASE_URL 指向相容的端點,挑選適合任務的開源權重模型,你就能在保留原有 Claude Code 工作流的同時,僅支付前沿模型價格的一小部分。如果你希望將所有開源模型整合在同一個金鑰和預算下(同時涵蓋 Codex、OpenClaw 等工具),你可以透過 Atlas Cloud Coding Plan 控制台進行設定,並隨時透過修改單行參數來切換模型。






