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

常见问题

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