Claude Code 配置

将 Claude Code CLI 指向启元Hub，统一计费并访问多模型能力。

准备工作

若你曾登录过 Anthropic 官方账号，建议先执行 claude /logout 清除 OAuth 缓存，避免与网关配置冲突。

已完成 Node.js 环境安装（见 Node.js 环境安装）
已在启元Hub 控制台创建 API Key（格式：sk-opc-...）
账户状态为 active（待审核用户暂不可调用）

安装 Claude Code

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

# 验证安装
claude --version

配置环境变量

将 Claude Code 的 API 端点指向启元Hub：

必须将 ANTHROPIC_API_KEY 设为空字符串。Claude Code 会优先读取该变量，若存在有效值可能绕过网关配置。

1. 临时配置（当前终端会话）

export ANTHROPIC_BASE_URL="https://api.qiyuanapi.cc/v1"
export ANTHROPIC_AUTH_TOKEN="sk-opc-your-api-key"
export ANTHROPIC_API_KEY=""

2. 永久配置（写入 shell 配置）

echo 'export ANTHROPIC_BASE_URL="https://api.qiyuanapi.cc/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-opc-your-api-key"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=""' >> ~/.zshrc
source ~/.zshrc

3. 项目级配置（.claude/settings.local.json）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.qiyuanapi.cc/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-opc-your-api-key",
    "ANTHROPIC_API_KEY": ""
  }
}

启动并验证

1. 启动 Claude Code

claude

2. 检查连接状态

在 Claude Code 内输入 /status，确认 Base URL 指向启元Hub。

模型选择建议

deepseek-v4：复杂推理、长上下文任务
qwen3.6：日常编码、对话与 Agent 工作流
具体模型名以控制台「模型 & 定价」页为准