AnthropicのTips一覧3ページ目

ツール定義に添える入力例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に書くメッセージの質でClaudeの立て直し方が変わります。良い例・悪い例、必須パラメーター欠落時のリトライ挙動、サーバーツールとの違いをまとめます。

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

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

Computer Useの長時間ループはスクリーンショットを急速に積み上げ、プロンプトキャッシュを壊しがちです。バッチ単位の間引きとcache_controlの置き方をまとめます。

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

Computer Useツールのeffort設定は、モデルによって推奨値が違います。Opus 4.7はhigh、Sonnet 4.6とOpus 4.6はmedium。maxは精度を上げずコストだけ増やします。

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

Claude APIのツール定義でnameに使える文字は英数字・アンダースコア・ハイフンの4種類、長さは128文字までです。日本語や記号が400になる理由と、名前の衝突を防ぐ命名ルールをまとめます。

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

Voyage AI embeddingのoutput_dtypeでfloat/int8/binaryを切り替える方法と、8個の浮動小数点値を1バイトに詰めるオフセットバイナリ方式の変換例をまとめます。

ユーザーの入力言語に関わらず特定の言語で応答させるには、systemパラメーターに言語指定を書きます。実装例と、2言語間の翻訳を固定する書き方、よくあるつまずきをまとめます。

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

Claude CitationsはPDFならページ番号、プレーンテキストなら文字インデックス、カスタムコンテンツならブロックインデックスと、ドキュメント種別ごとに引用の返り方が変わります。実装の落とし穴も解説します。

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

Web Fetchツールのurl_not_in_prior_contextエラーは、Claudeが自分でURLを組み立てて取得しようとすると発生します。データ持ち出し対策という設計意図と、正しい回避パターンを解説します。

Claude APIのweb_search/web_fetchが使うallowed_domainsに、キリル文字でamazon.comを偽装した1文字が混ざる手口と、許可リストをASCIIで監査するスクリプトを解説します。

Anthropic株は証券会社では買えません。非上場で株価もなく、S-1は秘密提出の段階です。IPOの時期、評価額の推移、間接的に触れる手段を示します。