Claude API Key 怎么获取？官方申请与国内替代方案

结论先行

• 在哪申请：登录 Claude Console（platform.claude.com，旧地址 console.anthropic.com 现在 301 跳转到这里），在 Settings → API keys 创建。Key 以 sk-ant- 开头，只在创建时显示一次。API 按预付费额度计费，新用户有少量免费测试额度，之后在 Billing 页面购买。
• 订阅不等于 API：claude.ai 的 Pro 订阅不含 API 额度；Max 和 Team 订阅每月附带一笔 API 额度，要把一个 Console 组织关联到订阅才能领取。Claude Code 既能用订阅登录，也能用 API Key。
• 国内限制：Anthropic 的支持地区列表里没有中国大陆，香港、澳门也不在列；通过云平台和授权经销商提供的 Claude 同样受这份列表约束。第三方中转的风险与价格见替代方案一节。

官方申请 Claude API Key 的步骤

API Key 只在 Claude Console 里创建，claude.ai 聊天界面没有这个入口。按 Anthropic 文档，流程是：

1. 登录 Console。打开 Claude Console（platform.claude.com），登录或注册账号。旧的 console.anthropic.com 会 301 跳转到 platform.claude.com，旧书签照常可用。
2. 购买额度。新用户会获得少量免费额度用于测试。之后由 Admin 或 Billing 角色在 Settings → Billing 点 Buy credits，输入金额后确认，额度立即可用。API 和 Playground 都从预付费额度扣费，用完即停；可以开启 auto-reload，余额低于阈值时自动补充。
3. 创建 Key。进入 Console 的 API keys 页面，点 Create key：填名称，选过期时间，Linked account 选自己（个人 Key）或某个服务账号（服务账号 Key），需要时限定到某个 Workspace。如果 Create key 按钮是灰的，多半是你的角色不允许创建 Key，请组织管理员调整角色，或为你的任务创建服务账号 Key。
4. 立即保存。完整 Key 以 sk-ant- 开头，只在创建时显示一次。关掉后 Console 不会再显示，丢了只能新建。
5. 写入环境变量并验证。官方 SDK 会自动读取 ANTHROPIC_API_KEY。

macOS / Linux（bash、zsh）：

# 官方 Key 只放在本机终端或服务端
export ANTHROPIC_API_KEY="sk-ant-..."

# 列出可用模型：返回 200 和 data 数组即说明 Key 可用
curl https://api.anthropic.com/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

Windows PowerShell：

$env:ANTHROPIC_API_KEY = "sk-ant-..."

Invoke-RestMethod -Uri "https://api.anthropic.com/v1/models" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_API_KEY"; "anthropic-version" = "2023-06-01" }

用模型列表接口验证，不需要先确定模型 ID。Anthropic 认证文档把 Authorization: Bearer <key> 列为直接 HTTP 请求的主要写法，示例按此书写；x-api-key 作为旧写法仍然支持，把那一行换成 -H "x-api-key: $ANTHROPIC_API_KEY" 也能用。anthropic-version 必须带上。

其他状态码的含义和处理见 AI API 错误码速查手册。Key 验证通过后，如果还要确认流式响应以 message_stop 结束、stop_reason（包括 tool_use）处理正确，按 Claude 流式输出与 message_stop 检查步骤逐项核对。

Key 类型、Workspace 与支出上限

创建 Key 时要选类型。类型决定 Key 代表谁、在哪儿能用、什么时候失效：

过期时间在创建时选：预设 3 小时、1 天、7 天、30 天，也可以自定义或选 Never，创建后不能修改。Key 过期后请求返回 401 authentication_error，只能新建。

Workspace 用来按环境或用途隔离 Key 和费用。限定到单个 Workspace 的 Key 不用额外传参；可用于多个 Workspace 的 Key，每次请求都要带 anthropic-workspace-id。

支出上限：Start、Build、Scale 三个用量等级的月度上限分别是 500、1,000、200,000 美元，新组织可能先处在限额更低的 Evaluation 等级。你可以在 Settings → Billing 给组织设一个更低的上限，也可以给单个 Workspace 单独设（默认 Workspace 除外）。达到自己设的上限时返回 400；达到等级上限时返回 429，且不带 retry-after，重试也没用。

国内用户常见难点：地区与支付

支持地区

Anthropic 公布的支持国家和地区列表同时适用于 claude.ai、Claude Code、API 和开发者平台，也适用于通过云平台和授权经销商提供的 Claude 模型。列表里没有中国大陆，香港、澳门也不在列；页面写明未列出的地区即不支持。开发者文档里的 API 支持地区页面同样没有中国大陆。

这项政策不只看网络位置。按官方页面，下面三类都不允许使用：

• 身处未支持地区的个人，包括受支持地区企业派驻在当地的员工和用户；
• 在未支持地区注册或总部设在那里的实体，其员工和用户即使身在受支持地区也包括在内；
• 被未支持地区的个人或实体直接或间接多数控股、控制的实体，同样不论员工身在何处。Anthropic 在 2025 年 9 月 4 日发文，把限制扩展到被这类地区总部企业持股超过 50% 的实体。

