Anthropic API Key 怎么获取和配置？

更新于 2026-10-28 · uniterouter.cyou

简答：Anthropic API Key 要在 Claude Console 的 API keys 页面创建，不是从 Claude 网页聊天页面复制。创建后立即保存完整密钥，配置到 <code>ANTHROPIC_API_KEY</code>，直接请求 Claude API 时使用 <code>Authorization: Bearer <key></code>；如果密钥未限定单一工作区，还要按官方要求发送 <code>anthropic-workspace-id</code>。

定义：Anthropic API Key 是用于向 Claude API 认证请求的静态密钥；它与 Claude 网页版登录会话、Pro 或 Max 等聊天订阅不是同一种凭据。

先确认这 4 项：Anthropic API Key 最小核验卡

本文是独立的第三方使用指南，不代表 Anthropic 官方。以下内容按 2026-10-28 检索到的官方文档整理；Claude Console 的界面、可用模型、认证字段、账单和组织权限可能变化，最终应以 Anthropic API Key 文档、Authentication 文档和当前账户页面为准。

官方认证文档同时说明，旧式 x-api-key 仍受支持，但新写的直接 HTTP 请求可以优先采用 Authorization Bearer 方式；不要把两种写法中的密钥、环境变量或网关凭据混用。

Anthropic API Key 与 Claude 账号、订阅有什么区别

Anthropic API Key 是程序调用 Claude API 时使用的认证凭据。Claude 网页版的登录会话不能直接替代 API Key，浏览器中能正常聊天也不代表代码已经具备 API 调用权限。

Claude Console 是开发者平台，官方帮助中心说明它用于创建 API Key、管理团队、设置 API 账单并使用 Playground。API 使用还受到组织权限和账户状态影响，不能仅凭拥有一个 Claude 网页账号推断 API 已开通。

Claude 的网页、桌面和移动端订阅与 Claude Console API 是不同产品入口。官方帮助中心明确说明，付费 Claude 订阅与 API 使用分别计费；部分 Max 或 Team 方案可能涉及单独的 API 额度规则，但具体资格、额度和账单状态应以当前官方账户页面为准。

因此，准备接入代码时应分别确认：

• 登录凭据：用于进入 Claude 网页或 Console。
• API Key：用于程序向 API 发起认证请求。
• API 账单和权限：决定账户或组织能否继续使用 API，不能替代密钥本身。

相关账户与 API 访问说明可查看 Claude API 访问帮助和 付费订阅与 API 分开计费的说明。

从 Claude Console 创建 Anthropic API Key

1. 登录 Claude Console；如果还没有 Console 账户，按页面提示注册或加入组织。
2. 打开 API keys 页面。
3. 点击 Create key，填写便于识别用途的名称，并选择有效期。
4. 根据使用场景设置 Linked account：个人开发通常关联自己；共享服务、CI 或无人值守工作负载可由组织管理员创建并关联服务账户。这个选择是身份和权限管理建议，实际可用选项取决于组织角色。
5. 如果需要把密钥限定到某个工作区，可在创建时选择工作区。官方文档说明，限定到单一工作区的密钥请求可以省略手动指定工作区 ID。
6. 创建后立即复制完整密钥并保存到密码管理器或 Secret Manager。官方说明完整值只在创建时显示一次，之后无法在 Console 中再次查看。

个人密钥代表对应用户，服务账户密钥代表服务账户；官方建议个人密钥用于自己的开发，服务账户密钥用于共享或自动化工作负载。工作区密钥仍可使用，但官方认证文档将其标为 legacy，并建议新集成优先评估身份绑定的个人密钥、服务账户密钥或 Workload Identity Federation。

如果 Create key 不可用，先检查组织角色和 API 密钥管理权限；官方文档指出，此时可能需要组织管理员调整角色或为工作负载创建服务账户密钥。不要使用他人发送的密钥绕过权限。

安全配置环境变量，再发起一次最小请求

不要把完整密钥写入源代码、提交到 Git、放进前端代码或打印到日志。下面的命令只验证环境变量长度，不会输出密钥内容。

macOS 或 Linux

export ANTHROPIC_API_KEY='在这里粘贴你的密钥'
printf '%s' "$ANTHROPIC_API_KEY" | wc -c

Windows PowerShell

$env:ANTHROPIC_API_KEY = '在这里粘贴你的密钥'
$env:ANTHROPIC_API_KEY.Length

如果长度为空或明显不符合你刚保存的密钥长度，先不要发送请求。检查时只看非空、长度或固定脱敏标记，不要输出密钥本身。

cURL 最小请求

curl https://api.anthropic.com/v1/messages \
  --header "Authorization: Bearer $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2026-10-21" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-opus-5-5",
    "max_tokens": 128,
    "messages": [
      {
        "role": "user",
        "content": "请只回复：API 调用成功"
      }
    ]
  }'

上例中的请求路径和请求头格式参考官方 Create a Message API 参考、Authentication 文档和 API 版本文档。截至本次核验，版本文档列出 2026-10-21，认证文档示例使用 claude-opus-5-5；模型是否对你的账户可用，仍需以当前官方模型列表和账户权限为准。

如果示例模型不可用，不要随意猜测模型名称；先查看官方模型文档或账户可用模型列表，再只替换 JSON 中的 model 字段。成功判定是返回正常的消息响应，而不是必须返回示例中的固定文字。

