Anthropic API Key（2026）：获取方法、密钥类型、Claude Code 配置与报错修复
要获取 Anthropic API Key，请登录 Claude Console，打开 API keys，点击 Create key，填写名称、过期时间和关联账号（你本人或服务账号），然后立即复制以 sk-ant- 开头的密钥，因为 Console 只显示一次。 调用 API 前需要先添加付款方式或充值额度：根据截至 2026 年 10 月 22 日的 Anthropic 定价页面，用量按 token 计费，新账号只有少量免费测试额度。同一个密钥适用于所有 Claude 模型，不存在单独的"Claude API Key"或"Sonnet 密钥"。
本指南面向需要为脚本、Claude Code 等编码 Agent 或生产服务申请密钥的开发者。内容涵盖 2026 年的密钥类型（个人密钥、服务账号密钥和旧版工作区密钥）、过期规则、让许多人首个请求就失败的 anthropic-workspace-id 请求头、可运行的代码、常见的 401/400/429 报错，以及什么情况下用一个密钥对接多家供应商更省事。
60 秒了解 Anthropic API Key
| 步骤 | 位置 | 须知（2026 年 10 月 22 日核对） |
|---|---|---|
| 1. 登录 | platform.claude.com | API 密钥在 Claude Console 中管理，而不是 claude.ai 聊天应用 |
| 2. 打开 API keys | Settings → API keys | 如果 Create key 是灰色的，说明你的角色无权创建密钥 |
| 3. 创建密钥 | 名称、过期时间、关联账号、可选工作区 | 过期预设：3 小时、1 天、7 天、30 天、自定义或永不过期 |
| 4. 只能复制一次 | 仅在创建时显示 | 以 sk-ant- 开头；丢失后无法再次查看 |
| 5. 添加账单 | Settings → Billing | 按美元按量付费；各层级有每月消费上限 |
| 6. 测试 | POST https://api.anthropic.com/v1/messages |
以 Authorization: Bearer（或旧版 x-api-key）发送密钥 |
来源：Anthropic 文档 Get your Claude API key 和 Authentication，2026 年 10 月 22 日核对。
分步操作：创建 Anthropic API Key
- 在 platform.claude.com 注册或登录 Console 账号。 Claude 聊天订阅与 API 分开计费，不过 Max 套餐每月附带 API 额度（详见下文以及我们的 Anthropic API 定价指南）。
- 打开 API keys 页面。 如果你的组织有多个工作区，可以在此选择一个，把密钥限定在该工作区内。
- 点击 Create key 并填写三项：一个有辨识度的名称（例如
ci-staging-claude）、过期时间和 Linked account。关联到你本人即为个人密钥；关联到服务账号则是用于共享工作负载的密钥。 - 立即复制密钥。 Anthropic 文档说明完整密钥只显示一次。请把它存进密码管理器或密钥管理服务，切勿提交到 Git 仓库。
- 在 Billing 页面充值或绑卡。 账户没有余额时，即使密钥有效，第一个请求也会失败。
- 导出为环境变量，这样 SDK 会自动读取：
export ANTHROPIC_API_KEY="sk-ant-api03-..." # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."
应该选择哪种密钥类型？
2026 年 Anthropic 区分三种密钥类型。选错类型，是有人离开团队后密钥"突然失效"的最常见原因。
| 密钥类型 | 身份 | 何时失效 | 适用场景 |
|---|---|---|---|
| 个人密钥 | 你本人，带有你的角色权限 | 你离开组织，或单工作区密钥失去该工作区权限 | 本地开发、个人脚本、你自己的 Claude Code |
| 服务账号密钥 | 服务账号 | 服务账号被归档或从工作区移除 | CI 流水线、生产服务、共享 Agent |
| 工作区密钥（旧版） | 无人（归属于工作区） | 过期、被停用/删除，或工作区被归档 | 仅限现有集成；建议迁移 |
数据来自 Anthropic Authentication 页面，2026 年 10 月 22 日。Anthropic 推荐使用个人密钥或服务账号密钥，因为它们绑定身份，不会比所属的人或工作负载存活得更久。对于运行在 AWS、Google Cloud、Azure、GitHub Actions 或 Kubernetes 上的生产环境，同一页面推荐使用 Workload Identity Federation，用短期令牌替代静态密钥。
值得了解的过期规则
- 过期时间在创建时设定，之后无法修改。
- 对于有效期至少 14 天的密钥，Anthropic 会在到期前 7 天给创建者发邮件；有效期至少 7 天的密钥则提前 1 天提醒；更短的密钥会静默过期。
- 过期后请求会返回
401 authentication_error，过期密钥无法重新激活，只能删除。 - Disable（停用） 可以恢复；Delete（删除） 不可恢复。
实用做法：笔记本电脑和编码 Agent 使用 30 天有效期的密钥，服务器使用存放在密钥管理服务中并定期轮换的服务账号密钥。更多内容见我们的 AI 产品 API 密钥安全管理和网关后的密钥轮换指南。
测试密钥：用 curl、Python 和 Node.js 发出第一个请求
下面使用的模型 ID claude-sonnet-5-5 是截至 2026 年 10 月 22 日 Anthropic 模型概览中的当前 Sonnet 模型。
curl https://api.anthropic.com/v1/messages \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
}'
# pip install anthropic
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=256,
messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")
// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 256,
messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);
这样的测试花费不到一美分：按 Sonnet 5.5 官方价格每百万输入 token 2 美元、每百万输出 token 10 美元计算（Anthropic 定价，2026 年 10 月 22 日），30 个输入 token 加 5 个输出 token 约为 0.0001 美元。
导致首个请求失败的工作区请求头
如果你的密钥未限定到某个工作区，每个请求都必须带上 anthropic-workspace-id，否则 API 会返回 400 invalid_request_error，提示 "This API key is not scoped to a workspace..."。工作区 ID 可以在 Console 的 Workspaces 页面找到。Python 中的修复方法：
client = anthropic.Anthropic(
default_headers={"anthropic-workspace-id": "wrkspc_..."} # only for keys not scoped to a workspace
)
为单个工作区创建的密钥可以省略该请求头，这也是 Anthropic 建议在创建时就限定工作区的原因（Authentication 文档）。
在 Claude Code 中使用 Anthropic API Key
Claude Code 可以通过 claude.ai 订阅、Console 登录、云服务商或 API 密钥进行认证。根据 2026 年 10 月 22 日核对的 Claude Code 认证文档：
- 如果设置了
ANTHROPIC_API_KEY，Claude Code 首次启动时会询问是否使用它，确认后即跳过浏览器登录。 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN和apiKeyHelper设置适用于 CLI、VS Code 扩展、Agent SDK 和 GitHub Actions，但不适用于 Claude Desktop 或云端会话。apiKeyHelper会运行一个返回密钥的脚本，适合从密钥库获取短期密钥。如果脚本连续失败三次，请求就会失败。- Console 用户现在可以无需创建 API 密钥直接登录（Claude Code v2.1.242 或更高版本），保存的是 OAuth 配置而不是静态密钥。这样做之前请先取消设置
ANTHROPIC_API_KEY。
export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude # approve the key when prompted
# inside Claude Code, /status shows which credential is active
如果 Claude Code 报出令牌或登录错误，请参阅我们的 Claude Code 认证令牌错误指南。如果想让 Claude Code 连接路由而非直连 Anthropic，请看 Claude Code API 路由配置。
Anthropic API Key 免费吗？
创建密钥免费，使用则需付费。Anthropic 的定价 FAQ 写明新用户会获得"少量免费额度用于测试 API"，之后每个请求都按 token 计费。有一个值得注意的例外：根据 2026 年 10 月 22 日核对的 claude.com/pricing，Max 5x 套餐（每月 100 美元）每月附带 100 美元、Max 20x 每月附带 200 美元的 Claude Platform API 额度；Pro（按月付费每月 20 美元）不含 API 额度。以下是 Anthropic 定价页面在 2026 年 10 月 22 日列出的每百万 token 当前价格：
| 模型 | 模型 ID | 输入 | 输出 | 缓存读取 |
|---|---|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 |
$10.00 | $50.00 | $0.25 |
| Claude Opus 5.5 | claude-opus-5-5 |
$4.00 | $20.00 | $0.20 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 |
$2.00 | $10.00 | $0.10 |
| Claude Haiku 5.5（提示词不超过 100K） | claude-haiku-5-5 |
$0.10 | $0.50 | $0.01 |
Batch API 将输入和输出价格减半，仅限美国境内推理（inference_geo: "us"）则乘以 1.1 倍。工作负载测算请看我们完整的 Anthropic API 定价指南。如果你需要真正免费的模型做原型，我们的免费 LLM API 对比列出了带实际限额的选项。
密钥自带消费上限和速率限制
组织的用量层级同时决定速率限制和每月消费上限。根据 2026 年 10 月 22 日核对的 Anthropic 速率限制页面，每月上限分别为 500 美元（Start）、1,000 美元（Build）和 200,000 美元（Scale）；新组织可能从更低的 Evaluation 层级开始。达到上限后，API 会返回 HTTP 429，直到下个月 1 日 00:00 UTC，除非你申请更高层级。你也可以在 Billing 页面设置更低的自定义消费上限，对于交给自主 Agent 使用的密钥，这是个好习惯。
Anthropic API Key 常见报错与修复
| 报错 | 可能原因 | 修复方法 |
|---|---|---|
401 authentication_error |
密钥拼写错误、已撤销、已停用或已过期 | 创建新密钥；过期密钥无法重新激活 |
提及工作区的 400 invalid_request_error |
密钥未限定工作区且未发送请求头 | 添加 anthropic-workspace-id，或创建限定工作区的密钥 |
404 not_found_error "Workspace ... not found" |
工作区 ID 错误，或密钥身份无访问权限 | 在 Workspaces 页面核对 ID |
429 "reached your API usage limits" |
达到层级每月消费上限 | 申请提升层级或等待每月重置 |
带 retry-after 的 429 |
超出每分钟请求数或 token 数 | 退避后重试；参见 LLM 速率限制详解 |
529 overloaded_error |
Anthropic 容量不足，与密钥无关 | 退避重试或故障转移；参见 API 错误 529 |
| Create key 按钮不可用 | 你的 Console 角色无权创建密钥 | 请管理员调整角色或提供服务账号密钥 |
来源：Anthropic Authentication、速率限制和错误文档，2026 年 10 月 22 日核对。
保护好密钥
- 切勿把密钥写进前端代码、移动应用或公开的 Notebook。对于必须直接调用 Claude 的 iOS 和 macOS 应用，Anthropic 提供 App Attest，签发 1 小时后过期的设备令牌。
- 每个环境、每个 Agent 使用单独的密钥，这样撤销其中一个不会影响其他。
- 即使设得很长，也要设置过期时间，让泄露的密钥有"保质期"。
- 在 CI 中启用密钥扫描；我们的 AI API 密钥扫描指南介绍了配置方法。
- 在 Console 中关注用量，并设置低于层级上限的消费限额。
一个密钥调用多种模型更简单的情况
Anthropic 密钥只能调用 Claude。如果你的产品或编码 Agent 还要调用 GPT、Gemini、DeepSeek、Qwen 或 Kimi，你就得管理五个密钥、五份余额和五套速率限制。Flatkey 这样的统一 API 只需一个密钥即可调用全部模型。2026 年 10 月 22 日，Flatkey 模型页面列出的 Claude Sonnet 5.5 价格为每百万 token 输入 1.60 美元 / 输出 8.00 美元，Claude Opus 5.5 为 3.20 / 16.00 美元，而 Anthropic 官方标价分别是 2 / 10 美元和 4 / 20 美元。根据 Flatkey 的 Anthropic SDK 指南，只需修改 base URL 即可使用 Anthropic SDK：
import anthropic
client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=256,
messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
如果你需要在发布当天就用上 Anthropic 独有功能、Workload Identity Federation、数据驻留控制或企业合同，请继续使用 Anthropic 直连密钥。更全面的对比请阅读 Flatkey 与直连供应商账号对比和一个 API Key 调用多个 AI 模型。
FAQ
如何获取 Anthropic API Key？
登录 platform.claude.com 上的 Claude Console，进入 Settings → API keys，点击 Create key，设置名称、过期时间和关联账号，然后复制仅显示一次的 sk-ant- 密钥。发出请求前先在 Billing 页面充值。
Anthropic API Key 免费吗？
创建密钥免费，新账号也有少量免费测试额度，但之后的 API 用量按 token 计费。截至 2026 年 10 月 22 日，Claude API 没有永久免费层级。
Claude API Key 和 Anthropic API Key 是一回事吗？
是的。Anthropic 文档说明 Claude API 的密钥也称为 Anthropic API Key。一个密钥可调用你的组织有权访问的所有 Claude 模型。
在哪里找到已有的 Anthropic API Key？
在 platform.claude.com/settings/keys 可以看到每个密钥的名称、提示和过期时间，但看不到完整密钥。如果丢失了，请创建新密钥并删除旧密钥。
Claude Pro 或 Max 订阅包含 API 额度吗？
Pro 不包含。截至 2026 年 10 月 22 日，claude.com/pricing 显示 Max 套餐附带每月 API 额度（Max 5x 每月 100 美元，Max 20x 每月 200 美元）。超出部分通过 Console 密钥按 token 计费，与聊天订阅分开结算。
为什么我的 Anthropic API Key 返回 401？
密钥拼写错误、已停用、已删除或已过期。过期密钥无法重新激活，请新建一个。如果报错提到工作区，那其实是缺少 anthropic-workspace-id 请求头导致的 400 错误。
如何在 Claude Code 中使用 Anthropic API Key？
在 shell 中设置 ANTHROPIC_API_KEY，运行 claude，在提示时确认使用该密钥。在 Claude Code 中输入 /status 可确认当前生效的凭据。
来源
- Anthropic：Get your Claude API key、Authentication、Pricing、Rate limits、Models overview，2026 年 10 月 22 日核对
- Claude Code：Authentication and IAM，2026 年 10 月 22 日核对
- Flatkey：模型目录和 Anthropic SDK 指南，2026 年 10 月 22 日核对