判断依据是人在哪里、实体归属哪里，换支付方式或换网络出口并不改变这一点。动手前请读完 Anthropic 使用政策和上面的地区政策。

支付方式

Console 采用预付费：按已购额度扣费，额度用完 API 即停。帮助中心描述的 Console 付款方式更新流程是填写新的银行卡信息；claude.ai 网页端订阅只接受信用卡或借记卡，App 内订阅由 App Store 或 Google Play 处理。额度购买后不予退款，一年后过期且不能延期。

已有 AWS、Google Cloud 或 Microsoft Azure 账号的团队，也可以通过 Amazon Bedrock、Google Cloud、Microsoft Foundry 等云平台使用 Claude，费用并入云账单。这些渠道同样受支持地区列表约束，各平台可用的功能也不完全一样。

Claude Code 用 API Key 还是订阅登录

两种都行。首次运行 claude 会打开浏览器登录；如果环境里已有 ANTHROPIC_API_KEY，并且你在提示里同意使用它，就会跳过登录。

多个凭据同时存在时，Claude Code 按这个顺序选用：云平台变量 → ANTHROPIC_AUTH_TOKEN → ANTHROPIC_API_KEY → apiKeyHelper → CLAUDE_CODE_OAUTH_TOKEN → Anthropic profile → /login 的订阅登录。

• 订阅用户误走 API 计费：已登录订阅、环境里又设了 ANTHROPIC_API_KEY 时，交互模式下确认一次就会改用这个 Key；-p 非交互模式只要变量存在就直接使用。想回到订阅，执行 unset ANTHROPIC_API_KEY，再用 /status 确认。
• Max 附带的 API 额度不能用于交互式 Claude Code：它覆盖的是 API、Console Playground、Managed Agents 和 Agent SDK 等。
• settings 文件覆盖 shell 变量：同一个变量既在 shell 里 export、又写在 settings 文件的 env 里时，以 settings 文件为准。
• CI 里没有浏览器：可以用 claude setup-token 生成有效期一年的 OAuth Token，设为 CLAUDE_CODE_OAUTH_TOKEN。它走订阅额度，需要 Pro、Max、Team 或 Enterprise。

检查当前终端里的凭据变量并回到订阅登录。macOS / Linux：

# 只列出变量名，不打印值
env | grep -o '^ANTHROPIC_[A-Z_]*'

# 清掉凭据、网关地址和模型映射，回到 claude.ai 订阅登录
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL ANTHROPIC_MODEL \
  ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL
claude    # 进入后输入 /status 查看当前生效的凭据

Windows PowerShell：

Get-ChildItem Env: | Where-Object Name -like 'ANTHROPIC_*' | Select-Object Name

Remove-Item Env:ANTHROPIC_API_KEY, Env:ANTHROPIC_AUTH_TOKEN, Env:ANTHROPIC_BASE_URL, Env:ANTHROPIC_MODEL, `
  Env:ANTHROPIC_DEFAULT_OPUS_MODEL, Env:ANTHROPIC_DEFAULT_SONNET_MODEL, Env:ANTHROPIC_DEFAULT_HAIKU_MODEL `
  -ErrorAction SilentlyContinue
claude

如果这些变量还写在 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）或项目 .claude/settings.local.json 的 env 里，也要一并删掉：settings 文件里的值优先于 shell 变量。

Key 在 curl 里能用、在 Claude Code 里却 401，多半是变量用错了：ANTHROPIC_API_KEY 发 X-Api-Key，ANTHROPIC_AUTH_TOKEN 发 Authorization: Bearer，两者都设时 ANTHROPIC_AUTH_TOKEN 优先。

Claude API Key 安全

• Key 只放在环境变量、密钥管理服务或 KMS 里；本地 .env 文件加进 .gitignore。
• 不写进代码和配置文件，不放进浏览器或移动端，不发到论坛、邮件和工单里。
• 把 Key 填进第三方工具，等于让这个工具能访问你的 Console 账号；不信任的工具不要填。
• 开发、测试、生产各用一个 Key，出问题只停一个。
• 创建时设过期时间，并定期轮换；Anthropic 帮助中心给的例子是每 90 天新建一个 Key、停用旧的。
• 怀疑泄露就立即处理：API keys 页面里 Disable 可以恢复，Delete 不能恢复。
• Anthropic 加入了 GitHub 的 secret scanning 计划：GitHub 在公开仓库里发现 Claude Key 后会通知 Anthropic，该 Key 会被自动停用，相关用户会收到邮件通知。
• 在 Billing 页面设组织支出上限，再按需给各 Workspace 设单独上限。

存储、权限、轮换和泄露处置的完整做法见 API Key 安全：存储、权限、轮换与响应。

替代方案：第三方中转

第三方中转（API 网关）用自己的上游账号调用模型，再把 Messages 或 OpenAI 兼容接口提供给你。用之前先想清楚三件事：

