Claude Code 配置

将 Claude Code CLI 指向 QiyuanHub，统一计费并访问自营 deepseek-v4.1。

准备工作

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

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

安装 Claude Code

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

# 验证安装
claude --version

配置环境变量

将 Claude Code 的 API 端点指向 QiyuanHub：

必须将 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）

也可在用户目录下的 `.claude` 文件夹中写入 settings（与环境变量二选一或组合使用）。

Claude Code 用户目录 .claude 结构 — 常见位置：用户主目录下的 `.claude`，内含 settings.json / config.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 Code 启动后欢迎界面 — 启动成功后可看到欢迎界面；发送「你好」验证网关是否返回回复。

claude

2. 检查连接状态

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

模型选择建议

deepseek-v4.1：编码、Agent、长上下文（1,048,576 token）与图片理解，默认开思考
想省时省钱的步骤可在客户端把思考关掉或降档，见「思考强度设置」
具体模型名以控制台「模型 & 定价」页为准；老名字 deepseek-v4 / qwen3.8-flash 已下线

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