読み込み中

初めてのAPI呼び出し

レッスン 25 分
読み込み中

初めてのAPI呼び出し

Claudeに挨拶するのは心が温まるかもしれませんが、あまり実用的ではありません。 このレッスンでは、Claudeに実際の内容を送って、構造化されたインサイトを 20行弱のコードで受け取ってみましょう。

準備する

まず、platform.claude.comからAPIキーを取得します。初めてのAPI呼び出しを行う前に、Claude Consoleの請求ページでクレジットがあることを確認してください。ない場合は、そこでクレジットを追加します。

新しく作成されたAPIキーを表示するClaude Consoleのダイアログ。コピーキーボタンと、このキーは二度と表示できないという警告が示されている

APIキーを取得したら、.env.local ファイルに保存して、バージョン管理の対象外にしておきます。キーをソースファイルにハードコードすると、GitHubに流出する原因になります。環境ファイルに保管するようにしましょう。

次に、SDKをインストールします。

npm install @anthropic-ai/sdk

リクエストの構造

すべてのAPI呼び出しはmessages.create 関数を通じて行われます。指定する項目は3つです。

  • モデル — どのClaudeモデルがリクエストを処理するか
  • 最大トークン数の上限 — レスポンスの長さの上限
  • メッセージのリスト — user または assistant のロールを持つオブジェクトで、他の場所でClaudeと会話するときと似た構造になっています

最も基本的な形で書くと、次のようになります。

typescript
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行のコードです。

typescript
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つあります。

  1. system プロンプトは、ペルソナを形作る部分です。私は雑談好きではなく、簡潔なシニアレビュアーが欲しかったので、そのようにそのまま伝えています。
  2. レスポンス内のmessage.content は文字列ではなく、ブロックの配列です。基本的なテキスト応答では通常 text 型のブロックが1つだけですが、Claudeはテキスト、ツール呼び出し、思考など複数のブロックを返すことがあるため、常にループして型を確認します。

実行すると、Claudeは add が実際には減算を行っていることを見抜き、1段落でそれを教えてくれます。それだけです。それがAPI呼び出しの全てです。

スクリプト実行時のターミナル出力:Claudeはこの関数がaddという名前なのに減算を使っていると応答し、return a - bをreturn a + bに変更するよう提案している

スクリプトから製品へ

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

デモのWebアプリ内の会議ダッシュボード。記録済みのプロジェクト会議が一覧表示され、それぞれに文字起こしのプレビューと、同じAPI呼び出しを利用する「要約を生成」ボタンが付いている

まとめ

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