Source: https://aiprimetech.io/zh/learn/claude-code-api/

[首页](/zh/) / [学习](/zh/learn/) / Claude Code API 详解 

# 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"
  }
}
```

## 常见问题 

 可以在 Claude Code 中使用自己的 API 密钥吗？

可以。在环境变量或 ~/.claude/settings.json 中设置 ANTHROPIC_API_KEY（或 ANTHROPIC_AUTH_TOKEN），并按需设置 ANTHROPIC_BASE_URL，然后启动 claude。它会向该密钥计费，而非使用订阅。 Claude Code 有自己的 API 吗？

没有——它使用标准的 Anthropic Messages API。任何支持该格式的服务，包括兼容 Anthropic 的网关，都可以为 Claude Code 提供服务。 为什么 Claude Code 忽略了我的订阅，却向我的 API 密钥计费？

如果在 shell 中设置了 ANTHROPIC_API_KEY，它会优先于订阅身份验证。取消设置该变量即可使用 Pro/Max 套餐。 可以将 Claude Code 指向其他端点吗？

可以，通过 ANTHROPIC_BASE_URL 设置。网关、代理和企业路由配置就是通过这种方式与 Claude Code 配合使用，无需修改 Claude Code。  

几分钟内开始使用 Claude

获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) 

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

## 更多 Claude API 指南

[如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/zh/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型对比](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[通过 Claude API 无限制使用 OpenCode](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥：如何获取和配置](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误：速率限制及 400、500、529 错误的解决方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度](/zh/learn/buy-claude-api-credits/)[Claude API 免费试用：哪些确实免费，哪些不免费](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[使用 Claude 运行 Codex CLI](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[将 LangChain 指向网关上的 Claude](/zh/learn/use-claude-api-with-langchain/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)