Tool Search Toolのregex版とBM25版はクエリの書き方が全く違う
Tool Search Toolのregex版はPython正規表現(200字上限)、BM25版は自然文(500字上限)でクエリを書きます。defer_loadingの仕様も含めて実装差を扱います。
サブカテゴリ
Agent SDKのTips一覧
Agent SDKを日々使うなかで効く小技・設定・ワークフローをまとめたTipsの一覧です。1記事1テーマで、すぐ試せる粒度に絞っています。
全23件 · 最終更新 2026/09/03
記事一覧
プログラマティックツールコーリングは4分でタイムアウトし多くの場合リトライされる
プログラマティックツールコーリングの保留は約4分でTimeoutErrorになります。5分弱で起きるコンテナのアイドル失効と混同しやすい、公式ドキュメント記載の実際のエラー文言と対策を扱います。
コード実行ツールが無料になる条件 — Web検索・Web Fetch併用時のみ
コード実行ツールは、Web検索かWeb Fetchと同じリクエストに含めると無料になります。単体利用の料金体系・コンテナの制限・使えないプラットフォームまで一次ソースの数値で押さえます。
Claudeツールを組み合わせるパターン — 公式が示す6つの型
Anthropic公式のTool combinationsが示す6つの組み合わせパターンを解説。Web検索×コード実行のリサーチ型からBrowser Useまで、選び方と実行環境が分かれる注意点をまとめます。
Claudeのstrict tool useとHIPAA/PHI — スキーマに書いてはいけない理由
strict tool useはHIPAA対応ですが、コンパイル済みスキーマは24時間キャッシュされプロンプトと同じPHI保護を受けません。書いてはいけない4箇所と、HIPAA readinessが及ぶ範囲です。
ツールストリーミングでinvalid jsonが来たときの直し方
fine-grained tool streamingで届いた入力がJSONとして壊れているとき、INVALID_JSONラッパーとis_error:trueでClaudeに返す公式の対処パターンを解説します。
Claudeのinput_examplesでツール呼び出し精度を上げる使い方
ツール定義に添える具体的な入力例input_examplesの書き方と、公式ドキュメントが示すトークンコスト実測値、サーバーツールでは使えないという制約までを扱います。
text_editorのstr_replaceで複数マッチエラーを防ぐ実装
Anthropic APIのtext_editorツールは、str_replaceが複数箇所にマッチしたときにどう止めるかをアプリケーション側の実装に委ねています。事前カウントで0件・複数件を検出する実装と、エラー後の直し方をまとめます。
eager_input_streamingの設定でツール入力を高速表示する
Anthropic APIのeager_input_streamingフィールドで、ツール入力をバッファリングなしに配信する設定方法をまとめます。旧betaヘッダーとの互換関係と、効果が出る場面も扱います。
Claudeのtool_useでJSONエスケープが変わりバグる理由と対処
Opus 4.6以降、tool_use inputのJSON表現がUnicodeとスラッシュのエスケープでモデルバージョンにより変わります。生文字列比較が壊れる原因と正しい直し方を解説します。
code executionツールのエラーコード一覧とunavailable等の対処法
code executionツールが返すエラーコードを、bash・text_editorのサブツール別に一覧にします。unavailableやoutput_file_too_largeへの実装側の対処も扱います。
Claudeが間接プロンプトインジェクションを拒否する理由と対策
tool_result内に自分の指示を書くと、Claudeが拒否したり確認を求めたりすることがあります。原因と、指示の置き場所を変える具体的な直し方をまとめます。
並列ツール呼び出しが一部失敗したときのis_errorの返し方
並列で呼ばれたツールの一部を実行しなかったときも、is_error: trueのtool_resultを必ず返す必要があります。書き方と例外パターンをまとめます。
code executionとbashツールの混同が起きる実行環境の対処法
code executionとbashツールを併用すると、Claudeは2つの実行環境を1つだと思い込むことがあります。混同が起きる仕組みとシステムプロンプトでの防ぎ方を解説します。
ClaudeのCitationsでスキャンPDFを引用できない理由と回避策
テキスト抽出できないスキャンPDFはCitationsの引用対象外です。仕組み上の理由と、OCRやテキスト抽出による回避策、citations無効時の読み取りとの違いを扱います。
disable_parallel_tool_useの効果はtool_choiceで変わる
disable_parallel_tool_useはトップレベルでなくtool_choice内に置くパラメータ。auto/any/toolでの挙動差と、効かないときによくある原因をまとめます。
Computer Useのクリックが外れる4パターンと診断表
Computer Useのクリックが外れる原因を症状別に4パターンへ分解した診断表。zoomの使いどころ、プロンプト設計、モデル選びが精度に効く範囲まで実装目線でまとめます。
Computer Useの座標ズレを直すスケーリング計算式とmacOS Retinaの罠
Computer Useのクリックが外れる最大の原因は座標のスケール不一致です。画面サイズとスクリーンショットサイズの比率計算式、モデル世代ごとの上限差、macOS Retinaの2倍問題を実装コード付きで解説します。
Claude web_searchのエラーコード一覧と対処法
Claude APIのweb_searchサーバーツールが返す6種類のエラーコードと、200成功扱いで返る特殊な形式、コード別の対処方針をまとめます。
並列ツール呼び出しを増やすシステムプロンプトの書き方
Claudeが複数ツールを同時に呼ぶ確率を上げる、システムプロンプトの2段階の書き方と、平均ツール呼び出し数(average tools per message)で効果を測る方法をまとめます。
コード実行ツールでファイルが消える理由 — $OUTPUT_DIRの罠と対処法
code executionツールが生成したファイルは、$OUTPUT_DIR直下に置かれた分しか回収できません。消える3パターンと確実に回収する書き方を実例で解説します。
advisor toolのモデル互換性 — executorとadvisorの全11パターン
advisor toolのexecutorとadvisorは自由に組み合わせられません。Sonnet4.6以上かつexecutor以上という2条件と、11種類のexecutorそれぞれが選べるadvisorの全パターンをまとめます。
advisor toolのHaikuナッジで通過率を7ポイント上げる実装
advisor toolでHaiku executorに追加のユーザーメッセージを1つ挟むと、Anthropicの内部評価で通過率が7ポイント上がりました。Sonnetでは無効、Opusでは逆効果になる理由と実装を解説します。
記事は新しい順に並んでいます。基本操作の時短から一歩進んだ自動化まで幅があるので、いま困っていることに近いタイトルから開けます。前提となるAgent SDKのセットアップはチュートリアル、挙動の背景を知りたいときは解説の記事が補完になります。同じカテゴリ内のタイプ別セクションから辿れます。