Facade Code 文档
配置 Agent

Claude Code 接入其他模型服务

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

先拿到服务商的信息

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

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

1. 添加服务商配置

把这段加到 facade.json(配置入口见Agent 配置)。地址、密钥和模型 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"
      }
    }
  }
}

每个模型别名都要填服务商支持的模型 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 会怎么启动它。

认证失败、模型不存在这类错误,见排查问题。

服务商示例:QwenCloud

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

QwenCloud 当前的地址与模型设置 ↗

查看 Markdown ↗文档

搜索文档

搜索本文档。↑ ↓ 选择,Enter 打开,Esc 关闭。