# 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#