使用中文開源模型的第三方網關設定：Claude Code 自訂 API 端點

Claude Code 可以透過第三方網關來與兼容 Anthropic 的端點進行通訊，而不是直接使用提供商的端點。這使得可以測試網關管理的工作流程，並使用網關暴露的模型 ID，包括 ECAIX 目前模型目錄中可用的中文開源模型。

這篇指南涵蓋的是一個針對提供商的第三方兼容性工作流程。Anthropic 的官方 Claude Code 網關文檔指出，Anthropic 不支持將 Claude Code 路由到非 Claude 模型的網關。ECAIX 不聲稱這個工作流程是由 Anthropic 官方支持的，且非 Claude 模型可能無法提供所有的 Claude Code 功能。

快速入門

如果您已經理解了兼容性的邊界，可以先嘗試這個簡單的步驟：

1. 打開 當前 ECAIX 模型目錄 並選擇一個活躍的模型 ID。
2. 創建一個 ECAIX API 密鑰 並將其保留在源控制外。
3. 設定 ANTHROPIC_BASE_URL 為 https://ecaix.com/api/ai/v1/anthropic。
4. 執行以下的診斷請求並記錄 HTTP 狀態碼。
5. 在讀寫模式下的測試專案中使用 claude -p。
6. 分別測試工具、流式輸出、上下文限制和權限。

發布時的驗證狀態

這張表格是故意的：配置範例並不等同於測試兼容性結果。

這個設定會如何改變

這個設定有四個獨立部分：

1. Claude Code 是創建編程任務並發送請求的客戶端。
2. 兼容 Anthropic 的網關 在 Anthopric 风格的端點接收請求。
3. 模型 ID 選擇網關暴露的上游模型。
4. API 密鑰 驗證請求並決定帳戶、配額和權限。

更換端點並不會將非 Claude 模型轉變成 Claude 模型。它只會改變哪個兼容的 API 表面接收請求。工具使用、上下文處理、模型別名、流式行為和權限流程可能因客戶端版本和網關實現而異。

在開始之前

您需要：

• 支援環境或設定基礎的端點配置的 Claude Code 安裝。
• 一個 ECAIX API 密鑰。
• 在 ECAIX 模型目錄中目前存在的模型 ID。
• 一個可以執行小型測試請求而不將 API 密鑰放入源控制的終端。

目錄會隨時間變化。在將模型 ID 拷貝到配置文件之前，請打開 ECAIX 模型目錄 並確認該模型是活躍的且可用於您計劃使用的 API 风格。

配置網關端點

Claude Code 在許多安裝情況下會儲存在 ~/.claude/settings.json。精確的設定模式可能會變化，因此請將以下內容視為起始模式，並與您安裝版本的文檔進行比較。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

請勿將包含實際 API 密鑰的文件提交到公開存儲庫。優先使用本地環境變量、密鑰管理器或您的 Claude Code 安裝推薦的機制。

您也可以在測試時在 Shell 會話中配置端點：

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

不同版本的 Claude Code 支援的變量名稱和設定可能會變化。如果客戶端忽略 ANTHROPIC_MODEL，請使用文檔中提到的模型字段或模型別名機制。網關仍然需要識別最終的模型 ID。

驗證兼容的 Anthropic 端點

在開始交互式編程會話之前，請發送一個小型請求。這將將端點、認證和模型 ID 的問題與 Claude Code 特定的行為分開。

以下命令會分別保存響應頭和響應體，然後打印 HTTP 狀態碼。請在本地 Shell 中使用實際授權密鑰，但請勿在文章、問題或共享日誌中貼上。

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

預期的解讀：

• 200：檢查響應的形狀並確認返回的模型或使用場景字段。
• 401 或 403：檢查密鑰、標頭、帳戶和權限範圍之前更改提示。
• 404：檢查基礎 URL、/messages 後綴和端點部署。
• 400：將請求縮小到最小有效體，並檢查模型特定的字段。
• 5xx 或超時：記錄請求時間和響應體，然後分離網關、上游和客戶端超時行為。

成功的響應確認密鑰、端點、請求格式和模型 ID 在該請求中能夠一起工作。它並不證明所有的 Claude Code 功能都能正常工作。

選擇模型 ID

ECAIX 的目錄包含來自中文提供商的模型家族。選擇適當的起始模型取決於任務，而不僅僅是模型名稱。

編程和一般開發

從目前的 DeepSeek、Qwen、GLM 或 Seed 編程能力模型開始，這些模型在目錄中可見。例如，目錄可能會暴露 ID 如 deepseek-v4.1-flash、qwen3.8-flash、glm-5.3 或 seed-2.0-code。可用性和能力可能會隨時間變化，請在發布配置之前總是驗證當前模型頁面。

長上下文和倉庫工作

對於大型倉庫或長技術文檔，請比較模型目錄中顯示的上下文長度。較大的上下文窗口並不自動意味著更好的倉庫結果：提示結構、工具支援、輸出限制和網關的請求限制也很重要。

工具呼叫和代理工作流程

如果工作流程需要功能呼叫或工具，請檢查模型和端點文檔。有些提供商通過兼容 OpenAI 的 API 暴露工具呼叫，而其他提供商則使用不同的字段名稱或僅支援工具行為的一部分。從小型工具呼叫測試開始，在給模型訪問實際倉庫或外部系統之前。

中文開發工作

中文開源模型在代碼、文檔、問題追蹤或團隊工作流程中包含中文內容時，可能是有用的。請用您自己的提示和倉庫樣本評估模型，而不是僅依賴一般排名。

在 API 請求成功後測試 Claude Code

當直接請求成功後，從一個只讀或低風險命令開始：

claude -p "Explain what this repository does without editing files."

然後測試一個狹窄範圍的任務。例如：

claude -p "List the likely entry points for the web application. Do not modify files."

逐漸增加測試的難度：

1. 純文本響應。
2. 簡短的代碼解釋。 3.倉庫導航。
3. 在可廢棄分支中的控制編輯。
4. 工具使用或多步驟任務。
5. 流式輸出和長上下文行為。

不要假設成功的文本響應證明了權限提示、工具呼叫、流式輸出、上下文限制或檔案編輯行為與基於 Claude 的會話完全相同。

選擇適當的 API 路徑

Claude Code 只是一個客戶端工作流程。適當的 API 路徑取決於您需要的客戶端和功能集：

對於 ECAIX，請使用 Anthropic Messages 文檔 來處理 Anthopric 风格路徑，以及 Chat Completions 文檔 來處理兼容 OpenAI 的客戶端。請使用 模型目錄 確認當前模型，以及 價格頁面 確認當前顯示的價格。

兼容性矩陣

以下矩陣是發布時的證據邊界，並非聲稱所有功能都已支持：