接入 Claude Code

将 Anthropic Claude Code CLI 接入 PilotAIHub，统一治理 Key 与成本。

简介

Claude Code 是 Anthropic 官方的终端编程 Agent，支持通过环境变量覆盖 API 端点。将 ANTHROPIC_BASE_URL 指向 PilotAIHub 网关，即可在 Claude Code 中调用 PilotAIHub 托管的 Anthropic 系列模型，并通过虚拟 Key 进行治理。

前置条件

已注册 PilotAIHub 账号并创建虚拟 Key；已安装 Node.js 18+。

安装 Claude Code

全局安装

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

安装后在终端运行 claude 启动。

配置 base_url

将 Claude Code 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

通过环境变量配置（见下方）。Claude Code 读取 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，启动前 export 即可生效；也可写入 ~/.zshrc 或 ~/.bashrc 持久化。

环境变量 ANTHROPIC_BASE_URL

ANTHROPIC_BASE_URL=https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 Claude Code 的 API Key / Secret 字段：

环境变量 ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN=sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。Claude Code 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 Claude Code 的模型选择处填写 PilotAIHub 支持的 model_code，例如 claude-sonnet-4-5。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证

curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

一次性运行

若不想全局配置，可在单次命令前临时设置环境变量：

临时配置启动

ANTHROPIC_BASE_URL=https://api.PilotAIHub.com/v1 \
ANTHROPIC_AUTH_TOKEN=pk-xxxxxxxxxxxxxxxx \
claude

进阶用法

建议在项目级 .env 中配置 Key，配合 direnv 自动加载。
不同项目可使用不同 PilotAIHub Key，便于按项目核算成本。
启用流式响应时，PilotAIHub 网关不缓冲 SSE，体验与直连一致。

常见问题

认证方式

Claude Code 默认使用 OAuth 登录。接入 PilotAIHub 时需改用 API Key 方式，即设置 ANTHROPIC_AUTH_TOKEN，而非 ANTHROPIC_API_KEY（后者会被 OAuth 流程覆盖）。

排查

401 → 确认使用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY
403 → 模型不在 Key 的 model_scope 内，在控制台编辑 Key 模型范围
429 → 并发或 RPM 超限，调低 Claude Code 并发或提升 Key 限额