send()/stream() サイクルになります。API サーフェスは 3 つの概念に縮小されました。
createSession()/resumeSession():会話を開始または継続するsession.send():メッセージを送信するsession.stream():レスポンスを取得する
インストール
Agent SDK 0.2.x は V2 インターフェースを含む最後のバージョンです。パッケージバージョンは 0.2.x から直接 0.3.142 にジャンプしたため、上記の削除バージョンと下記のインストールピンは同じ境界を説明しています。最後の V2 互換リリースをインストールするには、メジャーバージョンとマイナーバージョンをピンしてください。SDK はオプションの依存関係として、プラットフォーム用のネイティブ Claude Code バイナリをバンドルしているため、Claude Code を別途インストールする必要はありません。
クイックスタート
ワンショットプロンプト
セッションを維持する必要がない単純なシングルターンクエリの場合は、unstable_v2_prompt() を使用します。この例は数学の質問を送信し、答えをログに出力します。
基本的なセッション
単一のプロンプトを超えるインタラクションの場合は、セッションを作成します。V2 は送信とストリーミングを個別のステップに分離します。send()はメッセージをディスパッチしますstream()はレスポンスをストリーミングします
await using(TypeScript 5.2 以降)を使用して、ブロックが終了するときにセッションを自動的に閉じます。session.close() を手動で呼び出すこともできます。
マルチターン会話
セッションは複数の交換全体でコンテキストを保持します。会話を続けるには、同じセッションでsend() を再度呼び出します。Claude は前のターンを記憶しています。
この例は数学の質問を尋ねてから、前の答えを参照するフォローアップを尋ねます。