首页 / 文档 / Claude Code

Claude Code

通过两个环境变量将 Anthropic 的 CLI 智能体连接到网关——并避开那个会在不知不觉中向错误密钥计费的陷阱。

Claude Code 从环境变量读取端点,因此无需修改程序。这是网关上最常见的配置方式。

设置

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

以上就是完整的集成步骤。将这两行添加到 ~/.zshrc 或 ~/.bashrc 即可使其永久生效。

陷阱: 如果 ANTHROPIC_API_KEY 已在 shell 中设置,Claude Code 可能会优先使用它,并通过该密钥计费,悄然忽略你的网关密钥以及任何 Pro/Max 订阅。运行 echo $ANTHROPIC_API_KEY — 如果有任何输出, unset ANTHROPIC_API_KEY 然后再启动。

按项目配置

要让网关配置仅作用于一个代码仓库,而不是整个 shell,请使用设置文件:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

将其放在项目中的 .claude/settings.json ,或放在 ~/.claude/settings.json 以作为用户级默认配置。添加 .claude/settings.json 变为 .gitignore — 其中包含密钥。

验证配置是否生效

"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

如果请求没有出现在控制面板中,说明它们被发送到了别处 — 几乎总是因为上述 ANTHROPIC_API_KEY 陷阱。

选择模型

claude --model claude-opus-4-8

任意 ID,来自 模型 可用。复杂重构使用 Opus,日常工作使用 Sonnet — 请参阅 费用控制 了解为何这一选择对账单起决定性作用。

合理控制成本