Claude Console 怎么用？从登录到第一次 API 调用

Q: API Key 在哪里创建？

登录 Claude Console 后进入 API keys 页面，点击创建 Key，设置名称、有效期、关联账户和 Workspace 范围。完整 Key 应在创建后立即安全保存。

更新于 2026-10-23 · claudecn.cyou

简答：Claude Console 是管理 Claude API 的开发者控制台。新手按“登录→创建组织→准备额度→生成 API Key→Playground 测试→代码调用”操作即可；Claude.ai 聊天界面与 API 控制台用途不同。

定义：Claude Console 是用于管理组织、额度、API Key、工作区和 Playground，并接入 Claude API 的开发者控制台。

先看 5 步速查：Claude Console 到第一次调用

登录或注册：进入 Claude Console，完成账号登录和组织初始化。
准备额度：按组织页面提示补充资料、绑定支付方式并购买使用额度；符合条件的 Max 或 Team 方案可按官方规则关联组织领取月度 API 额度。
创建 API Key：进入 API keys 页面，设置名称、有效期、关联账户和工作区范围。
打开 Playground：选择模型，填写 system prompt 和 user prompt，运行并查看响应、Token 用量及原始请求。
导出代码：在 code 视图复制请求，再用环境变量保存密钥，接入 Python 或其他 SDK。

本站是非官方的使用指南站，Claude Console 的具体入口、组织资格和计费规则应以官方页面为准。官方说明显示，Console 可用于创建 API Key、设置账单和在 Playground 中试用 Claude；Playground 直接建立在公开的 Messages API 上。可查看Claude API 访问说明和Playground 使用说明。

Claude.ai、Claude Console、Claude API、Claude Code 怎么区分

名称	主要用途	与 API Key 的关系
Claude.ai	在网页中与 Claude 对话	聊天入口，不等同于 API Key
Claude Console	管理组织、额度、工作区、API Key 和 Playground	创建和管理 API Key 的控制台
Claude API	由程序通过接口调用 Claude	需要 API Key 或其他官方认证方式
Claude Code	面向终端或开发环境的编码工具	使用规则和认证方式应按其官方文档配置

官方将 Chat、移动端、桌面端以及 Claude Console/API 列为不同访问界面，因此不要把“能在 Claude.ai 聊天”直接理解为“已经具备可调用 API 的组织额度和 Key”。相关界面说明见官方访问界面对照。

注册登录、创建组织并准备 API 额度

打开 Claude Console，使用页面支持的方式注册或登录。
首次进入时，按页面要求填写组织名称、实体类型、所在国家或地区及使用场景等信息。
组织创建后，确认当前选中的组织和 Workspace。多人协作时，组织成员、角色和权限会影响 Playground、API Key、用量与账单页面的可见范围。
如果要使用 API 或 Playground，需要组织余额中有可用使用额度。官方流程包括补充组织及使用场景信息、填写支付信息并为账户充值。
如果账号属于符合条件的 Max 订阅者或 Team 方案所有者，可以按官方流程把 Console 组织与方案关联，以领取月度 API 额度；是否符合资格应以账户页面显示为准。

Console 的额度、账单和 API 使用不是一个简单的“登录后自动可用”关系。遇到 Playground 无法运行或余额不足时，先检查组织余额、账单状态和当前 Workspace，再检查 Key 与请求本身。额度流程可参考创建 Console 组织后如何开始使用 API。

创建 API Key：认证方式、工作区与安全保存

进入 Claude Console 的 API keys 页面：https://platform.claude.com/settings/keys。
点击创建 Key，设置名称和有效期，并选择个人 Key 或服务账户 Key；也可以把 Key 限定到单一 Workspace。
创建后立即复制完整 Key。不要把它写进前端代码、公开仓库、截图或日志。
本地程序优先使用环境变量 ANTHROPIC_API_KEY。官方 SDK 可以自动读取该变量。
怀疑泄露时，先在 Console 中禁用或删除旧 Key，再创建新 Key 并更新服务端配置。

当前官方认证文档将 Authorization: Bearer <key> 作为 API Key 的直接认证方式，同时说明旧的 x-api-key 请求头仍受支持。为减少新旧写法混淆，本文示例使用 Authorization；如果现有程序使用 x-api-key，不必因为这一点单独改造。完整规则见官方 Authentication 文档。

如果创建的是未限定单一 Workspace 的 API Key，请在请求中提供 anthropic-workspace-id；限定到单一 Workspace 的 Key 可以省略该请求头。缺少必要的 Workspace ID 时，官方文档说明可能返回 400 请求错误。

检查变量时不要打印密钥内容，只输出是否为空或长度：

test -n "$ANTHROPIC_API_KEY" && echo 'API key is set' || echo 'API key is empty'
printf '%s\n' "${#ANTHROPIC_API_KEY}"

用 Playground 测试模型、提示词和原始请求

登录 Console，在导航中选择 Playground。
如果组织使用多个 Workspace，先选择要使用的 Workspace。
在模型选择器中选择当前账户可用的模型，不要直接照抄搜索结果中的旧模型名。
在 system prompt 中写角色、任务、输出格式和限制条件；在 user prompt 中填写实际输入。
点击 Run，检查响应、停止原因、Token 用量和 usage 信息。
需要测试工具调用或结构化输出时，添加对应定义，并查看返回的工具调用和结果结构。
打开 code 视图导出当前请求，再把密钥改为环境变量读取。

当前 Playground 取代了旧 Workbench，用于试用模型和 API 功能。它不保存提示词历史或评估记录，当前草稿保存在浏览器中；因此重要提示词应自行保存。官方说明还指出，Playground 展示的原始请求和响应与应用通过 Messages API 发送和接收的结构相对应。

