Claude Code API Key 获取与计费配置指南

了解如何在 Claude Console 获取 Claude Code API Key、哪些情况可直接登录而无需创建密钥，理清 CLI 认证优先级、Max/Team 月度 API Credits 适用范围与计费边界。

UniRoute · 2026年10月23日

查询如何获取 Claude Code API Key 时，首先应确认你的身份认证与费用结算方式。如果你已订阅 Claude Pro、Max、Team 或 Enterprise 套餐，在 Claude Code 内运行 /login 即可直接登录，无需创建静态密钥。当你需要按量计费的直连 API 或运行自动化脚本时，可前往官方 Claude Console API keys 页面创建 Claude API keys（Get your Claude API key，2026-10-23 核验）。在受支持的 CLI 版本中，Console 账户也可通过 /login OAuth 直接登录，无需生成静态密钥（Authentication，2026-10-23 核验）。

声明：本文由提供独立第三方 API 网关服务的 UniRoute 发布，与 Anthropic 无官方隶属、授权或合作关系。如果你使用官方 Claude 订阅或直连 Claude Console Key，无需使用 UniRoute。

凭证路径与计费归属对比

在配置环境变量前，请先确认你的凭证对应哪一个结算账户：

接入路径	生效凭证	费用结算归属	适用场景
1. 官方 Claude 订阅登录	`/login` claude.ai OAuth（或由 `claude setup-token` 生成的 `CLAUDE_CODE_OAUTH_TOKEN`）	计入 Claude Pro、Max、Team 或 Enterprise 套餐用量限额	在现有订阅额度内进行交互式开发
2. 官方 Claude Console API	`ANTHROPIC_API_KEY`（`X-Api-Key`）或 Console OAuth 登录	计入 Claude Console 组织余额或符合条件的关联 API Credits（独立计费说明，2026-10-23）	直连 Anthropic API 按量计费与 CI 自动化
3. 第三方网关（如 UniRoute）	`ANTHROPIC_BASE_URL` + 网关凭证（`ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`）	计入所选网关账户余额（如 UniRoute USD 余额，按实际 Token 用量扣费）	多模型集中路由与独立的 API 预算管理

Max 与 Team 月度 API Credits 的当前适用条件

根据 Anthropic Monthly API credits for Max and Team plans（2026-10-23 核验），符合条件的套餐在 claude.ai 套餐账单（Billing）入口领取月度 API Credits 并关联组织，在 Claude Console 查看额度余额；使用时需注意以下边界：

不覆盖交互式会话： 终端、IDE、桌面端或网页端的交互式 Claude Code 会话，以及套餐限额用尽后的额外用量（Extra usage），均不消耗月度 API Credits。
claude -p 何时可用： 非交互式 claude -p（及 Claude Agent SDK）仅在由你本人使用已关联 Console 组织的 API Key 运行时才适用月度 API Credits；若在订阅登录状态下运行 claude -p，仍消耗订阅套餐限额。
Action、IDE 与桌面端不适用： 由 Claude Code GitHub Action、IDE 扩展或 Claude 桌面端（Desktop）触发的运行均计为 Claude Code 用量，即使带 -p 也不适用月度 API Credits。

如何在官方 Claude Console 获取 API Key

若你需要用于直连 Anthropic 计费的静态密钥，请按官方 Get your Claude API key（2026-10-23 核验）步骤创建：

打开 Console 密钥页： 登录 platform.claude.com/settings/keys（位于开发者 Console，而非 claude.ai 个人设置）。
选择密钥类型： 个人本地开发选 Personal key，共享 CI 流水线或后端自动化选 Service account key。这两类密钥会在关联账户离开组织时自动失效，优于旧式 Workspace key。
创建并限定范围： 点击 Create key，填写名称、有效期、关联账户，并按需限定所属 Workspace。
立即保存完整密钥： 以 sk-ant- 开头的完整密钥仅在创建时展示一次。请立即存入密钥管理工具；一旦丢失无法再次查看，只能新建替代密钥。
如无法点击创建： 说明当前组织账户缺少建 Key 权限。请联系组织管理员开通权限或代建服务账户密钥；若组织允许免 Key 登录，也可在 CLI 中通过 /login 使用 Console 账户直接登录。

CLI 密钥配置与认证优先级条件

在本地终端使用直连 Console API Key 时，可在启动 Claude Code 前导出环境变量：

# Placeholder only. Use only when you want direct Console API billing.
export ANTHROPIC_API_KEY="YOUR_CLAUDE_CONSOLE_API_KEY"
claude

切勿将真实密钥粘贴到聊天窗口、Git 仓库或截图中，也不要把官方 Console Key 发往第三方 ANTHROPIC_BASE_URL。排障时不要将 claude -p 放入自动检查脚本，因为 -p 会直接发起真实模型调用并产生扣费。

虽然早期环境变量说明（2026-05-05）指出在常规本地终端中环境变量密钥优先于订阅，但当前官方 Authentication precedence（2026-10-23 核验）能否生效取决于三项实际条件：

