Source: https://aiprimetech.io/zh/docs/guides/claude-code/

[首页](/zh/) / [文档](/zh/docs/) / Claude Code 

# Claude Code 

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

 复制页面 [ 以 Markdown 查看](/zh/docs/guides/claude-code.md) [ 向 ChatGPT 提问](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ 在 Claude 中提问](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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

## 设置 

```
Copyexport 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，请使用设置文件： 

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

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

## 验证配置是否生效 

```
Copy"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 陷阱。 

## 选择模型 

```
Copyclaude --model claude-opus-4-8
```

任意 ID，来自 [模型](/zh/docs/getting-started/models/) 可用。复杂重构使用 Opus，日常工作使用 Sonnet — 请参阅 [费用控制](/zh/docs/guides/cost-control/) 了解为何这一选择对账单起决定性作用。 

## 合理控制成本 
- Claude Code 每轮都会重新发送文件内容和工具结果 — 长会话的成本会呈非线性增长。使用 /clear 在互不相关的任务之间执行。
- 大型工具输出（包含 500 行的查询结果、完整的构建日志）会成为持续保留的上下文。通过管道传给 head ，只要条件允许。
- 提示词缓存在这里最有帮助，因为系统提示词和工具定义在各轮之间保持稳定。 

[MCP 服务器为 Claude Code 配备真正的工具](/zh/docs/guides/mcp-servers/)[费用控制智能体的 token 用在哪里](/zh/docs/guides/cost-control/)[故障排查没有任何反应时](/zh/docs/guides/troubleshooting/) 

[上一页视觉与图像输入](/zh/docs/api-reference/vision/)[下一页Cursor](/zh/docs/guides/cursor/)