Claude Code API 接入:配置与常见问题
Claude Code 是 Anthropic 官方的命令行编程 Agent,能读懂整个代码库、编辑文件、运行命令。通过 FlyRouter 使用时,只需把 API 地址和 Key 指向 FlyRouter,迁移工作流前请确认下方功能限制。
更新日期:
安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash安装完成后运行 claude --version 确认,遇到问题可以运行 claude doctor 自检。
配置 FlyRouter
创建 API Key
在控制台 API 密钥 页面为 Claude Code 单独创建一个 Key。
写入配置文件
编辑用户配置文件 ~/.claude/settings.json(Windows 为 %USERPROFILE%\.claude\settings.json),没有就新建:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.flyrouter.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-...",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
}
}ANTHROPIC_BASE_URL 不要带 /v1。
启动并确认
在项目目录运行 claude,然后输入 /status,看到 Anthropic base URL 一行显示 https://api.flyrouter.ai 即配置成功。
为什么写在 settings.json
写进 settings.json 后,无论从哪个终端、哪个 IDE 启动都会生效,而且第一次启动就能直接使用,不会停在登录页。同一个变量同时在 shell 和 settings.json 里设置时,以 settings.json 为准。不要把含 Key 的配置写进项目里会提交到 Git 的 .claude/settings.json。
也可以只用环境变量(只对当前终端生效):
export ANTHROPIC_BASE_URL="https://api.flyrouter.ai"
export ANTHROPIC_AUTH_TOKEN="sk-..."
claude选择模型
Claude Code 里的 opus、sonnet、haiku 三个别名分别对应上面配置的三个模型,haiku 还用于后台的轻量任务。会话中输入 /model 可以切换:
- Sonnet(
claude-sonnet-5-5):日常编程的主力,速度和效果均衡。 - Opus(
claude-opus-5-5):复杂重构、架构设计等难题。 - Fable(
claude-fable-5-1):最强推理,单价最高,可以在/model里直接输入模型 ID 使用。
想固定默认模型,可以在 env 里加 "ANTHROPIC_MODEL": "claude-sonnet-5-5"。模型 ID 必须和 模型价格 页面上的完全一致。
常见问题
启动后仍然要求登录
确认 ANTHROPIC_AUTH_TOKEN 写在 ~/.claude/settings.json 的 env 里,而不是只在某个终端里 export。如果之前用 Claude 账号登录过,可以在会话里运行 /logout 清掉旧的登录状态。
提示 There's an issue with the selected model
模型 ID 写错了,或这个 Key 限制了可用模型。到 模型价格 页面核对 ID,并检查 Key 的模型限制。
报 400 Extra inputs are not permitted
新版 Claude Code 偶尔会发送尚未普及的实验字段。在 env 中加入 "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" 即可。
请求超时
复杂任务首字可能较慢。可以在 env 里设置 "API_TIMEOUT_MS": "1200000"(20 分钟)放宽超时。
部分功能不可用
使用第三方 API 地址时,Remote Control、语音输入和 /fast 等依赖 Anthropic 账号的功能不可用,编程相关功能不受影响。
增加流量前核对费用
查看模型 ID 与价格、Token 费用核对和迁移清单。测试时记录客户端版本;第三方接口的账户专属功能和实验功能可能不同。