初めてのAPI呼び出し
Claudeに挨拶するのは心が温まるかもしれませんが、あまり実用的ではありません。 このレッスンでは、Claudeに実際の内容を送って、構造化されたインサイトを 20行弱のコードで受け取ってみましょう。
準備する
まず、platform.claude.comからAPIキーを取得します。初めてのAPI呼び出しを行う前に、Claude Consoleの請求ページ(新しいタブで開きます)でクレジットがあることを確認してください。ない場合は、そこでクレジットを追加します。

APIキーを取得したら、.env.local ファイルに保存して、バージョン管理の対象外にしておきます。キーをソースファイルにハードコードすると、GitHubに流出する原因になります。環境ファイルに保管するようにしましょう。
次に、SDKをインストールします。
npm install @anthropic-ai/sdkリクエストの構造
すべてのAPI呼び出しはmessages.create 関数を通じて行われます。指定する項目は3つです。
- モデル — どのClaudeモデルがリクエストを処理するか
- 最大トークン数の上限 — レスポンスの長さの上限
- メッセージのリスト —
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",
}],
});実例:バグのあるコードをレビューする
「hello」よりもう少し面白いものをClaudeに渡してみましょう。バグのあるコードを指定して、レビューを依頼します。全体はこれだけです — 1つのファイルで、約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);
}
}ここで注目すべき点が2つあります。
systemプロンプトは、ペルソナを形作る部分です。私は雑談好きではなく、簡潔なシニアレビュアーが欲しかったので、そのようにそのまま伝えています。- レスポンス内の
message.contentは文字列ではなく、ブロックの配列です。基本的なテキスト応答では通常text型のブロックが1つだけですが、Claudeはテキスト、ツール呼び出し、思考など複数のブロックを返すことがあるため、常にループして型を確認します。
実行すると、Claudeは add が実際には減算を行っていることを見抜き、1段落でそれを教えてくれます。それだけです。それがAPI呼び出しの全てです。

スクリプトから製品へ
実際の製品では、この同じ messages.create の形が、要約エンドポイントのようなものを支える仕組みになります。データベースから会議の文字起こしを取得し、「インサイトとリスクを抽出してください」というシステムプロンプトとともにClaudeに渡し、結果をその行に保存し直し、UIに返します。これは同じ呼び出しです — ルートハンドラーでラップされているだけです。

まとめ
- 初めてのAPI呼び出しは、モデル、トークン上限、メッセージを指定する
messages.create関数です。 - APIキーは
.env.localファイルに保存し、バージョン管理の対象外にしておきます。 - システムプロンプトを追加して、Claudeの振る舞いを形作ります。
- レスポンスの
contentはブロックの配列です — ループして各ブロックのtypeを確認します。 - ここから先は、すべてこのパターンの上に構築されていきます。