すべての記事
Claude Code で Go の REST API を本番品質に仕上げる — Gin・GORM・Docker・CI/CD の実装手順と運用の勘所
Claude Code と Go で REST API を本番品質に育てるための実装手順をまとめました。Gin・GORM による Clean Architecture 設計から、graceful shutdown・Docker 最小イメージ・GitHub Actions まで、運用で効く判断基準とともにお伝えします。
ネスト型サブエージェントのコンテキスト予算 — 5階層委譲で品質を落とさない契約設計
サブエージェントが入れ子にできるようになった後、深い委譲ほど要約が痩せて再実行が増えました。階層間にトークン予算と受け渡しスキーマ、失敗隔離、独立グレーダーの4つの契約を入れて品質を立て直した実装記録です。
Claude Vision API 実装パターン — 画像解析・PDF 処理・OCR を本番品質で動かすまで
Claude API のビジョン機能を本番投入するための実装パターンをまとめました。Base64・URL・Files API の使い分け、ネイティブ PDF 処理、Tool Use による壊れない構造化抽出、Batch API でのコスト削減、エラー対処まで動くコードで解説します。
Claude API Python 上級クックブック：本番運用で効く実践パターン集
Claude APIをPythonで本番運用するときに効く実装パターンを20個に厳選したコードレシピ集です。リトライを含む堅牢な呼び出し基盤、非同期・並列処理、コスト最適化、テストとデバッグ、監視と運用までを段階的に整理し、どこから手をつけるかの優先順位も併せて示します。
サブエージェントの入れ子は何階層が実用的か — 5階層ネスト解禁後に委譲構造を見直した記録
Claude Codeのサブエージェントが最大5階層まで入れ子にできるようになりました。実際に深い委譲を組んで「伝言ゲーム問題」による要約減衰とコスト増を確かめ、責務が3種類なら3階層で止めるという結論に至った過程と、深い委譲で守っている実務ルールを共有します。
編集した SKILL.md が反映されない — /reload-skills と .claude/skills 自動ロードで再起動なしに差し替える
SKILL.md を編集しても実行中のセッションには反映されません。.claude/skills 自動ロードと /reload-skills、SessionStart フックを組み合わせた再起動なしの差し替え運用と、版番号による検証手順を実運用の経験から整理します。
Managed Agents にスケジュールデプロイと vault が加わったので、自前 cron 運用との住み分けを決めた記録
6月12日の更新で Claude Managed Agents にスケジュールデプロイ・vault 環境変数・セッションスレッド Webhook が加わりました。自前の cron と平文クレデンシャル運用から何を移し、何を残すか。冪等性を軸にした判断基準と受け口の実装を残します。
「続きを書いてください」をやめる — Claude Fable 5 の 128k 出力で長文レポート生成を一括化した実装記録
数万字の月次レポートを生成するたび、出力上限で切れて「続きから」と投げ直していた運用を、Claude Fable 5 の 128k 出力で一括化しました。ストリーミングで受け切る実装、切断からの再開設計、分割生成との費用比較を実測ベースで残します。
Claude API の Code Execution ツールに月次の売上CSV集計を任せる — Files API 連携から課金の落とし穴まで
月末に形式の違う売上CSVを突き合わせる作業を、Claude API の Code Execution ツールに任せた実装をまとめます。Files API 連携、コンテナ再利用、5分最小課金やファイルプリロード課金などの注意点を実例ベースで扱います。
Claude Fable 5 を Opus 4.8 と三日間並走させて決めた、6月15日以降のモデルの使い分け
6月9日公開の Claude Fable 5 を、無料同梱の導入期間のうちに Opus 4.8 と同じ開発タスクで並走させました。長文コンテキストで出た差、単発修正での無風、フォールバック観察と、6月15日の課金変更後の使い分けを残します。
Claude Code の fallbackModel を三段構成にする — 過負荷の朝でも止まらない無人実行の設計記録
Claude Code の fallbackModel を三段構成で運用し、過負荷時も夜間バッチを止めない設計を実測つきでまとめます。実行モデルの記録方法、下位モデルに落ちた日の品質差への備え、deny ルール併用まで。
Android でペイウォールとレビュー誘導が重なって表示される競合を ModalGate で解決した実装メモ
ペイウォール・レビュー誘導・リワード広告案内の3つのダイアログが同時に表示される競合を、優先度付きの中央ゲート（ModalGate）で解決した実装メモです。Claude Code とのレビューで見つかった閉じ漏れの3経路と Kotlin 実装例を紹介します。