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 删除或撤銷；外洩 suspected 时立即撤銷并检查 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 文档。

建立房間