Claude Code Hooks の本番デバッグ術 — ログが足りない時、どこから切り分けるか
ローカルでは動くのに本番で沈黙するClaude Code Hooksの切り分け方を体系化しました。まず疑うべきは出力先という視点、ログ不足を補う3層の可観測性、最小再現環境を60秒で作るテクニック、JSON入出力とexit codeのプロトコル把握、マルチユーザー環境の権限診断まで扱います。
Claude Agent SDK でシャドウモードを実装する — 本番影響ゼロでエージェント精度を測る段階的ロールアウト設計
AIエージェントを本番に出す前に精度を測りたい。でもユーザーに触れさせるしかない。この矛盾を解くのがシャドウモードです。Claude Agent SDK で既存フローに影響を与えずエージェントを並走させ、差分を記録し、段階的に昇格するまでの実装を解説します。
Claude API の高可用性設計 — Sonnet / Haiku / Opus マルチモデルフォールバックを本番で成立させる
Claude API を単一モデル前提で組むと、障害やレート制限の瞬間にサービス全体が止まります。Sonnet・Haiku・Opus を段階的にフォールバックする本番実装を、コード・Circuit Breaker・ストリーミング対応まで含めて整理しました。
Claude API の tool_choice で無駄な推論を減らす — 4モードの使い分けとコスト最適化パターン
Claude API の tool_choice パラメータは、ツール呼び出しの挙動とコストの両方を左右します。auto / any / tool / none の4モードを実運用で使い分けるパターンを、動くコードとともに整理します。
Claude API の Parallel Tool Use を本番で使いこなす — 並列実行の制御・部分失敗の設計・レイテンシ最適化
Claude API の Parallel Tool Use は応答を体感で半分にしますが、部分失敗や二重書き込みの事故も増えます。asyncio.gather と Semaphore による制御、部分失敗の3方針、冪等性、観測、並列度の計測までを実運用の視点で書き残します。
Claude Agent SDK でプログレッシブデリバリーを実装する — カナリア・Feature Flag・自動ロールバックの本番パターン
Claude Agent SDKで構築したAIエージェントを本番へ安全にリリースするためのプログレッシブデリバリー実装パターン。カナリア配信・Feature Flag・SLOベースの自動ロールバックを組み合わせた実装コードと運用指針をまとめました。
エージェントに「承認ゲート」を差し込む — Claude API で Human-in-the-loop を本番運用する設計
自律エージェントの一部の判断だけを人間に委ねる承認ゲートを、Claude APIで本番に組み込む設計です。ゲートを入れる5つの場所、メッセージ履歴を保存した中断と再開、Slackやメールでの非同期通知、承認待ちの期限切れの扱い、監査ログに耐える構成まで動くコード付きで解説します。
Claude API インテリジェントモデルルーティング — Sonnet 4.6 / Haiku 4.5 自動選択でコストと品質を両立する設計パターン
リクエスト内容に応じてClaude Sonnet 4.6とHaiku 4.5を自動切り替えするインテリジェントルーティングの実装。分類器の設計からサーキットブレーカー、コスト監視まで本番運用パターンを網羅
Claude Sonnet 4.6 を本番で回しながら、Sonnet 5 への移行を下見する
Claude Sonnet 4.6 は 2026年2月17日リリース、いまは legacy 扱いで retirement は 2027年2月17日以降です。1Mコンテキスト・thinking・Computer Use の実装に加え、Opus 4.6 との実価格比較と、Sonnet 5 移行で 400 が返る5つの段差を整理します。
Claude API プロダクション耐障害設計パターン — モデルルーティング・サーキットブレーカー・フォールバック戦略の実装ガイド
Claude APIを本番運用で支える耐障害設計の実装パターン。サーキットブレーカー、モデルルーティング、フォールバックチェーン、リトライ戦略、ディザスタリカバリをTypeScriptの実装コードと、運用で気づいた注意点を添えて整理しました。
Claude API LLM評価パイプライン構築ガイド — Claude-as-Judge・プロンプトA/Bテスト・品質スコアリングの実装パターン
Claude API を使った LLM アプリケーション評価パイプラインの設計と実装。Claude-as-Judge、プロンプト A/B テスト、品質スコアリング、回帰テストの本番実装パターンを扱います。
Claude API の同時実行を束ねる — シングルフライトで重複推論とキャッシュ・スタンピードを防ぐ
同一プロンプトが同時に何度も Claude へ飛ぶ重複推論を、シングルフライト（request coalescing）で束ねる設計です。プロセス内・分散環境の実装、ジッター付きリトライ、負のキャッシュまで実測付きでまとめました。