交互首次批准 vs. -p 差异： 在标准 CLI 优先级中，云平台（cloud-provider）开关与 ANTHROPIC_AUTH_TOKEN 排在 ANTHROPIC_API_KEY 之前。交互模式下当轮到 ANTHROPIC_API_KEY 候选时，客户端会提示批准或拒绝一次并记住选择（若此前拒绝，需在 /config 中开启 Use custom API key）。非交互模式（claude -p）仅跳过该交互批准提示，不改变认证优先级——若同时存在更高优先级的云平台开关或 ANTHROPIC_AUTH_TOKEN，仍由更高优先级项生效。
企业 Claude apps gateway 与受管认证策略： 已登录的官方企业 Claude apps gateway 会话（而非普通第三方 Bearer 网关）优先于云平台开关、Bearer Token、API Key 与 /login 会话；组织受管认证策略则依具体策略配置，可以限制或阻止本地环境变量凭证。完整企业策略细则请参阅官方认证优先级文档。
Cloud 与 Desktop 不套用 CLI 环境变量： Cloud 会话始终使用订阅凭证，Claude 桌面端（Desktop）则不会读取终端的 Shell 环境变量（端侧差异详见 Claude Code 终端版 vs 桌面版对比指南）。

安全的 `SET/UNSET` 排查（不打印密钥明文）

请勿执行 echo $ANTHROPIC_API_KEY、env 全量输出或用 sed -i 盲删配置。可使用以下只读脚本检查当前 Shell 进程中的变量状态：

python3 - <<'PY'
import os
names = (
    "ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN", "ANTHROPIC_BASE_URL",
    "CLAUDE_CODE_OAUTH_TOKEN", "ANTHROPIC_PROFILE",
    "CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY",
)
for name in names:
    print(f"{name}: {'SET' if os.environ.get(name) else 'UNSET'}")
PY

该检查仅反映当前 Shell 进程，不验证密钥有效性或计费状态，也无法排查以下配置与会话来源：

~/.claude/settings.json
.claude/settings.local.json
CLAUDE_CONFIG_DIR
受管策略或已保存的 Gateway 会话

请在 Claude Code 内运行 /status 核对当前生效凭证与 Anthropic base URL。如需切回订阅，请先备份 ~/.claude/settings.json ，仅移除你手动添加的覆盖项，重启 claude 后用 /status 确认。

可选方案：通过 UniRoute 网关接入 Claude Code

据官方 Connect Claude Code to an LLM gateway（2026-10-23 核验），接入网关需同时配置 ANTHROPIC_BASE_URL 以及网关指定的 ANTHROPIC_AUTH_TOKEN（Authorization: Bearer）或 ANTHROPIC_API_KEY（x-api-key）。

如果你选择使用第三方网关 UniRoute，可在 ~/.claude/settings.json 中配置根地址 https://api.uniroute.app（不加 /v1 或 /v1/messages）与 ANTHROPIC_AUTH_TOKEN：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.uniroute.app",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_UNIROUTE_API_KEY"
  }
}

UniRoute API Key 与官方 Claude Console Key 属于不同凭证，不可互换。配置前可查看 UniRoute 模型价格、创建 UniRoute API Key，并参考 Claude Code 第三方 API 接入教程、协议与地址说明、套餐与余额说明及 Claude Code API 价格与费用预算指南。仅在准备发起会产生实际费用的真实模型调用前，再去确认账户余额与充值。

常见问题（FAQ）

已有 Claude Pro 或 Max 订阅，还必须申请 API Key 吗？

不需要。直接运行 claude 并通过 /login 登录即可使用订阅额度。

Claude Console 创建的 API Key 丢失后还能再次查看吗？

不能。sk-ant- 完整密钥仅在创建时显示一次，丢失后需在 platform.claude.com/settings/keys 新建替代密钥。

为什么登录订阅后，请求仍然走 API 计费？

在没有已登录的企业 Claude apps gateway 会话、且受管认证策略未阻止本地凭证的常规 CLI 会话中，云平台开关、ANTHROPIC_AUTH_TOKEN 或已批准的 ANTHROPIC_API_KEY（以及跳过批准提示但不改变优先级的 -p 模式下的 ANTHROPIC_API_KEY）排在 /login 订阅登录之前。请运行 /status 查看当前生效凭证。

配置 Key 后遇到 `401` 报错该如何排查？

可能是因为密钥无效或已撤销、发往了不匹配的 ANTHROPIC_BASE_URL，或放错了请求头变量（ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 混用）。

为什么只执行 `unset ANTHROPIC_API_KEY` 没有切回订阅？

当前会话可能仍受 ANTHROPIC_AUTH_TOKEN、apiKeyHelper、ANTHROPIC_PROFILE 或 ~/.claude/settings.json 中的 env 字段覆盖。请用 /status 定位来源并仅清理你添加的覆盖项。

Max 与 Team 套餐的月度 API Credits 能用于 Claude Code 吗？

不覆盖交互式 Claude Code 会话或套餐超额后的额外用量；仅在由你本人使用已关联 Console 组织的 API Key 运行 claude -p 或 Claude Agent SDK 时可用（订阅登录、GitHub Action、IDE 扩展或桌面端触发的运行均不适用）。