Claude API Key 由 Anthropic 的 Claude Console 统一管理,入口是 platform.claude.com,登录后进入 Settings → API keys → Create key,生成以 sk-ant- 开头、只完整显示一次的密钥。调用走 https://api.anthropic.com/v1/messages,设置 ANTHROPIC_API_KEY 环境变量或 x-api-key 请求头即可。 Claude API 官方入口与 Claude.ai 的区别
Claude 生态的入口比想象中多,新手最常见的错误是在 claude.ai 里注册了半天,最后发现拿不到 API Key。几个入口的作用先分清: - Claude Console(控制台):platform.claude.com,创建与管理 API Key、查看用量与账单的主入口;console.anthropic.com 是同体系的旧地址。
- API Keys 页面:Settings → API keys(即 platform.claude.com/settings/keys),创建、吊销密钥。
- 官方 API 文档:docs.anthropic.com / platform.claude.com/docs,接口说明、模型列表、错误码参考。
- 官方定价页:platform.claude.com/docs/en/about-claude/pricing,按模型列出每百万 token 单价与缓存费率。
- 官方状态页:status.anthropic.com,跟踪 api.anthropic.com、Claude Code 等组件实时状态。
- Claude.ai(网页/客户端):面向普通用户的聊天产品,Pro / Max 订阅在此生效,不提供 API Key。
注意区分:Claude 订阅是按席位包月(Pro 约 20 美元/月、Max 分档),买的是聊天产品使用权益;Claude API 是按 token 后付费,面向程序调用。两者可以共存但账目独立——订阅了 Pro 并不会自动获得 API 访问,反之 API Key 也不包含订阅权益。Claude Code 两种方式都能登录,但这是两把不同的「钥匙」。
中国大陆不在 Anthropic 官方支持地区列表中,这是注册前必须确认的前提;Claude 订阅(Pro/Max)与 API 按量计费是两套体系。
Claude API Key 创建步骤与密钥类型
从零到第一次调用,全程大约十分钟:
- 打开 platform.claude.com,用邮箱注册账号并登录(如已有 Claude.ai 账号可共用登录体系);
- 进入 Settings → API keys 页面(路径为 platform.claude.com/settings/keys);
- 点击 Create key,为密钥命名、选择过期时间;
- 选择密钥类型:个人密钥(Personal key,以你的身份运行,适合自己开发调试)、服务账户密钥(Service account key,代表一个服务账户,适合 CI / 生产 / 代理等共享负载);工作区密钥为旧版,官方建议新集成优先用前两种;
- 可将密钥范围限定到特定工作区(Workspace);
- 点击创建后,完整密钥只显示一次,以 sk-ant- 开头,立即复制并存入密码管理器或密钥管理服务,关掉弹窗就再也看不到了;
- 将密钥写入环境变量:export ANTHROPIC_API_KEY="sk-ant-...",官方 SDK 会自动读取;
- 用一条 curl 或最小 SDK 示例验证密钥:POST https://api.anthropic.com/v1/messages,请求头带 x-api-key 与 anthropic-version: 2023-06-01。
密钥类型选择建议:个人开发与脚本用个人密钥;任何会被多人或自动化共享的场景(CI 流水线、后台服务、Agent 工作负载),请让组织管理员创建服务账户并生成服务账户密钥——个人密钥会随创建者离开组织而失效,服务账户密钥的权限边界更清晰。
Claude API Key 的注意事项
- 密钥只显示一次:sk-ant- 开头的完整密钥仅在创建弹窗中展示,遗失后无法在控制台再次查看,只能删除重建。
- 别买第三方转售 Key:非官方渠道的 Claude Key 随时可能被吊销,还可能把你的请求数据转手给不明服务商。
- 环境变量与头文件:请求时用 x-api-key 头或 ANTHROPIC_API_KEY 环境变量;记得带上 anthropic-version 版本头,缺失会报错。
- 地区与合规:中国大陆不在 Anthropic 官方支持地区列表中,使用官方渠道需满足其地区政策;企业若需合规落地,可评估 AWS Bedrock、Google Vertex AI、Microsoft Foundry 等云厂商托管渠道,各地区可用性与条款需自行核实。
- 错误码只有两类需要重试:429 与 5xx / 529。4xx(400/401/403/404/413)改请求就好,重试无效。
Claude 模型清单与最新 API 价格
价格整理自 Anthropic 官方定价页与多方交叉核对,核查时间 2026 年 9 月 9 日,单位为美元 / 每百万 token。Claude API 采用扁平计价,同一费率不按上下文长度跳档:
| | | | | | |
|---|
| | | | | | 最新旗舰(2026-09-01 发布),长程 Agent 任务 |
| claude-opus-5 / claude-opus-4-8 | | | | | |
| | | | | | 主流工作负载首选,Agentic 能力接近 Opus 档 |
| | | | | | |
| | | | | | |
几个值得注意的事实:Claude Sonnet 5 于 2026 年 6 月 30 日发布,最初 $2/$10 是发布促销价、原计划 9 月起涨到 $3/$15——但 Anthropic 在 2026 年 9 月 1 日确认维持 $2/$10 标准价,涨价取消;同日发布的 Fable 5.1 成为新旗舰。输出价恒为输入的 5 倍,是预算 Claude 支出时最重要的经验法则。
省钱机制:Prompt Caching 缓存读取约 10%(输入价的一折),系统提示词与长文档复用场景可省近九成输入成本;Batch API 约 5 折,适合 24 小时内出结果即可的非实时任务;固定上下文低于阈值(部分新模型低至 512 token)也可参与缓存。缓存写入按 1.25 倍输入价(5 分钟 TTL)或 2 倍输入价(1 小时 TTL)计费。
Claude API 计费规则与试用额度
Claude API 采用按量后付费:先调用、后按 token 结算,输入与输出分开计价。账户层面有两种「墙」要分清:速率限制(每分钟请求数 RPM、输入 token 每分钟 ITPM、输出 token 每分钟 OTPM)与支出上限(你或组织在 Console 设置的月度 spend cap)——前者返回带 Retry-After 的 429,后者返回没有 Retry-After 的 429,会一直失败直到上限调整或重置。
关于免费/试用额度:Anthropic 对新账号与开发层级的赠送政策并不固定,历史上曾为新用户提供小额试用 credit;2026 年的政策请以 Console 的 Billing / Usage 页面实时显示为准,不要轻信教程里写死的「送 X 美元」。账户余额不足会报 credit_balance_error 类错误,需在 Console 充值或开启自动充值。
另外提醒:缓存命中的输入 token 在大多数模型上不计入 ITPM 限流,所以善用缓存不仅能省钱,还能变相放宽每分钟的输入吞吐上限——这是很多人忽略的「隐藏福利」。
Claude API 常见报错与排查
错误响应永远包含 error.type、error.message 与 request_id 三个字段,排查先看 type 定方向、留好 request_id 便于提工单。核心口诀:4xx 改请求,429 降速等,5xx / 529 退避重试。
| | | |
|---|
| | 请求格式或内容有问题,也可能表示触达了组织/工作区支出上限 | 检查请求体、messages 结构与参数;若为支出上限则去 Console 调整 |
| | | 核对密钥完整性,重新生成或更换 Key,确认环境变量已加载 |
| | | |
| | | |
| | | |
| | | |
| | 请求超过体积上限(Messages API 约 32MB) | |
| | | 按 Retry-After 退避;支出类 429 无 Retry-After,需处理额度而非重试 |
| | | 指数退避重试,持续出现则带 request_id 联系支持 |
| | | |
| | API 暂时过载(Anthropic 独有状态码) | 指数退避重试,通常数秒到数分钟恢复;持续则查官方状态页 |
官方 SDK 默认对瞬时错误(连接中断、限流、5xx)自动做指数退避重试,默认最多两次,可通过 max-retries 参数调整;自己写重试时务必加随机抖动(jitter)并设最大次数,避免所有客户端在同一时刻打爆服务。
Claude API 常见问题
Q:Claude API 有免费的吗?
A:Anthropic 没有长期免费的公开额度,新账号是否有试用 credit 以 Console Billing 页面为准;开发层级有免费的低限额档位用于测试,但正式生产需要付费或升级层级。
Q:买了 Claude Pro / Max 订阅还需要 API Key 吗?
A:Claude Code 用订阅登录即可,但那是「聊天产品身份」;想让自己的程序调用 Claude 模型,必须单独创建 API Key 并按量付费,两套账目独立。
Q:Key 在哪创建?丢了怎么办?
A:platform.claude.com → Settings → API keys → Create key。完整密钥只显示一次,丢了无法找回,删除重建即可。
Q:个人密钥、服务账户密钥和工作区密钥有什么区别?
A:个人密钥以你的身份运行、随你离开组织而失效;服务账户密钥代表独立服务身份,适合 CI 与生产共享负载;工作区密钥是旧版无主密钥。新集成优先用前两种。
Q:调用地址和请求头怎么填?
A:POST https://api.anthropic.com/v1/messages,请求头带 x-api-key、anthropic-version(如 2023-06-01)与 Content-Type: application/json。SDK 会自动处理。
Q:中国大陆能用 Claude API 吗?
A:官方层面不支持——中国大陆不在 Anthropic 官方支持地区列表中。请以官方支持地区页面的最新公布为准;企业合规落地可评估 AWS Bedrock、Google Vertex AI、Microsoft Foundry 等官方云托管渠道,各地区可用性需自行核实。
Q:国内开发者有什么合规替代方案?
A:思路有三条——使用受支持地区的合规身份与结算方式接入官方 API;通过云厂商托管渠道(Bedrock / Vertex AI / Foundry)走企业采购;或评估国产大模型 API(如 GLM、豆包、千问、DeepSeek 等)在能力与成本上的替代性。 Q:429 一直报,是重试不够还是别的问题?
A:先看有没有 Retry-After 头。有 → 真限流,按它等待;没有 → 大概率是触达支出上限(spend cap),重试无效,去 Console 调整预算。另外注意区分 429(你的问题)与 529(Anthropic 过载)。
Q:529 overloaded_error 是什么?
A:Anthropic 独有状态码,表示服务端暂时过载而非宕机。正确姿势是指数退避重试(从 1 秒起、加抖动、设上限),高峰通常几分钟内恢复,必要时临时切到较轻量的模型。
Q:哪个模型最划算?
A:默认从 Claude Sonnet 5($2/$10)起步,Agentic 能力接近 Opus 档且便宜得多;高吞吐简单任务用 Haiku 4.5;真正高难度推理与研究再上 Opus 5 / 4.8;最重的前沿任务才需要 Fable 5.1。
Q:输出为什么总是比想象中贵?
A:因为输出价恒为输入的 5 倍。控制 max_tokens、精简单轮上下文、让模型少输出冗长内容,是省 Claude 费用的头号杠杆;深度思考类模型的思维过程也计入输出。
Q:长文档怎么省钱?
A:用 Prompt Caching 缓存固定系统提示词与大段上下文,缓存读取价约为输入价的一折;固定上下文长度足够小时(新模型低至 512 token 起)也能命中缓存。非实时任务再叠 Batch 5 折。
Q:模型会不会突然下线?
A:会,且下线通知期有限。2026 年已下线 Haiku 3.5、Opus 4.1、Sonnet 4 与 Opus 4 等旧模型,请求会直接失败。生产代码请关注官方模型列表与弃用公告,把模型 ID 做成配置项。
Q:报错里的 request_id 有什么用?
A:每个响应都带 request_id,是定位单次请求的唯一凭证。排查、提工单、找官方支持时务必附上它。
以上内容仅供参考,Anthropic 的模型版本、价格、额度政策与地区支持范围可能随时调整,请以 platform.claude.com 官方文档与控制台页面的最新公布为准。