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),没有就新建:

~/.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 费用核对和迁移清单。测试时记录客户端版本;第三方接口的账户专属功能和实验功能可能不同。