• 政策：Anthropic 在 Claude Code 网关文档里写明，它不为第三方网关产品背书，也不维护、不审计这些产品；上一节的地区政策按使用者所在地和实体归属判断。是否使用、用在什么数据上，需要你结合自身情况评估，可参考 API 中转站合规风险判断。
• 数据：中转能看到你发出的全部内容，包括源代码。先确认是否记录请求正文、保留多久、上游是谁，见 API 中转站安全与隐私评估清单。
• 模型与计费：模型 ID 由中转自己定义，按 API 模型检测方法交叉核对；倍率和缓存计费怎么算见 API 中转站倍率说明。挑选 Claude Code 中转时可对照 Claude Code 中转站九项判断标准。

表中价格已乘分组倍率。Anthropic 已于 2026-09-30 宣布弃用 Claude Sonnet 4.5，官方 API 计划 2026-11-30 退役，新项目不建议再选 claude-sonnet-4.5；Claude Haiku 4.5 目前仍是 Active 状态，最早 2026-10-15 退役。日期以 Anthropic 模型弃用页为准。价格与可用模型以 GPTZZZ 模型价格页和控制台实时显示为准。

GPTZZZ 的 Claude Messages 地址是 https://gptzzz.ai/v1/messages，鉴权用 Bearer。先用 curl 验证 Key。macOS / Linux：

export GPTZZZ_API_KEY="你在控制台 /keys 页面创建的 Key"
export GPTZZZ_BASE_URL="https://gptzzz.ai/v1"

curl -sS "$GPTZZZ_BASE_URL/messages" \
  -H "Authorization: Bearer $GPTZZZ_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

Windows PowerShell：

$env:GPTZZZ_API_KEY = "你在控制台 /keys 页面创建的 Key"
$env:GPTZZZ_BASE_URL = "https://gptzzz.ai/v1"

Invoke-RestMethod -Method Post -Uri "$env:GPTZZZ_BASE_URL/messages" `
  -Headers @{ "Authorization" = "Bearer $env:GPTZZZ_API_KEY"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

在 Claude Code 里使用时，ANTHROPIC_BASE_URL 只填主机根 https://gptzzz.ai，不带 /v1，因为 Claude Code 会自己拼上 /v1/messages；凭据放进 ANTHROPIC_AUTH_TOKEN。macOS / Linux：

export ANTHROPIC_BASE_URL="https://gptzzz.ai"
export ANTHROPIC_AUTH_TOKEN="$GPTZZZ_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5.5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5"
unset ANTHROPIC_API_KEY
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://gptzzz.ai"
$env:ANTHROPIC_AUTH_TOKEN = $env:GPTZZZ_API_KEY
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-sonnet-5"
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
claude

进入后运行 /status，确认 Anthropic base URL 一行显示 https://gptzzz.ai，凭据来源是 ANTHROPIC_AUTH_TOKEN。只设 ANTHROPIC_BASE_URL 而不设凭据时，请求仍发往网关，但用的是已保存的 claude.ai 登录凭据，订阅的用量限额和计费照常适用。不要这样配置；切回官方订阅时，按上一节的命令把 ANTHROPIC_BASE_URL 一起清掉。网关凭据生效期间 Remote Control 和语音听写不可用；从 v2.1.196 起，只要 ANTHROPIC_BASE_URL 指向非 Anthropic 主机，Remote Control 也会被禁用。

还要注意模型 ID 的写法：GPTZZZ 用点号（如 claude-opus-5.5），Anthropic 官方用连字符（如 claude-opus-5-5）。Claude Code 的 opus、sonnet、haiku 别名默认解析为官方 ID（Anthropic API 下是 Opus 5.5、Sonnet 5.5、Haiku 5.5），和 GPTZZZ 的 ID 对不上，Sonnet 5.5 和 Haiku 5.5 也不在价格页上，所以上面用三个 ANTHROPIC_DEFAULT_*_MODEL 把别名指到价格页上的 ID，见Claude Code 模型配置文档。haiku 别名还用于后台任务；示例把它指到 claude-sonnet-5，想再省一点可以改成 claude-haiku-4.5，但要留意上面提到的退役时间。完整的模型映射、鉴权优先级和回退步骤见 Claude Code 中转站配置：API、Base URL 与验证；用 curl 和 Python 调 Messages API 的完整示例见 Claude 中转接入：API Key、Messages 与 Python。

官方资料

• Anthropic 文档：获取 Claude API Key
• Anthropic 文档：认证、Key 类型、过期与 Workspace
• Anthropic 文档：API 概览与请求头
• Anthropic 文档：用量等级、速率限制与支出上限
• Anthropic 文档：API 错误码
• Anthropic 文档：定价与免费额度说明
• Anthropic 文档：模型弃用与退役日期
• Claude 帮助中心：API 用量怎么付费
• Claude 帮助中心：Max 与 Team 计划的月度 API 额度
• Claude 帮助中心：API Key 安全最佳实践
• Anthropic：支持的国家和地区
• Anthropic：更新对未支持地区的销售限制（2025-09-04）
• Claude Code 文档：认证与凭据优先级
• Claude Code 文档：其他 LLM 网关（含不背书声明）
• Claude Code 文档：连接 LLM 网关
• Claude Code 文档：模型配置与别名

常见问题

继续阅读