Claude API 国内使用指南（2026）：价格、API Key 申请与充值、调用方法、中转怎么选

价格和规则取自 Anthropic 官方文档（2026 年 10 月 17 日，与 10 月 15 日的价格一致）；调用写法在本机用测试密钥逐个跑过，报错原文来自真实返回。用 Claude Code 写代码的，看 Claude Code 接中转站配置教程；本文讲的是在自己的程序里调用 Claude API。

价格（2026 年 10 月）

单位：美元 / 每百万 token。

还在提供的老模型：Opus 5 输入 5 美元、输出 25 美元；Sonnet 4.6 输入 3 美元、输出 15 美元；Haiku 4.5 输入 1 美元、输出 5 美元。新模型反而更便宜，没有特殊原因就换到 5.5 系列。

怎么选：

• Sonnet 5.5：大多数应用和编程助手的默认选择。
• Opus 5.5：最难的推理和长时间自主任务，价格只是 Sonnet 的两倍。
• Haiku 5.5：分类、提取、简短回复这类大量的简单任务，比 Sonnet 便宜 20 倍。
• Fable 5.1：最强档，价格是 Opus 5.5 的 2.5 倍。

三个省钱的办法

1. 用缓存。同样的系统提示词、工具定义、参考文档每次都重发时，开启缓存后，命中的部分 Opus 5.5 和 Sonnet 5.5 只收输入价的 5%，Fable 5.1 只收 2.5%，其他模型收 10%。写入缓存要多付一点（5 分钟缓存 1.25 倍，1 小时缓存 2 倍），读一次就回本。
2. 用批量接口（Batch API）。能等几个小时出结果的任务，输入输出都打五折，还能和缓存叠加。
3. 控制输出长度。现在所有模型的输出价都是输入价的 5 倍，设好 max_tokens，让回答简短些。

另有「快速模式」（fast mode），Opus 5.5 输入 8 美元、输出 40 美元，换更快的输出速度，一般用不到。更细的价格规则见英文版 Claude API pricing，里面有费用计算器。

Claude API 和 Claude 会员不是一回事

很多人以为开了 Claude Pro 就能调 API，其实是两套东西：

Max 套餐每月附带一定的 API 额度（Max 5x 100 美元、Max 20x 200 美元），Pro 不带。

官方怎么申请 API Key、怎么充值

1. 在 Claude Console 注册账号。
2. 充值：打开 Settings → Billing，绑定信用卡，购买额度（credits）。调用按用量从余额里扣。新账号有少量测试额度。
3. 创建密钥：打开 Settings → API keys（platform.claude.com/settings/keys），点 Create key，起个名字，选过期时间。
4. 马上复制：密钥以 sk-ant- 开头，只在创建时完整显示一次，丢了只能新建。
5. 设成环境变量 ANTHROPIC_API_KEY，官方 SDK 会自动读取。

新账号的限额和消费上限：

• 新组织可能先在 Evaluation 档，限额比标准低，用一段时间后自动升级。当前档位和限额在 platform.claude.com/usage/limits 查看。
• 每个档位有每月消费上限：Start 档 500 美元、Build 档 1,000 美元、Scale 档 20 万美元。到了上限，API 会暂停到下个月 1 日 0 点（UTC，北京时间早上 8 点），期间请求返回 429，重试也没用，只能申请提高上限。

国内能不能用

• Anthropic 官方的支持地区列表里没有中国大陆、香港和澳门（台湾、新加坡在列）。注册 Console 账号、绑卡付款都要求在支持的地区。
• 所以国内开发者常见的做法是：通过提供 Claude 模型的第三方 API 服务调用。对代码来说只是改一个地址、换一个密钥，请求格式和官方一样。
• 数据会经过服务商。涉及敏感数据或者对外提供服务的，先看服务商的隐私条款，并遵守所在地的相关规定。

「买 Claude API Key」要分清三种情况

搜「claude api key 购买」的人很多，市面上其实是三种不同的东西：

选第三方服务时，Claude 要多测这几项

通用的挑选方法见 API 中转站是什么？怎么选不踩坑。Claude 有几处特别的地方，值得单独测：

