博士

やっほー、ロボ子！今日はAnthropicの新しいClaude Agent SDK for Pythonについて話すのじゃ！

ロボ子

博士、こんにちは！Claude Agent SDKですか、面白そうですね。これは一体何ができるんですか？

博士

これはね、Claude Codeとのやり取りを簡単にするためのPython SDKなのじゃ。つまり、Claude Codeを使って色々できるってこと！

ロボ子

なるほど！インストールは簡単ですか？

博士

`pip install claude-agent-sdk`で一発なのじゃ！ただし、Python 3.10以上とNode.js、そしてClaude Code自体が必要だぞ。

ロボ子

ふむふむ。基本的な使い方はどうでしょう？

博士

`query()`っていう非同期関数を使うのじゃ。これでClaude Codeにクエリを送って、応答メッセージのAsyncIteratorが返ってくるぞ。

ロボ子

AsyncIteratorですか。ストリーミングで結果を受け取れるんですね。

博士

その通り！そして、`ClaudeSDKClient`を使うと、もっとインタラクティブな会話ができるのじゃ。カスタムツールとかフックも定義できるんだぞ。

ロボ子

カスタムツールとフックですか？それはどういうものですか？

博士

カスタムツールは、Claudeに提供できるPython関数なのじゃ。Claudeが必要に応じて呼び出すことができるんだぞ。例えば、株価を取得する関数とかね！

ロボ子

なるほど。Claudeが外部の情報を利用できるようになるんですね。

博士

そうそう！そしてフックは、Claudeエージェントループの特定の時点でClaude Codeが呼び出すPython関数なのじゃ。これで、Claudeに決定的な処理とか自動化されたフィードバックを提供できるんだぞ。

ロボ子

例えば、どんな時に使うんですか？

博士

例えば、Claudeが生成したコードを自動でテストするとか、特定の条件を満たしたらアラートを出すとか、色々できるのじゃ！

ロボ子

すごい！色々な応用ができそうですね。

博士

じゃろ？ちなみに、カスタムツールはインプロセスMCPサーバーとして実装されてるから、別のプロセスを管理する必要がないのじゃ。パフォーマンスも良くて、デバッグも簡単だぞ！

ロボ子

それは便利ですね！

博士

エラー処理もちゃんとされてるから安心なのじゃ。エラーの種類は[src/claude_agent_sdk/_errors.py](https://github.com/anthropics/claude-agent-sdk-python/blob/main/src/claude_agent_sdk/_errors.py)を見てね。

ロボ子

ありがとうございます！

博士

例として、[examples/quick_start.py](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/quick_start.py)に基本的な使用例があって、[examples/streaming_mode.py](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/streaming_mode.py)にもっと詳しい`ClaudeSDKClient`の例があるから、見てみるといいぞ。

ロボ子

試してみます！

博士

もしClaude Code SDKの古いバージョンからアップグレードする場合は、[CHANGELOG.md](https://github.com/anthropics/claude-agent-sdk-python/blob/main/CHANGELOG.md#010)をチェックするのじゃ。`ClaudeCodeOptions`が`ClaudeAgentOptions`に名前が変わったから注意だぞ。

ロボ子

承知しました！

博士

ライセンスはMITライセンスだから、自由に使っていいのじゃ！

ロボ子

素晴らしいですね！

博士

というわけで、今日の講義は終わり！最後に一つ、ロボ子。このSDKを使えば、まるで私がもう一人いるみたいに、プログラムが動き出す…って、それじゃあただのバグか！