Agent SDKのTips一覧3ページ目

code executionとbashツールを併用すると、Claudeは2つの実行環境を1つだと思い込むことがあります。混同が起きる仕組みとシステムプロンプトでの防ぎ方を解説します。

テキスト抽出できないスキャンPDFはCitationsの引用対象外です。仕組み上の理由と、OCRやテキスト抽出による回避策、citations無効時の読み取りとの違いを扱います。

disable_parallel_tool_useはトップレベルでなくtool_choice内に置くパラメータ。auto/any/toolでの挙動差と、効かないときによくある原因をまとめます。

Computer Useのクリックが外れる原因を症状別に4パターンへ分解した診断表。zoomの使いどころ、プロンプト設計、モデル選びが精度に効く範囲まで実装目線でまとめます。

Computer Useのクリックが外れる最大の原因は座標のスケール不一致です。画面サイズとスクリーンショットサイズの比率計算式、モデル世代ごとの上限差、macOS Retinaの2倍問題を実装コード付きで解説します。

Claude APIのweb_searchサーバーツールが返す6種類のエラーコードと、200成功扱いで返る特殊な形式、400との切り分け、コード別の対処方針をまとめます。

Claudeが複数ツールを同時に呼ぶ確率を上げる、システムプロンプトの2段階の書き方と、平均ツール呼び出し数(average tools per message)で効果を測る方法をまとめます。

code executionツールが作ったファイルは、$OUTPUT_DIR直下に置いた分しか返りません。消える原因の切り分け方と、確実に回収する書き方、取りこぼしの救い方を示します。

advisor toolのexecutorとadvisorは自由に組めません。Sonnet 4.6以上かつexecutor以上の2条件、executor別の一覧、Sonnet 5.5がOpus 4.8以前を弾く理由を解説します。

advisor toolでHaiku executorに追加のユーザーメッセージを1つ挟むと、Anthropicの内部評価で通過率が7ポイント上がりました。Sonnetでは効果が測定されず、Opusでは逆効果になる背景と実装を解説します。