検索結果を二度運ばない — response_inclusion で消費済みブロックを応答から外す設計
dynamic filtering を有効にしたエージェントで出力トークンが膨らむ原因は、code execution が消費し終えた検索結果ブロックが応答に二重で乗ることにあります。response_inclusion を excluded にして安全に外せる条件と、full を保つべき条件を実装と判断表で整理しました。
Claude エージェントのツール返り値を圧縮する — 巨大レスポンスを文脈に積まずに集約する設計
データベースの数千行、Webスクレイプ後のHTML、ファイル読み込みの数MBといった巨大なツール出力をそのまま Claude に渡すと文脈が破裂し、コストも品質も同時に悪化します。スキーマ縮約・サマリ・参照渡しの3層で圧縮する本番アーキテクチャを実装パターン付きで整理しました。
Claude API の Tool Use でスキーマ定義ミスが出たとき：実際に遭遇した3つのパターンと診断手順
Claude API の Tool Use でよく起きるスキーマ定義ミス・invalid_tool_use・Claude がツールを呼ばない問題を、実際のアプリ開発で遭遇したケースをもとに診断手順と修正パターンで解説します。
Claude API のツール呼び出しを Zod で型安全にした — TypeScript 開発者が詰まるポイントと実装パターン
as anyが散らばったツール呼び出しコードを、TypeScriptとZodで型安全に作り直す実装パターンです。スキーマ自動変換とランタイムバリデーション、optionalとnullableの違いやネストしたunion型の変換など詰まりやすいポイント、複数ツールの管理方法までを実践コード付きで解説します。
Claude API × Python 実践：ツール呼び出しとストリーミングを組み合わせてAIアシスタントを作る
Claude API の Tool Use とStreamingを同時に使うPython実装を解説。ツールを定義してリアルタイム応答するAIアシスタントの完成コードと、組み合わせ時に詰まりやすいポイントを丁寧に解説します。
Claude API のツール実行エラーを Claude 自身に診断させる — 自己修正ループの設計と本番実装
Tool Use実装で避けられないツール実行エラーの対処法を解説。is_errorフラグを活用してエラー情報をClaudeに返し、自己診断・修正ループを実装する実践的なPythonコードと本番でのアンチパターンも紹介します。
「考えながら調べる」AIエージェントの作り方 — Claude API 拡張思考 × Tool Use 本番実装ガイド
Claude APIの拡張思考（Extended Thinking）とTool Useを組み合わせる実装パターンを詳解。頻出エラーの根本原因、リサーチエージェントの完全実装コード、本番でのコスト・タイムアウト設計まで体系的に解説します。
「tool result could not be submitted」エラーが出たときの完全対処ガイド
Claudeで突然現れる「tool result could not be submitted」エラーは、ドキュメントに詳しい記載が少なく原因特定に時間がかかります。このエラーが出る場面の整理、主な原因と対処法、デバッグ手順のまとめ、よくある疑問への回答を個人開発者の実体験をもとに解説します。
Claude API × Go言語 本番実装 — Anthropic Go SDK・並行処理・Tool Use・マイクロサービス統合
Anthropic Go SDK で Claude API を本番運用するための実装パターン。ストリーミング・goroutine による並行処理・Tool Use・Gin/Echo 統合・グレースフルシャットダウンまで、動作するコードとともに整理しています。
Claude API Think Tool — エージェントのインターリーブド推論でツール呼び出し精度を劇的に向上させる
Claude APIのThink Toolパターンを徹底解説。Extended Thinkingとの違い、エージェントループでのインターリーブド推論の実装方法、ツール呼び出し精度を最大54%向上させる本番設計パターンを詳しく紹介します。
Claude SDK Tool Runner でエージェントループを自動化する
ツール呼び出しの検出・実行・返却という定型ループを自前で書かずに済む、Claude SDKのTool Runnerを解説します。Tool Helpersによるツール定義、エージェントループの構築、自動コンパクションでのコンテキスト管理、strict指定による入力スキーマの厳密検証までコード例で確認します。