Claude API Key 怎么获取?2026 最新申请流程
获取 Claude API Key 的核心流程是三步:注册并登录 Anthropic Console(控制台 console.anthropic.com)、为账户绑定支付方式并充值、在 API Keys 页面点击创建后立即复制保存。整个过程通常十分钟内就能完成,下面按步骤拆解,并给出拿到 key 之后的第一段可运行调用代码。
第一步:注册 Anthropic Console 账户
API Key 不是在 claude.ai 聊天网站里申请的,而是在面向开发者的 Anthropic Console 控制台。打开 console.anthropic.com,用邮箱或 Google 账号注册。首次登录会要求你创建一个 组织(Organization),填写组织名称即可——后续的账单、成员、密钥都挂在这个组织下。
- 注册需要邮箱验证,部分情况下还会要求绑定手机号完成验证。
- 一个组织下可以创建多个 工作区(Workspace),不同工作区可以分别设置预算上限和密钥,便于区分项目或环境(如生产 / 测试)。
第二步:绑定支付方式并充值
Claude API 采用预付费 + 按量计费模式,没有免费额度无限用一说,所以创建 key 前通常需要先在 Billing(账单) 页面绑定信用卡并充值一笔余额。进入控制台左侧的 Settings → Billing,添加支付方式后充值,账户才会进入可调用状态。
计费按输入 / 输出 Token 分别计价,不同模型价格不同,并支持设置每月用量上限来防止超支。各模型的具体价格、限速档位(Rate Limit Tier)与免费试用政策可能随时调整,具体以 Anthropic 官网为准。如果你想提前估算成本,可以参考 Claude API 价格详解:各模型计费方式与省钱对比 和 Claude API Token 怎么计算?附在线估算方法。
第三步:创建并保存 API Key
充值完成后,进入控制台的 API Keys 页面(Settings → API Keys),点击 Create Key:
- 给密钥起一个有辨识度的名字,比如
blog-prod或local-dev,方便日后审计和吊销。 - 如果有多个工作区,选择该密钥归属的 Workspace。
- 点击创建后,系统会展示一段以
sk-ant-开头的字符串。这串明文只显示这一次,关闭弹窗后无法再次查看,必须立即复制并妥善保存。
如果不慎泄露或遗失,正确做法是在 API Keys 列表里把旧密钥 Revoke(吊销),再创建一个新的,而不是反复尝试找回。
第四步:用 API Key 发起第一次请求
Claude 的调用入口是 Messages API(POST /v1/messages),鉴权方式是在请求头里带上 x-api-key 和 anthropic-version 两个字段。2026 年的主力模型为 Claude Opus 4.8、Claude Sonnet 4.6、Claude Haiku 4.5,下面用官方 SDK 演示。
Python(anthropic 官方 SDK)
先安装:pip install anthropic。推荐把密钥放进环境变量 ANTHROPIC_API_KEY,SDK 会自动读取,避免硬编码进代码:
import anthropic
# 不传 api_key 时,SDK 自动读取环境变量 ANTHROPIC_API_KEY
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
messages=[
{"role": "user", "content": "用一句话介绍你自己"}
],
)
print(message.content[0].text)
Node.js(@anthropic-ai/sdk)
安装:npm install @anthropic-ai/sdk。同样从环境变量读取密钥:
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // 读取 process.env.ANTHROPIC_API_KEY
const message = await client.messages.create({
model: "claude-opus-4-8",
max_tokens: 1024,
messages: [
{ role: "user", content: "用一句话介绍你自己" },
],
});
console.log(message.content[0].text);
这两段代码跑通后,说明你的 key 已经生效。想看更细致的逐步讲解,可以读 Claude API 怎么调用?从注册到第一次请求完整教程 与 Claude API Python 示例代码:10 分钟跑通第一个程序。Messages API 的全部参数(如 system、temperature、工具调用 Tool Use、流式输出 SSE、多模态图片输入等)则可查阅 Claude Messages API 全部参数说明(含代码示例)。
API Key 的安全保管建议
密钥相当于你账户的付费凭证,一旦泄露可能被人盗刷。务必遵守几条原则:
- 绝不写进代码并提交到 Git。用环境变量或密钥管理服务,把
.env文件加进.gitignore。 - 不要放进前端 / 客户端。浏览器和 App 里的密钥任何人都能抓到,调用必须经由你自己的后端中转。
- 按项目分密钥、设预算上限。不同环境用不同 key,配合 Workspace 的用量上限,泄露时也能把损失控制在局部。
- 定期轮换。对长期运行的服务,周期性创建新 key、吊销旧 key。
Claude Code 也需要这把 key 吗?
Claude Code 是 Anthropic 官方的命令行工具,登录时既可以用 Claude 订阅账号,也可以用 API Key 的方式接入计费。如果你打算在终端里用它写代码,可以参考 Claude Code 怎么安装?Windows 完整安装教程(2026);遇到登录问题则看 Claude Code 登录失败怎么办?认证问题完整解决。
常见问题
没有充值能创建 API Key 吗?
通常需要先在 Billing 页面绑定支付方式并充值,账户才能正常发起付费调用。是否提供少量免费试用额度、以及额度多少,会随政策变化,具体以 Anthropic 官网为准。建议直接充入一笔小额余额走通整个流程。
API Key 丢了能找回吗?
不能。明文密钥只在创建时显示一次,关闭后无法再查看。如果丢失或泄露,请在 API Keys 页面吊销旧密钥并重新创建一个,这也是泄露后的标准应急处理。
用了正确的 key 还是报错 401 怎么办?
401 表示鉴权失败,常见原因包括:复制时多了空格或换行、用了已吊销的 key、请求头字段写成了 Authorization 而不是 x-api-key、或环境变量没生效。逐项排查方法见 Claude API 报错 401 怎么解决?认证失败排查指南;如果是触发限速返回 429,则参考 Claude API 429 限流报错怎么办?3 种重试方案。