すべての記事
Claude API のプロンプトキャッシュで月額コストを半分にした実装メモ
Claude API のプロンプトキャッシュを正しく設計すると、長文プロンプトを使う本番ワークロードは月額コストが体感で半分以下になります。実例ベースで設計のコツとつまずきどころをまとめました。
Claude Code でテスト駆動開発を実装する — エージェントと書く TDD ワークフロー
Claude Code に「先にテストを書いてもらう」という制約を加えると、エージェントの暴走が止まり、生成コードの質が劇的に変わります。私が半年間試行錯誤して辿り着いた、エージェント時代の TDD ワークフローを共有します。
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のストリーミングレスポンスが途中で止まる原因をタイプ別に診断し、タイムアウト・レート制限・max_tokens・クライアント実装バグそれぞれの修正コードを解説します。
Claude Code で個人開発の『単価』を設計する — 収益化までの待ち時間を短くする思考法
個人開発の収益化が遠く感じる原因は、技術ではなく『単価設計』と『リードタイム』にあります。Claude Code を使ってMVPを最短で形にし、最初の収益までの距離を縮める実践的な思考法をまとめました。
Claude API の stop_reason を読み解く — 応答の途切れを「終了」と誤認しないための設計
Claude API のレスポンスに含まれる stop_reason を正確に分岐するだけで、未完了出力の取りこぼしや無駄なリトライが大きく減ります。end_turn・max_tokens・pause_turn・refusal の見分け方と実装パターンをまとめました。
Claude Code に依存ライブラリのアップグレードを任せる — 破壊的変更を見落とさない検証ループの設計
個人開発で 30 を超える依存ライブラリを抱えると、月一の一括アップグレードが恐怖の儀式になります。Claude Code に任せられるところと、人間が手放してはいけない判断を切り分け、破壊的変更を本番に漏らさない検証ループを実例で整理します。
Claude API でジェネレーティブ UI を本番投入する — JSON Schema と Tool Use で動的コンポーネントをストリーミング描画する実装パターン
Claude API のツール呼び出しと部分 JSON ストリーミングを組み合わせ、AI が動的に組み立てた UI コンポーネントを安全に描画する本番設計を、コンポーネントレジストリ・型安全性・フォールバック含めて解説します。
Claude Code の .claude/ ディレクトリをチームで共有する設計 — Git管理する範囲と個人設定の境界
Claude Code の .claude/ をチームで共有する時、どのファイルを Git に入れて、どこを個人設定に残すか。実プロジェクトで得た境界線と .gitignore テンプレートをまとめます。
Claude Code のシークレット管理とトラスト境界設計 — エージェント時代の秘匿情報ハンドリング本番ガイド
Claude Code がシェルを掌握する時代の秘匿情報設計を、トラスト境界・注入パターン・流出防止フックの3軸で体系化。.env から MCP までの本番運用パターンと、よくある落とし穴を実装コード付きで解説します。
Claude Code Hooksが無限ループする問題 — PostToolUseが自己発火するときの止め方
Claude Code の Hooks を仕掛けたら、ツール呼び出しが止まらなくなった。PostToolUse が自分で書き換えたファイルを再び拾って延々と発火し続ける、典型的な無限ループの原因と止め方を実例ベースで解説します。