すべての記事
Claude Agent SDK で複数 MCP サーバを束ねるときのツール名衝突 — 名前空間と動的調停の設計
GitHub MCP と Linear MCP の create_issue が同居したとき、Sonnet 4.6 はどちらを呼ぶか分かりません。複数 MCP を束ねる Claude Agent SDK アプリで踏むツール名衝突の構造と、TypeScript で書ける Reconciler の実装、本番で踏んだ失敗パターンまでをまとめます。
Claude エージェントのツール返り値を圧縮する — 巨大レスポンスを文脈に積まずに集約する設計
データベースの数千行、Webスクレイプ後のHTML、ファイル読み込みの数MBといった巨大なツール出力をそのまま Claude に渡すと文脈が破裂し、コストも品質も同時に悪化します。スキーマ縮約・サマリ・参照渡しの3層で圧縮する本番アーキテクチャを実装パターン付きで整理しました。
Claude API のチャット履歴を階層サマライズする：3 段階圧縮でトークンを 70 % 削減した設計
壁紙アプリのインアプリ AI チャットで増え続ける履歴トークンを抑えるため、直近ターン・中期エピソード・長期エンティティの 3 層に分けて圧縮する設計を、TypeScript の動くコードと 7 週間の運用データつきで記録しました。月額 API 費用を $480 から $145 まで下げています。
Claude エージェントに安全弁を仕込む：個人運営で暴走を止める三層キルスイッチ設計
個人運営の Claude エージェントで実際に経験したリトライ暴走 3 時間で $32 の損失を起点に、プロセス内ガード・プラットフォーム停止フラグ・観察層の三層キルスイッチを Cloudflare Workers + KV で組む設計記録。TypeScript の動くコードと運用メトリクス付き。
Claude SDK でツール呼び出しが InputValidationError で失敗し続ける：Deferred Tools の正しい扱い方
Claude Code SDK や Cowork でツールを呼び出すと InputValidationError が発生するケースの根本原因と解決策。Deferred tools の仕組みを理解し、ToolSearch を正しく使うことで解消できます。
Claude API の Tool Use でスキーマ定義ミスが出たとき：実際に遭遇した3つのパターンと診断手順
Claude API の Tool Use でよく起きるスキーマ定義ミス・invalid_tool_use・Claude がツールを呼ばない問題を、実際のアプリ開発で遭遇したケースをもとに診断手順と修正パターンで解説します。
Claude API で多言語レビュー返信を自動化した — 5,000万DL アプリで学んだ実装の落とし穴
累計5,000万DL以上の壁紙・ヒーリングアプリを運営する個人開発者が、Claude APIで多言語レビュー返信を自動化した実装ログ。App Storeの8秒待機ルールや1セッション30件制限など、公式ドキュメントには書かれていない落とし穴と解決策を詳解します。
壁紙アプリの一括カテゴリ分類を Claude Vision API で自動化した話 — 実運用で見えた精度と限界
累計5,000万DLを超える壁紙アプリの画像カテゴリ分類を Claude Vision API で自動化した実体験。精度・コスト・落とし穴を正直に記録します。
Claude API Messages Batches API でコストを半額にする — 個人開発者が学んだ非同期処理設計
Claude API の Messages Batches API を使って API コストを最大50%削減する非同期設計パターン。個人開発で実際に運用して気づいた設計判断・コスト試算・本番環境でのエラー処理まで実装コードとともに解説します。
Claude API でアプリ内 AI チャットを実装して踏んだ6つの罠 — 本番投入までの設計記録
Claude APIをアプリ内チャットに組み込んで本番で直面した6つの設計ミスを、個人開発での実運用経験から解説。コンテキスト設計、ストリーミング、セッション管理、コスト監視の実装パターンを動くコード付きで紹介します。
Claude API のモバイル統合で個人開発者が直面する設計判断 — コスト・UX・オフライン対応の実践パターン
Claude APIをiOS/Androidアプリに統合する際、個人開発者が最初に直面するモデル選定・非同期設計・コンテキスト管理・オフライン対応・コスト管理の設計判断を、10年の個人開発経験と5,000万DL超の運用知見から解説します。
App Storeのレビュー1,000件をClaude APIで分析したら、自分のアプリの本当の問題が見えてきた
個人開発10年超・累計5,000万DLの経験から語る。App StoreレビューをClaude APIでバッチ分析し、次の改善優先順位を自動生成する実装パターンと、試して気づいた落とし穴を共有します。