1. 缓存有没有生效。按上面的方法加 cache_control，把同一个长提示词连发两次，看第二次返回的 usage 里 cache_read_input_tokens 是不是有几千。一直是 0，或者缓存读取也按全价扣费，长对话会贵好几倍。
2. 模型名是不是官方的。claude-sonnet-5-5、claude-opus-5-5 这类官方名字能直接用，说明服务商对接得比较规范；用 Claude Code 时尤其重要，因为它按官方名字发请求。
3. 长提示词怎么计价。Haiku 5.5 超过 10 万 token 后官方价格变成 5 倍，看服务商有没有照这个规则算，还是有别的算法。
4. 思考、工具调用、图片、PDF 能不能用。用 Claude 原生接口（/v1/messages）调用，这些功能才最完整。

调用示例

官方：curl

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-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

官方：Python SDK

先安装：pip install anthropic。

import anthropic

client = anthropic.Anthropic()  # 自动读取环境变量 ANTHROPIC_API_KEY
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)
print(msg.usage)  # 看 input_tokens、output_tokens、cache_read_input_tokens

通过第三方服务调用（以 api.foo 为例）

官方 SDK 用 base_url 换地址，写到域名为止，不加 /v1（SDK 会自己拼 /v1/messages）：

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["APIFOO_API_KEY"],
    base_url="https://api.foo",
)
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)

已经用 OpenAI SDK 写好的程序，也可以直接调 Claude，地址是 https://api.foo/v1，模型名写 claude-sonnet-5-5。不过 Claude 的思考、缓存、PDF 等功能用原生接口更完整。

我们用测试密钥把这两种写法都跑了一遍（anthropic 1.15.0、openai 3.32.0），服务器日志显示请求分别到达 /v1/messages 和 /v1/chat/completions，地址和格式都对。可用的模型和价格见 api.foo 模型广场。

常见报错

报错原文可以直接复制到页面里搜索（Mac 按 Cmd+F，Windows 按 Ctrl+F）。

401 invalid x-api-key：密钥不对

{"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"},"request_id":"req_…"}

Python SDK 里是 anthropic.AuthenticationError: Error code: 401。如果是 x-api-key header is required，说明请求里根本没带密钥。走官方 OpenAI 兼容接口时，原文是 Invalid Anthropic API Key。怎么办：重新复制密钥，注意前后不要有空格；检查密钥是否过期、被删除。

429 rate_limit_error：超出限额或月度上限

两种情况都是 429：

• 请求太快：返回里带 retry-after，等一会儿重试，官方 SDK 会自动重试。
• 到了月度消费上限：报错里有 enforced_spend_limit_reached，写着下个月几号恢复。重试没用，只能在 Console 申请提高上限，或者等下个月。

529 overloaded_error：官方繁忙

Anthropic 那边临时负载过高。怎么办：稍后重试，按 1、2、4、8 秒逐步拉长间隔。

400 invalid_request_error：请求格式不对

常见原因：

• 4.6 及以后的模型不支持「预填」（把最后一条消息设成 assistant 让模型接着写），会返回 400。
• 4.7 及以后的模型不支持 thinking: {"type": "enabled"} 的老写法，要改用自适应思考。
• max_tokens 没填，或者超过了模型上限。

怎么办：看报错的 message 说的是哪个参数，对照官方文档改。

402 billing_error、403 permission_error、404 not_found_error

• 402：付款信息有问题或者余额不足，去 Console 的 Billing 页面处理。
• 403：这把密钥没有权限访问这个资源，比如属于别的工作区。
• 404：多半是模型名写错了，比如写成 claude-sonnet-5.5（点号）而不是 claude-sonnet-5-5（横线）。

用第三方服务时的报错

格式由服务商决定。比如 api.foo 这类基于 New API 搭建的服务，密钥不对是 401 无效的令牌，余额不够是 用户额度不足，模型不在这把密钥的分组里是 无可用渠道。更多见 API 报错排查大全。

相关阅读

• Claude Code 接中转站 / 第三方 API 配置教程
• API 中转站是什么？怎么选不踩坑
• Gemini API 国内使用指南
• API 报错排查大全
• 英文版：Claude API pricing（含计算器）、How to get a Claude API key

参考资料

Anthropic 官方文档，2026 年 10 月 17 日查阅：价格、获取 API Key、限额、错误、支持地区、提示词缓存、OpenAI SDK 兼容。