SupaStore

返回博客列表

Claude API Key 怎么获取？2026 Claude API Key 申请、配置与安全使用指南

Claude API Key 怎么获取？本文讲清在 Claude Console 申请 Claude API Key 的步骤、有效期设置和工作区范围，说明国内通过中转站获取 Key 的方法，演示在 Python、cURL 和 Claude Code 中配置 API Key，并整理防止 Key 泄露、过期报 401 和轮换 Key 的安全使用建议。

SupaStore 开发者体验组 ·

Claude API Key 怎么获取？2026 Claude API Key 申请、配置与安全使用指南

Claude API Key 是调用 Claude API 的身份凭证：每次请求都要带上它，Anthropic 据此识别你的账号并扣费。拿到 Claude API Key 之后，你就能在自己的程序、Claude Code、Cursor 等工具里使用 Claude 模型。

这篇文章讲清在官方控制台申请 Claude API Key 的步骤、有效期和权限范围，国内开发者通过中转站获取 Key 的方法，以及在代码和工具里配置 Key、防止泄露的注意事项。Claude API 怎么收费，见《Claude API 价格是多少？2026 Claude API 收费标准与省钱指南》。

方式一：在 Claude Console 申请 Claude API Key

  1. 注册并登录 Claude Console（开发者平台，和 claude.ai 聊天账号是两套体系）；
  2. 在账单页面完成付款设置，API 采用预付费，没有余额无法调用；
  3. 打开 API Keys 页面，点击 Create key；
  4. 填写名称，选择有效期，并选择这个 Key 关联到你本人还是服务账号，也可以指定工作区；
  5. 复制以 sk-ant- 开头的完整密钥。

密钥只会显示一次，关闭后无法再次查看，丢失了只能重新创建。如果 Create key 按钮是灰色的，说明你的角色没有创建权限，需要请组织管理员调整。

Claude API Key 的有效期

创建时可以选择 3 小时、1 天、7 天、30 天、自定义时长，或"永不过期"。有效期创建后不能修改；Key 过期后，请求会返回 401 authentication_error，且无法重新激活，只能新建。有效期 14 天以上的 Key 会在过期前 7 天收到提醒邮件。

工作区与 Key 的权限范围

为某个工作区创建的 Key 只能在该工作区使用。官方更推荐使用关联个人或服务账号的 Key：个人 Key 代表你本人，服务账号 Key 适合共享的或自动化的任务。

方式二：通过中转站获取 Key（国内推荐）

官方渠道需要支持地区的账号和外币支付方式，中国大陆不在服务地区内。国内开发者更常见的做法是通过 Claude API 中转站获取 Key。以 SupaStore 为例：

  1. 登录 SupaStore 控制台，进入【令牌管理】→【添加令牌】；
  2. 勾选允许使用的 Claude 模型，并设置额度上限；
  3. 复制 sk- 开头的密钥，接口地址填写 https://api.supastore.cc/v1。

中转站 Key 和官方 Key 不能混用：官方 Key 填到中转站、或中转站 Key 直连官方，都会返回 401。选择中转站时的检测清单见《API中转站是什么？2026 AI中转站选型避坑指南》。

Claude API Key 怎么配置

环境变量（推荐）

# macOS / Linux
export ANTHROPIC_API_KEY="sk-your-api-key"

# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-your-api-key"

官方 SDK 会自动读取 ANTHROPIC_API_KEY，代码里不需要出现密钥。

Python SDK

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.supastore.cc/v1",  # 直连官方时省略
)  # 自动读取 ANTHROPIC_API_KEY

完整的调用示例见《Claude API 调用教程：Python 接入 Claude API 完整示例》。

cURL

curl https://api.supastore.cc/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 256, "messages": [{"role": "user", "content": "你好"}]}'

Claude Code

在 ~/.claude/settings.json 的 env 中配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，完整步骤见《Claude API 中转怎么用？国内 Claude Code 中转站配置教程》。注意：同时设置了 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 时，API Key 优先，旧 Key 失效会导致 401，删掉不用的那个即可。各类工具的接口地址填写规则见《Base URL 是什么？API Base URL 怎么填》。

Claude API Key 安全使用建议

  1. 不要写进代码和 Git 仓库：用环境变量或密钥管理服务保存，提交前检查是否误提交了 .env；
  2. 不要放在前端页面：网页里的 Key 任何访问者都能看到，官方要求从你自己的后端调用 Claude API；
  3. 按用途分别创建 Key：Claude Code、业务服务、测试脚本各用一个，出问题时只影响一处，也方便在日志里区分消耗；
  4. 设置有效期和额度上限：官方 Key 选择合适的有效期，中转站 Key 设置额度上限，泄露时损失可控；
  5. 定期轮换：先创建新 Key、更新所有调用方，确认正常后再删除旧 Key；
  6. 怀疑泄露立即处理：在控制台停用或删除该 Key。官方控制台里"停用"可以恢复，"删除"是永久的。

在 Claude Code 里，还可以用权限规则禁止 Claude 读取 .env 等敏感文件，见《Claude Code 权限怎么设置？》。

Claude API Key 常见问题排查

现象 常见原因 处理方法
401 authentication_error Key 错误、已过期、已删除，或复制时多了空格 重新复制 Key；过期的 Key 需要新建
官方 Key 在中转站报 401 官方 Key 和中转站 Key 不通用 使用中转站控制台生成的 Key
402 或余额不足 账户余额或 Key 额度用完 充值或调高 Key 的额度上限
403 permission_error 当前 Key 没有访问该资源的权限 检查组织和工作区设置
浏览器中调用报 401 组织不允许从浏览器直接调用 改为从后端调用

更多错误码见《Claude API 报错怎么办？2026 Claude API 错误码大全》。

常见问题 (FAQ)

Q: Claude API Key 在哪里申请？

答： 登录 Claude Console 开发者平台，在 API Keys 页面点击 Create key，填写名称、选择有效期后即可生成以 sk-ant- 开头的密钥；国内开发者也可以在中转站控制台创建令牌获取 Key。

Q: Claude API Key 忘记保存了怎么办？

答： 官方控制台的完整密钥只在创建时显示一次，之后无法再次查看，只能重新创建一个新的 Key 并更新到你的程序中。

Q: Claude API Key 会过期吗？

答： 会，创建时可以选择 3 小时到 30 天的有效期、自定义时长或永不过期，有效期创建后不能修改，过期后请求返回 401，需要重新创建 Key。

Q: Claude Pro 订阅能拿到 API Key 吗？

答： 不能直接拿到，claude.ai 的 Pro、Max 订阅与 Claude API 是两套体系，API Key 需要在 Claude Console 开发者平台单独申请并按 Token 付费。

Q: Claude API Key 泄露了怎么办？

答： 立即在控制台停用或删除该 Key，再创建新 Key 并更新到所有调用方，同时检查账单和使用日志，确认是否有异常调用。