推荐安装
先安装 FlyHub CLI,再用它写入配置文件与环境变量(Anthropic / Claude Code 环境变量)。将 Key 换成控制台里的密钥即可。
# 安装 FlyHub CLI
curl -fsSL https://flyhub.cn/install.sh | bash
export PATH="$HOME/.flyhub/bin:$PATH"
# 一键配置(将 Key 替换为控制台密钥)
flyhub setup claude-code --key <FLYHUB_API_KEY>若已安装过 CLI,可只执行 flyhub setup claude-code --key <FLYHUB_API_KEY>。已设置 FLYHUB_API_KEY 时可省略 --key。更多工具:flyhub setup list
手动安装
1. 安装 Claude Code
Claude 模型请使用 Anthropic 原生协议。Claude Code 使用 ANTHROPIC_AUTH_TOKEN,不要用 OpenAI 兼容端点。
若已安装 Claude Code,可跳过本节,直接进入环境变量配置。
1.1 安装 Node.js 与 Claude Code
请先安装 Node.js 18 或更高版本。Windows 用户建议同时安装 Git for Windows。
在终端中运行:
npm install -g @anthropic-ai/claude-code验证安装:
claude --version若输出版本号(如 x.x.xxx (Claude Code)),说明安装成功。
2. 配置环境变量
将 <FLYHUB_API_KEY> 替换为 FlyHub 控制台创建的 API Key,然后执行对应平台的命令:
macOS / Linux:
SHELL_RC="$HOME/.zshrc"; case "$SHELL" in *bash*) SHELL_RC="$HOME/.bashrc";; esac
cat >> "$SHELL_RC" <<'EOF'
export ANTHROPIC_BASE_URL=https://api.flyhub.cn
export ANTHROPIC_AUTH_TOKEN="<FLYHUB_API_KEY>"
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
export CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5
export CLAUDE_CODE_EFFORT_LEVEL=high
EOF
source "$SHELL_RC"Windows(PowerShell,写入用户级环境变量):
setx ANTHROPIC_BASE_URL "https://api.flyhub.cn"
setx ANTHROPIC_AUTH_TOKEN "<FLYHUB_API_KEY>"
setx ANTHROPIC_MODEL "claude-sonnet-5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-4-5"
setx CLAUDE_CODE_SUBAGENT_MODEL "claude-sonnet-5"
setx CLAUDE_CODE_EFFORT_LEVEL "high"Windows 执行 setx 后需重新打开终端;模型 ID 请以 GET /v1/models 返回为准。
3. 启动 Claude Code
配置完成后,在新终端中运行:
claude4. 故障排查
API 返回 401 或 invalid_bearer_token:确认 Key 完整、无多余空格、未被删除。若仍失败,请在控制台重新创建 Key 并重试。
模型不可用:先调用 GET /v1/models 获取实时列表,核对模型 ID 拼写。
准备好了?登录控制台 · 充值 · 创建 API Key