Facade Code 說明文件
設定 Agent

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 換成供應商提供的值:

facade.json
{
  "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。隨用隨付金鑰則要改用對應區域的端點。

QwenCloud 目前的端點與模型設定 ↗

以 Markdown 檢視 ↗說明文件

搜尋說明文件

搜尋本指南。用 ↑ ↓ 移動、Enter 開啟、Esc 關閉。