最初の Claude API リクエスト
認証を設定し、利用できるモデルで応答を読む。
Console アカウント、API 権限、利用枠が必要です。プランに API クレジットがあっても、デスクトップへのログインだけで API 設定は完了しません。サンプルは Node.js 22+、HTTP は curl を使います。
1. 認証情報をサーバー側に置く
Console でキーを作り、環境変数かサーバーの Secret に保存します。公開ページ・ブラウザー・コミットには含めません。.env.example を参考にローカルの .env を作り、管理対象から除外します。必要な場合だけ ANTHROPIC_WORKSPACE_ID を設定します。
ANTHROPIC_API_KEY=YOUR_LOCAL_KEY
ANTHROPIC_MODEL=AN_ACCESSIBLE_MODEL_ID
# ANTHROPIC_WORKSPACE_ID=wrkspc_...2. 利用できるモデルを選ぶ
Console または Models API で現在の ID を確認し、ANTHROPIC_MODEL に設定します。古い文書の終了済みモデルを使わないでください。以下は対応する x-api-key と API バージョンを使用し、必要なら workspace ヘッダーを追加します。
curl --fail-with-body https://api.anthropic.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"3. 小さなメッセージを送る
client.mjs と first-call.mjs を同じフォルダーに置き、.env を作成して実行します。/v1/messages へ送り、テキストと使用量を出力します。実行は API の利用枠を消費しますが、このサイトの閲覧では呼び出しません。
node --env-file=.env first-call.mjs4. 応答全体を読む
content は配列であり、単一の文字列ではありません。text を取り出し、stop_reason と usage を確認します。end_turn は終了、max_tokens は打ち切り、tool_use は次章の処理が必要です。エラーを空の正常回答として扱わないでください。
サンプルファイルを取得
教材の出力は実行ごとに変わります。前提を確認して結果を検証してください。閲覧だけでは API を呼びません。
練習と確認
ローカルから短いリクエストを一つ送り、usage と stop_reason を確認します。仮のメモにキーを残さないでください。
終わったら、振り返ってみましょう：
公式資料を読む
CLI の操作は公式文書と照合し、API のサンプルは模擬応答で検証しました。実アカウントでの一連の操作は未実施です。