在 Claude Code 中使用 Firefly Router
通过环境变量和 Firefly Router API 配置 Claude Code，并了解模型选择、验证方法与兼容性边界。
Claude Code 是 Anthropic 提供的编程 Agent 产品，界面、配置项和支持能力可能随版本变化。本文说明一种通用接入方案：通过环境变量将 Claude Code 的模型请求转发到 Firefly Router API。
安装 Claude Code
已安装的用户可跳过。执行以下命令安装：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
获取 Firefly Router API Key
访问 Firefly Router 开放平台 创建 API Key（选择 default 默认项目），替换下文中的 FIREFLY_ROUTER_API_KEY。
配置环境变量
以下两种方式 任选其一，不要混用：方式一立即生效但仅对当前终端会话有效；方式二写入配置文件，长期生效。
方式一：终端环境变量（仅当前会话）
MacOS 和 Linux：
export ANTHROPIC_BASE_URL="https://api.fireflyai.chat/anthropic"
export ANTHROPIC_AUTH_TOKEN="${FIREFLY_ROUTER_API_KEY}"
export ANTHROPIC_MODEL="zhipu/glm-5.3-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="zhipu/glm-5.3-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="zhipu/glm-5.3-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="zhipu/glm-5.3-flash"
export ANTHROPIC_DEFAULT_FABLE_MODEL="zhipu/glm-5.3-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="zhipu/glm-5.3-flash"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_EFFORT_LEVEL="max"
claude
Windows（PowerShell）：
$env:ANTHROPIC_BASE_URL="https://api.fireflyai.chat/anthropic";
$env:ANTHROPIC_AUTH_TOKEN="$env:FIREFLY_ROUTER_API_KEY"
$env:ANTHROPIC_MODEL="zhipu/glm-5.3-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="zhipu/glm-5.3-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="zhipu/glm-5.3-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="zhipu/glm-5.3-flash"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL="zhipu/glm-5.3-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="zhipu/glm-5.3-flash"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
claude
方式二：写入 settings.json（长期生效）
将同样的变量写入 ~/.claude/settings.json 的 env 字段：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.fireflyai.chat/anthropic",
"ANTHROPIC_AUTH_TOKEN": "FIREFLY_ROUTER_API_KEY",
"ANTHROPIC_MODEL": "zhipu/glm-5.3-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "zhipu/glm-5.3-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "zhipu/glm-5.3-flash",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "zhipu/glm-5.3-flash",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "zhipu/glm-5.3-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "zhipu/glm-5.3-flash",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
注意：settings.json 的 env 会 覆盖 终端里 export 的同名变量；该文件包含明文 API Key，请勿提交到 git 仓库；保存后需重启 Claude Code 生效。
配置项说明
Claude Code 内部会按场景使用不同档位的模型（主对话、后台摘要、子 Agent 等），只配置部分变量会让对应场景静默失败：
| 变量 | 作用 | 不配置或配置错误的影响 |
|---|---|---|
ANTHROPIC_BASE_URL | 将模型请求转发到 Firefly Router 的 Anthropic 兼容端点 | 请求被发往 Anthropic 官方端点，鉴权失败 |
ANTHROPIC_AUTH_TOKEN | 使用 Firefly Router API Key 鉴权 | 返回 401 鉴权错误 |
ANTHROPIC_MODEL | 主对话使用的模型 | 使用 Claude 默认模型名，Firefly Router 端点无法识别，报模型不存在错误 |
ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL | Claude Code 按任务档位选择模型时使用的模型名 | 对应档位的任务（如 haiku 档的后台标题生成、摘要）请求失败 |
CLAUDE_CODE_SUBAGENT_MODEL | 子 Agent 使用的模型 | 子任务请求失败或效果明显变差 |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | 触发自动压缩上下文的窗口大小 | 需与模型上下文一致，例如：zhipu/glm-5.3-flash 为 1M（1048576）；设置过小会过早压缩丢失上下文，过大则报上下文超限错误 |
CLAUDE_CODE_EFFORT_LEVEL | 控制 Claude Code 的推理强度 | 设为 max 以获得最充分的推理；较低值可能在复杂任务上降低质量 |
确认配置是否生效
在 Claude Code 中输入 /status 确认配置状态：
- Base URL 应显示为
https://api.fireflyai.chat/anthropic - Model 应显示为
zhipu/glm-5.3-flash
Claude Code 的 /model 菜单是内置的固定别名列表，不会显示 Firefly Router 模型，也无需在其中切换——配置是否生效以 /status 显示为准。
最后随便发送一条消息（例如 hi），能正常收到回复即说明端到端配置成功。
第三方工具：cc-switch
cc-switch 等社区工具可以在多套供应商配置之间切换。这类工具并非 Firefly Router 官方维护，其预设配置可能与本页推荐值存在差异，使用后请对照「配置项说明」逐一核对各变量取值，并用 /status 确认实际生效的 Base URL 与模型。