# Claude Code 接入其他模型服务

继续用 Claude Code 这个 CLI，只把某一套启动配置接到兼容 Anthropic 的模型服务。

## 先拿到服务商的信息

安装 Claude Code，准备服务商的 Anthropic 兼容地址、API 密钥和模型 ID。如果只有 OpenAI 兼容地址，Claude Code 用不了。

下面的例子新建一个 `Claude · work` 条目，你原有的 Claude Code 条目不受影响。

## 1. 添加服务商配置

把这段加到 facade.json（配置入口见[Agent 配置](https://facadecode.com/zh-cn/docs/settings/)）。地址、密钥和模型 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"
      }
    }
  }
}
```

每个模型别名都要填服务商支持的模型 ID。Haiku 对应的映射用于较小的后台任务，可以和主模型不同。

## 2. 核对地址和模型映射

| 配置项 | 作用 |
| --- | --- |
| `ANTHROPIC_BASE_URL` | 把 Claude Code 的请求转到服务商的 Anthropic 兼容接口。 |
| `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`，在项目里给它一个短任务。

服务商有用量统计的话，确认请求记在正确的账号上。启动失败或请求失败时，运行 **Show Agent Launch** 并选择工作位置，在报告里找到这个条目，看 Facade 会怎么启动它。

认证失败、模型不存在这类错误，见[排查问题](https://facadecode.com/zh-cn/docs/troubleshooting/)。

## 服务商示例：QwenCloud

用 QwenCloud Token Plan 的密钥时，基础地址填 `https://token-plan.maas.qwencloudapi.com/apps/anthropic`，模型选这个计划里有的 ID。按量付费的密钥要用对应区域的地址。

[QwenCloud 当前的地址与模型设置 ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/claude-code)