wbstorm

Anthropic Console API 密钥：创建、工作区与轮换（2026）

Console 里生成 sk-ant- 密钥、选对类型与工作区，并和 claude.ai 的 Pro 订阅分开管理。

要在代码里调用 Claude API，第一步通常不是写 curl，而是在 Claude Console 里创建并保管 API 密钥。Console 地址是 platform.claude.com；密钥页面为 Settings → API keys。与 claude.ai 上的 Claude Pro 订阅 分开计费、分开管理。

检索词是 Anthropic Console API 密钥怎么创建和管理。下文依据 Anthropic 官方文档 platform.claude.com/docs/en/get-api-key 与 API overview。首次注册与第一条 Messages 请求可对照站内 获取 API key 入门；浏览器订阅见 Claude Pro 与 Projects。集成方案要对齐时，用 wbstorm 开短会，步骤见 创建与加入房间。

登录 Console创建密钥安全存储与轮换

Console API 与 Claude Pro 别混用

场景Console API 密钥Claude Pro（claude.ai）
主要用途Messages API、SDK、自动化与自建应用浏览器与官方客户端里的对话与功能
开通位置platform.claude.com 账号与 Billingclaude.ai 账号与订阅设置
凭证形式sk-ant-… API 密钥或联合身份短期令牌登录 claude.ai 的账号会话
本页下一步创建并轮换 Console 密钥见 Claude Pro 笔记

密钥类型怎么选

01

个人密钥（Personal）

代表你本人；适合本地开发与个人实验。若你离开组织，该密钥会失效。

02

服务账号密钥（Service account）

绑定服务账号，适合 CI、生产服务或长期运行的 Agent；团队共享 workload 时优先此类型。

03

工作区密钥（Workspace，旧式）

属于某个工作区、无个人所有者；官方更推荐个人或服务账号密钥，以便账号移除时自动失效。

在 Console 创建 API 密钥

  1. 1

    登录 Claude Console

    打开 platform.claude.com，使用你的 Anthropic 账号登录；尚无账号则按官方流程注册，并确认你所在地区在 Anthropic 支持范围内（见官方 Supported regions 文档）。

  2. 2

    打开 API keys 页面

    进入 platform.claude.com/settings/keys（Settings → API keys）。若 Create key 为灰色，你的角色可能没有创建权限，需组织管理员调整角色或代为创建服务账号密钥。

  3. 3

    创建并命名密钥

    点击 Create key，填写名称，选择过期时间，将 Linked account 设为自己或服务账号；可按需选择工作区以限制密钥可用范围（见 Workspaces 文档）。

  4. 4

    复制并只保存一次

    创建成功后，Console 只会完整显示一次以 sk-ant- 开头的密钥。立即复制到密码管理器或云厂商 Secrets Manager；丢失后无法再次查看，只能新建密钥。

在应用里使用密钥

  1. 1

    环境变量

    官方示例：export ANTHROPIC_API_KEY="sk-ant-api03-…"。Anthropic 客户端 SDK 会自动读取 ANTHROPIC_API_KEY。

  2. 2

    HTTP 请求头

    直接调用 REST API 时，在 x-api-key 或 Authorization: Bearer 中携带密钥，并带上官方要求的 anthropic-version 等头（见 Authentication 文档）。

  3. 3

    多工作区

    若同一密钥可用于多个工作区，每次请求还需发送 anthropic-workspace-id 头；单工作区密钥通常可省略。

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

模型 ID 与请求体字段以当前 platform.claude.com/docs 的 Messages API 为准；上面 curl 仅作头字段示例。

Billing、限额与工作区

  1. 1

    开通计费

    在 platform.claude.com/settings/billing 按官方指引添加合法付款方式；API 用量按 Console 计费规则结算，具体费率与套餐以页面显示为准，本页不臆测价格数字。

  2. 2

    查看 Rate limits

    打开 platform.claude.com/usage/limits 查看组织的 RPM/TPM 与月度 spend 档位；需要更高限额时使用页面上的 Request tier increase。

  3. 3

    用工作区隔离环境

    在 platform.claude.com/settings/workspaces 划分开发、预发与生产，便于分账与限额；创建密钥时绑定对应工作区。

轮换与撤销

  1. 1

    新建替代密钥

    在 API keys 页面创建新密钥，命名含日期或环境，便于审计。

  2. 2

    更新部署

    在本地 .env、CI 机密、Kubernetes Secret 等处替换为新密钥；跑一条只读 smoke 请求确认 200。

  3. 3

    撤销旧密钥

    确认无服务仍引用旧 key 后，在 Console 删除或撤销；若怀疑泄露时立即撤销并检查 Billing 异常用量。

Claude Pro 订阅包含 API 额度吗？

不是同一账单。Claude Pro 是 claude.ai 上的消费者订阅；API 调用通过 Console 账号与 Billing 计费。两者账号体系相关但产品边界不同，以 Anthropic 官方说明为准。

密钥泄露了怎么办？

立刻在 API keys 页面撤销该密钥，创建新密钥并轮换所有部署。查看 Billing 与 usage 是否有异常请求；必要时联系 Anthropic 支持并附上 request-id。

和 Amazon Bedrock / Vertex 上的 Claude 一样吗？

不一样。本页讲的是直连 Claude API（api.anthropic.com）与 Console 密钥。云厂商渠道使用各自 IAM 与计费，见官方 Claude on AWS / Google Cloud / Azure 文档。

创建房间