Agent SDKのTips一覧2ページ目

CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSは、進捗のないサブエージェントを強制終了する環境変数です。既定値の連動先、中断後の挙動、他の制御との使い分けをまとめます。

自前でメッセージ履歴を圧縮すると、task_budgetのカウントダウンはtotalからやり直しになります。remainingに予算の残りを渡し続ける計算と更新のタイミングを、数値例つきで示します。

Claude APIのmid-conversationツール変更は、tools配列を編集せずにツールの提供・撤回を切り替え、プロンプトキャッシュを壊さない仕組みです。対応モデル・ヘッダー・配置制約・メッセージ内定義を扱います。

Claude APIのweb_fetchツールは既定でキャッシュ済みコンテンツを返します。use_cache:falseで最新情報を強制取得する手順とレイテンシとのトレードオフを解説します。

Claude APIが返すエラーのJSON形式と、Python・TypeScript・Go・Ruby・Java・PHP・C#の7言語でSDKが投げる例外クラスの対応表をまとめます。

Sonnet 4.6用のmax_tokensをそのまま流用すると、Sonnet 5では出力が途中で切れます。原因と、effortとmax_tokensの調整方法をまとめます。

入力トークン数を事前計算せずに、コンテキストウィンドウが許す最大量までClaudeに出力させる実装パターンをmodel_context_window_exceededで組む方法を解説します。

古いツール結果を消しつつ重要な情報だけmemoryファイルに退避する設計。クリア警告の仕組み、既定値、exclude_toolsの扱い、つまずきの切り分けを扱います。

Managed AgentsのAPIレート制限、セッション予算、接続できるMCPサーバーの種類、パートナー向けブランディング規定を、症状と判断から引ける形でまとめます。

Compactionで会話を要約すると、そのままではsystem promptのキャッシュまで巻き込んで無効化されます。system prompt側に別のcache_controlを置いて防ぐ設計を実装例で示します。

tool result clearingとthinking block clearingを併用するときの適用順序・keep設定・トークンカウントへの反映を実装例つきで解説します。

Managed Agentsの標準ツール一覧と、有効化・無効化・実行前の確認・ドメイン制限・カスタムツール追加の設定方法をまとめます。

Managed Agentsのセッションが止まった・コストが膨らんだときに、Consoleのセッションビューアのどこを見るか。症状別の見分け方とantコマンドでの開き方をまとめます。

Managed Agentsのセッションを止め、続け、割り込む3つの実践パターンをイベント順序付きで解説します。

Managed Agentsのvaultでmcp_oauth認証情報のリフレッシュが失敗したとき、webhookとmcp_oauth_validateでどこまで原因を切り分けられるかを、statusの3値ごとの対応とあわせて示します。

Managed Agentsのcloud環境で使える言語・データベース・ユーティリティを公式リファレンスから一覧します。DBが既定で起動していない点やPlaywrightの制約など、実装前に踏みがちな落とし穴も扱います。

Compactionのinstructionsは既定の要約プロンプトを丸ごと置き換えます。定期実行型とオンデマンド型の違い、ツール定義があると要約が空になる落とし穴まで実装で示します。

Tool Search Toolのregex版はPython正規表現(200字上限)、BM25版は自然文(500字上限)でクエリを書きます。defer_loadingの仕様も含めて実装差を扱います。

プログラマティックツールコーリングの保留は約4分でTimeoutErrorになります。5分前後のコンテナのアイドル検知や90秒のセル制限との違い、公式ドキュメント記載の実際のエラー文言と対策を扱います。

コード実行ツールは、Web検索かWeb Fetchと同じリクエストに含めると無料になります。単体利用の料金体系・Web検索との費用比較・Managed Agentsでの扱い・使えないプラットフォームまで一次ソースの数値で押さえます。

Anthropic公式のTool combinationsが示す6つの組み合わせパターンを解説。Web検索×コード実行のリサーチ型からBrowser Useまで、選び方と実行環境が分かれる注意点をまとめます。

strict tool useはHIPAA対応ですが、コンパイル済みスキーマは24時間キャッシュされプロンプトと同じPHI保護を受けません。書いてはいけない4箇所と、HIPAA readinessが及ぶ範囲です。

fine-grained tool streamingで届いた入力がJSONとして壊れているとき、INVALID_JSONラッパーとis_error:trueでClaudeに返す公式の対処パターンを解説します。

ツール定義に添える入力例input_examplesの書き方と、トークンコストの目安、効果が出なかった実例、サーバーツールで使えない制約を扱います。

Anthropic APIのtext_editorツールは、str_replaceが複数箇所にマッチしたときにどう止めるかをアプリケーション側の実装に委ねています。事前カウントで0件・複数件を検出する実装と、エラー後の直し方をまとめます。

Anthropic APIのeager_input_streamingフィールドで、ツール入力をバッファリングなしに配信する設定方法をまとめます。旧betaヘッダーとの互換関係と、効果が出る場面も扱います。

Opus 4.6以降、tool_use inputのJSON表現がUnicodeとスラッシュのエスケープでモデルバージョンにより変わります。生文字列比較が壊れる原因と正しい直し方を解説します。

code executionツールが返すエラーコードを、bash・text_editorのサブツール別に一覧にします。unavailableやoutput_file_too_largeへの実装側の対処も扱います。

tool_result内に自分の指示を書くと、Claudeが拒否したり確認を求めたりすることがあります。原因と、指示の置き場所を変える具体的な直し方をまとめます。

並列で呼ばれたツールの一部を実行しなかったときも、is_error: trueのtool_resultを必ず返す必要があります。書き方と例外パターンをまとめます。