Claude 非同期パイプラインで「毒メッセージ」を隔離する — デッドレターキュー設計の実装メモ
1件の壊れた入力がバッチ全体を止める「毒メッセージ」問題を、Cloudflare Queues のデッドレターキューで隔離する設計と実装。Claude API 特有の失敗パターンの切り分けまで実体験ベースでまとめます。
Claude API の max_tokens 打ち切りを継続生成でつなぐ — 重複とコードブロック分断を防ぐ実装
長文生成が途中で切れる max_tokens 打ち切りを検出し、assistant プレフィルで続きを書かせ、つなぎ目の重複やコードフェンスの分断を防いで安全に組み立てる継続生成の実装パターンをまとめました。
Claude API の本番観測性を OpenTelemetry GenAI 規約で再設計する — モデル移行とコスト監査に耐える設計メモ
Claude API を組み込んだプロダクションサービスの観測性を、OpenTelemetry GenAI セマンティック規約に揃えて再設計するための実装メモ。スパン属性、メトリクス、コスト追跡、モデル切替時のリプレイ性を、個人開発サービスで運用してきた経験から具体的なコードで示します。
Claude API のストリーミングで tool_use の引数が JSON パースに失敗する原因と対処
Claude API のストリーミングで tool_use を受け取ると、なぜか JSON.parse が SyntaxError を返す。input_json_delta の正しい組み立て手順と、再接続時の取りこぼし対策をまとめます。
Claude API のスケジュール運用で観察した tail latency と、リトライストームを抑えるガードレール設計
個人開発で 6 サイトを並行運用し、14 日分のログから p95/p99 の輪郭とリトライ嵐の発生条件を観測しました。ジッタ・バジェット・サーキットブレーカーを組み合わせた本番ガードレールの実装と、観測 → 設計 → 改善の比較値をまとめます。
Claude の output_format タグで仕様逸脱を抑える運用 — 個人開発アプリのコピーライティング自動化で固まった設計
ストア説明文やASOコピーを多言語で量産しても仕様が崩れないよう、Claudeのoutput_formatタグを軸に固めた設計を実運用から書き起こしました。最小構成の例、出力崩れを防ぐ5つのチェックポイント、100言語を並列バッチで流すときの落とし穴、App Store Connect運用への組み込みまで扱います。
App Storeのレビュー1,000件をClaude APIで分析したら、自分のアプリの本当の問題が見えてきた
個人開発10年超・累計5,000万DLの経験から語る。App StoreレビューをClaude APIでバッチ分析し、次の改善優先順位を自動生成する実装パターンと、試して気づいた落とし穴を共有します。
Claude API で実装する自律リサーチエージェント: Web検索・要約・知識管理の完全システム設計
技術調査を任せられる自律リサーチエージェントをClaude APIとWeb検索ツールで組み立てる設計を紹介します。エージェントループの制御、信頼できる情報だけを通す品質保証レイヤー、知識ベースへの格納、3層の予算制御と暴走防止まで、個人開発者が本番で運用できる構成を通しで解説します。
Claude API で社内ドキュメント横断検索エージェントを作る — ハイブリッドRAG・部署別アクセス制御・監査ログの本番実装
Claude API × Python で社内 Wiki・PDF・Notionを横断検索するエージェントを本番品質で実装します。ハイブリッドRAG・RBAC・監査ログの3セットを動くコードで解説。ナイーブRAGの情報漏洩リスクを防ぐ設計パターンも紹介。
週次レポートの手作業から解放される — Claude API × GitHub × Linear × Slack の自動化実装
毎週のSlack進捗報告をClaude APIで自動化する実装ガイド。GitHub・LinearのデータをClaude APIで整形してSlackに投稿するNode.jsシステムを、実際のコードを交えて解説します。
Claude API Pythonクライアントで最初によく出るエラー：初心者が詰まる7つのポイントと解決コード
Claude API Python SDKを使い始めた際に遭遇しやすい7つのエラーを、原因と修正コードをセットで解説。AuthenticationError・RateLimitError・BadRequestError・レスポンス解析ミスなど、初心者が詰まりやすいポイントを体系的にまとめました。
Claude APIとGoogle Apps ScriptでGmailを自動分類・返信する
Claude APIとGoogle Apps Scriptを組み合わせ、Gmailの受信メールを自動分類して返信下書きまで生成する仕組みを作ります。APIキーの取得とGASプロジェクトの準備、メール取得と分類プロンプト、ラベル付けと下書き作成の自動化、つまずいた3つのポイントまでコピペで動くコード付きです。