Claude Code + 你的供應商
保留 Claude Code 作為 CLI,將其中一組啟動設定接到另一個相容於 Anthropic 的模型供應商。
取得供應商資訊
安裝 Claude Code,然後取得供應商提供的 Anthropic 相容 base URL、API 金鑰與模型 ID。只有 OpenAI 相容端點無法搭配 Claude Code 使用。
這個範例會新增一組名為 Claude · work 的獨立設定。你其他的 Claude Code 項目會維持原有設定。
1. 加入供應商設定
將這組設定加入 facade.json(參見Agent 設定)。把範例中的 URL、金鑰與模型 ID 換成供應商提供的值:
{
"clis": {
"Claude · work": {
"type": "claude",
"model": "YOUR_MODEL_ID",
"env": {
"ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_API_KEY": null,
"ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
}
}
}
}每個模型別名都要使用供應商支援的模型。Haiku 對應的模型用於較小的背景任務,可以和主要模型不同。
2. 檢查端點與模型對應
| 設定 | 作用 |
|---|---|
ANTHROPIC_BASE_URL | 將 Claude Code 導向供應商的 Anthropic 相容 API。 |
ANTHROPIC_AUTH_TOKEN | 提供供應商的權杖。 |
ANTHROPIC_API_KEY: null | 為這組設定移除繼承而來的 Anthropic API 金鑰。 |
model | 設定這個項目啟動時使用的模型。 |
ANTHROPIC_DEFAULT_…_MODEL | 將 Opus、Sonnet、Haiku 的請求對應到供應商提供的模型 ID。 |
範例把金鑰直接存進 facade.json。如果想改讀既有的環境變數,請使用 "ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}"。Agent 啟動前,編輯器必須已經具備這個變數。
這些變數只會套用到以這個項目啟動的 Agent,你不需要修改 Claude Code 的全域設定。
3. 以這組設定啟動 Claude Code
儲存 facade.json,選擇 New Agent,然後選擇 Claude · work。交給它一個簡短的專案任務。
如果你的供應商提供用量記錄,請確認請求出現在正確的帳號底下。如果 Agent 無法啟動或請求失敗,請執行 Show Agent Launch 並選擇工作位置。在報告中找到這個項目,就能看到 Facade 會如何啟動它。
遇到驗證錯誤或找不到模型,請看疑難排解。
範例:QwenCloud
若使用 QwenCloud Token Plan 金鑰,base URL 請填 https://token-plan.maas.qwencloudapi.com/apps/anthropic,並選擇你的方案可用的模型 ID。隨用隨付金鑰則要改用對應區域的端點。