Authorization、x-api-key 和工作区请求头怎么选

根据当前 Anthropic 认证文档，直接 HTTP 请求可以使用：

• Authorization: Bearer <API Key>：当前官方认证文档展示的 API Key 方式。
• x-api-key: <API Key>：仍受支持的 legacy 兼容写法。
• anthropic-workspace-id: <Workspace ID>：当密钥未限定到单一工作区时，按官方要求指定请求使用的工作区。
• anthropic-version: 2026-10-21：声明 API 版本，具体版本以当前版本文档为准。

不要同时填写两套不同密钥，也不要把工作区 ID 当成 API Key。官方说明，限定到特定工作区的密钥只能在该工作区使用，请求可以省略工作区 ID；未限定到单一工作区的密钥则需要在请求中指定 anthropic-workspace-id。

如果缺少工作区请求头，官方示例显示 API 会返回 400 的 invalid_request_error；如果工作区 ID 不存在或当前身份无权访问，可能返回 404。工作区 ID 可在 Console 的 Workspaces 页面查看，也可以按官方 Workspaces 文档使用对应接口查询。

401、400、403、404 和模型错误的排查顺序

排查顺序建议固定为：请求地址 → 环境变量非空 → 认证头 → API 版本 → 工作区请求头 → 请求体和模型 → 账户权限与账单。响应正文中的错误类型和 message 比单看 HTTP 状态码更有用；不要把 401 认证问题直接归因于模型或网络。

密钥轮换、禁用和生产环境注意事项

创建密钥时可以设置有效期。官方认证文档说明，密钥过期后请求会返回 401，过期密钥不能重新激活，需要创建新密钥并更新部署配置。

• 个人开发：使用个人密钥，保存在本机环境变量或本地密钥管理工具中。
• 共享或 CI：优先使用服务账户密钥，避免多人共用某个个人身份。
• 生产工作负载：可以根据部署环境评估 Workload Identity Federation，用短期凭据减少长期静态密钥的保存和轮换压力。
• 疑似泄露：立即在 Console 中禁用或删除相关密钥，检查部署环境并创建替代密钥；不要把密钥粘贴到工单、群聊、截图或公开仓库。

官方文档区分了 Disable 和 Delete：禁用可以恢复，删除是永久操作；过期密钥只能删除。实际操作前应先确认新密钥已经在目标环境中生效，避免轮换时造成不必要的中断。

如果你已经完成官方密钥核验，下一步才需要考虑是否通过兼容接口接入其他开发工具；这不是调用 Anthropic API 的必需条件。

常见问题

Anthropic API Key 在哪里创建？

在 Claude Console 的 API keys 页面创建。登录 Console 后打开 API keys，点击 Create key，设置名称、有效期和关联账户。完整密钥只在创建时显示一次，丢失后不能在 Console 中再次查看，只能创建新密钥。

Claude Pro 或 Max 订阅可以直接当 Anthropic API Key 使用吗？

不能把网页端登录状态或订阅本身当作 API Key。Claude 订阅和 Claude Console API 是不同产品入口，API 使用需要单独配置 Console 访问和认证；部分方案可能有独立 API 额度规则，具体以当前官方账户和账单页面为准。

Anthropic API 应该用 Authorization 还是 x-api-key？

当前官方认证文档展示的直接 HTTP 请求方式是 <code>Authorization: Bearer <API Key></code>。<code>x-api-key</code> 仍受支持，但被官方标为 legacy 兼容方式。新请求不要同时混用两种认证头，也不要使用不同密钥。

什么时候需要 anthropic-workspace-id？

如果 API Key 没有限定到单一工作区，官方要求在请求中提供 <code>anthropic-workspace-id</code>。限定到具体工作区的密钥可以省略该请求头。缺少该字段时，官方示例显示可能返回 400 的 invalid_request_error。

为什么 Anthropic API Key 返回 401？

先检查环境变量是否为空、请求是否把变量名当成了普通文字、认证头是否为 <code>Authorization: Bearer <key></code>，以及密钥是否过期、禁用或删除。排查时只输出长度或脱敏标记，不要打印完整密钥。

个人密钥和服务账户密钥怎么选？

自己的本地开发和脚本通常可以使用个人密钥；共享服务、CI、生产程序或无人值守工作负载更适合服务账户密钥。这里是基于身份隔离和权限管理的实践建议，具体选项仍取决于组织角色和账户权限。

Anthropic API Key 丢失后还能找回吗？

不能。官方说明完整密钥只在创建时显示一次，之后不能在 Console 中再次查看。应创建新密钥，确认新配置生效后，再按实际情况禁用或删除无法确认安全状态的旧密钥。

相关阅读

• Claude Code 接入兼容 API 的配置方法
• Cursor 接入 Anthropic API 的核验与排错
• 查看更多 API 接入与错误排查指南

参考资料

1. Claude Platform Docs：Get your Claude API key（platform.claude.com）
2. Claude Platform Docs：Authentication（platform.claude.com）
3. Claude API Reference：Create a Message（platform.claude.com）
4. Claude Platform Docs：Versions（platform.claude.com）
5. Claude Help Center：How can I access the Claude API?（support.claude.com）
6. Claude Help Center：Why is Claude API usage billed separately?（support.claude.com）
7. Claude Platform Docs：Workspaces（platform.claude.com）