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

[首页](/zh/) / [学习](/zh/learn/) / Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时改用 claude setup-token 

# Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token 

Claude Code 需要 API 密钥才能运行。无论您是首次配置 Claude Code，还是从直接使用 Anthropic 账户迁移到固定费率网关，都需要生成密钥、配置两个环境变量并验证连接。 

## Claude Code API 密钥：简要说明 

Claude Code API 密钥是一个普通的 Anthropic 格式密钥（sk-...），Claude Code 会从以下位置读取它： ANTHROPIC_API_KEY。您可以在 Claude 控制台中获取密钥（设置 → API 密钥，仅显示一次），也可以在本网关的控制面板中获取（随时可查看）。通过 export 设置后，Claude Code 即可启动，无需在浏览器中登录。使用网关密钥时，还需将 ANTHROPIC_BASE_URL 设为网关主机地址。这就是全部配置；本页其余部分将详细介绍 API 密钥、通过以下命令获取的 OAuth 令牌 /login 与 claude.ai 会话密钥之间的区别、各操作系统的配置步骤，以及常见错误。 

## 什么是 Claude Code API 密钥 

Claude Code API 密钥是一种身份验证凭据，让 Claude Code CLI 能够向 Claude 模型提供商发送请求。没有它，您在 Claude Code 中运行的每条命令都会返回身份验证错误。该密钥是一个存储在环境变量中的字符串，可使用 ANTHROPIC_API_KEY（通过 x-api-key 请求头发送）或 ANTHROPIC_AUTH_TOKEN（作为 Bearer 令牌发送）。两者都适用于 AI Prime Tech。 

当您使用 AI Prime Tech 这样的网关，而非直接使用 Anthropic 时，密钥来自网关控制面板，而不是 Anthropic 控制台。密钥格式可能不同，但在 Claude Code 中的配置流程完全相同：在环境中设置密钥，将基础 URL 指向网关，Claude Code 会处理其余部分。您的密钥关联的是网关账户余额或订阅，而不是 Anthropic 账单。 

同一个密钥可以同时用于多台机器和多个 Claude Code 会话。不过，如果团队共用一个密钥，所有用量都会计入同一账户的速率限制和余额。为团队配置时，请在控制面板中为每位开发者生成单独的密钥，以便按个人正确跟踪用量并实施速率限制。 

## API 密钥与 OAuth 令牌的区别，以及什么是“会话密钥” 

Claude Code 接受两种凭据。API 密钥（ANTHROPIC_API_KEY，或作为 Bearer 令牌发送的 ANTHROPIC_AUTH_TOKEN）按 token 从 API 余额中计费，这是使用网关时采用的凭据。OAuth 令牌来自 Claude Pro 或 Max 订阅： /login 在 Claude Code 中执行可登录账户，而 claude setup-token 会生成一个长期有效的令牌，您可以将其用于 CI 或无界面机器，使其使用订阅额度，而不是 API 余额。 

“Claude 会话密钥”不属于上述任何一种：它是来自 claude.ai 的浏览器会话 Cookie，一些非官方客户端会提取它来操作聊天界面。它不是 API 凭据，使用它违反面向消费者的服务条款，而且它会过期，还可能导致账户被停用。如果您需要通过程序访问，请使用 API 密钥，可从 Anthropic 控制台或类似本网关的服务获取。 

## 步骤 1 — 获取密钥：Claude 控制台或网关控制面板 

有两个地方可以生成 Claude Code 接受的密钥。在 Claude 控制台（位于 platform.claude.com 的 Claude 平台）中，打开“设置 → API 密钥”，点击“创建密钥”，为其命名并复制密钥值。控制台只会显示一次完整密钥，此后仅列出名称和前缀，因此在这里管理密钥意味着创建新密钥，而不是找回旧密钥。 

Claude Code 需要的是普通密钥；管理员 API 密钥是用于管理组织的另一种凭据，无法用于请求身份验证。然后执行 export ANTHROPIC_API_KEY=sk-ant-... 在您的 shell 中完成设置，Claude Code 即可使用该密钥，无需执行 /login。Anthropic 按 token 计费，且需要先在账户中添加付款方式。 

更快捷的方式是使用网关密钥：在 aiprimetech.io 注册，打开控制面板中的“API 密钥”，点击“创建”。密钥随时可在控制面板中查看，您可以随时重新复制、重命名或撤销。它采用相同的 sk- 格式，并使用同一个变量；唯一额外的步骤是设置 ANTHROPIC_BASE_URL，详见步骤 2。 

此时您已有密钥，但还没有余额。测试前请先小额充值，模型页面会显示每个模型一美元可购买的用量；如果您已经确定会全天使用 Claude Code，也可以在 /plans/ 页面选择无限量套餐。 

## 步骤 2 — 设置环境变量 

Claude Code 通过两个环境变量读取网关配置：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。将 ANTHROPIC_BASE_URL 设为网关的根主机地址，不要添加任何路径后缀。Anthropic SDK 会自动追加 /v1/messages；如果基础 URL 中包含 /v1，请求就会访问 /v1/v1/messages，并返回 404 错误。 

在 Linux 或 macOS 上，将以下内容添加到您的 shell 配置文件（~/.bashrc、~/.zshrc 或 ~/.profile）：export ANTHROPIC_BASE_URL="https://aiprimetech.io" 和 export ANTHROPIC_API_KEY="在此填入您的密钥"。在 Windows 上，通过“设置 > 系统 > 高级系统设置 > 环境变量”将它们设为系统环境变量，或将其添加到 PowerShell 的 $PROFILE 中。 

