让 Claude Code 用聚合站而不是 Anthropic 认证：环境变量与登录态怎么配

为什么要切换认证路径

Claude Code 默认使用 Anthropic 的官方 API 端点，并依赖登录态（OAuth）或 API 密钥进行认证。如果你希望经由 LLM API 聚合站调用 Claude 以及其他模型（如 GPT、DeepSeek 等），就需要改变 Claude Code 的请求目标，让它将请求发送到聚合站的端点，并使用聚合站颁发的 API key。这样做的好处是：一个 key 可以访问多个模型，计费统一，且聚合站通常支持 USDC 充值、无 KYC 等特性。

核心环境变量

Claude Code 支持通过环境变量覆盖默认的 API 端点与认证方式。关键变量如下：

• ANTHROPICBASEURL：设置聚合站的 API 基础 URL（例如 https://api.example.com 或具体的兼容路径）。Claude Code 会将请求发送到这个地址，而不是 Anthropic 官方地址。
• ANTHROPICAPIKEY：填入聚合站生成的 API key。这个 key 用于认证，聚合站会根据它来扣费（用户按官方价 ×1.3 扣费）和路由模型。

注意：不同聚合站的 URL 路径可能略有差异，请参考其文档确认是否需要添加 /v1 等后缀。通常，如果聚合站兼容 Anthropic API 格式，设置这两个变量即可。

设置环境变量的方法

根据你的操作系统和终端，选择一种方式：

临时设置（仅当前会话）

在终端中直接导出变量：

export ANTHROPIC_BASE_URL="https://api.example.com"
export ANTHROPIC_API_KEY="sk-你的聚合站key"

然后运行 Claude Code 命令。关闭终端后失效。

永久设置（写入 shell 配置文件）

将上述 export 语句添加到 ~/.bashrc、~/.zshrc 或 ~/.config/fish/config.fish 中，然后重启终端或执行 source 使其生效。

通过 .env 文件（如果 Claude Code 支持）

部分版本支持在项目目录或用户目录下的 .env 文件中定义变量。请查阅 Claude Code 文档确认是否支持以及加载顺序。

清理旧登录态

Claude Code 可能会缓存 Anthropic 的 OAuth 令牌或旧配置，导致即使设置了环境变量，仍尝试使用旧凭证。建议清理以下位置：

• 凭据文件：检查 ~/.claude/ 或 ~/.config/claude/ 目录，删除 credentials.json、auth.json 等文件（具体名称以实际为准）。
• 环境变量冲突：确保没有其他变量（如 ANTHROPICAUTHTOKEN）干扰。如果之前设置过，请取消或覆盖。
• 登出命令：如果 Claude Code 提供 logout 子命令，先执行登出。

清理后，重新启动终端，让新的环境变量生效。

验证切换是否成功

运行一个简单的 Claude Code 命令（如 claude "你好"），观察输出。如果请求成功，说明认证已切换。你也可以查看聚合站的控制台，确认请求到达并有扣费记录（用户按官方价 ×1.3 扣费）。如果报错，检查：

• 环境变量是否拼写正确；
• API key 是否有余额；
• 聚合站端点是否兼容 Anthropic API 格式。

注意事项

• 贡献 key 给聚合站可获得 USDC 返利（按官方价 ×1.1，优质 key ×1.2），但这与本文的消费端配置无关。
• 不要将 API key 提交到版本控制系统，建议使用环境变量或密钥管理工具。
• 如果聚合站同时支持 OpenAI 格式，Claude Code 可能仍需使用 Anthropic 兼容端点，请以聚合站文档为准。

通过以上步骤，你可以让 Claude Code 经由聚合站认证，从而用一个 key 调用多个模型，并享受统一的计费方式。