Python 与 curl 最小验证示例

先准备环境变量，不要把真实密钥写进代码或命令历史。Python SDK 的安装和读取方式以官方文档为准：

python3 -m venv .venv
source .venv/bin/activate
pip install anthropic
export ANTHROPIC_API_KEY='仅在本地环境设置'

创建 quickstart.py：

import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="<MODEL_ID>",
    max_tokens=128,
    messages=[
        {"role": "user", "content": "请用一句话说明 API 调用成功"}
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

运行：

python quickstart.py

如果需要绕过 SDK，使用最小 HTTP 请求验证认证、额度和请求格式：

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: <API_VERSION>" \
  -H "content-type: application/json" \
  -d '{"model":"<MODEL_ID>","max_tokens":128,"messages":[{"role":"user","content":"请用一句话说明 API 调用成功"}]}'

<MODEL_ID> 和 <API_VERSION> 必须替换为当前官方文档或 Console 可用的值。Python 示例可参考官方 Python SDK 文档，请求头和接口结构可参考官方 API overview。

费用、Token、用量和限额怎么理解

API 使用通常围绕输入 Token、输出 Token、组织额度和速率限制管理。Token 可以理解为模型处理文本时使用的计量单位；实际价格、模型费率和计费细节应以官方定价页及账户页面为准，本文不列未经核验的价格。

在 Console 的 Usage 页面查看请求、Token 和使用情况。
在 Billing 页面查看组织账单，并设置低于组织上限的自定义支出限制。
在 Rate limits 页面查看当前组织的速率限制和使用层级。
把开发、测试和生产请求分配到合适的 Workspace，便于区分用量和控制支出。

官方限额文档区分了支出限制和速率限制；达到自己设置的支出限制时可能返回 400，触发速率或月度上限时可能返回 429。可查看官方 Rate limits 文档了解当前页面和限制说明。

常见故障速查：现象、原因与自查方法

现象	可能原因	自查方法
无法登录或反复回到登录页	账号验证、组织邀请或登录状态未完成	重新完成验证，确认登录的是正确账号；若加入团队，向组织管理员确认邀请和登录方式。
Playground 找不到或无法运行	未选择正确组织或 Workspace，组织没有可用额度，或账号角色权限不足	确认组织、Workspace、余额和角色；官方角色说明可查看是否具备 Playground 或 API Key 权限。
401 authentication_error	Key 格式错误、已撤销、已过期或未正确发送	检查环境变量是否为空、请求头是否为 Authorization Bearer，确认 Key 状态并重新创建。
403 permission_error	Key 对目标资源、组织或 Workspace 没有权限	检查 Key 类型、关联账户、Workspace 范围和组织角色。
404 not_found_error	接口路径、资源 ID 或 Workspace ID 不存在	核对请求路径和资源标识，不要把旧模型名或错误 Workspace ID 当成当前值。
429 rate_limit_error	触发请求速率、Token 速率、月度支出上限或 Workspace 限制	查看响应中的 retry-after；同时到 Usage、Billing 和 Rate limits 页面判断是速率限制还是支出上限。
没有余额或 billing_error	组织支付信息或可用额度存在问题	检查 Billing 页面、组织余额和支付状态；符合条件的方案额度按官方页面关联。

错误码含义应以官方错误文档为准：401 对应认证问题，403 对应权限问题，404 对应资源不存在，429 可能对应速率或支出限制。官方还建议保留响应中的 request_id，便于进一步排查。详见Claude API errors和Console 角色与权限说明。

结论：新手应该怎样判断是否配置成功

Console 能打开，且当前组织与 Workspace 正确。
组织有可用额度，或账户页面明确显示已关联的官方额度。
API Key 未过期、未禁用，环境变量非空。
Playground 能运行并显示响应与 usage。
Python 或 curl 最小请求能返回正常响应，再开始接入自己的工具。

如果只在聊天界面使用 Claude，不需要把 Playground、API Key 和代码调用混在一起；如果要接入程序，则应从 Console 的组织、额度、Key 和最小请求开始逐项验证。

常见问题

Claude Console 是不是 Claude.ai？

不是。Claude.ai 主要用于聊天，Claude Console 用于管理组织、额度、API Key、Workspace 和 Playground。要从程序调用 Claude，还需要完成 Console 侧的额度和认证配置。

Claude Console 一定要充值才能使用吗？

Claude API 和 Playground 需要组织有可用使用额度。部分 Max 或 Team 方案可以按官方规则关联组织领取月度 API 额度，具体资格和流程以账户页面为准。

API Key 在哪里创建？

为什么 API Key 能用，但请求仍然失败？

先检查组织额度、Key 状态、模型值、Authorization 请求头、API 版本请求头、JSON 格式，以及未限定 Workspace 的 Key 是否缺少 anthropic-workspace-id。

429 错误应该一直重试吗？

不要盲目连续重试。先查看响应是否包含 retry-after，并区分速率限制、Token 限制和月度支出上限；同时检查 Console 的 Usage、Billing 和 Rate limits 页面。

参考资料

How can I access the Claude API?（support.claude.com）
I created a Claude Console organization - how do I start using the Claude API?（support.claude.com）
How do I use the playground?（support.claude.com）
What interfaces can I use to access Claude?（support.claude.com）
Authentication（platform.claude.com）
API overview（platform.claude.com）
Python SDK（platform.claude.com）
Rate limits（platform.claude.com）
Claude API errors（platform.claude.com）
Claude Console roles and permissions（support.claude.com）