第10章 · Ecosystem & Next Steps
Agent SDK でカスタムエージェントを作る
Agent SDK
→ で次のスライド · F でフルスクリーン · N で講師ノート · Esc で終了
重要キーワード
Agent SDK
エージェントSDK
Claude Code のコアを再利用してカスタムエージェントを構築できる SDK
Loop
ループ
計画→ツール実行→観察 を繰り返す基本構造
Memory
メモリ
セッションを跨いで保持する状態
Headless
ヘッドレス
対話 UI なしで動かすモード
Claude Agent SDK
Agent SDK は、Claude Code の中核 (計画 → ツール → 観察 ループ) を 任意のアプリに組み込める SDK。 ターミナルだけでなく、Slack ボット・社内ツール・SaaS の中で動くエージェントが作れます。
なぜ Agent SDK?
- ゼロから「ループ + ツール選択 + 安全機構」を書くのは大変
- Claude Code が長年磨いてきた仕組みを再利用できる
- Hooks / Skills / MCP / Subagents もそのまま動く
- セッション再開・メモリ・キャッシュ含む
インストール
wzxhzdk:0
Hello World (Python)
wzxhzdk:0
主要オプション
| オプション | 用途 |
|---|---|
system_prompt |
エージェントの役割 |
allowed_tools |
利用可能ツール (Read/Edit/Bash...) |
cwd |
作業ディレクトリ |
mcp_servers |
MCP サーバー設定 |
hooks |
フック登録 |
permission_mode |
default / acceptEdits / plan |
model |
使用モデル |
max_turns |
自律ループの上限 |
Streaming で受信
wzxhzdk:1
Slack ボット例
wzxhzdk:2
TypeScript 版
wzxhzdk:0
Hooks との組み合わせ
Agent SDK でも .claude/settings.json の hooks が動きます。
ファイル編集 → 自動 lint、危険コマンドブロック、ロギング等が SDK から動く。
Headless モード
-p フラグ的なワンショット呼び出し:
wzxhzdk:1
CI ジョブや バッチ処理向け。
Multi-Agent パターン
複数のエージェントを協調させる: - Researcher: 情報収集 - Writer: 草案作成 - Critic: レビュー - Editor: 仕上げ
各エージェントを Claude Agent SDK の query で動かし、結果を別エージェントに渡す。
セキュリティ
- ツール許可リストを最小化
- 実行ディレクトリを sandbox に
- 出力を検証してから外部に出す
- Hooks で危険コマンドをブロック
- max_turns で無限ループを防ぐ
Use Case
- 社内 Slack ボット: 質問対応・タスク管理
- CI に組み込むレビュアー: PR を自動分析
- データ整形パイプライン: ETL の中で LLM を呼ぶ
- カスタマーサポートのエージェント: チケット解決
- コード生成サービス: SaaS の機能としてエージェントを提供
Claude Code との関係
- Claude Code = Agent SDK + ターミナル UI + 公式 Hooks/Skills
- Agent SDK = 同じコアを klzzwxh:0009 ようにしたもの
試す
カスタムエージェントの設計を Claude に。
▶ Agent 設計依頼
「社内 GitHub の PR を毎晩レビューして翌朝の Slack に要約投稿する」エージェントの設計を Agent SDK 想定で書いてください。必要な ClaudeAgentOptions / 主要ロジックの擬似コード / リスクと緩和策を順に。Hands-on Exercise
演習: 最小エージェントを書く
Agent SDK で 30 行以内のミニエージェントを書いてください。
- 用途: 「指定フォルダの README.md を集めて 5 行で要約する」
- 利用ツール: Read, Glob のみ
- 出力: Markdown
🎉
まとめ
お疲れ様でした!