Claude API × Stripe で月額課金 SaaS を設計する — アーキテクチャから実装まで
Claude API を組み込んだ SaaS の月額課金設計を、Stripe Billing・Usage Metering・Webhook の実装コード付きで解説します。APIコスト管理からティア設計まで、個人開発者が実際に収益化するための設計パターンです。
モデルが予告なく使えなくなる日に備える — 引退・撤回・過負荷を一つのステートマシンで扱うルーター設計
あるモデルが、技術的な障害ではなく外部都合で短時間のうちに使えなくなる。引退・撤回・一時的な過負荷という三種の「使えない」を一つの可用性ステートマシンで扱い、自動運用を止めないルーターを TypeScript と Python の動くコードで設計します。
Claude API のモデル抽象レイヤー設計 — 世代交代に業務ロジックを巻き込まない内部アーキテクチャ
モデル文字列を業務コードに直書きすると、世代交代のたびに本番が静かに壊れます。論理ロールと物理モデルIDを切り離す anti-corruption layer を、TypeScript と Python の動くコード・移行コスト・実運用の判断軸とあわせて設計します。
Subagent 間で状態を渡す3つの設計パターン — 4ヶ月のブログ自動生成で見えた使い分け
Subagentパイプラインで親子間の状態を引き渡す3つの方法——JSONファイル・環境変数・Context Bundle——を、4ヶ月のブログ自動生成の本番運用データで比較しました。件数規模ごとの推奨レンジと、重複回避やカテゴリバランスなど実際に渡している情報の設計を紹介します。
Claude API の 200K コンテキストをどう割り振るか — システム・ツール・メモリ・履歴の予算枠を実運用で決めた話
Claude API の 200K コンテキストを「無制限の置き場」ではなく予算として扱い、システム・ツール定義・メモリ・履歴・回答ヘッドルームに枠を切る設計を、TypeScript の実装コードと壁紙アプリ運用で得た数値とともに記録しました。
Claude Code の Sub-agent パターン — 複雑なタスクを自律的に分解・並列処理する設計手法
Claude Codeが内部で使うSub-agentアーキテクチャを解剖し、タスク分解・並列実行・結果統合を自分のプロジェクトで設計する手法を解説します。分解の粒度をCLAUDE.mdで制御する方法、並列処理のガードレール、モノレポでの実践、デバッグと監視の勘所までを扱います。
Claude Managed Agents を本番へ移すときに躓く境界 — Agent / Environment / Session の分離と、鍵をサンドボックスへ渡さない構成
Claude Managed Agents の本番設計を、SDK の実際の型で確かめながら整理します。サンドボックス制御・永続メモリ・認証情報・マルチエージェント・コスト計測が、それぞれどのオブジェクトに属しているかを扱います。