【結論】SDKを用途別に使い分ける
Claude Codeでエージェント型アプリを作る場合はClaude Agent SDK、単純なMessages API呼び出しにはAnthropic SDKを使い分けます。
SDKのモデル名、認証、ストリーミング、Tool use、エラー処理は現行の公式ドキュメントを確認します。
APIキーはソースや.envへ安易に保存せず、Secret Managerまたは実行環境の秘密変数を使います。
# ターミナルで実行：TypeScriptプロジェクトを作成
mkdir claude-sdk-demo && cd claude-sdk-demo && npm init -y
# ターミナルで実行：公式SDKを導入
npm install @anthropic-ai/sdk
# ターミナルで実行：秘密値を表示せず設定有無を確認
test -n "$ANTHROPIC_API_KEY" && echo "API key is configured"
# ターミナルで実行：テストを実行
npm test具体的な手順・設定方法
チャットAPIか自律エージェントかを決め、必要最小限のSDKを選びます。
モデル、最大出力、タイムアウト、再試行、監査ログ、Tool allowlistを設定します。
外部APIはモックでテストし、実料金が発生する結合テストを分離します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Anthropic TypeScript SDKを使う要約CLIの設計案を作成してください。
APIキーは環境変数から読み、入力長、タイムアウト、429、5xx、秘密情報ログを扱ってください。
承認するまでパッケージ導入、ファイル編集、API呼び出しは行わないでください。注意点・よくあるエラーと対処法
Claude Code自身の認証と、作成するアプリのAPI認証を混同しないでください。
環境変数名を変えるだけでは秘密管理になりません。
Agent SDKに強いツール権限を与える場合は、sandbox、allowlist、最大ターン、停止条件を設定してください。