すべての記事
Haiku 4.5・ストリーミング・プロンプトキャッシングを組み合わせて個人開発アプリのAPIコストを抑えた記録
個人開発アプリのAI機能で膨らむAPIコストを、Haiku 4.5への移行・ストリーミング・プロンプトキャッシングの3つの組み合わせで抑えた記録です。各ステップの実装と落とし穴、統合パターン、実装前後のコスト比較、キャッシュの損益分岐を先に計算する考え方までまとめました。
Claude API の metadata.user_id は何のために送るのか — abuse 検知とプライバシーの折り合いを設計する
Claude API の metadata.user_id は abuse 検知の精度を上げるためのフィールドですが、生のメールアドレスをそのまま渡すとプライバシー上の問題が出ます。HMAC で安定した擬似 ID を作る具体的な実装と、渡すべき/渡さない場面の判断基準をまとめました。
Claude API のプレフィルで『JSON 出力が必ず通る』本番設計 — 個人 SaaS で辿り着いた4層防御
Claude API のプレフィルだけでは JSON パースが落ちる本番ケースを、4層防御パイプラインでパース成功率 99.98% まで持ち上げた実装記録です。切断応答 1,081 件で修復コードを実測し、当初掲載していた閉じ補完の誤りも訂正しています。
Claude API の 400/422/529 を“呼ぶ前”に消す5層プリフライト設計 — 月数百件の失敗呼び出しをゼロにした実装
Claude API の 400/422/529 エラーを“呼ぶ前”に止める5層プリフライト設計を、TypeScript の完全実装と運用1ヶ月分の数値でまとめました。失敗呼び出しのコスト・リトライ・通知ノイズを同時に削減できます。
Claude API のツール呼び出しを Zod で型安全にした — TypeScript 開発者が詰まるポイントと実装パターン
as anyが散らばったツール呼び出しコードを、TypeScriptとZodで型安全に作り直す実装パターンです。スキーマ自動変換とランタイムバリデーション、optionalとnullableの違いやネストしたunion型の変換など詰まりやすいポイント、複数ツールの管理方法までを実践コード付きで解説します。
Claude Agent SDKでサーガパターンを実装する — 補償トランザクションと冪等性の設計
Claude Agent SDKで複数ステップのワークフローを安全に組み立てる実践ガイド。補償トランザクション・冪等性キー・部分失敗時の状態復元を、本番環境で動かしてきた構成パターンとともに紹介します。
Claude Agent SDK の Transactional Outbox 実装 — 「副作用の取りこぼし」を本番でゼロにする設計
Claude Agent SDK で発生する「DBには書かれたのにメール/決済/通知が飛ばなかった」事故を防ぐため、Transactional Outbox パターンを Postgres と Cloudflare Queues を例に本番品質で実装する手順をまとめます。
Claude Haiku / Sonnet / Opus 切替戦略で利益率を最大化する実装ガイド
Claude APIのモデルをタスク複雑度に応じて動的に切り替え、API費用を大幅削減しながら品質を維持する実装パターンを詳解。実コスト計算・ルーティングロジック・プロンプトキャッシング併用まで解説します。
「営業チームが欲しがる」AI自動化 — Claude Agent SDK で構築するマルチエージェント営業支援システム
Claude Agent SDK を使ってリード管理・提案書生成・フォローアップを自動化するマルチエージェント営業支援システムを本番レベルで構築する完全ガイド。コスト最適化・人間レビューゲート・CRM連携の実装例も詳細に解説します。
Claude API × Python 実践：ツール呼び出しとストリーミングを組み合わせてAIアシスタントを作る
Claude API の Tool Use とStreamingを同時に使うPython実装を解説。ツールを定義してリアルタイム応答するAIアシスタントの完成コードと、組み合わせ時に詰まりやすいポイントを丁寧に解説します。
Claude API で実装する自律リサーチエージェント: Web検索・要約・知識管理の完全システム設計
技術調査を任せられる自律リサーチエージェントをClaude APIとWeb検索ツールで組み立てる設計を紹介します。エージェントループの制御、信頼できる情報だけを通す品質保証レイヤー、知識ベースへの格納、3層の予算制御と暴走防止まで、個人開発者が本番で運用できる構成を通しで解説します。
Claude API のツール実行エラーを Claude 自身に診断させる — 自己修正ループの設計と本番実装
Tool Use実装で避けられないツール実行エラーの対処法を解説。is_errorフラグを活用してエラー情報をClaudeに返し、自己診断・修正ループを実装する実践的なPythonコードと本番でのアンチパターンも紹介します。