# Claude Code + 你的供應商

保留 Claude Code 作為 CLI，將其中一組啟動設定接到另一個相容於 Anthropic 的模型供應商。

## 取得供應商資訊

安裝 Claude Code，然後取得供應商提供的 Anthropic 相容 base URL、API 金鑰與模型 ID。只有 OpenAI 相容端點無法搭配 Claude Code 使用。

這個範例會新增一組名為 `Claude · work` 的獨立設定。你其他的 Claude Code 項目會維持原有設定。

## 1. 加入供應商設定

將這組設定加入 facade.json（參見[Agent 設定](https://facadecode.com/zh-tw/docs/settings/)）。把範例中的 URL、金鑰與模型 ID 換成供應商提供的值：

```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 會如何啟動它。

遇到驗證錯誤或找不到模型，請看[疑難排解](https://facadecode.com/zh-tw/docs/troubleshooting/)。

## 範例：QwenCloud

若使用 QwenCloud Token Plan 金鑰，base URL 請填 `https://token-plan.maas.qwencloudapi.com/apps/anthropic`，並選擇你的方案可用的模型 ID。隨用隨付金鑰則要改用對應區域的端點。

[QwenCloud 目前的端點與模型設定 ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/claude-code)
