
AIエージェントのツール呼び出しループを止める:5層ガードの実装
同じツールの反復は、次の実行を拒否し、呼び出し元にも停止結果を返して止めます。進捗の確認、完了済み操作の再利用、結果不明の書き込みを再送しない復旧手順まで説明します。

同じツールの反復は、次の実行を拒否し、呼び出し元にも停止結果を返して止めます。進捗の確認、完了済み操作の再利用、結果不明の書き込みを再送しない復旧手順まで説明します。

systemを拒否する400が出たら、実際に送信されたJSONと接続先の仕様を照合します。指示をuserへ移す前に、初期指示の置き場所、会話中のsystemの対応条件、ツール結果の形式を確認しましょう。

会社から渡されたAPIキーは、接続先と認証方式を確認して設定します。対話モードではキーの承認も必要です。設定ファイルが読み込まれたことと、狙った認証・モデルで応答が返ることを分けて確かめましょう。

長い会話での混乱は/context、次のセッションで抜ける指示は読み込み、Context7の不調は接続と文書取得から確認します。メモリを追加する前に、症状に合った小さな修正を試しましょう。

--dangerously-skip-permissionsを付けると、Claude CodeはbypassPermissionsで起動します。--allowは選択肢を増やすだけです。確認が残る条件やPlanの例外を理解し、編集の自動承認やツールを限定した実行も使い分けましょう。

OpenRouter経由ならOpenRouterのキーとモデルID、DeepSeek直結ならDeepSeekのキーとモデル名を使います。二つの設定例と、認証・モデル・ツールの初回エラーを切り分ける手順を確認できます。

Claude Code のステータスラインは、セッションの JSON を受け取るコマンドで作れます。すぐ試すなら /statusline、自分で表示を管理するなら手動設定を使い、先に模擬入力で出力を確認しましょう。

Claude Code の top_p deprecated は、実際に呼び出すモデルへ古いサンプリング指定が送られていないかを調べるのが出発点です。設定ファイルだけでなく、アダプタが組み立てた最後のリクエストから指定を省き、同じ作業が完了するか確認します。

Nano Banana ProでDeadline expiredと表示されても、応答が503 UNAVAILABLEなら、まず回数と時間を決めて同じ条件で再試行します。504と応答なしは別に扱い、画像が保存できるまで成功とは判定しません。

録音ファイルは gemini-3.5-transcribe、リアルタイム字幕は gemini-3.5-transcribe-live を使います。自作辞書と話者・単語時刻は録音の同じリクエストに入れられません。用途別の Python 例と、暫定字幕と確定文を分けて終了待ちに上限を設ける処理を紹介します。

2026年10月6日時点、使えるのはGPT-6.1 Solのみ。Fable 5.5は未発表、Gemini 4はFairwind限定、GPT-6.1 Astraは公開中止です。

Imagen 4 から直接 API へ移るなら Nano Banana 2.1 を検討します。Firebase は SDK の対応を別に確認し、画像を取り出す処理と採用基準まで更新してから本番を切り替えます。

LLMエージェントの費用を止めるには、送信前に確定費用と予約中の費用を合算して判定します。ローカルで動く予約例を使い、同時要求、費用不明、再試行、停止後の再開条件まで設計します。

Nano Banana 2の503「Model is Overloaded」には、回数と待ち時間を決めた再試行で対処します。画像生成・編集に使えるPython例を示し、画像が返ったかの確認、試行上限に達した後の保留、結果不明のタイムアウトの扱いまで説明します。

Nano Banana Proはgemini-3-pro-imageを指定し、新規実装では公式Interactions APIから始められます。JSON・YAML設定を送信用の形式へ変換し、返却MIMEで画像を保存するコードと、PDFを先に読解する2段階の手順を示します。

制限表示だけで禁止内容やPro全体の停止とは判断できません。Geminiでは画像の「Proでやり直す」、AI Modeでは現在のProメニュー、APIでは応答の理由と最終画像を確認します。

公開HTTPSや署名付きURLは、対応するGemini APIで画像参照に使えます。「Unsupported file URI type」が出たら、送信先と実際の値を確認し、URL・生バイト・アップロード済みファイルの指定を直してください。

APIConnectionErrorが出たら、失敗したプロセスで接続先、例外の原因、HTTP応答の有無を確認します。原因に合うCA・プロキシ・通信許可を直し、同じ条件の小さい要求から復旧を確かめます。リクエストIDがなくても、未処理や未課金とは断定できません。

OpenAI APIのquota exceededは、待って再試行するだけでは解消しない請求・利用枠のエラーです。詳細コードを確認し、実際に使っている組織の残高、組織とプロジェクトの強制支出上限、承認済み利用枠を調べます。

OpenClawのエラーは、モデル提供元の認証、Gatewayへの接続、実行環境の設定で対処が変わります。まず失敗した接続を特定し、その接続に使われる認証元を修正します。再実行は待機時間と処理済みの作業を確認してから行います。

音声で応答するならRealtime、字幕だけならライブ文字起こし、録音の議事録ならファイル文字起こしが出発点です。mini・GPTLive・STT→LLM→TTSを同じ成果で比べ、履歴や後処理まで含めた予算を計算できます。

MCP を減らす前に、どの段階でコンテキストが増えたかを確認しましょう。ツール定義は遅延読み込み、巨大な結果は絞り込み、長い会話は作業状態の引き継ぎで対処し、同じ作業を完了できるか確かめます。

Claude Code modsは自分の権限で動き、askルールより先にツール呼び出しを許可できます。denyが守られるのは組織のガードがある環境だけです。

Claude Sonnet 5.5は単価がSonnet 5と同じで、AA測定の1課題の費用はlow〜xhighで下がりmaxだけ約5割増えます。effortは1段下から試します。