Claude API Key 获取与使用教程
Claude API Key 是调用 Claude 模型时用来证明"你是谁、费用记在谁账上"的一串密钥。官方的 Key 在 Anthropic 的 Claude Console 里创建，以 sk-ant- 开头；cdnd（Claude Code 中转站） 的 Key 在 cdnd 控制台里创建，以 sk-cdnd- 开头，只能给 Claude Code 用。本文讲清楚两种 Key 分别怎么获取、能用在哪里，以及在 Claude Code 里怎么配置、怎么设限额、泄露了怎么办。
什么是 Claude API Key
按官方文档，Claude API Key（也叫 Anthropic API Key）是在 Claude Console 里生成的静态密钥，每次请求都要带上。程序用它调用 Claude API，费用从这个 Key 所属组织的额度里扣。
它和 Claude Pro / Max 订阅是两回事：订阅是在 Claude Code 里用 claude.ai 账号登录（/login），走的是订阅额度；API Key 走的是 Console 里按量计费的额度。
| 官方 Claude API Key | cdnd API Key | |
|---|---|---|
| 开头 | sk-ant- |
sk-cdnd- |
| 在哪创建 | Claude Console（platform.claude.com） | cdnd 控制台 |
| 能调用什么 | 官方 Claude API 的各个接口 | 只服务官方 Claude Code（CLI 和 VS Code 插件） |
| 怎么付费 | 预付额度，银行卡购买 | 人民币充值，按官方标价扣余额，见 价格 |
| 在中国大陆 | 不在官方支持地区内 | 可以直接使用 |
官方 Claude API Key 怎么获取
创建步骤
- 打开 Claude Console（
platform.claude.com），登录或注册账号。 - 进入 API keys 页面（
platform.claude.com/settings/keys）。 - 点 Create key，填名称，选择有效期，把 Linked account 设为你自己（个人 Key）或某个服务账号（服务账号 Key）。也可以限定到某个 workspace。
- 复制 Key。完整的 Key 以
sk-ant-开头，只在创建时显示一次；丢了在 Console 里也查不到，只能新建一个。
有效期可以选 3 小时、1 天、7 天、30 天、自定义或 Never，创建后不能修改。过期的 Key 请求会返回 401，不能重新启用。
使用前要先买额度
按 Claude 帮助中心的说明，Claude API 用的是预付额度：先在 Console 的 Billing 页面（platform.claude.com/settings/billing）点 Buy credits 买额度，再调用 API；额度用完就不能再调用，直到再次购买。付款方式是银行卡。购买的额度一年后过期，不退款。
拿到 Key 后，官方 SDK 会自动读取 ANTHROPIC_API_KEY 环境变量；直接发 HTTP 请求时放在 Authorization: Bearer 请求头里，旧的 x-api-key 请求头也仍然支持。
为什么在国内很难用上官方 Key
- 地区限制：Anthropic 的支持地区政策写明，Claude.ai、Claude Code、API 和开发者平台只对列表中的国家和地区开放，没列出的都不支持。中国大陆、香港、澳门都不在列表里。政策还说明，人身处不支持的地区时使用，同样属于不支持。
- 付款：额度要先用银行卡购买，之后才能调用。
所以在国内，绕路注册、付款再长期使用官方 Key，门槛和风险都不低。只是想用 Claude Code 写代码的话，用中转站的 Key 更直接；两种方式的区别见 国内使用 Claude 的方式 和 Claude 封号原因。
cdnd API Key：Claude Code 专用
创建步骤
- 在 cdnd 控制台 用邮箱注册。
- 充值。余额为空时，控制台会提示先充值再创建 Key；充值方式见 Claude Code 价格。
- 进入 API keys 页面，点 Create key，起一个好认的名字，比如
laptop、ci、项目名。 - 点 Copy key 复制。完整的 Key 只显示这一次，之后列表里只显示
sk-cdnd-AbCd…wxyz这样的缩写。cdnd 只保存 Key 的哈希值，丢了找不回，只能新建。
Key 的格式
cdnd 的 Key 以 sk-cdnd- 开头，后面是一串随机字符。cdnd 只认这个前缀：把官方的 sk-ant- Key 填进来，cdnd 不会识别，也不会用它；反过来，cdnd 的 Key 也不能直接拿去调用官方 API。
能用在哪里，不能用在哪里
cdnd 只服务官方 Claude Code。每个请求都会检查是不是 Claude Code 发出的，不是的会被拒绝；而且只转发 Claude Code 用到的接口：POST /v1/messages 和 POST /v1/messages/count_tokens，模型列表由 cdnd 自己返回。
| 用法 | 能用吗 | 结果 |
|---|---|---|
Claude Code 命令行（claude） |
能 | 正常使用 |
| Claude Code 的 VS Code 插件 | 能 | 配置方式见 VS Code 插件教程 |
| 用 Anthropic 官方 SDK（Python、TypeScript）写的程序 | 不能 | 返回 403：cdnd serves Claude Code only |
| curl、Postman 等直接发请求 | 不能 | 返回 403 |
| Cursor、Cline 等其他应用 | 不能 | 返回 403 |
OpenAI 格式接口（/v1/chat/completions、/v1/responses 等） |
不支持 | 不转发，返回 404，提示改用 Anthropic 格式 |
| Batches、Files 等其他官方接口 | 不支持 | 不转发，返回 404 |
如果你需要在自己的程序里调用 Claude API，cdnd 的 Key 用不了，需要官方 Key。
在 Claude Code 里使用 API Key
Claude Code 接入 cdnd 只要两个环境变量：ANTHROPIC_BASE_URL 指向 cdnd，ANTHROPIC_AUTH_TOKEN 填 Key。
export ANTHROPIC_BASE_URL=https://api.cdnd.sh
export ANTHROPIC_AUTH_TOKEN=sk-cdnd-你的Key
claude
长期使用建议写进 ~/.claude/settings.json 的 env 里；Windows 写法、VS Code 插件配置和验证方法，见 Claude Code 第三方 API 配置教程。还没装 Claude Code 的话，先看 安装教程。
按 Claude Code 官方文档，几种凭据的区别是：
| 凭据 | 发送方式 | 说明 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN |
Authorization: Bearer 请求头 |
用于网关或代理，直接生效，推荐填 cdnd Key |
ANTHROPIC_API_KEY |
x-api-key 请求头 |
官方 Key 的标准用法；交互模式下第一次会问你是否使用 |
apiKeyHelper |
由你写的脚本输出 Key | 适合从密码管理器里动态取 Key |
/login 登录 |
订阅账号的 OAuth 凭据 | Pro、Max、Team、Enterprise 的默认方式 |
同时存在多种凭据时，Claude Code 按 ANTHROPIC_AUTH_TOKEN → ANTHROPIC_API_KEY → apiKeyHelper → … → /login 的顺序选第一个。cdnd 两种请求头都认，所以 cdnd Key 填在 ANTHROPIC_API_KEY 里也能用。运行 /status 可以看到当前实际在用哪一个。
管理 API Key
每个项目或设备单独一个 Key
一个账号可以建多个 Key。Key 列表会分别显示每个 Key 的最近使用时间、近 30 天请求数和本月花费，所以按项目、按设备分开建 Key，用量一目了然，出问题时也只需要撤销其中一个。
设置每月花费上限
在 Key 那一行点 Limit，填每月最多花多少美元，留空表示不限。每个请求按所用模型的 Claude API 官方标价计算，缓存读写也算在内。超过上限后，这个 Key 会返回 429，直到当月结束（按北京时间计算）自动恢复；也可以随时调高上限。给 CI 或临时共享的 Key 设个上限，可以防止意外花超。
改名和撤销
- Rename：随时改名，不影响使用。
- Revoke：撤销后，用这个 Key 的客户端从下一个请求开始收到 401。撤销不能恢复，只能新建 Key 替换。撤销过的 Key 仍保留在列表里备查，点 All 可以看到。
cdnd 没有"重新生成"按钮。想换 Key（轮换），就新建一个，把配置里的旧 Key 换掉，确认能用后再撤销旧的。
own Key 和 pool Key
大多数用户只会看到一种 Key：它使用 cdnd 的共享账号池，按官方标价从你的余额扣费。余额用完时请求返回 402，充值后恢复。
如果你在 cdnd 托管了自己的 Claude 账号，创建 Key 时会多一个 Routes to 选项：
- own：只用你自己托管的账号，不扣余额。账号还没添加或还没审核通过时，请求会返回 403（this key has no accounts）。和朋友共用账号时，可以给每人各建一个 own Key，分别设上限，见和朋友拼车。
- pool：使用共享账号池，按官方标价扣余额。
API Key 安全
API Key 等于你的余额，泄露了别人就能用你的钱。
- 不要提交进 git：项目里的
.claude/settings.json会被提交，不要把 Key 写进去。按项目配置请用.claude/settings.local.json，手动创建的话先加进.gitignore。 - 不要贴到公开的地方：截图、issue、聊天群、博客里的配置示例，都把 Key 换成占位符。
- 按用途分开建 Key，给共享的 Key 设上限：泄露时影响范围小，损失有上限。
- 怀疑泄露就立刻撤销：在控制台 Revoke 掉，新建一个换上；看看 Key 列表里的最近使用时间和本月花费有没有异常。
- 官方 Key 同理：官方文档建议把 Key 放进密码管理器、定期轮换、发现泄露就在 Console 里禁用（Disable，可恢复）或删除（Delete，永久），创建时也可以设置有效期，缩短泄露后的可用时间。
常见报错
| 状态码 | 报错信息 | 原因和处理 |
|---|---|---|
| 401 | This cdnd API key is invalid or has been revoked | Key 填错或已撤销，见 401 排查 |
| 403 | cdnd serves Claude Code only | 请求不是 Claude Code 发出的，见 403 排查 |
| 403 | this key has no accounts | own Key 还没有可用的托管账号，见 说明 |
| 402 | Your cdnd balance is used up | 余额用完，充值 后自动恢复 |
| 429 | This key reached its monthly spend limit | 达到这个 Key 的月度上限，调高上限或等下个月 |
| 404 | the OpenAI-format … isn't supported | 用了 OpenAI 格式的接口，cdnd 只支持 Anthropic Messages API |
更多问题，比如设置了变量还弹登录，见 第三方 API 配置教程的常见报错。
常见问题
Claude Pro 有 API Key 吗？
订阅和 API Key 是分开的。按官方文档，Pro 订阅在 Claude Code 里是用 claude.ai 账号登录（/login）使用的；API Key 要在 Claude Console 单独创建，用单独购买的预付额度付费。官方帮助中心提到的每月 API 额度只附带在 Max 和 Team 套餐里，Pro 不在其中，而且这部分额度不能用于 Claude Code 和 Claude 应用。
cdnd 支持 OpenAI 格式吗？
不支持。cdnd 只支持 Anthropic Messages API，并且只转发 Claude Code 用到的 /v1/messages 和 /v1/messages/count_tokens。请求 /v1/chat/completions 等 OpenAI 格式的接口会返回 404。
cdnd 的 Key 能在自己写的程序或 curl 里用吗？
不能。cdnd 只服务官方 Claude Code（命令行和 VS Code 插件），用 Anthropic SDK、curl 或其他应用发出的请求会返回 403。需要在自己的程序里调用 Claude API，请使用官方 Key。
官方 sk-ant- Key 能填进 cdnd 用吗？
不能。cdnd 只识别以 sk-cdnd- 开头的 Key，官方 Key 填进来不会被当作 cdnd Key，也不会被使用。用 cdnd 时请在 cdnd 控制台创建 Key。
Key 丢了或者忘了复制怎么办？
找不回来。cdnd 和官方 Console 都只在创建时显示一次完整的 Key。新建一个 Key 换上，再把旧的撤销即可。
一个 Key 可以在几台电脑上用吗？
可以，cdnd 不限制设备数量。但建议每台电脑或每个项目单独建一个 Key，这样用量分开统计，某台设备丢了或 Key 泄露时，只撤销那一个就行。
用 ANTHROPIC_AUTH_TOKEN 还是 ANTHROPIC_API_KEY？
用 cdnd 推荐 ANTHROPIC_AUTH_TOKEN：它以 Bearer 请求头发送，启动后直接生效。ANTHROPIC_API_KEY 也能用，但交互模式下第一次启动会询问是否使用这个 Key。两个都设置时，Claude Code 优先用 ANTHROPIC_AUTH_TOKEN。