すべての記事
Claude API のテレメトリを ClickHouse に流して分析する — 本番環境のコスト・遅延・エラーを可視化する設計ガイド
Claude API のリクエスト単位でコスト・遅延・トークン使用量を ClickHouse に蓄積し、Materialized View でリアルタイムダッシュボードを構築する本番運用設計を解説します。
Claude API の『messages.X.role must alternate』を1分で直す — 400 invalid_request_error の典型パターン
Claude API で頻発する『messages.X.role must alternate』エラーの原因と直し方を、user/assistant の交互ルール・tool_use と tool_result の対応関係・履歴管理の落とし穴に分けて、実例コード付きで整理します。
Claude API で多言語翻訳 SaaS を本番運用する設計ガイド — 用語集・スタイル・ドメイン適応の実装
多言語翻訳SaaSをClaude APIで本番運用するための設計を通しで解説します。タグやプレースホルダーを失わせない前処理、用語集の注入と強制、スタイルガイドによるトーン制御、Few-shotでのドメイン適応、品質ゲートとコスト最適化まで、具体的なコードと運用ノウハウでまとめました。
Claude APIをCloudflare Queuesで非同期処理する：障害復旧と優先度制御を含めた本番設計
Claude APIをCloudflare Queuesで非同期処理する本番グレードのパイプライン設計を、Producer/Consumer両方の動作コード・障害時のリトライ戦略・優先度制御・コスト制御まで含めて解説します。
Claude API を本番投入する前に決めておくインフラ要件 — 規模・SLA・コンプライアンスから逆算する設計判断
プロトタイプは動いたが本番投入の判断基準が曖昧——そんな状態から、トラフィック規模の3段階見積もり、SLAから逆算する可用性設計、データレジデンシーとコンプライアンス、レート制限429の扱いまで、Claude APIのインフラ要件を実数値とチェックリストで決めていく手順を整理しました。
Claude API のセマンティックキャッシュを本番投入する — 類似プロンプト判定としきい値設計、汚染防止
類似プロンプトへの応答を再利用するセマンティックキャッシュをClaude APIの本番に組み込む設計を一気通貫で解説します。embeddingと類似度しきい値の決め方、マルチテナント分離、キャッシュ汚染を防ぐガード層、フォールバックと劣化モード、プロンプトキャッシュとの重ね方、効果を測る観測性の指標まで踏んだ地雷とともに紹介します。
「The requested model does not exist」が消えない理由 — Claude API モデル名と権限の落とし穴
Claude APIのmodel_not_foundエラーは、多くがモデルIDの綴りや古いエイリアスの残存で起きます。2026年4月時点で実在するモデルIDの一覧、Tier・地域・権限の3分チェック、Sonnet 4.6への安全な移行手順、ログから切り分ける診断スニペットまで順に整理しました。
Claude API のレイテンシを下げる4つのインフラ施策 — モデルを変える前に試したい打ち手
Claude API の応答が遅いと感じたとき、モデル変更の前に効くインフラ施策があります。リージョン選定・HTTP接続再利用・プロンプトキャッシュ・ストリーミングの4点を、実装と計測の観点で整理しました。
Claude API × Inngest で耐障害性のある AI ワークフローを本番運用する — リトライ・冪等性・人間承認を組み込んだ実装ガイド
Claude API と Inngest を組み合わせて、リトライ・冪等性・人間承認・ファンアウトを TypeScript の動くコードで実装します。Next.js / Vercel / Cloudflare Workers に乗せられる軽量な耐障害ワークフローの設計指針です。
Claude API × Stripe で月額課金 SaaS を設計する — アーキテクチャから実装まで
Claude API を組み込んだ SaaS の月額課金設計を、Stripe Billing・Usage Metering・Webhook の実装コード付きで解説します。APIコスト管理からティア設計まで、個人開発者が実際に収益化するための設計パターンです。
Claude API のプロンプトキャッシュがヒットしない時の診断手順
Claude API のプロンプトキャッシュが効いていない時、まず確認すべきは usage フィールドです。cache_read_input_tokens がゼロのまま増えない原因を、5つの典型パターンに沿って切り分けます。
Claude API のプロンプトをコードとして管理する — レジストリ・バージョニング・A/Bテストの本番運用ガイド
Claude API を本番運用していると必ず直面する「どの prompt が、いつ、誰に、どの version で配信されたか」を解決するためのレジストリ設計と、A/Bテスト・段階的ロールアウト・自動ロールバックまでを実装レベルで解説します。