如需按项目配置，请在项目根目录中创建 .env 文件，并设置相同的变量。Claude Code 会加载工作目录中的 .env 文件，其中的设置优先于系统级变量。如果不同项目使用不同的 API 提供商，这种方式很实用。请务必将 .env 添加到 .gitignore，避免意外将密钥提交到版本控制系统。 

## 步骤 3 — 验证连接 

设置环境变量后，打开一个新的终端会话（以加载变量），然后运行 Claude Code。输入一条简单消息，例如“你好，请确认你能回复。”如果收到 Claude 的回复，就说明整个配置已正常工作：密钥有效、基础 URL 正确，且网关已成功将您的请求路由到 Claude。 

如果验证失败，错误消息会说明问题所在。401 或 403 错误表示 API 密钥无效或已过期，请从控制面板重新复制。404 错误几乎总是意味着基础 URL 有误，请检查是否意外添加了 /v1 后缀或末尾斜杠。连接被拒绝错误表示无法访问网关，请检查网络、VPN 或防火墙设置。 

您也可以使用 curl 请求网关的状态端点，以编程方式验证：curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models。如果密钥有效，该请求会返回可用模型列表。如果此方法有效，但 Claude Code 无法使用，则问题出在环境变量的加载上，而不是密钥或网关本身。 

## 步骤 4 — 配置模型偏好 

默认情况下，Claude Code 会为每个层级（Sonnet、Opus、Haiku）使用内置的模型选择。您可以通过额外的环境变量覆盖这些设置：ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_DEFAULT_FABLE_MODEL。请将它们设为网关支持的准确模型标识符。 

对于大多数开发者，设置 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 和 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6 就已足够。Claude Code 在大多数交互中默认使用 Sonnet；当您通过 /model 命令选择 Opus，或计划模式升级为更强的模型时，则会使用 Opus。网关支持当前所有 Claude 模型版本。 

设置 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 可启用网关模型发现功能。这会让 Claude Code 向网关查询可用模型，而不是使用硬编码列表。同时设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，以防止遥测请求发送到网关；这样可以减少无关请求，并略微降低请求延迟。 

## 常见身份验证错误排查 

最常见的问题是环境变量未加载。在配置文件中设置变量后，必须打开新的终端，因为现有终端仍使用旧环境。在 Windows 上，您可能需要完全重启终端应用，而不只是打开新标签页。可使用 echo $ANTHROPIC_BASE_URL（bash/zsh）或 echo $env:ANTHROPIC_BASE_URL（PowerShell）进行验证。 

如果连接有效，却仍出现“找不到模型”错误，说明模型标识符与网关提供的模型不匹配。模型 ID 区分大小写，并且与具体版本对应。请在控制面板或 /v1/models 端点中查看支持的准确标识符。常见错误包括使用“claude-3-opus”而不是“claude-opus-4-6”，或在环境变量值中添加了多余的空白字符。 

请检查控制台余额。要继续使用而不中断，请充值按量付费余额，或升级到无限量套餐——1 天（$9）或 1 周（$39），以固定费用访问所有模型，无需按 token 计费。 

复制

```
# Add to ~/.bashrc or ~/.zshrc:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verify connection:
# $ source ~/.bashrc && claude
# Or test the gateway directly:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models
```

## 常见问题 

 ANTHROPIC_API_KEY——如何获取？

你可以在 Claude Console 中创建密钥（设置 → API 密钥 → 创建密钥；密钥内容仅可复制一次），也可以在此处的网关控制台中创建，密钥会持续可见。将其导出为 ANTHROPIC_API_KEY；如果使用网关密钥，还需设置 ANTHROPIC_BASE_URL。 Claude Code 和其他工具需要分别使用不同的密钥吗？

不需要。同一个 API 密钥可用于 Claude Code、Cursor、Cline、Aider，以及任何使用 Anthropic Messages API 或 OpenAI 兼容端点的工具。一个密钥即可用于多个工具。 Claude 会话密钥与 API 密钥相同吗？

不同。会话密钥是非官方客户端使用的 claude.ai 浏览器 cookie；API 密钥则是 API 和 Claude Code 所需的凭证。只有 API 密钥受支持、可用于计费且稳定可靠。 如何获取 ANTHROPIC_API_KEY？

可以从 Anthropic 控制台获取（按标价向你的 Anthropic 账户计费），也可以从本网关的控制台获取（从低于面值购入的额度中扣费，或使用无限量套餐）。两者都填入 ANTHROPIC_API_KEY 环境变量。 什么是 claude setup-token 有什么作用？

它会为 Claude 订阅创建一个长期有效的 OAuth 令牌，让 Claude Code 无需交互式登录即可在 CI 或无界面环境中运行。它消耗订阅用量，而非 API 额度；使用网关时，则使用 API 密钥。 ANTHROPIC_BASE_URL 应包含 /v1 吗？

不应包含。只需将其设为根主机地址：https://aiprimetech.io——Anthropic SDK 会自动追加 /v1/messages。包含 /v1 会导致路径重复，并返回 404 错误。 可以在多台机器上使用同一个密钥吗？

可以。一个密钥可同时用于你的所有设备。所有用量都计入同一账户的余额和速率限制。团队使用时，请为每位开发者生成独立密钥，以便分别跟踪用量。  

几分钟内开始使用 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](/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 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/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-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/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 Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)