你的第一个 API 调用

向 Claude 说 "你好" 可能会温暖你的心，但它并不真正有用。在本课中，我们将向 Claude 发送一些真实的内容并获得结构化洞察——只需不到 20 行代码。

准备工作

首先，从 platform.claude.com 获取一个 API 密钥。你需要事先购买一些积分。

获取 API 密钥并将其存储在 .env.local 文件中，以使其不进入版本控制。在源文件中硬编码密钥会导致它们在 GitHub 上泄露——将其保存在环境文件中。

接下来，安装 SDK：

npm install @anthropic-ai/sdk

请求的结构

每个 API 调用都通过 messages.create 函数。你指定三件事：

• 一个 model — 哪个 Claude 模型处理请求
• 一个 max tokens 限制 — 响应长度的上限
• 一个 messages 列表 — 带有 user 或 assistant 角色的对象，类似于你在其他地方与 Claude 对话的结构

这是最基本形式的样子：

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

const client = new Anthropic();

const msg = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 2048,
  messages: [{
    role: "user",
    content: "Hello, Claude",
  }],
});

一个真实的例子：审查有 bug 的代码

让我们给 Claude 一些比 "你好" 更有趣的东西。我们将将其指向一些有 bug 的代码并要求审查。这是完整的代码——一个文件，大约 20 行：

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

const client = new Anthropic();

const buggyCode = `
function add(a, b) {
  return a - b;
}
`;

const response = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 2048,
  system: "You are a terse senior code reviewer. Give feedback in one paragraph.",
  messages: [
    { role: "user", content: `Review this code:\n${buggyCode}` },
  ],
});

for (const block of response.content) {
  if (block.type === "text") {
    console.log(block.text);
  }
}

这里要注意两件事：

1. system 提示是你塑造角色的地方。我想要一个简洁的高级审查者，而不是健谈的——所以我直接说出来。
2. 响应中的 message.content 是一个块数组，而不是字符串。对于基本的文本回复，通常只有一个 类型的块，但 Claude 可以返回多个块——文本、工具调用、思考——所以我们总是循环并检查类型。