# Claude Agent SDKの便利だけど知られていない機能 🌍 エージェントが延々とツールを呼び続けて止まらない...そんな経験はありませんか？ max_turns を使えば、ツール使用回数に上限を設定して、エージェントの暴走を防げます。 📌 タイトル：max_turns はツール使用ターンのみカウント 🔗 URL： 🧩 概要 `max_turns` はエージェントのツール使用ラウンドトリップのみをカウントし、テキストのみの応答はカウントしません。デフォルトは無制限です。上限に達すると `ResultMessage` の `subtype` が `error_max_turns` になります。重要なポイントとして、上限到達後もセッションIDは保持されるため、セッションを再開してより高い上限で続行することが可能です。 🛠 使い方 ```python # Python result = await prompt="このプロジェクトのテストを修正してください", max_turns=10, # ツール使用10回まで ) if result.subtype == "error_max_turns": print(f"ターン上限に到達: {result.num_turns}ターン") print(f"セッションID: {result.session_id}") # より高い上限で再開 result = await prompt="続行してください", max_turns=20, resume=result.session_id, ) ``` ```typescript // TypeScript const result = await prompt: "Fix the tests in this project", maxTurns: 10, }); if (result.subtype === "error_max_turns") { // Resume with higher limit const resumed = await prompt: "Continue", maxTurns: 20, resume: result.sessionId, }); } ``` 🏗 本番システムへの組み込み方 ・タスクの想定複雑度に基づいて適切なターン上限を設定し、無限ループを防止します ・`error_max_turns` を検知して自動的にセッションを再開するリトライロジックを実装します ・ターン数をメトリクスとして収集し、タスクの複雑度やエージェントの効率を分析します ・段階的にターン上限を引き上げるエスカレーション戦略を構築します 💡 ユースケース 🛡 ユーザー向けアプリで、1リクエストあたりのエージェント実行時間を制限する 🔄 最初は少ないターンで試し、必要に応じて自動的に上限を引き上げる段階的実行 📊 ターン数の統計を取って、プロンプトやツール設計の改善に活かす ⚠️ 注意点 ・テキストのみの応答はカウントされないため、実際のAPI呼び出し回数とは異なる場合があります ・デフォルトは無制限なので、本番環境では必ず上限を設定することを推奨します ・上限が低すぎるとタスクが中途半端に終わる可能性があるため、タスクに応じた適切な値を選んでください ✨ 「ツール使用回数だけカウント」という仕様は意外と知られていません。この特性を理解して活用することで、より正確なリソース管理ができます！ #ClaudeAgentSDK# #AIAgent#

# Claude Agent SDKの便利で実践的な使い方 🎛 エージェントの暴走が心配ですか？ターン数・予算・努力レベルで実行を細かく制御できます。 ループ実行の制御（ターン・予算・努力レベル）は、`max_turns`・`max_budget_usd`・`effort` でエージェントの実行範囲を制限し、コストとレイテンシを最適化する機能です。 📌 タイトル：ループの実行方法を制御する 🔗 URL： 🧩 概要 `max_turns` でツール呼び出し回数の上限、`max_budget_usd` で実行コストの上限、`effort` でモデルの思考の深さを設定します。オープンエンドな指示でも予算上限で安全に打ち切れます。 🛠 使い方 `query()` のオプションに `max_turns=30`、`max_budget_usd=1.0`、`effort="medium"` を設定します。`model="claude-sonnet-4-6"` でモデルを明示指定できます。 🏗 実践的な使い方 ・本番エージェントの暴走防止に `max_turns=30` と `max_budget_usd=1.0` を設定します。「このコードベースを改善して」のようなオープンエンドな指示でも安全に打ち切れます。 ・`effort` を `low`（ファイル検索・一覧）/ `medium`（定型編集）/ `high`（リファクタ・デバッグ）/ `xhigh`（Opus 4.7 推奨のエージェンティックコーディング）/ `max`（多段問題の深い分析）と使い分けます。 ・小型・高速モデルが必要なサブタスクには `model="claude-sonnet-4-6"` を明示指定し、コスト効率を上げます。 💡 ユースケース 🛡 オープンエンドなタスクの安全な予算制限 ⚡ タスク難度に応じた effort レベルの最適化 💰 サブタスクへの軽量モデル適用によるコスト削減 ⚠️ 注意点 `max_turns` を超過すると `error_max_turns` で終了します。`resume` で上限を上げて再開可能です。`effort` は `xhigh` 以上で Opus 4.7 が推奨されます。 #ClaudeAgentSDK# #AI#

