Claude Code API 详解

Claude Code 是一个终端智能体，但在底层，每个操作都会调用同一个你也可以直接使用的 Anthropic Messages API。这带来了一个实用的结果：你可以控制它连接哪个端点、向哪个密钥计费，进而控制一次会话的成本。本页介绍这些组成部分，并提供详细设置指南的链接。

“Claude Code API”的实际含义

并不存在名为 Claude Code API 的独立产品。Claude Code 通过 Claude 订阅（Pro/Max）或 API 密钥进行身份验证；在 API 模式下，它会向环境配置所指向的端点发送标准 Messages API 请求，其中包含系统提示词、对话、工具定义和工具结果。

该端点可以配置。两个环境变量控制着整个过程：ANTHROPIC_BASE_URL（请求发送到哪里），以及 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY（由哪个账户付费）。将它们直接指向 Anthropic，或指向兼容 Anthropic 的网关，Claude Code 的行为都完全相同。

在 Claude Code 中使用自己的 API 密钥

在 shell 配置文件或 ~/.claude/settings.json 中设置这两个变量，然后照常启动 claude。包含 settings.json 示例的完整操作说明，请参阅我们的 <a href="/zh/learn/claude-code-api-key-setup/">Claude Code API 密钥设置指南</a>。

有一点需要注意：如果在 shell 中设置了 ANTHROPIC_API_KEY，即使你同时拥有订阅，Claude Code 仍会按 API 费率计费——环境变量优先。如果你打算使用 Pro/Max 套餐，请取消设置该变量。

一次 Claude Code 会话的成本

智能体会话会消耗大量 token：每次文件读取、工具结果和差异内容都会进入上下文。专注工作一小时可能消耗数百万输入 token，因此提示词缓存非常重要——在支持缓存的端点上，重复上下文会从缓存中重新读取，费用仅为原价的一小部分。

我们在 <a href="/zh/learn/claude-code-api-costs/">Claude Code API 成本指南</a>中详细分析了实际的单次会话用量、缓存行为，以及如何控制长时间会话的成本。

直接使用 Anthropic 与使用网关的对比

直接访问 Anthropic API 可获得按用量计费和官方支持，是预算稳定的团队适合采用的默认选择。AI Prime Tech 等独立网关（与 Anthropic 无隶属关系，也未获其背书）以固定费率或折扣费率转售访问服务，并提供相同的传输格式，因此只需更改基础 URL 和密钥，Claude Code 即可使用。

无论选择哪种方式，都应验证流式传输能否端到端正常工作，并确认所需模型可通过 Claude Code 请求的确切 ID 使用——完整检查清单请参阅<a href="/zh/learn/use-claude-api-with-claude-code/">在 Claude Code 中使用 Claude API</a>。

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。