Claude学院

Claude API 怎么调用？从注册到第一次请求完整教程

调用 Claude API 分三步：在 Anthropic 控制台注册账号并创建一个 API Key，安装官方 SDK（Python 用 anthropic，Node 用 @anthropic-ai/sdk），然后向 Messages API 端点 POST /v1/messages 发请求。整个流程跑通最快只要十几分钟，下面逐步拆开讲。

第一步：注册账号并拿到 API Key

访问 Anthropic 控制台（console.anthropic.com）用邮箱注册并完成验证，进入 API Keys 页面点击 Create Key 创建一把密钥。密钥形如 sk-ant-...，只在创建时完整显示一次，务必立刻复制保存。API 调用需要预先充值或绑定额度，具体计费与额度以 Anthropic 官网为准。这一步的细节和常见卡点，可以参考 Claude API Key 怎么获取？2026 最新申请流程。

拿到密钥后，不要硬编码进代码，而是写进环境变量，避免泄露：

# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-你的密钥"

# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-ant-你的密钥"

第二步：理解 Messages API 的核心结构

Claude 现在所有文本对话都走同一个端点：POST https://api.anthropic.com/v1/messages。它有两个必带的请求头：

  • x-api-key：你的 API Key（注意不是 Authorization: Bearer）。
  • anthropic-version：API 版本号，当前用 2023-06-01。

请求体里三个字段几乎每次都要写：model（模型 ID）、max_tokens（本次最多生成多少 token）、messages（对话数组，按 user / assistant 交替）。当前主力模型有三个，按需求选：

模型模型 ID定位
Claude Opus 4.8claude-opus-4-8最强，适合复杂推理、长链路 Agent
Claude Sonnet 4.6claude-sonnet-4-6速度与智能的平衡，日常首选
Claude Haiku 4.5claude-haiku-4-5最快最省，适合分类、简单任务

三个模型怎么取舍，可以看 Claude 模型怎么选？Opus / Sonnet / Haiku 选型指南。请求体里还有很多可调参数，完整清单见 Claude Messages API 全部参数说明（含代码示例）。

第三步：用 Python 发出第一次请求

先安装官方 SDK：

pip install anthropic

然后写最小可运行示例。SDK 会自动读取环境变量 ANTHROPIC_API_KEY，所以代码里不用再写密钥：

from anthropic import Anthropic

client = Anthropic()  # 自动读取 ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "用一句话解释什么是 API。"}
    ],
)

print(response.content[0].text)

运行后 response.content 是一个内容块数组，文本在第一个块的 .text 里。response.usage 还会返回 input_tokens 和 output_tokens，方便你估算成本。SDK 的安装与配置细节（代理、超时、重试等）可参考 Anthropic Python SDK 安装与配置完整教程，更完整的逐行讲解见 Claude API Python 示例代码：10 分钟跑通第一个程序。

用 Node.js 调用

Node 侧用官方包 @anthropic-ai/sdk：

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

const client = new Anthropic(); // 读取 ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "用一句话解释什么是 API。" }
  ],
});

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

更多 Node 写法（含流式、TypeScript 类型）见 Claude API Node.js 调用示例：从安装到流式输出。

进阶：流式输出、工具调用与多模态

跑通基础请求后，常用的三个能力是：

另外，多轮对话只需把每一轮的 user / assistant 消息按顺序追加进 messages 数组再次发送即可（上下文管理见 Claude API 多轮对话怎么实现？上下文管理详解）。如果想在终端直接和模型协作写代码，还可以用 Anthropic 官方命令行工具 Claude Code，安装见 Claude Code 怎么安装？Windows 完整安装教程（2026）。

常见问题

调用报 401 认证失败怎么办？

多半是密钥写错或没生效：检查 x-api-key 头是否填的是完整密钥（不是 Authorization: Bearer）、环境变量是否真正加载、密钥有没有被删除或停用。逐项排查见 Claude API 报错 401 怎么解决？认证失败排查指南。

遇到 429 限流报错该如何处理？

429 表示触发了每分钟请求数或 token 数上限。官方 SDK 默认会对 429 和 5xx 做指数退避重试；并发高时建议读取响应里的 retry-after 头按提示等待，或降速排队。三种重试方案见 Claude API 429 限流报错怎么办？3 种重试方案。

怎么控制调用成本？

主要靠三点：选对模型（简单任务用 Haiku 4.5）、合理设置 max_tokens 避免浪费、用提示词缓存复用长前缀。具体价格以 Anthropic 官网为准，省钱技巧见 Claude API 怎么省钱？5 个降低 Token 成本的方法。

← Claude API 开发