Claude APIClaude API KeyClaude API 价格API 调用错误码Claude API 中转

Claude API 完整使用指南 - 申请、Key 获取、调用、错误码

Claude API 怎么用？本文详解 Claude API key 申请、获取、调用方式、平台对比、常见错误（400 / 403）排查与中转方案。

· 阅读约 13 分钟

“Claude API 如何使用”、“Claude API key 怎么获取”、“Claude API 怎么购买”——这是开发者接入 Claude 的第一道门槛。本文系统讲清楚 Claude API 的申请流程、key 管理、最小可运行调用示例、价格、常见错误码排查，以及国内开发者特别关心的 Claude API 中转方案。

注意：本文所有具体定价、限额、官方政策都可能随时间调整，请以 Anthropic 官方文档为准。

什么是 Claude API

Claude API 是 Anthropic 提供的程序化访问入口。它和 claude.ai 网页版的关系是：网页版是给最终用户用的产品，API 是给开发者把 Claude 能力嵌入自己应用的接口。

通过 Claude API，你可以：

  • 用代码批量调用 Claude 模型
  • 在自己的产品里接入 Claude 能力
  • 用 Claude Code、Cursor、Continue 等开发工具
  • 走 Batch / Caching / Vision / Tool Use 等高级特性

API 地址：https://api.anthropic.com，采用 RESTful + JSON，所有主流语言都能调。

怎么申请 Claude API Key

前置条件：

  • 国际网络（国内 IP 默认无法访问 console）
  • 海外手机号或可收验证码的邮箱
  • 海外信用卡或其它支持的支付方式

步骤：

  1. 浏览器打开 https://console.anthropic.com
  2. 用邮箱注册账号
  3. 验证手机号（必须是支持的国家，国内 +86 不可用）
  4. 进入 Billing 页面，添加 Payment Method
  5. 选择 Build / Scale 套餐，预充值或开通后付费
  6. 进入 API Keys 页面，点击 Create Key
  7. 复制 key（形如 sk-ant-...），只显示一次，妥善保存

如果你不打算自己注册，可以用第三方中转，跳过手机号 / 信用卡环节，后文专门讨论。

海外手机号 / 信用卡的国内变通

国内开发者最常卡在两个地方：

卡点常见做法
手机号实体海外卡 / 长期可收码的虚拟号
信用卡海外信用卡 / 虚拟信用卡（如部分平台发行的 Visa 充值卡）

请注意：用国内身份信息申请的虚拟卡，账号风控被检测到时有被封停的可能，且 Anthropic ToS 不允许账号转售。

API Key 管理

创建 key 后，控制台支持：

  • 命名 key（按用途区分，如 prod-bot、dev-test）
  • 单独撤销某个 key
  • 设置 spending limit（用量上限，防止刷爆）
  • 查看每个 key 的近期用量

安全建议：

  • 永远不要把 key 写进前端代码或公开仓库
  • 在 GitHub Actions / Vercel 等环境用环境变量注入
  • 定期轮换 key，发现泄露立刻 Revoke

Claude API 调用最小示例

下面是三个最小可运行示例，输入 “你好，请用一句话介绍你自己”。

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-4-6",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

Python

import os
from anthropic import Anthropic

client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=256,
    messages=[
        {"role": "user", "content": "你好，请用一句话介绍你自己"},
    ],
)
print(resp.content[0].text)

安装 SDK：pip install anthropic

TypeScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

const resp = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 256,
  messages: [{ role: "user", content: "你好，请用一句话介绍你自己" }],
});

console.log(resp.content[0].text);

安装 SDK：npm i @anthropic-ai/sdk

模型 ID（如 claude-sonnet-4-6、claude-opus-4-7、claude-haiku-4-5）以官方 model 列表为准。

Claude API 价格

截至本文撰写时，主力模型 API 价格的近似值（每百万 token，具体以官方为准）：

模型输入 ($/M)输出 ($/M)
Claude Haiku 4.5约 0.80约 4
Claude Sonnet 4.6约 3约 15
Claude Opus 4.7约 15约 75

详细的成本估算公式和省钱手段，可参考本站 Claude 收费完整解析一文。

常见错误码排查

调用 Claude API 时，HTTP 状态码 + 响应体中的 error.type 是排查关键。

状态码error.type含义排查方向
400invalid_request_error请求结构有问题检查 JSON、必填字段、模型 ID
401authentication_errorAPI key 错 / 缺检查 header x-api-key 是否正确
403permission_error权限不足 / 区域受限账号被风控 / IP 在受限地区
404not_found_error路径或资源不存在检查 endpoint、model 拼写
413request_too_large请求体过大拆分请求或减少上下文
429rate_limit_error触发速率限制退避重试 / 升级套餐
500api_error服务端错误重试，多次出现联系支持
529overloaded_error服务过载退避重试

Claude Code API Error 400 经常出现的几个根因：

  • 模型 ID 拼错（如多了个空格、版本号过期）
  • max_tokens 漏填或为 0
  • messages 数组为空
  • 工具调用格式不符合最新 schema

Claude Code API Error 403 经常出现的根因：

  • API key 已被撤销
  • 账号被风控（多见于共享 / 中转账号）
  • 在 ToS 限制地区直接调用官方 API

Claude Code API 配置

Claude Code 默认连官方 API，但可以通过环境变量或配置文件改后端。

