Messages APIの基本

なぜ学ぶか： Claude APIのほぼすべてはMessages API（メッセージのやり取り）でできています。「systemで役割を与え、messagesで会話を積む」という組み立て方が分かると、単発の質問から複数ターンの対話まで、AI機能を自在に設計できます。前に学んだ『AIへの指示』が、ここでコードになります。

コード例

import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();

// 複数ターンの会話（API はステートレス→履歴を毎回送る）
const message = await client.messages.create({
  model: "claude-opus-4-8",
  max_tokens: 1024,
  // system: AI の役割・前提
  system: "あなたは簡潔に答えるプログラミングの先生です。",
  messages: [
    { role: "user", content: "TypeScript の型注釈って何？" },
    { role: "assistant", content: "変数に「この種類の値が入る」と宣言する印です。" },
    { role: "user", content: "例を1つ、短く教えて。" },
  ],
});

const text = message.content.find((b) => b.type === "text");
console.log(text?.type === "text" ? text.text : "");

3ターン目の質問に答えてもらうため、1〜2ターン目の履歴も一緒に送っています。「毎回まるごと送る」がステートレスAPIの基本です。