Claude Code 命令行接入

手动安装

1. 安装 Claude Code

Claude 模型请使用 Anthropic 原生协议。Claude Code 使用 ANTHROPIC_AUTH_TOKEN（Bearer），指向 https://api.flyhub.com.cn，不要填 OpenAI 兼容端点 /v1。

若已安装 Claude Code，可跳过本节，直接进入环境变量配置。

1.1 安装 Claude Code

方式一：官方原生安装，不需要 Node.js：

curl -fsSL https://claude.ai/install.sh | bash

方式二：npm 安装（需要 Node.js 22 或更高版本）：

bash

npm install -g @anthropic-ai/claude-code

验证安装：

bash

claude --version

bash

claude doctor

claude --version 能输出版本号、claude doctor 无报错即可。Windows 建议安装 Git for Windows：Claude Code 的 Bash 工具需要它，不装则改用 PowerShell 工具。

2. 配置环境变量

将 <FLYHUB_API_KEY> 替换为 FlyHub 控制台创建的 API Key，然后执行对应平台的命令：

macOS / Linux：

bash

SHELL_RC="$HOME/.zshrc"; case "$SHELL" in *bash*) SHELL_RC="$HOME/.bashrc";; esac
cat >> "$SHELL_RC" <<'EOF'
export ANTHROPIC_BASE_URL=https://api.flyhub.com.cn
export ANTHROPIC_AUTH_TOKEN="<FLYHUB_API_KEY>"
export ANTHROPIC_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
export CLAUDE_CODE_SUBAGENT_MODEL=claude-opus-5
export CLAUDE_CODE_EFFORT_LEVEL=high
EOF
source "$SHELL_RC"

Windows（PowerShell，写入用户级环境变量）：

powershell

setx ANTHROPIC_BASE_URL "https://api.flyhub.com.cn"
setx ANTHROPIC_AUTH_TOKEN "<FLYHUB_API_KEY>"
setx ANTHROPIC_MODEL "claude-opus-5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-opus-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-4-5"
setx CLAUDE_CODE_SUBAGENT_MODEL "claude-opus-5"
setx CLAUDE_CODE_EFFORT_LEVEL "high"

Windows 执行 setx 后需重新打开终端才会生效；更推荐直接改下一节的 settings.json。默认模型用 claude-opus-5（最稳）；sonnet / fable 系列目前在该网关上会丢消息，见故障排查。

推荐安装会自动写入 settings.json 的 env。官方行为：同一个变量在 shell / 用户级环境变量和 settings.json 的 env 里都设置时，以 settings.json 为准。所以换 Key / 换地址时优先改 settings.json，改完重启 claude。

2.1 修改 settings.json

打开用户目录下的 .claude/settings.json，将 env 改为下列内容（只改这一段，保留文件中其他字段）。推荐安装会自动写入该文件；手动配置时若没有该文件，可新建并只放入下面的 env。

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.flyhub.com.cn",
    "ANTHROPIC_AUTH_TOKEN": "<FLYHUB_API_KEY>",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-5",
    "CLAUDE_CODE_EFFORT_LEVEL": "high"
  }
}

模型选择：默认 claude-opus-5 实测最稳，claude-haiku-4-5 也可用于轻量任务。不要用 sonnet 系列（claude-sonnet-5 / claude-sonnet-5-5 / claude-sonnet-4-6）和 claude-fable-5-1：它们经该网关调用时， Claude Code 发的多段消息有约 40% 概率丢正文，模型会回「你的消息是空的 / Nothing came through」，但退出码仍是 0。因此这里把 sonnet 别名也指到了 opus-5。

也可直接删除 env 整段，让 Claude Code 使用上一节写入的环境变量
保存后完全退出 Claude Code，再开新终端运行 claude

3. 启动并验证

一键安装会把 claude 接到 FlyHub 的 bin 目录，同一窗口即可运行。手动安装后若提示找不到命令，把安装目录加入 PATH，或新开终端。

bash

claude

启动后进入 Claude Code 运行 /status：Status 页出现 Anthropic base URL 一行（值为 https://api.flyhub.com.cn），以及 Auth token 一行，说明请求走的是 FlyHub 而不是 claude.ai 登录。没有这两行就说明变量没生效。

4. 故障排查

答非所问、模型说「你的消息是空的 / Nothing came through / 只有省略号」：这不是配置错误，而是网关对 sonnet / fable 系列多段消息的处理问题。把 ANTHROPIC_MODEL（以及 ANTHROPIC_DEFAULT_SONNET_MODEL）换成 claude-opus-5 或 claude-haiku-4-5 即可稳定。实测：两段 content 的请求，claude-sonnet-5 约 5 次里 2～3 次丢正文，claude-opus-5 / claude-haiku-4-5 全部正常。

启动仍要求登录 Anthropic：Claude Code 没读到 Key。把 ANTHROPIC_AUTH_TOKEN 放进 ~/.claude/settings.json 的 env（Windows 为 %USERPROFILE%\.claude\settings.json）或当前 shell 的 export；项目目录里 .claude/settings.json 的 env 要等首次运行向导和信任之后才生效，不能用来跳过登录。

400 报 context_management、Extra inputs are not permitted 等字段错误：网关不认 Claude Code 新发的实验字段，在 settings.json 的 env 里加 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 后重启。

安装后提示找不到 claude：npm install -g 不会刷新当前窗口的 PATH。推荐用一键安装（会写入 FlyHub bin 下的 claude 入口）。若仍找不到，Windows 把 %APPDATA%\npm 加入 Path，macOS / Linux 把 $(npm prefix -g)/bin 加入 PATH，或新开终端。

已 setx / export，请求仍打到旧地址：检查 ~/.claude/settings.json 里的 env——它优先于用户级环境变量，请改为第 2.1 节配置或删除后重开终端。

Claude Desktop 桌面版不读 ANTHROPIC_BASE_URL / settings.json，要用 CC Switch 写 3P 配置，参见 Claude 客户端接入页。

API 返回 401 或 invalid_bearer_token：确认 Key 完整、无多余空格、未被删除。若仍失败，请在控制台重新创建 Key 并重试。

模型不可用：先调用 GET /v1/models 获取实时列表，核对模型 ID 拼写。

准备好了？登录控制台 · 充值 · 创建 API Key

获取 API Key 查看定价

接入 FlyHub · Claude Code CLI

推荐安装

手动安装

1. 安装 Claude Code

1.1 安装 Claude Code

2. 配置环境变量

2.1 修改 settings.json

3. 启动并验证

4. 故障排查