环境变量方式：

# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-xxxx"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

# Windows PowerShell
$env:ANTHROPIC_API_KEY = "sk-ant-xxxx"
$env:ANTHROPIC_BASE_URL = "https://api.anthropic.com"

配置文件方式：

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

接入中转：

只需把 ANTHROPIC_BASE_URL 改成中转地址，其它代码一行都不用动：

export ANTHROPIC_BASE_URL="https://your-relay.example.com"

这是 Claude Code 设计上对替代后端的官方支持。

Claude API 接口测试

调通新 key 的最快方式是用 Postman 或 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-haiku-4-5",
    "max_tokens": 32,
    "messages": [{"role":"user","content":"ping"}]
  }'

返回 200 + 一段文本 → 通了。 返回 401 → key 不对。 返回 403 → 权限 / 地区问题。 连不上 → 网络问题。

Claude API 如何使用 Skills

Skills 是 Anthropic 推出的能力扩展（类似工具调用 + 内置上下文的组合），让 Claude 可以加载特定领域的预制知识与流程。

在 API 中使用 Skills 的关键点：

  • 通过 extra / headers 字段或最新 SDK 提供的参数启用
  • 指定 skill 名称，模型会在响应中按 skill 的指引执行
  • 部分 skill 需要 beta 标记 header

最小示例（伪代码，具体字段以官方文档为准）：

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[...],
    extra_headers={"anthropic-beta": "skills-2025"},
)

实际开发时，请直接对照 Anthropic 官方 Skills 文档，因为参数细节和 beta header 名会随时间调整。

Claude API 中转方案

“Claude API 中转”是国内开发者绕不开的话题。中转的本质是一个中间服务器，对外暴露兼容 Anthropic 协议的接口，对内代你访问 Anthropic API。

请求路径：

你的应用 → 中转服务器 → api.anthropic.com → 返回

中转之所以存在，是因为国内 IP 直连官方会被拒，且海外信用卡门槛挡住了很多用户。

主流中转方式

类型说明优点风险
自建 Cloudflare Workers自己写脚本反代可控、便宜仍需海外账号
自建 VPS国内可达的 VPS 反代完全可控运维成本
商业中转平台第三方提供 endpoint即开即用数据隐私 / 跑路风险
国内 AI 聚合平台把 Claude 集成进多模型平台接入快、统一计费合规 / 模型替换风险

中转价格差异主要来自：

  • 是否真的转发到官方 Claude（vs 模型替换）
  • 是否共享账号摊薄成本
  • 是否做 prompt caching 帮你省 token
  • 平台自己的毛利空间

便宜得离谱的多半是模型替换或共享号，长期不稳定。

怎么购买 Claude API

正规渠道：

  1. console.anthropic.com 注册
  2. 添加海外信用卡
  3. 充值或开通自动扣费
  4. 创建 key 开用

第三方渠道：

  • 国内中转平台按次或按 token 充值
  • 信用卡代付服务（注意风控）
  • AWS Bedrock / GCP Vertex AI（企业推荐）

无论哪种，API key 都要按敏感凭据管理：不要发群、不要写死、定期轮换。

调试技巧

1. 用 Postman 先打通

新 key 第一次用，先在 Postman 里发同样的请求，确认能返回。之后再把成功的请求复制到代码里。

2. Python SDK 错误处理

from anthropic import APIStatusError, RateLimitError

try:
    resp = client.messages.create(...)
except RateLimitError:
    # 退避重试
    ...
except APIStatusError as e:
    print(e.status_code, e.response.text)

3. 打印完整请求

调试时把请求 URL、header（去掉 key）、body 全打出来，对比官方文档示例最容易找出差异。

4. 用 Haiku 调试

调试逻辑时用 Claude Haiku 4.5，便宜十几倍，调通了再切 Sonnet / Opus。

FAQ

Q：API key 泄露了怎么办？ 立即到控制台 Revoke 该 key，并检查近期账单是否有异常用量。

Q：能用一个 key 多人共享吗？ 技术上能，但违反 ToS 且容易撞限速。生产环境给每个服务发独立 key 更好管理。

Q：API 用量怎么监控？ console.anthropic.com → Usage 页面有每日 / 每个 key 用量。生产建议自己加埋点记录 prompt + completion token。

Q：API 接入 Claude Code 后怎么算钱？ Claude Code 只是客户端，钱按它实际调的 API 走。调官方就是官方价，调中转就是中转价。

Q：claude code api error 400 / 403 怎么排查？ 400 看请求体格式（模型 ID、max_tokens、messages），403 看 key 状态和地区。具体见上文错误码表。

Q：Claude API 中转网站推荐？ 本文不做具体中转商推荐。市场鱼龙混杂，需要自己评估服务稳定性、模型真实性、合规风险。详见本站 Claude 中转站完整指南。

小结

接入 Claude API 的标准路径：

  1. 注册官方账号 → 创建 key → 跑通最小示例
  2. 用 Haiku 调试逻辑，再切到主力模型
  3. 用环境变量管理 key，不写死、不公开
  4. 监控用量 + 设置 spending limit
  5. 国内场景，要么走中转、要么走 Bedrock / Vertex
  6. 出错先看状态码 + error.type，对照本文错误码表

Claude API 的接入面其实不复杂，难点在 key 拿到之前的注册环节，和大规模使用时的成本控制。