# Claude Agent SDKの便利で実践的な使い方 🔌 MCP で Playwright・DB・GitHub 等の外部ツールをエージェントに接続して、能力を無限に拡張できます。 MCP（外部ツール接続）は、Model Context Protocol を介して外部の MCP サーバー（ブラウザ・DB・API 等）をエージェントに接続する機能です。 📌 タイトル：MCP を使用して外部ツールに接続する 🔗 URL： 🧩 概要 `mcp_servers` に stdio / HTTP / SSE トランスポートで外部 MCP サーバーを指定します。`allowedTools` でアクセス可能なツールを制御し、`env` や `headers` で認証情報を注入します。 🛠 使い方 `mcp_servers` に stdio / HTTP / SSE トランスポートでサーバーを指定します。例えば Playwright は `{"command": "npx", "args": ["@playwright/mcp@latest"]}`、Postgres は `"env": {"DATABASE_URL": "..."}` で接続情報を注入します。`allowed_tools=["mcp__postgres__query"]` で利用可能なツールを制御します。 🏗 実践的な使い方 ・Playwright MCP サーバーを接続し「 を開いて内容を説明して」で E2E テストや Web スクレイピングエージェントを構築します。 ・Postgres MCP サーバーに接続し「先週のサインアップ数を日別で」と尋ねると、Claude がスキーマ検出→ SQL 生成→実行します。`allowedTools: ["mcp__postgres__query"]` で読み取りのみ許可。 ・GitHub MCP サーバーで Issue トリアージや自動対応ボットを構築します。 ・`system/init` メッセージの `mcp_servers[].status` で接続状態を起動前に検証します。 💡 ユースケース 🌐 Playwright によるブラウザ自動化 🗄 自然言語での DB クエリ実行 📋 GitHub Issue の自動トリアージ ⚠️ 注意点 `permissionMode: "acceptEdits"` は MCP ツールを自動承認しません。`allowedTools` のワイルドカード（`mcp__github__*`）で必要なサーバーのみ許可するのが安全です。接続タイムアウトはデフォルト 60 秒です。 #ClaudeAgentSDK# #AI#

Claude Fable 5が45分前から使えなくなった。じっくり味わえて良かった。自宅で自動稼働させているClaude Desktopが止まってしまい業務ストップ。帰宅してチューニングしよ

# Claude Agent SDKの便利で実践的な使い方 📡 画像アップロード・割り込み・コンテキスト永続が使えるストリーミング入力モードを使いこなしましょう。 ストリーミング入力 vs シングルメッセージは、永続的対話向けのストリーミングモードと、ステートレス環境向けのシングルメッセージモードの使い分けです。 📌 タイトル：ストリーミング入力 🔗 URL： 🧩 概要 ストリーミング入力モード（推奨）は画像アップロード・メッセージキュー・割り込み・コンテキスト永続に対応し、リッチな対話体験を提供します。シングルメッセージ入力は AWS Lambda 等のステートレス環境で 1 回限りの応答に最適です。 🛠 使い方 ストリーミングモードがデフォルトです。シングルメッセージモードは Lambda 等のステートレス環境で明示的に選択します。 🏗 実践的な使い方 ・チャット UI で「このコードベースを分析して」の後にアーキテクチャ図（画像）を追加添付してレビューさせる、リッチな体験を実現します。 ・メッセージキューで外部イベント（CI 結果、Slack 通知等）をエージェントに追加注入し、動的に文脈を拡張します。 ・AWS Lambda で「認証フローを説明して」を単発実行するサーバーレス関数にはシングルメッセージモードを使用します。 💡 ユースケース 🖼 画像添付付きのコードレビュー 📨 外部イベントの動的注入 ⚡ サーバーレス環境での単発タスク実行 ⚠️ 注意点 シングルメッセージモードでは画像添付・割り込み・マルチターンが非対応です。リッチな対話が必要な場合はストリーミングモードを使用してください。 #ClaudeAgentSDK# #AI#

「Claudeが働いてくれるから、私は8時間寝られます」 👉 新型AIモデル「Fable 5」が話題です。 Anthropicの社員は寝る間も惜しい超多忙ぶり・・・かと思いきや、Claude Code/Coworkの製品責任者はちゃんと寝ているそうです。 先日東京で開催されたAnthropicのイベント「Code w/ Claude」で、 キャサリン・ウーさん @_catwu に「Fable 5」開発の裏側や仕事の自動化のリアルを聞きました。@mshrnakagawa

# Claude Agent SDKの便利で実践的な使い方 💬 エージェントとの会話を継続・再開・分岐させて、複雑なタスクをマルチターンで進められます。 セッション管理は、`continue`・`resume`・`fork` で会話の継続・再開・分岐を実現し、コンテキストを維持したマルチターン対話を可能にする機能です。 📌 タイトル：セッションの操作 🔗 URL： 🧩 概要 セッションにより会話の文脈が保持されます。Python は `ClaudeSDKClient`（セッション ID 自動管理）、TypeScript は `continue: true` でマルチターンを実現します。`resume` で中断したセッションを再開、`fork_session` で履歴を分岐して代替案を探索できます。 🛠 使い方 ```python # 再開 options = ClaudeAgentOptions(resume=session_id) # 分岐 options = ClaudeAgentOptions(fork_session=True) ``` 🏗 実践的な使い方 ・「認証モジュールを分析して」→「JWT 化してリファクタして」と文脈を引き継ぐマルチターン対話を構築します。 ・`error_max_turns` で終了したセッションを `resume` でより高い上限で再開し、続きから実行します。 ・`fork_session=True` で元セッション（JWT 路線）を壊さず OAuth2 路線を別ブランチで探索。2つの独立した履歴を保持します。 ・`list_sessions` / `get_session_messages` / `rename_session` でセッションピッカー UI やクリーンアップ処理を構築します。 💡 ユースケース 🔄 制限到達後のセッション再開による継続実行 🌿 fork による代替アプローチの並行探索 🗂 セッション一覧 UI の構築 ⚠️ 注意点 セッションは `~/.claude/projects//.jsonl` に保存されます。ホスト間での再開には `cwd` の一致が必要です。サブエージェントのトランスクリプトはメイン会話と独立して永続化されます。 #ClaudeAgentSDK# #AI#

Claudeの最新モデル「Fable 5」に頼んだら、ついに夢が叶った…！ あの広告で死ぬほど見かける「左右に動いて仲間を増やして圧倒するやつ」、完全に再現してくれた。 これで広告の偽物ゲームに騙されず、思う存分プレイができる！ #Claude# #fable5#