Claude API のツール呼び出しを Zod で型安全にした — TypeScript 開発者が詰まるポイントと実装パターン
as anyが散らばったツール呼び出しコードを、TypeScriptとZodで型安全に作り直す実装パターンです。スキーマ自動変換とランタイムバリデーション、optionalとnullableの違いやネストしたunion型の変換など詰まりやすいポイント、複数ツールの管理方法までを実践コード付きで解説します。
Claude Haiku / Sonnet / Opus 切替戦略で利益率を最大化する実装ガイド
Claude APIのモデルをタスク複雑度に応じて動的に切り替え、API費用を大幅削減しながら品質を維持する実装パターンを詳解。実コスト計算・ルーティングロジック・プロンプトキャッシング併用まで解説します。
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を組み合わせる実装パターンを詳解。頻出エラーの根本原因、リサーチエージェントの完全実装コード、本番でのコスト・タイムアウト設計まで体系的に解説します。
Claude API のストリーミングを途中で止める — AbortController の正しい使い方と請求の仕組み
Claude API のストリーミングを AbortController で止めたとき、実際に請求される出力トークンを100回計測しました。中断ドリフトの実測値、close 未配線が生む月18.7ドルの差、プロキシのバッファリング問題までを Node.js と Python の実装つきで扱います。
iPhone のショートカットから Claude API を呼ぶ — 選択テキストを瞬時に整形する個人開発者向けの運用ノート
iPhone のショートカット.app から直接 Claude API を呼び、選択テキストを瞬時に整形・要約する実装手順を、個人開発者の運用視点でまとめました。Cloudflare Workers で API キーを保護する方法もあわせて解説します。
Claude API のリトライを書いたらレート制限が悪化した話 — Retry-After を読まないリトライの罠
Claude API でリトライを実装したのに 429 エラーがむしろ増えた、という相談をよく受けます。原因のほとんどは Retry-After ヘッダーの無視と、ジッターのない指数バックオフです。診断と修正手順をまとめました。
「The requested model does not exist」が消えない理由 — Claude API モデル名と権限の落とし穴
Claude APIのmodel_not_foundエラーは、多くがモデルIDの綴りや古いエイリアスの残存で起きます。2026年4月時点で実在するモデルIDの一覧、Tier・地域・権限の3分チェック、Sonnet 4.6への安全な移行手順、ログから切り分ける診断スニペットまで順に整理しました。
Claude API × Inngest で耐障害性のある AI ワークフローを本番運用する — リトライ・冪等性・人間承認を組み込んだ実装ガイド
Claude API と Inngest を組み合わせて、リトライ・冪等性・人間承認・ファンアウトを TypeScript の動くコードで実装します。Next.js / Vercel / Cloudflare Workers に乗せられる軽量な耐障害ワークフローの設計指針です。
Claude API のプロンプトキャッシュがヒットしない時の診断手順
Claude API のプロンプトキャッシュが効いていない時、まず確認すべきは usage フィールドです。cache_read_input_tokens がゼロのまま増えない原因を、5つの典型パターンに沿って切り分けます。
Claude API を本番にのせる前に揃えるインフラ — 「動く」と「本番で持つ」の間にある8つの実装
ローカルで動く Claude API のコードを本番に移すと、レート制限・タイムアウト・課金事故・無音障害が一気に襲ってきます。月数万リクエスト規模を運用して見えた、必要最小限のインフラ8項目を整理しました。