すべての記事
ハルシネーションを本番で抑える: Claude API 多層防御アーキテクチャの設計図
Claude API を本番投入したときに最後まで残るのが、ハルシネーション（事実誤認）への対処です。プロンプト工夫だけでは限界がある、という結論に至った私の運用記録から、入力・推論・出力・事後検証の4層で誤回答を抑える具体的な実装パターンを共有します。
Claude API のReplay駆動テスト — 本番応答を録画して回帰テストを成立させる設計パターン
非決定的なClaude APIの応答を録画・再生し、回帰テストを安定させるReplay駆動テストの設計です。Messages API・Streaming・Tool Use多段それぞれのカセット実装、メッセージハッシュをキーにする理由、CIへの録画ガード組み込み、本番障害の再現への応用まで扱います。
Claude API × WebSocket × Redis Pub/Sub でスケーラブルなリアルタイム AI チャットサーバーを構築する — Node.js 本番設計・マルチユーザー対応・コスト制御の実装
Claude API × WebSocket × Redis Pub/Sub でリアルタイム AI チャットサーバーを本番運用する設計と実装。SSE との判断基準、マルチインスタンス対応、停止遅延がユーザーごとの予算精度をどう崩すかまで、計測コードつきで扱います。
Claude API のプロンプトキャッシュで月額コストを半分にした実装メモ
長文のシステムプロンプトを毎リクエスト送る本番ワークロードでは、プロンプトキャッシュの設計次第で月額コストが大きく変わります。ヒット率の計測から始める手順、TTLの選択、トークン下限と4ブロック上限の制約、toolsを1つ足してヒット率が0になった失敗談まで半年の運用実例でまとめました。
Claude の「Spanner Temporarily Unavailable」エラーが出たときの読み解き方と対処法
Claude API や Claude.ai で稀に発生する「Spanner temporarily unavailable」エラー。表示は短いのに原因が見えにくいこのエラーを、Anthropic のインフラ構造から逆算して読み解き、開発者が今すぐ取れる現実的な対処法を整理します。
Claude API で『解約されにくい』マイクロSaaS を作る — 月10万円を安定生産する6つの実装パターン
月10万円のマイクロSaaSは『作る』より『保つ』ほうが難しい。Claude API を組み込んだサブスクで解約率を抑え、安定収益を作るための実装パターン6本を、Stripe と Cloudflare Workers の動くコード付きで丁寧にまとめました。
Claude APIストリーミングが途中で切れる — 症状別の診断と修正パターン
Claude APIのストリーミングが途中で止まるとき、まず「エラーか無音か」で切り分けます。ネットワークタイムアウト、429や529のレート制限、コンテキストウィンドウ超過、max_tokens到達、クライアント実装のバグという5つの原因別に診断手順と修正コードを示し、本番で使える実装に仕上げます。
Claude API の stop_reason を読み解く — 応答の途切れを「終了」と誤認しないための設計
Claude API のレスポンスに含まれる stop_reason を正確に分岐するだけで、未完了出力の取りこぼしや無駄なリトライが大きく減ります。end_turn・max_tokens・pause_turn・refusal の見分け方と実装パターンをまとめました。
Claude API でジェネレーティブ UI を本番投入する — JSON Schema と Tool Use で動的コンポーネントをストリーミング描画する実装パターン
Claude API のツール呼び出しと部分 JSON ストリーミングを組み合わせ、AI が動的に組み立てた UI コンポーネントを安全に描画する本番設計を、コンポーネントレジストリ・型安全性・フォールバック含めて解説します。
Claude APIサービスに使用量課金を実装する — トークン計測・価格換算・Stripe Metering実装ガイド
Claude APIを組み込んだサービスで使用量に応じた課金を実装する方法を完全解説。トークン計測から価格換算ロジック、Stripe Metered Billingとの統合、利用制限の実装まで動作確認済みコードで紹介します。
Claude API × Tauri 2 で本番デスクトップ AI アプリを構築する — Rust ブリッジ・SSE ストリーミング・配布までの実装
Tauri 2 と Claude API を組み合わせて、軽量で安全な本番デスクトップ AI アプリを構築する方法を解説。Rust 側でのキー保管、SSE ストリーミング、Tool Use 実装、コード署名と配布までを実装コード付きで体系的にまとめます。
Claude APIで「知識商品」を自動生成して販売する — PDF・テンプレート・ニュースレターで収益を作る仕組み
Claude APIでPDFレポート・テンプレート・ニュースレターといった知識商品を自動生成し、BASEやGumroad、Stripeで販売する収益構造の作り方を解説します。個人開発者にこの形態が向いている理由の整理から、PDF自動生成サービスの最小構成の実装例まで、コードとともに紹介します。