Claude Code 接入

在启动 Claude Code 前设置牛API根地址和专用 Token。按兼容模式从并发 1 和短消息起步，基础连接成功后再开启工具调用与长任务。

官方文档：Claude Code ↗

推荐协议Anthropic Messages

Base URLhttps://api.reniuniu.win

认证方式Bearer Token 环境变量

建议并发1

接入方式兼容模式

测试顺序短消息 → 工具 → 长任务

安装

官方推荐使用原生安装器：

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

macOS / Linux

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

安装要求和替代方法请查看 Claude Code 官方安装文档。

先准备两项

1. 在牛API控制台创建 Claude Code 专用 Key；
2. 复制准备使用的真实模型 ID，并确认 Key 分组有权限。

临时配置环境变量

牛API采用 Bearer 认证示例，因此使用 ANTHROPIC_AUTH_TOKEN。ANTHROPIC_BASE_URL 使用网关根地址，不添加 /v1，Claude Code 会请求 /v1/messages。

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.reniuniu.win"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
claude

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.reniuniu.win"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude

环境变量只对当前终端及从中启动的进程有效。修改后重启终端，并从该终端启动 Claude Code。IDE 从桌面图标启动时可能看不到终端变量。

兼容模式

官方文档确认 ANTHROPIC_AUTH_TOKEN 映射到 Authorization: Bearer。首次接入只测试短消息；成功后再分别测试流式、单个低风险工具和长连接，不要直接运行生产仓库任务。

持久化配置

官方支持把变量放入用户级 ~/.claude/settings.json，Windows 对应 %USERPROFILE%\.claude\settings.json。直接写入 Token 会形成明文敏感配置，首次接入优先使用终端环境变量；长期使用时应采用操作系统凭据管理或团队密钥管理方案。

不要把凭据写进项目的 .claude/settings.json。如使用 .claude/settings.local.json，先确保它被 Git 忽略；团队环境应由管理员统一分发和轮换凭据。

验证连接

1. 在已设置变量的终端运行 claude；
2. 输入 请只回复：牛API连接正常；
3. 运行 /status；
4. 确认状态中显示牛API Base URL，以及 ANTHROPIC_AUTH_TOKEN 为凭据来源；
5. 回到牛API控制台核对用量记录。

不要直接复制官方文档里的示例模型进行牛API测试。模型 ID 必须从牛API控制台获取。

登录与网关凭据冲突

官方文档说明，网关凭据变量会优先于已保存的 claude.ai 登录。ANTHROPIC_BASE_URL 单独存在并不能替代登录凭据。出现反复登录或认证冲突时：

1. 运行 /status 检查当前 Base URL 和凭据来源；
2. 确认只设置一种网关凭据变量；
3. 若要仅使用网关，可按官方说明运行 /logout 清除已保存登录；
4. 若要恢复官方登录，取消设置网关凭据和 Base URL，再重启终端。

工具调用与长连接

Claude Code 会频繁调用工具并维持流式长连接，这比单轮聊天更容易暴露协议字段、上下文长度、代理超时和连接中断问题。首次测试应使用短请求、并发 1，再逐步测试工具调用和长任务；任一步失败都退回上一步排查。

常见问题

• 401：检查是否误用了 ANTHROPIC_API_KEY；Bearer 网关应使用 ANTHROPIC_AUTH_TOKEN。
• 400：可能是 Messages 请求字段或模型不兼容，记录错误正文但删除敏感内容。
• 429：停止并行 Agent，降低请求频率后重试。
• 流式中断：用短消息复现，记录时间、请求 ID、客户端版本和网络环境。
• 修改不生效：完全退出 Claude Code，重启终端后再启动。