配置 Agent
Claude Code 接入其他模型服务
继续用 Claude Code 这个 CLI,只把某一套启动配置接到兼容 Anthropic 的模型服务。
先拿到服务商的信息
安装 Claude Code,准备服务商的 Anthropic 兼容地址、API 密钥和模型 ID。如果只有 OpenAI 兼容地址,Claude Code 用不了。
下面的例子新建一个 Claude · work 条目,你原有的 Claude Code 条目不受影响。
1. 添加服务商配置
把这段加到 facade.json(配置入口见Agent 配置)。地址、密钥和模型 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"
}
}
}
}每个模型别名都要填服务商支持的模型 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。按量付费的密钥要用对应区域的地址。