メンバーシップ
実装コード付きの上級ガイドが読み放題
Claude Lab をご覧いただきありがとうございます。コピー&ペーストで使える実装コード、ベンチマーク結果、本番設計パターンを含む上級ガイドを毎日追加しています。無料記事で基礎を学んだ後の「次の一歩」として、お役に立てれば幸いです。
- ✦すべてのプレミアム記事が読み放題
- ✦毎日追加される実装コード付き上級ガイド
- ✦本番環境で使える設計パターン・ベストプラクティス
プレミアム記事
399 本の限定記事MCPサーバが十数個を超えてから、起動直後の一覧を信用しなくなりました
起動直後に「接続できません」と並ぶサーバのうち、こちらから手を打てるものは一部だけです。応答なし・起動失敗・プロトコル拒否を分けて返すプローブを実装し、14台構成で逐次22.03秒が並列5.09秒まで縮むところ、待ち時間を詰めると健全なサーバが失敗に化けるところを実測で残しました。
無音で半分になっていた定期実行と、欠落を捕まえる突き合わせ
1日2回動いているはずのバッチが、実際には1回しか起動していませんでした。エラーは1件も出ていません。期待起動回数と実行記録を突き合わせて、無音の欠落を検出する仕組みを作ります。
モデルIDを一括置換する前に、手元の CLI が抱えるカタログを引きます
新しい世代が出ると、前の世代のモデルIDが急に古く見えます。インストール済みの実行ファイルに埋め込まれたカタログを引き、一致・日付不一致・書式破損の三段に仕分けてから直す手順を、実測値とスクリプトつきでまとめました。
連携フォルダに置いたロックが、二度目の無人実行を締め出すまで
クラウド同期の連携フォルダでは作成も改名も通るのに、削除だけが拒まれます。そこへ二重起動防止のロックを置いた結果、二度目以降の無人実行が永久に見送られました。三方式の実測と、ロックの置き場所を分ける実装をまとめます。
検証スクリプトの出力を、そのまま hook から返してはいけません
hook に足した検査スクリプトは正しく動いていたのに、会話のほうが先に容量を使い果たしていました。833ファイルを走査して58バイトしか返さない検査と、同じ対象で42KBを返す検査を実測で並べ、hook に出力予算を設ける設計をまとめます。
リポジトリに置いた allow を信じるか、環境側の信頼登録に寄せるか
使い捨ての実行環境で Claude Code を非対話で走らせると、リポジトリ内の permissions.allow が信頼待ちのまま落ちます。何が落ちて何が残るのかを 2.1.246 で確かめ、許可設定の置き場所を決め、起動前に検出するプリフライトを用意します。
キャッシュのTTLを1時間に延ばすかは、離席の長さではなく戻る場所で決めています
Claude Code v2.1.242 で promptCacheTtl と subagentPromptCacheTtl が追加されました。1時間キャッシュが効く条件は離席時間ではなく、同じ作業ディレクトリと同じ git 状態へ戻るかどうかです。判断の順番と、効いているかを確かめる手順をまとめました。
空白ひとつで、80件の検査が0件になる — 一括処理を任せる前に置くガード
空白を含むフォルダ名の下で走らせた検査ループが、80件のうち1件も開いていませんでした。断片が実在パスに化ける仕組みを実測で切り分け、削除を伴うバッチに置く件数アサーションまで書き残します。
同じスキルを二か所に置いていたら、片方だけ中身が痩せていました
同名のスキルが二つのスコープに存在していました。SKILL.md は sha256 まで一致しているのに、片方には本文が名指ししているファイルが入っていません。66本を走査して欠落2件に絞るまでに検出器を三度書き直した記録です。
コネクタが使えない朝に、待つのか人に返すのかを分ける三つの状態
無人実行でコネクタに届かないとき、原因は起動途中・未認証・恒久欠落の三つに分かれます。それぞれ正しい対処が正反対になる理由と、待機予算を切り分ける判定器の実装をまとめました。
Claude Code の headersHelper に移したら、プロジェクト配下のカタログだけ認証が通らなくなりました
自前のプラグインカタログを headersHelper へ移す途中で、ユーザースコープでは動くヘルパーがプロジェクト配下だけ落ちました。原因は認証情報の非継承です。動くヘルパー2種と実測した実行コスト、無人実行での注意点をまとめました。
Claude Code の read deny が許可フォルダの内側まで届いていなかった話
秘密ファイルとソースが同じツリーに同居する個人開発環境で、permissions.deny の Read ルールが実際にどのファイルまで届いているかを数え直した記録です。棚卸し用のスクリプトつき。
起動しただけで1万トークン消えるスキルを、大きさではなく到達率で切り分ける
自分用の運用スキルが、呼び出しただけで約1万トークンを消費していました。節ごとにトークンを測り、最大の節ほど切り出してはいけない理由と、到達率で分けたときの実測値を、監査スクリプトつきでまとめます。
一度キャッシュに載った500ページは、直しても消えません
修正をデプロイしたのに壊れたページが出続けたことがあります。原因はコードではなくエッジキャッシュでした。ステータスコードだけを見る保存判定が、200で返る壊れたHTMLを通していたのです。本文の完全性で保存可否を決めるガードの実装と、運用で調整した誤検知の線引きを、実際に踏んだ経緯とともに書きました。
透かし入りの生成テキストを、アプリの配信物に載せる前に決めておくこと
2026年8月2日以降のClaudeモデルは生成テキストに機械可読の透かしを埋め、ファイルにはC2PA署名メタデータを付けます。個人開発の配信物でどこまで通してよいかの線引きと、出所を再現できる提出ゲートの作り方を実測とコードで整理します。
フォーク既定のサブエージェントで、レビュー役だけは名前で呼ぶという線引き
サブエージェントのフォークが既定になり、親の会話をそのまま引き継ぐようになりました。作業は継承させ、判定は継承させない。その境界をリポジトリに宣言し、ずれを機械的に見つけるまでの設計です。
Todo ツールが既定オフになった Claude Code で、多段作業の進捗をどう追うか
Claude Code v2.1.233 以降、新しいモデルでは TodoWrite と Task 系ツールが既定で読み込まれません。環境変数で戻す前に確かめるべき3つの分岐と、チェックリストの代わりに置いた作業台帳の実装、並列実行で台帳が壊れた境界の実測結果をまとめます。
長考の途中で切れる接続は、上流ではなく中継が作っています
自作プロキシや Worker を挟んだ途端、Claude Code が長い思考の最中に切断される。原因は上流でもモデルでもなく、中継がバイトの流れを止めていることにあります。6通りの中継を並べて切り分け、本番に入れる前に確かめる手順まで整理しました。
生成物1ファイルが手書きコード70本より重いので、Claude Code に読ませる範囲を決め直しました
運用中のリポジトリを対象に、どの領域が文脈をどれだけ食うかを数え直しました。生成物の除外・探索パターンの選び方・settings.json での固定まで、実際に決めた運用ルールとその根拠をまとめます。
課金ユーザーに広告が出る不具合を、判定の一元化で止めるまで
広告除去を購入した方に広告が出てしまう不具合の原因は、フラグの不足ではなく判定の分散でした。Claude Codeで広告SDKの呼び出し口を棚卸しし、単一の純粋な判定関数へ畳み込むまでの実装記録です。期限判定を端末時計に預けない工夫や、消し忘れを構造で防ぐ設計も紹介します。
同じ rm -rf が、10箇所では戻せて5箇所では戻せませんでした — auto モード既定化の前に可逆性を測る
8月14日から auto モードが Pro / Max / Team の既定になります。止まる境界は「取り消せない・破壊的・環境の外」ですが、可逆性は操作の名前ではなく実行時点の状態で決まりました。復旧不能バイトを数えるプローブと、15対象の実測をまとめます。
一時的な401が長期トークンを置き換える — ヘッドレス実行の資格情報に「出所」を持たせる
共有した資格情報ファイルは、たった一度の一時的な401で長期トークンを失うことがあります。24並列の実行に401を1回だけ注入して被害範囲を実測し、資格情報に出所フィールドを持たせるガードと隔離のコストを比較、24マイクロ秒で現在地を確定する起動時カナリアまで検証しました。
同じコミットから作った zip なのに SHA-256 が変わる — プラグイン配布のピン留めを壊さない正規化
HTTPS 経由の zip からプラグインを導入できるようになり、SHA-256 のピン留めも選べるようになりました。同一内容の zip を2回作って測ったところ、22,669 バイト中 50 バイトだけが異なりハッシュが毎回変わりました。原因の測定と、20回連続で同一ハッシュになる正規化手順をまとめます。
権限モードを変えても止まらない書き込み — サブエージェント用 PreToolUse ゲートを150通りで測る
ワークフローのサブエージェントによるファイル編集は、セッションの権限モードに関わらず自動承認されます。残る境界である agent_id / agent_type ベースの PreToolUse フックを150通りのペイロードで測り、素通りしていた54件の内訳と、フェイルクローズへ寄せた実装を共有します。
呼んだはずのスキルが何も返さない — 起動前に名前の解決順序を確定させる
端末の組み込みコマンドと同名のスキルは、非対話セッションで呼び出しが解決されないことがあります。実効名の表を起動前に作る preflight を書いて走らせ、検査器自身が取りこぼしていた2件までを実測で洗い出した記録です。
秘密を渡さず、リクエストだけ通す — サンドボックス資格情報マスキングの差し替えが効く境界
Claude Code のサンドボックス資格情報マスキングは、センチネル値を読ませて送信時に実値へ差し替える設計です。差し替えが効く認証方式と効かない方式、そしてボディに載せたときに生じる長さのずれを、最小プロキシを自作して実測しました。
ファイルシステムの分離をネットワークと別に締める — 触ったパスを採り、書き込み面から絞る
Claude Code v2.1.216 でファイルシステムの分離をネットワークと切り離して指定できるようになりました。締める前にジョブが触ったパスを strace で採取し、読み取り面と書き込み面を分けて測った実務メモ。同じジョブを3回走らせたときのパス集合の安定率と、接頭辞に畳んだときの安定率の差まで実測しています。
存在チェックが通っても書けない — 無人実行の前提を能力プローブで測る
ディレクトリが存在することと、そこへ書けることは別の問題です。無人で走るClaude Codeのセッションが静かに止まる原因を実測し、存在チェックの代わりに実際の読み書きを試す能力プローブ方式のプリフライトを設計しました。書けるのに消せない場所やシェルの落とし穴も扱います。
予算上限で止まった実行の再開設計 — 停止点36通りを総当たりして分かったこと
ヘッドレス実行が予算上限で止まると、成功でも失敗でもない第三の終了が生まれます。停止点36通りを総当たりして再開の健全性と総支出を測った実験から、原子的な書き込みとインデックス優先の再開、上限をバッチ全体でなく最小の再開単位に掛ける設計へ至った記録です。
会話の途中でツールを差し替える — プロンプトキャッシュを守るツールレジストリの設計
ターン間でツールを追加・削除できるようになった一方、ツール定義はキャッシュプレフィックスの最前列にあります。12種類の変更を指紋で実測し、安定コアと揮発テールに分けるレジストリ設計とガード実装をまとめました。
400文字だけ残したはずのツール出力が、1MB を握り続けていた
自作の MCP サーバーやツールラッパーで出力を切り詰めても、Node の sliced string は元の全文を握り続けます。境界が13文字であること、平坦化が効く書き方と効かない書き方、ヒープスナップショットから親を数える監査スクリプトまで、すべて実測して記録しました。
作業ルートを途中で足したとき、無視規則と deny はどこまで届くのか — DirectoryAdded で境界を測り直す
セッション途中で作業ルートを追加すると、無視規則も deny パターンもそのままでは新しいルートに届きません。git check-ignore と照合器の比較で境界を実測し、DirectoryAdded から呼ぶ差分監査スクリプトの実行結果まで記録しました。
MCPサーバーは繋がっているのに、ツールが0件で返る — 無人実行の権限劣化をツール表の差分で止める
資格情報が抜けてもMCPのハンドシェイクは成功し、tools/list は空配列を返します。例外が飛ばないまま実行が完走する構造と、期待ツール表との差分で無人実行を止めるpreflightの実装を、実測値つきで記録しました。
ツール出力10万文字の境界で消える一行 — 実測から組み立てた出力封筒の設計
エージェントのツール出力が10万文字を超えると全文はファイルへ退避され、モデルには先頭を切り取ったプレビューだけが渡ります。手元のリポジトリで実測した生存率と、判断材料を先頭へ押し出す出力封筒の実装をまとめました。
許可リストに書いた環境変数は誰の環境で展開されるのか — Managed MCP の実効ポリシーを指紋で確かめる
Managed MCP の allowlist・denylist に書いた環境変数参照の解決元が、起動時環境と managed-settings の env に変わりました。同じ設定ファイルが環境ごとに別のポリシーになる仕組みを手元で再現し、実効ポリシーを指紋で突き合わせる起動前チェックを組みました。
Mcp-Session-Id を前提にしない MCP サーバーへ — 状態の置き場所を作り直す
MCP仕様の2026-07-28リリース候補でMcp-Session-Idヘッダーの廃止が示されました。自作リモートMCPサーバーのセッション結合を監査スクリプトで数え、状態を三つに仕分けて署名付きカーソルへ移行するまでの実測記録です。移行の順番と旧方式の外し方まで具体的に書いています。
strictAllowlist で Claude Code サンドボックスの外向き通信を締める
Claude Code v2.1.219 の sandbox.network.strictAllowlist で自動化の外向き通信を締めた実践メモ。接続先を洗い出すスクリプト、失敗までの時間で拒否とDNSと回線を切り分ける実測、許可リストをホスト名で書くべき理由まで。
メモリストアの棚卸しが半分しか返らない — path_prefix セグメント一致への移行
agent-memory-2026-07-22 で memories.list が変わりました。順序固定・depth 厳格化・path_prefix のセグメント一致。件数が静かに半減した実例と、破壊的変更に耐える棚卸し層、depth=1 再帰の走査コストの実測をまとめます。
共通エージェント定義をセッション単位で差し替える運用設計
Managed Agents の agent_with_overrides を使い、1つの土台エージェントをセッションごとにモデル・プロンプト・ツール・MCP・スキルまで安全に差し替える設計パターンを、検証コードと実運用の落とし穴とともにまとめました。
プロンプトキャッシュを入れたのに請求が下がらなかったとき — cache_read を計測してヒット率の穴を塞ぐ運用メモ
cache_control を付けたのに Claude API の請求が下がらない。原因を推測で潰す前に cache_read と cache_creation を毎リクエスト記録し、ヒット率の穴を非決定プレフィックス・TTL 失効・しきい値未満の3系統に切り分ける運用メモです。
コミット済みのシンボリックリンクが worktree の外を指す — AI に並列作業を預ける前のリポジトリ点検
Claude Code 2.1.212 で、コミット済みのシンボリックリンクを worktree 作成時に辿ってリポジトリ外へ書きうる不具合が修正されました。パッチが塞いだのは辿りの側です。危険なリンクがコミットされている側を点検する監査スクリプトと、隔離の手順をまとめました。
headless の Claude Code を止めたのに、ビルドだけが生き残っていた — exit 143 を前提に停止処理を設計する
headless モードの Claude Code が Bash 実行中に SIGTERM を受けると、コマンドのプロセスツリーが孤児化していました。2.1.212 の修正で挙動は exit 143 に変わります。この契約を前提に、監督スクリプトと後片づけを設計し直す手順をまとめます。
プランモードを「読むだけ」と信じていた — 前提を機構で確かめ直す
Claude Code 2.1.212 で、プランモードがファイルを変更する Bash を許可プロンプトも canUseTool も通さず実行していた不具合が修正されました。前提が崩れていた期間に何が起きうるのか、手元で確かめる方法と、モード名に安全性を預けない設計をまとめます。
宣言したMCPサーバーが一覧から消えていた — 名前空間をベンダーと共有する前提で設定を組み直す
MCPサーバー名がベンダーに予約され、自分の .mcp.json の宣言が黙って無効になる。無人実行で気づけないこの欠落を、宣言と実体を突き合わせる preflight と接頭辞規約で落とす設計をまとめました。
承認したのは、私が読んだ文字列ではなかった — 確認プロンプトの中継を細工文字で検証する
チャットへ中継した確認プロンプトに双方向上書き文字やゼロ幅文字を混ぜて通す実験をしました。NFKC正規化では検知率が0%だった理由、日本語コミットメッセージを止めてしまった素朴な規則の失敗、見せる文字列と照合する文字列を分けて細工を全件止める実装までを記録します。
夜間に回した並列サブエージェントの記録が、追えなくなった — --forward-subagent-text で増えたログを絞り直す
サブエージェントのテキストと思考を stream-json へ流せるようになった一方で、無人実行のログ量は跳ね上がります。実測値をもとに、事後解析に効く記録だけを残す3層の保存方針と相関IDの設計をまとめました。
手元では動くのに、配ると呼び出されない — Cowork プラグインから剥がした4つの前提
自分の環境で動いていたスキル4本をプラグインにまとめて渡したところ、発火したのは1本だけでした。発火率の測り方と、配布前に剥がすべき環境依存・description・権限・命名衝突の4前提を実装込みで整理します。
テーブルが「… 2,847 more rows」で切れていた朝 — 描画上限とトークン計上を切り離して、ツール出力を設計し直す
Claude Code 2.1.209 で 200 行超の markdown テーブルは先頭 200 行＋残り件数の表示になりました。省略されるのは描画だけで、モデルは全行を受け取ります。この差を測り、ツール出力を集約型へ組み替える設計をまとめます。
許可ルールを積み上げたセッションが毎ターン重くなる — ルールセットの棚卸しと、安全性を保ったまま数を減らす設計
deny/ask ルールを増やすほど毎ターン遅くなる問題が 2.1.209 で修正されました。ただしルール設計そのものの負債は残ります。棚卸しスクリプト・被覆検出・ターン時間の実測手順と、列挙型から接頭辞型へ移す設計をまとめます。
夜間セッションの常駐メモリが朝には数GB — 蓄積の四つの出どころと、RSS を刻んで切り分ける
夜間に回した Claude Code のプロセスを朝に見ると、常駐メモリが数GBまで膨らんでいました。2.1.209 で塞がれた四つの蓄積源と、自分の構成に残る分を RSS の傾きで切り分ける方法、しきい値で畳む運用までを個人開発の目線で整理します。
Claude Code の描画をプレーンテキストに切り替える — screen reader mode の三経路と、ログとして残すときの実寸
夜間に回した Claude Code のログを翌朝開いたら、同じ行が何十回も積み重なっていました。screen reader mode の三つの有効化経路と、ANSI 制御シーケンスを含んだログの実寸を測るスクリプト、描画を素にすると何が失われるかまでを、個人開発の運用目線で整理します。
無人実行のログを読める形に保つ — axScreenReader のプレーンテキスト描画を計測して常用に切り替える
Claude Code の出力をログへ落とすと、制御列と再描画で膨らみ後から追えなくなります。axScreenReader のプレーンテキスト描画を3経路で有効化し、同一タスクを計測して常用へ切り替えるまでの実装と判断を記録します。
Dynamic Workflows の規模と effort を、勘ではなく手元の台帳で決める
Dynamic Workflows の一般提供で /config の workflow size と effort が自分の手に渡りました。large を選び続けて費用だけが伸びた1週間の記録から、OpenTelemetry のコンソール出力を台帳化し、タスク型ごとに size と effort を割り当てるまでを実装込みで整理します。
無人実行で auto モードの確認要求を止めずに捌く — permission-prompt-tool で deny-by-default に応える
auto モードの事前確認は、手元で作業しているときは頼もしい味方ですが、深夜の無人実行では「確認待ち」で朝まで止まる原因になります。permission-prompt-tool で確認要求を受け止め、deny-by-default で自動判定して台帳に残す構成を、動くコードつきでまとめました。
型は付いたのに、安全にはならなかった — JS→TS 移行で Claude Code に任せた範囲と任せなかった範囲
tsc が緑でも any は静かに漏れます。型カバレッジで移行の実態を測り、Claude Code に任せて速い作業と人が決めるべき判断を線引きし、悪化を止める CI ゲートまでを実装付きで整理した運用メモです。
push先がいつの間にか一つ増えていた — /commit-push-pr が origin 以外のリモートへも押し始めた変更に、許可リストで蓋をする
7月14日の更新で /commit-push-pr が origin に加えて設定済みの push リモートへも自動で押すようになりました。便利な一方、ミラーやバックアップ用の第二リモートを持つ環境では、意図しない push が静かに増えます。どのリモートへ押し得るかを棚卸しし、許可リスト外の push を pre-push フックで止め、無人実行でも安全に回す設計を実装込みで整理しました。
設定したはずのMCPタイムアウトが効かず、毎回きっかり60秒で切れていた — request_timeout_ms をサーバー単位で取り戻す
長めのMCPツール呼び出しが、設定した待ち時間を無視してきっかり60秒で切れていました。原因は .mcp.json のサーバー単位 request_timeout_ms が読まれず既定へ落ちていたこと。修正後の正しい置き方と、値をツールの性質から逆算する設計、切れ際を自分で確かめる手順を実装込みで整理しました。
ユーザーに届くAI生成の短文を、公開前に二段ゲートで止める
アプリでユーザーに届くAI生成の短文を、決定的ルール層とClaude分類層の二段ゲートで公開前に検査する設計です。fail-closedを芯に据えた判定統合、生成時に検疫して配信時は取り出すだけの構成、生成数で効くコスト設計、人間のサンプリング体制まで実装コード付きで整理しました。
検索の精度は二段目で決まる — 埋め込みで粗く集め、Claude で並べ直す個人ナレッジ検索
埋め込み検索だけでは「意味は近いが答えではない」候補が上位に残ります。粗く集めた候補を Claude で並べ直す二段検索の設計を、構造化スコアリング・棄権・コスト試算まで個人ナレッジ検索の実装でまとめました。
Claude API の同時実行を束ねる — シングルフライトで重複推論とキャッシュ・スタンピードを防ぐ
同一プロンプトが同時に何度も Claude へ飛ぶ重複推論を、シングルフライト（request coalescing）で束ねる設計です。プロセス内・分散環境の実装、ジッター付きリトライ、負のキャッシュまで実測付きでまとめました。
画像を原寸で送るか縮小するか — Opus 4.7 の高解像度ビジョンで1枚ごとに解像度を決めるコスト設計
Opus 4.7 の高解像度ビジョンで壁紙の細部分類は上がったのに、全部を原寸で送ったら週のトークンが跳ねました。1枚ごとに解像度と使うモデルを決める preflight を設計し、精度を保ったままコストを下げた実測を残します。
Extended Thinking を入れたのに精度は横ばい、請求だけ伸びていたとき — 思考トークンの限界効用を計測して budget を決める運用メモ
budget_tokens を大きめに固定したまま、精度が変わらないのに請求だけ伸びていく。思考トークンを台帳に残し、budget を1段上げたときの正解率の伸びを限界効用として計測して、根拠のある値に落とす運用メモです。
コネクタに書き込みツールが増えた夜、無人ジョブは黙って何かを送れるようになる
コネクタの更新で書き込みツールが静かに増えた瞬間、無人で回している定期処理はメール送信やファイル削除まで手が届くようになります。ツール表面のスナップショットと差分検知で、未承認の書き込みを実行前に止める関所の作り方を、個人開発の実務からまとめます。
Claude API の 413 request too large を設計で避ける — 送信前サイズ見積もりと分割の実装
長文と画像と tool_result を1リクエストに詰めすぎると Claude API は 413 request too large で落ちます。32MB の壁・base64 の膨張・処理段階で起きる隠れた上限を実測し、送信前にサイズを見積もって安全に分割する設計をコード付きでまとめました。
非ストリーミングの長い応答が10分の壁で黙って二重課金されていた — SDK既定のタイムアウトと自動リトライを設計し直す
Anthropic SDK の既定タイムアウト10分と自動リトライ2回が、長い非ストリーミング応答を裏で二重に走らせて課金することがあります。発生の仕組みと、ストリーミング切替・明示的な timeout/max_retries・ローカル台帳で止める実装を、実測値とともにまとめました。
生成した壁紙が既存カタログに似すぎていないか — 知覚ハッシュで絞り Claude Vision で最終判定する近重複検出
SHA256の完全一致ではすり抜ける再配色・軽いクロップのニアデュプを、知覚ハッシュの事前フィルタとClaude Visionの最終判定で捕まえる二段構えのパイプライン。実測のprecision較正とコスト設計まで、壁紙カタログの個人運用から共有します。
本番で観測した引数分布からツールスキーマを締め直す
Claudeのツール呼び出しが渡してくる引数を本番で丸ごと記録し、その分布からJSON Schemaにenumやpatternを足して締め直す運用手法を整理しました。緩いスキーマが生む意味のドリフトの実例、段階的に締める手順、締め直し前後の実測値、状況別の推奨まで計測コード付きで紹介します。
Whisper が無音区間に『ご視聴ありがとうございました』を書き足していたとき — 日本語文字起こしの幻聴を計測して潰す運用メモ
Whisper の日本語文字起こしは無音や雑音の区間で存在しない定型句を挿入します。no_speech_prob と avg_logprob で幻聴を計測し、VAD で無音を落とし、Claude に検証させて残った混入を潰すまでの実装と運用手順をまとめました。
コネクタが遅くなり始めた夜、処理を自動で退避させる — 個人運用のヘルス連動サーキットブレーカー
コネクタのエラーやレイテンシが見えても、次に要るのは退避の判断です。エラー率とp95で開閉するサーキットブレーカーを、動くPythonコードと夜間ジョブへの組み込みまで、個人運用の実装メモとしてまとめました。
画像分類の信頼度を鵜呑みにしない — クラス別しきい値の較正と棄却ルーティング
全体の一致率は92%なのに特定カテゴリだけ71%——Claude Visionの自己申告confidenceを鵜呑みにせず、クラス別にしきい値を較正して低信頼の判定を人手キューへ棄却する設計を実測記録として残します。検証セットの規模、較正が静かに腐る問題、採用の判断基準まで扱います。
PreCompact と SessionEnd で長時間セッションの決定事項を引き継ぐ
自動コンパクションで消えるのは会話ではなく「なぜそう決めたか」です。PreCompact / SessionEnd / SessionStart の3フックで決定ログを外部ファイルへ退避し、次のセッションへ確実に手渡す実装を、動くコードと実測値つきで解説します。
夜間バッチが勝手に上位モデルで走っていた — タスクごとにモデル上限を宣言して機械で守る
モデル名をコードに散らすと、いつのまにか安いはずのバッチが上位モデルで走ります。タスクごとの上限を宣言するマニフェストと、既定拒否の解決レイヤ、そして逸脱を検出する差分監査の設計をコード付きでまとめました。
出力は同じ、道筋は違う — エージェントの軌跡を不変条件で守る
既定モデルが入れ替わっても最終出力は正しいまま、ツール呼び出しの道筋だけが静かに変わることがあります。実行トレースを記録し、不変条件で機械的にアサートする軌跡回帰ハーネスを実装コードと実測値で整理しました。
「ゲートに合格した原稿」と「公開された原稿」は同じものか — 検証と公開のあいだに開く隙間
無人パイプラインでは、品質ゲートが検証したファイルと実際に公開されるファイルが別物になる隙間があります。内容のダイジェストを束ねた合格証を発行し、公開直前に照合するTOCTOU対策の設計を、実装コード、導入前後の実測、4段階の導入手順、運用で気づいた落とし穴とともにまとめました。
RAG が自信たっぷりに間違え始めたとき — 検索の取りこぼしを接地率で計測する運用メモ
Claude API の RAG で、回答は流暢なのに事実がずれ始める。多くの場合、原因は検索側で答えを含む文書を取りこぼすサイレントなリコール低下です。接地率と検索ヒット率を計測し、段階的に立て直した運用メモを、動くコードと実数値付きで残します。
20万トークンの崖で夜間バッチの請求が跳ねた — count_tokens プリフライトで長コンテキスト単価を避ける
Sonnet 5 のネイティブ1Mコンテキストは、入力が20万トークンを超えた瞬間にリクエスト全体が長コンテキスト単価へ切り替わります。無人バッチで請求が静かに倍増する崖を、課金対象外の count_tokens プリフライトで手前に止めた実装を、Python と TypeScript の動くコードで記録します。
自コードの Required Reason API 申告漏れを Claude Code で棚卸しする
PrivacyInfo.xcprivacy の理由コードは、依存ライブラリだけでなく自分のコードにも必要です。個人開発の壁紙アプリで申告漏れを見つけた経験から、Swift ソースを走査して該当 API と理由コードを突き合わせる Claude Code ワークフローをまとめます。
無人エージェントの挙動変更を、フィーチャーフラグで少しずつ試す設計
無人で走るエージェントのプロンプトや挙動を一度に全変更すると、劣化が朝まで見えません。フィーチャーフラグで一部の実行にだけ新挙動を割り当て、品質を見てから広げる設計と、決定論的バケット・自動ロールバック・監査証跡の実装を紹介します。
MCP コネクタを申請・無人運用に回す前に、各ツールを契約テストで確かめる
手元で動いた MCP コネクタをそのまま無人ジョブに繋ぐと、応答形状の誤読や書き込みの二重発火で静かに壊れます。ツール記述・応答契約・冪等性・レイテンシを機械検証する小さなハーネスの作り方を、実測値とともにまとめました。
4サイト分のClaude費用が一つの請求に混ざる — ワークスペース単位で支出を割り当て、絞るパイプラインを見極める
複数プロジェクトのClaude API費用が一つの組織請求に合算されて判断を誤る問題を、Cost Report / Usage Report の group_by でワークスペース別に割り当てて解く実装メモです。防御的パース・showback表・費用対効果での選別まで扱います。
Claude API が本番で突然 429 を返し始めたとき — レート制限の余白をヘッダから計測して枯渇前に絞る運用メモ
429 が出てから慌ててリトライを入れるのは後手です。Claude API のレスポンスヘッダには残量が毎回書かれています。余白を継続計測し、枯渇する前に自分から絞る運用メモを、実装フックと計測ログの読み方でまとめます。
検知はできても、鳴りすぎて気づけなくなった — 個人運用のアラートを一通の『起こす価値のある報せ』に絞るまで
無音の不発を検知できるようにした途端、今度は通知が鳴りすぎて麻痺しました。事象ではなく行動を単位にアラートを畳み、ヒステリシスと静音時間、段階的エスカレーションで『起こす価値のある報せ』だけを残すまでの設計メモです。
背景セッションが実行中のまま固まっていた — agents ビューにハートビートを添えて停滞を数分で捕まえる
Claude Code の agents ビューは背景セッションを一望できますが、実行中の表示は稼働の証明ではありません。ハートビートを外付けして、静かに固まったセッションを翌朝でなく数分で捕まえる運用設計を、実測とつまずきどころとともに共有します。
夜間ジョブのコミットが追えなくなった — Claude Code の可読なセッション名で無人実行に相関キーを通す
複数リポジトリで夜間ジョブを無人実行していると、翌朝のコミットがどの実行から生まれたのか分からなくなります。Claude Code の可読なセッション名を相関キーとして設計し、コミット・ログ・セッションを一本の糸でつなぐ実装を、実測値とともに共有します。
長い会話で指示が効かなくなる ― 追従度を測って立て直す設計
長い会話でシステムプロンプトの指示が徐々に効かなくなる現象を、追従度スコアとして数値で捉える方法から解説します。崩れが起きる場所の特定、指示の薄れを抑えるプロンプト構造、会話の途中で錨を打ち直す再アンカーの設計まで、動くコードと実測値を交えて立て直し方を示します。
同意ダイアログより先に広告SDKを初期化していた — Claude Code で ATT と AdMob の順序を直す
起動と同時に広告SDKを開始すると、ATT の同意が取れる前に IDFA が空のまま初期化され、フィルレートは正常なのに計測だけが薄くなります。散らばった初期化順序を Claude Code で洗い出し、ATT の解決を待ってから広告を開始する形へ直した実装を共有します。
Claude Code のネイティブ1Mコンテキストを、いつ使い、いつ使わないか — コストで決める判断ルール
Sonnet 5 が既定になり、Claude Code はネイティブで1Mトークンのコンテキストを扱えるようになりました。大きな窓は便利ですが、広げるほど費用は増えます。全部を窓に入れるべきか、分割して読ませるべきか。実測できる token 見積もりと、状況ごとに答えを出す判断ルールを、動くコードとつまずきどころ付きでまとめます。
Fable 5 が全世界に戻り、Sonnet 5 が既定になった — 個人運用の自動化スタックで3モデルをどの層に置くか
Fable 5 の全世界提供再開と Sonnet 5 の既定化で、個人運用の自動化に使える上位モデルが一気に3つ揃いました。優劣で選ぶのではなく、タスクの持ち場でモデルを割り当てる方針オブジェクトを、フォールバック梯子と記録つきの実装でまとめます。
Web 監視が『異常なし』と言い続けた二週間 — 沈黙する取りこぼしを計測して切り分ける運用メモ
Cowork と Claude in Chrome で組んだ競合監視が、実際には変化を取りこぼしているのに『変更なし』と報告し続けることがあります。取得成功と抽出成功を分けて計測し、沈黙する失敗を検知する運用手順をまとめました。
Opus 4.7 の fast mode 廃止（7/24）で無人ジョブを落とさない — speed パラメータの事前検査と移行
claude-opus-4-7 の fast mode が 2026-07-24 に廃止され、speed: fast がエラーになります。無人パイプラインを静かに壊さないための、使用箇所の機械検出・fail-closed な実行時ガード・4.8 への移行シムを実装コード付きでまとめました。
1M が既定になっても、全部は詰めない — コンテキスト枠を審査する admission policy と劣化曲線の実測
Sonnet 5 が Claude Code の既定になりネイティブ1Mコンテキストが標準化しました。ハードエラーは消えた代わりに現れた静かな劣化を probe で可視化し、詰め込みを審査する admission policy と有効トークン単価での監視を、動くコードと実測値で共有します。
Claude apps gateway の発表を読んで、個人開発の管制面を作り直した話
セルフホスト型 Claude apps gateway の設計を管制面と実行面の分離として読み解き、個人開発の規模に縮約します。アプリ別コスト帰属・モデル許可リスト・fail-closed の支出上限を Cloudflare Workers で実装した記録です。
claude-opus-4-7 の speed:fast が 7/24 で失効する — 能力ペア単位で守る preflight
Opus 4.7 の fast モードが 2026-07-24 に廃止されます。モデルIDは有効なまま speed 指定だけがエラーになるため、モデルID監査では取りこぼします。能力ペア単位の preflight と自動移行を実装します。
同時リクエスト数はいくつまで持つのか — Little の法則と実測メモリで決める Claude API 本番デプロイのインフラ要件
同時リクエスト数・待ち行列長・メモリはいくつに設定すべきか。Claude API 本番デプロイのインフラ要件を Little の法則と実測ハーネスで数字から導く手順を、夜間バッチで OOM を踏んだ経験をもとに整理しました。
増えた枠を基線に混ぜない — 週次上限+50%の期限付きウィンドウでバックログを片づける設計
Claude Code の週次上限が7/13まで50%引き上げられました。期限付きの余裕を日常の実行頻度に混ぜず、終わりのあるバックログ消化だけに使うためのバーストキュー設計と、期限後の基線膨張を検出する台帳をコード付きでまとめました。
5分の沈黙で誰かがやり直しを始める — streaming idle watchdog 既定化で数え直すリトライの責務
Claude Code の streaming idle watchdog 既定化で、実行スタックに再試行する層がもう一枚増えました。SDK・自前ラッパー・watchdog・スケジューラの4層を棚卸しし、最悪ケースの試行回数を掛け算で見積もり、リトライ責務を一層に畳む設計をまとめます。
Claude Code に大規模リファクタを任せたら本番だけ挙動が変わったとき — 暗黙の契約ドリフトを差分で計測する運用メモ
Claude Code に大きなリファクタを任せると、テストは緑なのに本番の挙動だけが静かにずれることがあります。例外経路・ログ形状・初期化順序・戻り値の形を署名として録り、コミットごとに差分で捕まえる契約ドリフト検出ハーネスの設計と実装をまとめました。
単価が40%下がっても、タスク単価は下がるとは限らない — Opus 4.8 から Sonnet 5 への移行損益をトークン消費プロファイルで測る
Sonnet 5 の導入価格は Opus 4.8 より約40%安ですが、ツール往復が増えるとタスク単価は逆転し得ます。消費ベクトルの記録・並走ハーネス・損益分岐ターン数の逆算までを動くTypeScriptと実測で示します。
昨夜の無人セッションはどのモデルで走ったのか — Sonnet 5 既定化を機に整える実行モデルの記録と固定
Claude Code の既定モデルが Sonnet 5 に切り替わり、--model 未指定の無人セッションは静かにモデルが変わります。ヘッドレス出力からモデル名を防御的に抽出して追記記録し、既定ドリフトを検知して固定か追従かを判断する設計を動くコードでまとめました。
9月1日に単価は1.5倍へ戻る — Sonnet 5 導入価格の期限を織り込む実効日付きコスト予測
Claude Sonnet 5 の導入価格 $2/$10 は 2026-08-31 で終わり、9月からは $3/$15 になります。静的な単価表のままでは月次予測が3割ずれる問題を、有効期間つき単価テーブルと予測シミュレータで解く設計をまとめました。
Message Batches に2万件投げたら41件だけ静かに欠けていたとき — 部分失敗を照合して再投入する運用メモ
Message Batches API の processing_status: ended は全件成功を意味しません。errored・expired が結果に静かに混ざる仕組みと、custom_id 台帳で欠落を照合し二重処理なく再投入する実装を、実運用の計測値とともに整理します。
モデルを切り替えた朝、キャッシュヒット率はゼロに戻る — Opus 4.8 から Sonnet 5 への段替えとプロンプトキャッシュ再ウォーム設計
プロンプトキャッシュはモデル単位で分離されるため、モデル移行の初日はヒット率が0%から始まります。割合ベースの段階移行が二重にコストを壊す構造と、タスク系統単位で切り替えるコホート・カットオーバー設計を実測コードつきで整理します。
夜の同じ分に何本着火しているか — Cowork スケジュールタスクの衝突を cron から平らにする設計
Cowork のスケジュールタスクが同じ時刻に集中して共有リソースを奪い合う問題を、cron 式から着火時刻を展開して衝突と並行度を数え、プレミアム枠を動かさずにピークだけを削る貪欲オフセットで平準化する設計を、動くコードと実測 before/after で解説します。
上流タスクが今日ちゃんと動いたかを、下流タスクが自分で確かめる — 無人スケジューラの完了台帳と依存バリア
無人スケジューラには依存関係の概念がないため、朝の参照データ更新が静かに失敗しても、昼の生成タスクは前日の残り物でそのまま走り続けます。上流の完了を原子的に台帳へ記録し、下流が実行前に前提を検証する依存バリアの設計を、動くTypeScriptと私自身の運用体験で解説します。
AIが出した数値と出典を、そのまま受け入れない — 検証専任サブエージェントで突き合わせるゲート設計
エージェントが生成した要約の数値と出典を、生成とは別の検証専任サブエージェントで確かめてから受け入れるゲート設計です。主張をクレーム台帳として取り出し、数値は関数で再計算、引用は原文との文字列照合で確認する構成を、動くTypeScriptのコードとともにまとめました。
モデルは残るのにパラメータだけ期限切れになる — Claude API リクエストの廃止を日付で先回りする設計
モデル名は有効なまま、指定していたパラメータだけが廃止日を迎えてバッチが落ちることがあります。リクエストを部品に分解し、部品ごとに廃止期限を持たせて起動前に先回りする設計を、TypeScript の動くコードと運用の実測でまとめました。
Claude API のドキュメント抽出が「自信満々に間違える」とき — 沈黙する誤りを不変条件で捕まえる運用メモ
請求書や契約書の構造化抽出で一番怖いのは、クラッシュではなく「スキーマも通り信頼度も高いのに値だけ間違っている」沈黙の誤りです。不変条件・二段抽出・フィールド単位の誤り率で運用する実装メモを共有します。
新モデルが増えてもコスト集計をズラさない Claude API 単価レジストリと fail-closed 設計
Opus 4.8 と Haiku 4.5 が Messages API に加わったとき、コード中に散らばった単価がコスト集計を静かに狂わせます。単価を1か所に集約し、未知モデルを fail-closed で弾く実装を、実コード付きで紹介します。
「同じ 429」が経路ごとに違う顔で返る — Claude を Anthropic 直叩きと Azure Foundry の二経路で安全に回す
Claude が Microsoft Foundry でも一般提供されたことで、直叩きと Azure 経由の二経路が現実的になりました。同じ 429 が経路ごとに違う形で返る問題を、正規化エラー型と retry-after の両形式パースで畳む実装をまとめます。
3日前のローカルミラーで判断していた — 無人タスクが古い作業コピーを信じて二重作業する事故を止める
速度のために使い回す永続クローンは、いつの間にかリモートとずれます。同期を確かめないまま「この記事はもう直したか」を読みに行くと、無人タスクは古い木を信じて二重編集や空振り成功を起こします。HEAD 突き合わせと書き込み可否のプリフライト、自己修復の再クローンをbashで実装します。
新型 iPhone で壁紙がぼやける問題を Claude Code で直す — 端末別解像度の振り分けを安全に増やす
新しい iPhone が出るたびに壁紙アプリで画像がぼやけたり余白が出たりする原因と、散らばった端末分岐を一枚のテーブルに集約して安全に拡張する方法を、Claude Code を使った実際のリファクタリング工程として共有します。
ツール出力が大きすぎてコンテキストを溶かす問題 — カーソルで小分けに返すページング設計
一覧系のツールが数百件をそのまま返すと、エージェントのコンテキストは一回の呼び出しで溶けます。カーソルベースのページングでツール出力を小分けに返し、トークン予算を守る設計を実装コード付きで解説します。
中間ファイルを毎回作り直さない — Code Execution のコンテナを跨いで多段パイプラインの状態を保つ
Code Execution ツールのコンテナを container ID で再利用し、生成済みファイルや前処理結果を次のリクエストへ持ち越す設計を解説します。実行時間課金の落とし穴と container_expired の安全な扱い方まで、実装コード付きで整理しました。
ツールが返す画像を Claude に「見せる」 — tool_result を画像ブロックにしてトークンを約10分の1にする
ツールが返した画像を tool_result に文字列で詰めると、同じ画像が約10〜20倍のトークンを消費します。image コンテンツブロックとして返す正しい組み立て方と、SDK 実装・コスト見積もり・落とし穴を実コードでまとめました。
Claude API の Context Editing を入れたらエージェントが同じ調査を繰り返したとき — クリア境界とキャッシュ無効化を計測する運用メモ
Context Editing でツール結果を自動クリアしたら、エージェントが直前に読んだ内容を忘れて同じツールを呼び直し、キャッシュも毎回壊れてコストが上がった。沈黙する劣化を計測ログで切り分け、trigger・keep・clear_at_least を実測で決める運用メモです。
古い入力で無音劣化させない — 無人パイプラインの入力フレッシュネス契約
スケジュール実行の自動パイプラインが、空や古い参照データを読んで静かに劣化した成果物を出す事故を防ぐための設計。鮮度・非空・由来を契約として検証するゲートをbashで実装し、私自身がCoworkで踏んだ落とし穴も共有します。
Trusted Devices の発想を一人運用に翻訳する — 自動実行を「許可した端末からだけ」に縛る
2026年6月28日に Claude Code へ入った Trusted Devices は Team / Enterprise 向けの端末検証機能です。同じ仕組みは使えなくても、その発想は一人の自動運用に翻訳できます。端末を壊れにくく識別し、許可した端末以外では即座に止める実装を、動くコードとつまずきどころ付きでまとめます。
接続が切れた瞬間、その投稿は通ったのか — 無人パイプラインで MCP 書き込みを二重実行せずにやり直す
接続断で中断した MCP の書き込みツール呼び出しは、サーバー側で実行されたかどうか分かりません。素朴な再試行が二重投稿を生む理由と、冪等キーと照合読み取りで安全にやり直すラッパーの実装を、無人パイプラインの実例とともにまとめました。
ストリーミングを並行で束ねると、ノートPCの CPU が先に音を上げる — 実測値で並行本数を絞る適応スロットルの設計
ストリーミングのCPU使用が軽くなっても、複数セッションを1台で束ねるとホストのCPUが先に飽和します。固定セマフォの限界と、実測CPUに応じて並行本数を上下させる適応ゲートの実装を、動くコードと実測値で解説します。
ツール呼び出しは成功しているのに前進しない — 無人エージェントの停滞を検知して止める設計
エラーは出ていないのに同じ手を繰り返し、予算だけが溶けていく。無人エージェントの『成功し続ける停滞』を、行動フィンガープリントと進捗オラクルで検知して安全に止める設計をPythonの実装つきでまとめました。
Cowork × GitHub MCP の自動トリアージが回を追うごとに静かにズレていくとき — 冪等性とラベル境界を保つ運用メモ
Cowork と GitHub MCP の Issue 自動トリアージは初回こそ完璧でも、無人で回し続けると重複コメント・誤再分類・レート枯渇で静かに崩れます。冪等プロンプト・ラベル境界の自己監査・件数バジェットで安定運用に持っていく実務メモです。
弱いモデルへ静かに落ちる方がエラーより怖い — Claude API のモデル降格に「下限」を設ける設計
無人運用のパイプラインでモデルが使えなくなったとき、弱いモデルへ自動で落ちる実装は危険です。タスクごとの能力契約と降格予算で「どこまで落ちたら止めるか」を決める設計を、個人開発の自動運用の実体験から解説します。
OAuthトークンが切れた瞬間に無人実行が手詰まりになる — リモートMCPを止めないトークンライフサイクル設計
リモートMCPコネクタはOAuthで認可されますが、アクセストークンは短命です。対話実行ではブラウザで再認可できても、無人のスケジュール実行では誰もダイアログを押せません。期限を自分で持ち、先読みで更新するトークンライフサイクル設計をまとめました。
無人で回し続けても重くならないか — Claude Code 長時間セッションのメモリ使用量を観測して頭打ちにする
長時間の無人セッションで Claude Code が徐々に重くなる問題を、ps による RSS 定点観測・ローリング基準値のウォッチドッグ・セグメント分割の3点で頭打ちにする運用設計を、観測スクリプトと before/after で具体的にまとめます。
「成功」と記録されたのに成果がゼロだった — Cowork スケジュールタスクの無音失敗を終了前アサーションで止める
Cowork のスケジュールタスクが exit 0 で終わったのに成果物が一つも生まれていない。終了コードだけを信じると見逃すこの無音失敗を、完了条件をアサーションに落として証拠ログとともに赤くする設計をまとめます。
自己修復ループに「諦める条件」を設計する — エラーを4分類して再試行予算を割り当てる
LLMの自己修復ループは「直し続ければいつか通る」という前提で組むと破綻します。エラーを4つのクラスに分類し、クラスごとに再試行予算を割り当てて諦める条件を明示する設計を、動くTypeScriptの分類器実装、コスト天井の置き方、構造化した試行ログ、フォールバックの段構えとともに解説します。
Claude API のストリーミングが「エラーも出さずに」止まるとき — 沈黙する停止を検知して途中から続ける運用メモ
Claude API のストリーミングが例外も出さずに無言で止まる「沈黙停止」を、トークン間隔のウォッチドッグで検知し、受信済みテキストを引き継いで途中から再開する実装と、長時間の自動運用で崩れないためのタイムアウト予算の設計をまとめます。
漏洩しても請求が膨らむ前に止める — 無人パイプラインのAPIキー被害半径設計
漏洩を前提にAPIキーの被害半径を縮める設計。ワークスペース単位のキー分離、無停止ローテーション、使用量のローリングベースライン＋中央絶対偏差でスパイクを検知する番犬の実装を、定期実行への組み込みまで通します。
同じモデル名で挙動が変わったとき — 無人パイプラインに起動時カナリアを置いて差分を捕まえる
同じモデル名のまま挙動が変わる無言の上方更新は、無人パイプラインでは誰も気づけません。起動時に小さなカナリアを走らせて構造の指紋を比べ、ベースラインとの差分でドリフトを判定してバッチを止める設計を、ゴールデンデータセット回帰テストとの違いや実測したコストとともに紹介します。
Claude Code の利用データは集まったのに予算管理が回らなかった — コスト帰属と無駄席の見える化メモ
Claude Code Analytics API でデータは取れても、予算管理には直結しません。利用ログをコスト帰属・無駄席検出・誤報しないアラートに変えるまでの運用メモを、動くコードと実測の閾値とともにまとめました。
Claude API でApp Storeの多言語ストア掲載情報を文字数制限つきで生成する
App Storeの掲載情報を翻訳のまま貼るとSubtitleの30文字などの制限で弾かれます。Claude APIのTool Useで文字数制限をスキーマとして強制し、生成後の再検証と超過フィールドだけを圧縮する修復ループで各ロケールの上限内に収める実装を、キーワード欄の使い切り方まで含めて解説します。
応答が返らないMCP呼び出しに、無人の定期実行が丸ごと飲み込まれた日 — 自前のデッドラインで止め時を握る
リモートMCPツール呼び出しが応答なしで止まると、無人の定期実行はそのまま待ち続けます。プラットフォーム側の打ち切りに任せきりにせず、自前のデッドラインとサーキットブレーカで止め時を握る設計を、実装込みで整理しました。
サンドボックスはコードを動かせても、認証ファイルは読ませない — Claude Code の sandbox.credentials で秘密の露出面を絞る
Claude Code のサンドボックスは既定で ~/.aws/credentials やトークン環境変数を読めてしまいます。v2.1.187 で入った sandbox.credentials を使い、無人運用の秘密の露出面をOS強制で絞る設定と検証手順を実装込みで整理します。
API リクエスト1本でリモート MCP サーバーに直接つなぐ — Messages API の MCP コネクタ実装メモ
ローカルに MCP クライアントを立てずに、Messages API の mcp_servers と mcp_toolset だけでリモート MCP サーバーのツールを呼ぶ実装をまとめました。allowlist/denylist 設計、レスポンス処理、無人運用での落とし穴まで。
前の実行が終わらないうちに次が走り出すとき — リースとフェンシングトークンで定期エージェントの多重起動を抑える
毎朝の定期実行が前回の処理を追い越して二重に走り出す問題を、リースとフェンシングトークンで抑える設計を解説します。素朴なロックが破れる瞬間の分析から、任意ストア上の最小リース実装、副作用直前のトークン検証、上限付きキャッチアップまで、運用で固めた既定値とともに実装コード付きで整理しました。
サポートAIが本番で「自信満々に間違える」とき — 根拠の外を踏ませず、迷ったら人へ渡す運用メモ
Claude API のカスタマーサポートエージェントが、テストでは完璧でも本番で存在しない情報を断言してしまう問題への対処。検索段階で「答えない」を決める設計、根拠付き生成、誤自信率の計測、エスカレーション精度の調整までを運用視点でまとめます。
Claude Design 由来のプロトタイプを本番化する — 単一ソース・CI・OGP自動生成の実装
Claude Design で作ったプロトタイプを Claude Code で本番運用に耐える形へ。生成物ランタイムを土台にする判断、ロジックを mixin で分離する構成、取引台帳を単一ソースにするデータ設計、GitHub Actions による自動更新と OGP 画像の実ブラウザ生成まで、実装込みで解説します。
ツール定義を一行直しただけで、キャッシュが丸ごと作り直しになりました — cache_control ブレークポイントの置き場所
ヒット率が突然ゼロに張り付いた原因は、揮発するブロックを安定したブロックより上流に置いていたことでした。prefix キャッシュのカスケード失効の仕組みと、安定→揮発でブロックを並べ替え、4つしかない cache_control ブレークポイントをどこに置くかを実装と判断表で整理します。
修正済みのファイルを、もう一度直そうとしました — 浅い永続クローンの陳腐化と「読む前に取り直す」判断
無人のエージェントが、すでに直したファイルをもう一度直そうとしていました。原因は数日前の浅い永続クローンを読み続けていたことです。ローカルHEADとリモートHEADの突き合わせで陳腐化を数値で検知し、判断の前にだけ取り直す設計と、二重作業を防ぐ冪等性の考え方を整理します。
上限が倍になった日に決めたこと — 共有APIキーで定期ジョブを束ねる余白予算の設計
レート上限が倍になってもジョブ間隔を詰めなかった理由と、共有APIキーで複数の定期ジョブを束ねる「余白予算」の設計をまとめました。レスポンスヘッダーからの現状計測、ジョブ別の消費割り当て、予算を据え置いた判断の背景、本番運用で見えた落とし穴までを実コードとともに紹介します。
Claude API の従量課金で、Stripe の請求額と自分の帳簿がズレるとき — 使用量イベントの突合運用メモ
Claude API の従量課金は「使った分だけ請求」が理想ですが、実運用ではStripe側の集計と自前の使用量台帳が静かにズレます。Billing Meters の冪等化・突合ジョブ・モデル変更耐性まで、運用で効いた設計を整理します。
毎朝のバッチでプロンプトキャッシュが毎回ミスしていた — 1時間TTLを延命するウォーミング間隔と損益分岐の出し方
数時間おきに走る定期実行では、1時間TTLのプロンプトキャッシュでも毎回コールドミスします。中身を変えずにTTLを延命するウォーミングの間隔をTTLから逆算し、読み取りコストを織り込んだ損益分岐を式で出す方法を、4サイトの自動生成パイプラインの実測とともにまとめました。
思考が常時オンのモデルに移すと、プレフィルが静かに効かなくなる — Fable 5 でストリーミングとトークン予算を直した記録
Fable 5 は思考が常時オンです。プレフィルが使えない・ストリーミングの先頭ブロックがテキストではない・max_tokens に思考分の余白が要る、という三つの前提崩れを、自分の自動投稿パイプラインで直した実装メモです。
同じモデルが環境ごとに別名になる問題 — Claude をマルチプロバイダーで呼ぶ識別子リゾルバの設計
Fable 5 が API・Bedrock・Vertex で同時に使えるようになった結果、同じモデルが環境ごとに別の識別子を持つようになりました。ハードコードした model 文字列が移行を阻む問題を、論理モデル名・能力フラグ・起動時検証を備えた識別子リゾルバで畳み直す実装を整理します。
Claude API のプロンプトキャッシュが本番で静かにヒットしなくなるとき — TTLと節約額の実測メモ
プロンプトキャッシュは導入直後だけ効いて、本番では知らぬ間にヒットしなくなることがあります。完全一致プレフィックスを静かに壊す5つの要因、5分と1時間TTLの選び方、節約額を推測でなく実測に変える計装、変更頻度の階段で置くブレークポイント設計までを運用目線でまとめました。
毎回まっさらな環境で目覚める無人エージェント — 最初の30秒に状態回復を設計する
スケジュール起動の無人エージェントは、毎回まっさらな使い捨て環境で目を覚まします。書き込めないはずのパス、まだ起動しきっていないファイルシステム、消えた作業ディレクトリ。最初の30秒に状態回復を織り込む設計を、実際の運用ログから具体的に書きました。
無人の記事生成タスクが『ほぼ同じ記事』を二度書く前に止める重複検出ゲート
Cowork のスケジュールタスクで毎日記事を生成していると、無人ゆえに数日前と中身がほぼ重なる記事を作ってしまいます。公開直前に slug の類似度と当日ログを照合して重複を止めるゲートを、実際に誤公開を防いだ実装とともにお届けします。
Claude Files API のファイルが知らぬ間に溜まる — 内容ハッシュ台帳で重複を止め、孤児を回収する
自動パイプラインで Files API を使うと、同じファイルが何度もアップロードされ孤児ファイルが静かに溜まります。内容ハッシュ台帳での重複排除と、参照されなくなったファイルの GC 設計を実装例つきで解説します。
Claude API の静的キーをやめる — Workload Identity Federation で CI と本番を鍵なしに切り替える
Claude Platform で一般提供が始まった Workload Identity Federation を使い、sk-ant- 形式の静的キーを数分で失効する OIDC トークンへ移行する設計を扱います。GitHub Actions の鍵なし認証、移行手順、トークン更新まで具体的に整理しました。
Claude API のコスト計算が請求と合わないとき — usage の4トークンバケットを正しく会計する
プロンプトキャッシュを有効にすると、自前のコスト集計とコンソールの請求額が食い違うことがあります。input_tokensにキャッシュ分が含まれない仕様、単価の異なる4つのトークンバケットの重み付き会計、1コール1行で突合できる台帳の組み方までを運用上の注意とともにまとめました。
Claude API のストリーミングは「全部届く」前提が崩れる — 部分失敗を回復に変える運用メモ
Claude API のストリーミングは、同時接続が増えた途端に途中で切れ・重複し・半端なツール引数を吐きます。部分失敗を異常ではなく前提として扱い、静かに回復させるための実装と監視を、運用で削れた具体例とともにまとめました。
pause_turn の継続ループに上限を入れる — 無人で長時間サーバーツールを安全に回す
web_search や code execution など長時間サーバーツールを使うと返ってくる pause_turn を、無人運用で安全に継続する設計をまとめました。4種類の stop_reason を1ループで分岐し、継続回数と時間に上限を入れ、セグメントを跨ぐ usage を数える実装まで扱います。
90秒で切られるコード実行セルを跨いで、長いバッチをチェックポイント分割で回す
Claude のコード実行ツールはセル単位で90秒の上限が明示されました。長いバッチがここで打ち切られないよう、コンテナのファイルシステムへ進捗を残してセルを跨いで再開する設計を、計測・冪等なチェックポイント・撤退判断まで実装コード付きで整理します。
Cowork の bash が『ファイルがありません』と言うのに Finder には見える理由
クラウド同期フォルダを Cowork に接続すると、bash からは実体のないプレースホルダが見え、cat が失敗します。オンデマンド実体化の仕組みと、自動化を取りこぼさないための設計パターンを実体験から解説します。
検索結果を二度運ばない — response_inclusion で消費済みブロックを応答から外す設計
dynamic filtering を有効にしたエージェントで出力トークンが膨らむ原因は、code execution が消費し終えた検索結果ブロックが応答に二重で乗ることにあります。response_inclusion を excluded にして安全に外せる条件と、full を保つべき条件を実装と判断表で整理しました。
Context7 を入れても Claude Code が古いコードを書くとき — 注入が効いているかを運用で確かめる
Context7 MCP を入れたのに古い API のコードが返る——その多くはドキュメント注入が静かに不発になっています。注入が効いたかを毎回確かめる検証フック、ライブラリ単位のバージョン固定、未対応ライブラリへのフォールバックを運用の実装メモとしてまとめます。
service_tier で優先枠をユーザー応答だけに振り向ける
Priority Tier を契約しているのにピーク時だけユーザー向け応答が遅くなる——その原因を service_tier の auto と standard_only の挙動から切り分け、背景ジョブを優先枠から隔離する構成を、自動運用の実例とともにまとめました。
effort パラメータを工程ごとに振り分けて Claude の出力コストと待ち時間を整える
Claude API の effort パラメータは思考・本文・ツール呼び出しを含む出力トークン全体を制御します。一律 high をやめ、工程ごとに段階配分する実装と動的ルーターを、個人開発の自動運用での実測とともに解説します。
サブエージェントの並列実行で、1つの失敗が全体を巻き込まない設計
複数のサブエージェントを並列に走らせる fan-out / fan-in 構成を、トークン予算・結果コントラクト・部分失敗の扱いまで含めて設計します。1つのブランチが落ちても全体を止めない実装と実測値を共有します。
Cloudflare AI Gateway を Claude の手前に置くと、見えるはずの数字が見えなくなる — 運用で効いた計装メモ
Cloudflare AI Gateway を Claude API の前段に置いたあと、コスト按分・セマンティックキャッシュの誤ヒット・フォールバックの静かな品質低下・予算の実効化で実際につまずいた箇所と、その手当てをコード付きでまとめます。
Claude Design の画面案を Claude Code にそのまま実装させる — ローカルコードベース連携で往復を畳む
6/17 の Claude Design 更新でローカルコードベース起点の動作が入りました。トークンを単一の正本にして、画面案を Claude Code へ受け渡し、実装まで一本の流れに畳む手順を、コピーして使えるコードと共にまとめます。
Claude Design に既存コードベースを読ませて画面案を作る — デザインと実装の往復を一人で畳む
6月17日の更新で Claude Design はローカルのコードベースを起点に動けるようになりました。既存コンポーネントを反映した画面案を作り、そのまま Claude Code へ渡すまでを、4サイトのUIを一人で手入れする個人開発の現場目線で設計します。
search_result ブロックで自前ナレッジに根拠を引かせる — Claude Citations 実装メモ
自前のRAGでClaudeが「どの記事を根拠にしたか」を見失う問題を、search_result コンテンツブロックと citations で解決する実装手順を、4サイト運用の実測値とともにまとめます。
Claude × Playwright のブラウザエージェントが「成功したつもり」で失敗するとき — 操作を検証し UI の変化に先回りする実装メモ
Claude API と Playwright のブラウザエージェントは、視覚で判断する分だけ「やったつもりで失敗する」誤成功が起きます。自己申告を信じず操作を事後検証する設計と、UI 変化に先回りで気づくドリフト検知の実装をまとめます。
スケジュール生成が無音で不発に終わったことを、外側から気づく仕組み
exit 0 で終わったのに成果物がゼロだった——そんな無音の不発を、ジョブ自身のログではなく外部のハートビート台帳と地の事実から検知する設計を、個人開発で複数サイトを自動運用している立場からまとめました。
弾いたはずの記事が公開された — 品質ゲートと git push を同じ呼び出しにまとめた代償
無人運用の投稿パイプラインで、品質ゲートで弾いたはずの記事がそのまま公開されました。原因はゲートと git push を一つのシェル呼び出しに連結したことでした。終了コードが握りつぶされる仕組みと、公開マーカー方式で「通過を確認してからしか push しない」二段構えの実装を記録します。
Claude Code に /cd が来た — キャッシュを温存したまま複数リポジトリを横断する運用設計
Claude Code に追加された /cd で作業ディレクトリを移すと、プロンプトキャッシュを作り直さずにセッションを別リポジトリへ運べます。複数リポジトリを順に処理する運用での設計判断と落とし穴をまとめました。
SessionEnd フックに後片付けとログ記録を寄せる
自動投稿の後片付けだけが月に数回抜け落ちる——原因は片付けを処理の続きとして書いていたことでした。Claude CodeのSessionEndフックへ一時ファイル削除とログ記録を寄せる方法を、4サイト運用で実際に移した内容、つまずいた点と回避策、発火確認の手順とともにまとめました。
Claude API のレスポンスキャッシュが「古い答え」と「似て非なる誤答」を返すとき — 鮮度管理と誤ヒット抑制の実装メモ
Claude API のレスポンスキャッシュは速度とコストを劇的に改善しますが、運用で問題になるのは平均ヒット率ではなく、古い答えと意味的な誤ヒットの二つです。キー設計・鮮度管理・誤ヒット抑制・観測の実装をまとめます。
無人で動くエージェントに渡すMCPツールを絞り込む — ポリシー強制で権限を deny-by-default にする
無人実行のClaude Codeエージェントは、許可ダイアログに頼れないぶんツールの届く範囲がそのまま事故の範囲になります。MCPサーバーとツールを deny-by-default で締め、必要なものだけを許可リストで渡す構成を実例つきでまとめました。
壊れた settings.json で Claude Code が起動しなくなったとき — セーフモードの挙動と設定の分け方
settings.json の構文ミスで Claude Code が起動しなくなったときに、どの階層が壊れているかを切り分けて数分で復旧する手順と、自動運用で壊れにくい設定の分割・検証パターンをまとめました。
課金変更が直前で撤回された日 — 慌てて組み替えないための可逆なパイプライン設計
6月15日に発効するはずだった課金変更が、直前に撤回されました。前日まで「本日発効」とログに書いていた立場から、headless 工程を慌てて組み替えずに済んだ理由と、撤回・延期に耐える可逆なパイプライン設計を、動くコードとともに記録します。
Claude API のドキュメント抽出が「確信を持って間違える」とき — 検証層の設計メモ
Claude API で請求書や契約書を構造化抽出するとき、最も怖いのは例外ではなく「もっともらしく間違った JSON」です。スキーマ検証・算術整合・二重抽出の一致率で誤抽出を本番前に捕まえる検証層を、TypeScript の実装とともにまとめました。
予告された課金変更が直前で保留された——切り替えを急がない自動運用の設計
6/15に発効するはずだった課金変更が当日に保留されました。告知日を信じてパイプラインを切り替えると、撤回時に二重で壊れます。実行時シグナルでカットオーバーを判断する設計を、実装コードとともに残します。
多言語アプリの訳ブレを止める — Batch API と用語集キャッシュで Localizable.strings を一貫翻訳する設計
UI文字列を1本ずつ翻訳すると用語がブレます。Claude の Message Batches API と用語集のプロンプトキャッシュを組み合わせ、Localizable.strings を10言語以上へ一貫翻訳するパイプラインを、実測コストと落とし穴つきで設計します。
予告された課金変更が直前で撤回されたとき、設定を一行も書き換えずに済ませる
発効するはずだった課金変更が当日に撤回される——そんな事態でも設定を一行も書き換えずに済ませるための設計です。プラットフォームの挙動を一箇所のフラグに集約する方法、適用時の月額差分を実測から先に出す手順、撤回を「保留のまま」にする考え方、先回り改修が招く事故を記録します。
Claude API のマルチテナント SaaS で「請求が合わない」を消す — テナント分離とコスト帰属の実装メモ
Claude API の SaaS をマルチテナント化したとき最初に壊れるのはコスト帳尻です。計測の単一窓口・原子的カウンター・Anthropic 請求との突合・テナント分離の敵対的検証まで、本番で動く TypeScript と運用判断を実装メモとしてまとめます。
自律エージェントの判断根拠を台帳に残す — 「なぜそうした」を後から説明できる設計
自律エージェントが本番デプロイやファイル削除のような後戻りしづらいアクションを取るとき、採用案・却下案・前提を構造化して台帳に残す設計をまとめました。structured output と追記専用ログ、影響度による線引きまで実装します。
Claudeの構造化出力を本番で信頼する — 検証ゲートと修復ループの設計
Claude APIの構造化出力が「たまに」壊れる本番環境で、tool useによる強制・スキーマ検証ゲート・一度だけの修復ループ・劣化フォールバックを組み合わせ、壊れたJSONを運用から消すための設計をコード付きで解説します。
長時間エージェントのトークン肥大を context editing と memory tool で抑える
ツール結果が積み上がって入力トークンが膨らむ長時間エージェント向けに、context editing と memory tool を併用し、削減量を count_tokens で実測する手順を、自前バックエンド実装つきでまとめます。
Claude Code の大規模リファクタを 1 コミット単位で巻き戻せる状態に保つ — チェックポイント設計とロールバック検知の実装メモ
Claude Code に大規模リファクタを任せると速さの裏でレビュー不能な巨大 diff が積み上がります。チェックポイントをマニフェストで管理し、コミット粒度を pre-push で機械的に強制し、ロールバック判断を Observability に紐づける——個人開発と受託で固めてきた実装メモです。
予約実行が始まる前に、使うモデルが本当に応答するか1回だけ確かめる
設定したモデルが、夜間ジョブが動き出す前に消えていることがあります。引退・撤回・地域制限の3つを起動時の1回のプローブで見分け、適格なモデルへ実行設定を自動で書き換える設計を TypeScript の動くコードでまとめました。
Claude API の PII マスキングは台帳運用で決まる — 復元・暗号化・漏洩率の本番設計メモ
Claude APIへ送る前のPIIマスキングで本当に難しいのは検出ではなく、復元用トークン台帳の運用です。正規表現とHaikuのNERによる2層検出、暗号化した共有ストアとしての台帳実装、ゴールデンデータセットによる漏洩率の毎日計測まで、本番で踏んだ落とし穴を含めて動くコード付きで整理します。
課金変更が発効した日に、headless 実行のコストを工程ごとに計測する仕組みを入れた
6月15日の課金変更で headless 実行とエージェント委譲が月次クレジット制になりました。どの工程がいくら使っているかを response.usage から工程タグ単位で記録し、日次で円換算レポートを出す計測レイヤーの実装を共有します。
Anthropic API のベータヘッダを一元管理し、機能の引退でバッチを止めない設計
anthropic-beta ヘッダを散らばったまま使うと、ベータ機能の引退や GA 昇格でバッチ全体が 400 で落ちます。ケイパビリティ登録簿と起動時プリフライトで、機能の世代交代に耐える小さな抽象化を実装します。
長時間走るエージェントの文脈が静かに劣化する — コンテキスト予算と圧縮の設計
夜通し走らせたエージェントの判断が朝には雑になる——原因は文脈の蓄積による希釈と位置効果です。コンテキストを予算として配分する設計、劣化を観測してから圧縮する手順、いつ何をどう捨てるかの実装、プロンプトキャッシュとの関係まで、動くコードと実測の勘所つきで扱います。
モデルが予告なく使えなくなる日に備える — 引退・撤回・過負荷を一つのステートマシンで扱うルーター設計
あるモデルが、技術的な障害ではなく外部都合で短時間のうちに使えなくなる。引退・撤回・一時的な過負荷という三種の「使えない」を一つの可用性ステートマシンで扱い、自動運用を止めないルーターを TypeScript と Python の動くコードで設計します。
Claude に最新ページを直接読ませる — web_fetch ツールの実装と落とし穴
Claude API の web_fetch ツールで、公式ページや PDF の本文をそのままコンテキストに取り込む実装手順です。URL を勝手に作らせない検証の仕組み、トークンを溶かさない設定、200 で返るエラーの処理まで、個人開発の自動運用で実際に踏んだ判断を共有します。
PR ごとに走る CI が月次クレジットを溶かす前に — Claude Code GitHub Actions の消費を抑える3層ガード
6/15 から Claude Code GitHub Actions は繰越なしの月次クレジットで課金されます。全PRでレビューを走らせると月初に枯れます。実行条件・1回の上限・消費の可視化という3層で、CIを止めずに消費を抑えた設計と動くワークフローをまとめました。
Claude Agent SDK のツールを冪等にする — 二重実行を止める冪等性キーと Outbox の実装メモ
Claude Agent SDK のリトライやセッション再開で決済を二重処理する事故を防ぐ実装メモ。決定的な冪等性キー・Outbox・軽量ラッパーの3パターンを、動くコードと運用メトリクスつきで設計します。
応答したモデルを記録する — headless パイプラインでモデル実体とコストを突き合わせる
API 応答が返す model フィールドと usage を毎回記録し、要求モデルと実際に応答したモデルのズレを検出する設計です。6/15 の usage credits 移行に向けたモデル別コスト照合まで実装します。
繰越されない月次クレジットを月初に枯らさず月末に余らせない — バーンレート配分スケジューラの設計
繰越のない月次クレジットは、使いすぎても使い残しても損になります。残量と経過日数からバーンレートを算出し、ヘッドレス実行のペースを自動調整するスケジューラの設計を、個人開発の自動運用で実測した数値とともにまとめました。
Claude Code の Hooks で品質ゲートを壊さず回す — exit code の意味・ブロック挙動・観測設計の実装メモ
Claude Code Hooks を自動化の安全弁として運用するための実装メモ。exit code 0/2/その他の使い分け、JSON 出力による決定制御、ブロックが暴発したときの切り分け、観測ログの設計までを実例で整理します。
Claude の Dreaming を長期稼働エージェントのメモリ整理に組み込む
Managed Agents の Dreaming は過去セッションを点検してメモリを再構成する自己改善機構です。Harvey や Wisedocs の公開数値を読み解き、Anthropic SDK で自前のメモリ整理ループを組む完全なコードと、本番運用での落とし穴までをまとめました。
6/15 の claude-sonnet-4・claude-opus-4 引退に備えて、本番のモデルIDを棚卸しする
6月15日に claude-sonnet-4 と claude-opus-4 が API から引退します。直書きされたモデルIDを引退前に洗い出し、出力パリティを検証し、別名レイヤーとフォールバックで安全に切り替えるまでの実装手順をまとめました。
モデルの自動アップグレードでクレジットを使い切らないために — enforceAvailableModels で実行モデルを固定する
6月15日の課金変更で月次クレジットは繰越なしに移行します。サブエージェントやフォールバックが意図せず上位モデルへ上がってクレジットを溶かさないよう、enforceAvailableModels で実行モデルを管理側から固定する設計と検証手順をまとめました。
Cowork スケジュールタスク運用の実際 — 朝のダイジェストと週次レポートを無人で回すまで
Claude Cowork のスケジュールタスクで定期実行・リマインダー・自動レポートを設定する手順を、cron 式の基本から無人実行に耐えるプロンプト設計、複数タスクの時間帯設計まで、運用で掴んだ勘所とともにお届けします。
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個に厳選したコードレシピ集です。リトライを含む堅牢な呼び出し基盤、非同期・並列処理、コスト最適化、テストとデバッグ、監視と運用までを段階的に整理し、どこから手をつけるかの優先順位も併せて示します。
「続きを書いてください」をやめる — Claude Fable 5 の 128k 出力で長文レポート生成を一括化した実装記録
数万字の月次レポートを生成するたび、出力上限で切れて「続きから」と投げ直していた運用を、Claude Fable 5 の 128k 出力で一括化しました。ストリーミングで受け切る実装、切断からの再開設計、分割生成との費用比較を実測ベースで残します。
Claude API の Code Execution ツールに月次の売上CSV集計を任せる — Files API 連携から課金の落とし穴まで
月末に形式の違う売上CSVを突き合わせる作業を、Claude API の Code Execution ツールに任せた実装をまとめます。Files API 連携、コンテナ再利用、5分最小課金やファイルプリロード課金などの注意点を実例ベースで扱います。
Claude Code の fallbackModel を三段構成にする — 過負荷の朝でも止まらない無人実行の設計記録
Claude Code の fallbackModel を三段構成で運用し、過負荷時も夜間バッチを止めない設計を実測つきでまとめます。実行モデルの記録方法、下位モデルに落ちた日の品質差への備え、deny ルール併用まで。
Android の戻るボタン広告ゲートを入れ子から並列独立構造へ — Claude Code と進めた終了フロー再設計の記録
戻るボタンの広告が「出ない」と「出すぎる」を同時に起こした原因は、入れ子分岐に埋め込まれた暗黙の優先度でした。壁紙アプリ v2.1.0 で広告ゲートを並列独立構造へ作り直した過程を、Kotlin実装・Claude Codeへの依頼内容・テストまで含めて記録します。
月次クレジット移行を前に、自動パイプラインの工程配分を見直した記録
6月15日の課金変更で Agent SDK・headless 実行・GitHub Actions が月次クレジット制へ移行します。自動投稿パイプラインの工程を実測トークンから棚卸しし、3つの実行経路へ振り分け直した設計判断を共有します。
広告運用を Cowork に任せて分かった「人間が押すべき一手」の線引き
AdMob のビディングパートナー申請やフロア調整といった広告運用の反復作業を Cowork に任せてきた中で見えた、AI に任せきれる作業と、人間が自分の手で押さなければならない一手の境界線を、実際の運用記録からまとめました。
Claude Code で .xcresult を解析し、iOS テスト失敗を最短で特定する実装メモ
Xcode 16 で xcresulttool のレガシー JSON が廃止され、.xcresult からテスト失敗を機械的に取り出す手順が変わりました。新しい test-results フォーマットを jq で整形し、Claude Code に渡して失敗原因と該当コードまで一気に絞り込む実装を、6アプリ並行運用の実体験とともにまとめます。
Claude API のモデル抽象レイヤー設計 — 世代交代に業務ロジックを巻き込まない内部アーキテクチャ
モデル文字列を業務コードに直書きすると、世代交代のたびに本番が静かに壊れます。論理ロールと物理モデルIDを切り離す anti-corruption layer を、TypeScript と Python の動くコード・移行コスト・実運用の判断軸とあわせて設計します。
MCP の tools 以外の3つの能力を使い分ける：resources・prompts・sampling の設計
MCP サーバーで何でも tools にしてしまう設計の限界を、resources・prompts・sampling という3つの primitive で解きほぐします。壁紙アプリのアセット管理サーバーを題材に、判断基準と実装、クライアント対応の現実的な制約までまとめました。
Claude Design のデザインシステムを“作り捨て”にしない運用設計
Claude Design で一度きれいな資料が出ても、デザインシステムを毎回作り直していては資産になりません。既存資料からの抽出を再現性のある運用に落とし込み、原稿を渡すだけで誰でも同じ品質の資料を立ち上げる回し方を、個人開発とアート活動の現場目線で設計します。
自律エージェントの破壊的操作に事前条件・事後条件の契約ゲートを付ける
スキーマも型も通るのに中身が壊れている——自律エージェントのもっともらしい失敗を、事前条件・事後条件の契約ゲートで止める設計です。tryGuard・commitGuard・rollbackの構造、TypeScriptでの実装、スナップショットによる安全な巻き戻し、既存エージェントへの後付け手順まで紹介します。
ユーザーレビューやクラッシュログをClaude APIに渡す前に — 個人情報を可逆マスキングする前処理の設計メモ
App StoreのレビューやCrashlyticsのログをClaude APIで分析するとき、本文に紛れ込む個人情報をどう扱うかは避けて通れません。出力から実データへ辿り直せる可逆マスキングの設計と、本番で踏んだ落とし穴を実装コード付きでまとめました。
Crashlyticsのクラッシュを根本原因ごとに束ねる — Claude APIで作るトリアージの設計メモ
Crashlyticsの「Issue」は同じ原因を別物として散らしてしまうことがあります。累計5,000万DLのアプリ運用で溜まったクラッシュを、Claude APIで根本原因ごとに束ね直して優先順位をつける設計を、動くコードと実測値とともに共有します。
Claude 非同期パイプラインで「毒メッセージ」を隔離する — デッドレターキュー設計の実装メモ
1件の壊れた入力がバッチ全体を止める「毒メッセージ」問題を、Cloudflare Queues のデッドレターキューで隔離する設計と実装。Claude API 特有の失敗パターンの切り分けまで実体験ベースでまとめます。
再現できないエージェント障害をなくす設計 — 決定論的リプレイとイベントソーシング
深夜に一度だけ失敗した自律エージェントの障害は、そのまま再実行しても再現できません。モデル出力やツール入出力といった非決定の境界をイベントログに記録し、決定論的にリプレイして原因を特定する設計を、スキーマ定義から録音再生ラッパー、実行単位のコスト配賦まで実装コードとともに解説します。
効くスキルの設計 — テンプレート固定と判断基準で Claude Code の出力を安定させる
Claude Code のスキルで毎回ブレる出力を安定させるための実践設計。いつ使うかの明示、判断基準テーブル、references テンプレートでの品質固定、トレーサビリティ規則を、実運用のコード付きで解説します。
Claude API の max_tokens 打ち切りを継続生成でつなぐ — 重複とコードブロック分断を防ぐ実装
長文生成が途中で切れる max_tokens 打ち切りを検出し、assistant プレフィルで続きを書かせ、つなぎ目の重複やコードフェンスの分断を防いで安全に組み立てる継続生成の実装パターンをまとめました。
Dynamic Workflow を自作する — phase / agent / pipeline で再現可能な調査パイプラインを書く
Claude Code の Dynamic Workflow を自作するための実践ガイド。phase / agent / pipeline / parallel のプリミティブ、JSON Schema による出力の固定、敵対的検証パターンの移植、トークンコストの設計までをコード付きで解説します。
アプリのスクショPSDを一晩で15言語に展開する — Coworkでやって見えたフォントと字形の現実
Android版『綺麗な壁紙』のストア用スクリーンショットPSDを、Coworkで複数言語に一括展開した実作業の記録です。psd-toolsによるテキスト抽出、レイヤー名へ翻訳文を流し込む発想、タイ語・韓国語の字形でつまずいた現実までを残します。
Claude の品質回帰を eval ハーネスで自動検出する設計
プロンプトを少し直したら、別の入力で出力が静かに悪化していた。本番投入した Claude の品質をプロンプト変更やモデル更新のたびに守るための eval ハーネスを、実装コードと運用での実測値とともに整理しました。
完了条件を1行で渡してClaude Codeを自走させる — 4サイト記事生成パイプラインの設計と実装
Lab 4サイトで稼働している記事生成パイプラインの内部設計を、E2E駆動の完了条件と5回ループ上限を軸に整理しました。article_gate.py の合否を Done-when として渡すことで、Claude Code を毎日16本の記事生成で安定運用しています。
Claude API のプロンプトキャッシュを 5m と 1h で二段に分ける — TTL を分けるとコストは下がり運用は安定する
Anthropic API の cache_control には 5 分と 1 時間という 2 種類の TTL があります。これを「静的な前提情報は 1h、可変な few-shot は 5m」と二段に分けて運用する設計を、私の本番ワークロードで観測した数値とともに整理しました。
Claude API の本番観測性を OpenTelemetry GenAI 規約で再設計する — モデル移行とコスト監査に耐える設計メモ
Claude API を組み込んだプロダクションサービスの観測性を、OpenTelemetry GenAI セマンティック規約に揃えて再設計するための実装メモ。スパン属性、メトリクス、コスト追跡、モデル切替時のリプレイ性を、個人開発サービスで運用してきた経験から具体的なコードで示します。
Claude Code を非エンジニアに渡すまでに私が組んだ6つの順番 — 個人開発者の小さなチーム向け展開設計
CyberAgent WINTICKET の Claude Code 研修事例を起点に、個人開発者と少人数チームが非エンジニアへ Claude Code を安全に渡すための展開順序を6段階で整理しました。Permission 設計、pnpm によるサプライチェーン対策、Managed Settings、GitHub 共有までを実体験ベースで解説します。
Claude Code × Xcode Cloud — ci_scripts と TestFlight 自動配信を 1 週間で動かすまでの実装メモ
Fastlane で長く回してきた個人アプリの CI を Xcode Cloud に移行した実装メモです。ci_scripts/ の3つのフックスクリプト、TestFlight 自動配信、dSYM アップロードまで、Claude Code との具体的なやり取りを残しました。
Cloudflare Workers の 62 MiB 上限を踏んだ朝に、5,000 記事規模で組み直した Content Split アーキテクチャ
個人で 4 ブログを Cloudflare Workers + Next.js で運用していたある朝、articles.json が肥大化して Worker bundle が 62 MiB 上限を踏み、デプロイが止まりました。メタデータと HTML 本文を分離する Content Split Architecture に組み替えた具体的な実装と、切り替え 1 ヶ月で観測したビルド時間・キャッシュ効果・運用上の落とし穴を共有します。
Claude on Xcode で Firebase SDK の更新作業を半自動化する — 個人開発 6 本の iOS アプリで固めた実装メモ
Xcode に統合した Claude on Xcode を使い、Firebase SDK のメジャー更新と SPM 移行を 6 本の iOS アプリでまとめて進めた工程を、選択コマンド・プロンプト雛形・回帰検証の流れまで残します。
Claude Code で Glide 5.0.5 の Java 8 API クラッシュを1行で消した話
Beautiful HD Wallpapers v2.0.0 で Android 6.0.1 ユーザーが全員 3 秒以内にクラッシュ。Claude Code との対話で coreLibraryDesugaringEnabled の 1 行だけが足りていなかったことに辿り着いた実体験です。
壁紙アプリ 2 本の Crashlytics を Claude Code で 11 日間掘り続けた実装ログ
壁紙アプリ 2 本（綺麗な壁紙 v2.0.0 / 浮世絵壁紙 v1.7.0）でリリース後に Crashlytics と Play Console から噴き出した 30 件超のバグを、Claude Code で 11 日間掘り続けて v2.1.1 / v1.8.1 まで仕上げた工程を、スタックトレース → 原因仮説 → 修正コミットの順で公開します。
Claude API のスケジュール運用で観察した tail latency と、リトライストームを抑えるガードレール設計
個人開発で 6 サイトを並行運用し、14 日分のログから p95/p99 の輪郭とリトライ嵐の発生条件を観測しました。ジッタ・バジェット・サーキットブレーカーを組み合わせた本番ガードレールの実装と、観測 → 設計 → 改善の比較値をまとめます。
Claude API の構造化レスポンスを本番で安定させる — tool_use と JSON Schema、多層検証の実装メモ
Claude API の応答を JSON で受け取る実装は数行で書けますが、本番運用では「形は正しいが意味が壊れている」レスポンスにどう備えるかが分かれ目になります。tool_use・JSON Schema・ドメイン検証を組み合わせた多層パイプラインを、壁紙アプリの分類処理での実体験を交えて整理しました。
Claude API のグレースフル・デグラデーション設計 — AI 機能が静かに動き続ける 4 階層フォールバック
Claude API を本番運用すると、モデル単位のフォールバックだけでは守りきれない時間帯が必ず出てきます。SLI 連動の 4 階層デグラデーション設計を、Python と TypeScript のコード・SLO バーンレート・実運用の判断軸とあわせて整理しました。
二段構えのモデル構成 — Haiku 4.5 オーケストレーター × Opus 4.6 ワーカーで保つコストと品質の均衡
オーケストレーションをHaiku 4.5に、専門タスクをOpus 4.6に任せる二段構えのモデル構成を解説します。1Mトークンあたりの実コスト比較、ワーカーに任せる5つの判定基準、ストリーミングの使い分け、詰まった落とし穴と捨てたアプローチまで、個人開発の月次コストを抑えた記録です。
Claude Code と GitHub Actions で 4 サイトの自動投稿パイプラインを 7 ヶ月運用して見えてきた品質ゲート設計
Claude Code とスケジュールタスクで Lab 4 サイトに毎日 16 本の記事を自動投稿してきた中で、Helpful Content System のインデックス崩壊を経験してから設計し直した品質ゲート、トークン管理、ロールバック手順を実装サンプル込みでまとめます。
Subagent 間で状態を渡す3つの設計パターン — 4ヶ月のブログ自動生成で見えた使い分け
Subagentパイプラインで親子間の状態を引き渡す3つの方法——JSONファイル・環境変数・Context Bundle——を、4ヶ月のブログ自動生成の本番運用データで比較しました。件数規模ごとの推奨レンジと、重複回避やカテゴリバランスなど実際に渡している情報の設計を紹介します。
Claude Code × Obsidian で「自律する司書」を据える ― 4 サイト運営から見た 3 層ストレージと Skill 実装の運用ノート
Andrej Karpathy 氏の LLM Wiki 構想を入り口に、Claude Code と Obsidian を組み合わせた自律型ナレッジ OS を、4 サイト並行運用の実際の運用構造に当てはめながら設計します。3 層ストレージ・ingest/compile Skill・Dataview 監視・週次ジョブの実装まで、本番運用に耐える形で整理します。
Claude API のレスポンスを Cloudflare R2 にアーカイブする実装メモ — 監査・再現性・障害分析の3軸設計
Claude API のリクエストとレスポンスを Cloudflare R2 に保存して、監査・障害分析・本番リプレイの3つに使う設計を、Workers の waitUntil パターンと D1 メタデータインデックス込みで実装メモにまとめました。
Claude Code で「死蔵 SDK」を計画的に剥がす — 個人開発12年で堆積した非アクティブ依存を安全に棚卸しする運用設計
個人開発12年で iOS/Android の壁紙アプリ4本に堆積した、もう誰も使っていないのに依存だけ残り続けている SDK — それを Claude Code で安全に棚卸しして剥離するパイプラインを、実コードと数値付きで共有します。
iOS Crashlytics の障害トリアージを Claude Code で自動化する — dSYM シンボリケーションから修正候補生成までの本番運用設計
Firebase Crashlytics に届く iOS クラッシュを Claude Code で受け取り、dSYM シンボリケーション、影響範囲推定、修正候補のドラフト PR までを一筆書きで流すパイプラインの本番運用設計を、累計5,000万DLのアプリ事業での実例と数値とともにまとめます。
Claude Code で App Store Connect と AdMob の売上を毎朝集計するパイプライン — 壁紙アプリ 4 本で 8 週運用した実装ノート
App Store Connect API と AdMob Reporting API のレスポンス揺れを Claude Code で吸収しながら、4 本の iOS 壁紙アプリの売上・AdMob 収益・サブスク継続率を毎朝 7:00 JST に統合集計する運用を 8 週間続けた、設計と実装と落とし穴の記録です。
Claude Code で iOS 壁紙アプリ 4 タイトルの StoreKit 2 移行を並行で回した 5 月の実測ノート
壁紙アプリ4タイトルのStoreKit 2移行とAdMob周りの段階公開を、Claude Code経由で並行で回した5月の実測ノートです。Xcodeワークスペースの並べ方、移行でつまずく5つの分岐点、RevenueCatとの判定順序の落とし穴、任せてよかったタスクとダメだったタスクを記録しました。
Claude Code の Skill・Subagents・Rules を組み合わせて、社内プロジェクトを 1 時間以内に動かす：個人運用に落とし込んだ実装パターン
Claude Code の Skill・Subagents・Rules を組み合わせて、後回しになりがちな社内プロジェクトの 1 週間分のタスクを 1 時間で完了させる仕組み。SonicGarden の実装を起点に、個人開発で 12 年回してきた運用感覚に落とし込んだ構成と落とし所をまとめます。
Claude API の 529 Overloaded を本番アプリで吸収する — レジリエンス実装パターン
529 Overloaded は単発のリトライでは止まりません。累計5,000万DLのアプリ運用で踏んできた失敗を踏まえ、ユーザー体験を落とさずに吸収するためのキュー化・モデル切替・フォールバック設計をコード付きで整理します。
Claude API のジョブキューに優先度と公平性を組み込む設計 — 5,000万DL個人開発で実装したバックプレッシャーの実践
Claude API を本番運用すると必ず詰まる「長文1リクエストが短文100リクエストを止める」問題に、3層プライオリティキューと DRR で公平性を入れた実装の話です。アーティスト・個人開発者の廣川政樹が5,000万DLアプリで運用してきた構成を、コードと運用メトリクスとともに共有します。
Claude の output_format タグで仕様逸脱を抑える運用 — 個人開発アプリのコピーライティング自動化で固まった設計
ストア説明文やASOコピーを多言語で量産しても仕様が崩れないよう、Claudeのoutput_formatタグを軸に固めた設計を実運用から書き起こしました。最小構成の例、出力崩れを防ぐ5つのチェックポイント、100言語を並列バッチで流すときの落とし穴、App Store Connect運用への組み込みまで扱います。
Claude API の 200K コンテキストをどう割り振るか — システム・ツール・メモリ・履歴の予算枠を実運用で決めた話
Claude API の 200K コンテキストを「無制限の置き場」ではなく予算として扱い、システム・ツール定義・メモリ・履歴・回答ヘッドルームに枠を切る設計を、TypeScript の実装コードと壁紙アプリ運用で得た数値とともに記録しました。
Claude API の tool_result could not be submitted が再発しないための回復ハンドラ設計
Claude API でエージェントを長時間動かしていると、ある日突然 'tool_result could not be submitted' が連発し始めることがあります。再試行しても直らない、ストリーミング途中で死ぬ、そして次のセッションでもまた出る — 常時稼働のエージェント基盤で実際に踏み抜いた4種類の原因と、TypeScript で書いた回復ハンドラの実装を整理しました。
App Store Connect・Play Console・Crashlytics・AdMob を横断する『朝刊エージェント』を Claude Agent SDK で組んだ1ヶ月の運用記録
アプリ6本を運営していると、朝起きて4つの管理画面を順に開くだけで30分以上消えていきます。その時間を 1 通のダイジェストに圧縮した Claude Agent SDK のレシピを、実測データつきで共有します。
Claude API のトークンコストを月初3日間データから±10%精度で月末予測する
月初の3日間トークン消費データから月末コストを±10%精度で予測するEWMA＋季節性分解モデルの実装と、しきい値超過時に自動的にプロンプトキャッシュやモデルルーティングを切り替える本番設計を解説します。
Claude Agent SDK で複数 MCP サーバを束ねるときのツール名衝突 — 名前空間と動的調停の設計
GitHub MCP と Linear MCP の create_issue が同居したとき、Sonnet 4.6 はどちらを呼ぶか分かりません。複数 MCP を束ねる Claude Agent SDK アプリで踏むツール名衝突の構造、TypeScript で書ける Reconciler の実装、そして本記事に最初に載せた schemaHash が5種類のスキーマ変更を全て見逃していた実測と訂正までをまとめます。
Claude エージェントのツール返り値を圧縮する — 巨大レスポンスを文脈に積まずに集約する設計
データベースの数千行、Webスクレイプ後のHTML、ファイル読み込みの数MBといった巨大なツール出力をそのまま Claude に渡すと文脈が破裂し、コストも品質も同時に悪化します。スキーマ縮約・サマリ・参照渡しの3層で圧縮する本番アーキテクチャを実装パターン付きで整理しました。
Claude API のチャット履歴を階層サマライズする：3 段階圧縮でトークンを 70 % 削減した設計
壁紙アプリのインアプリ AI チャットで増え続ける履歴トークンを抑えるため、直近ターン・中期エピソード・長期エンティティの 3 層に分けて圧縮する設計を、TypeScript の動くコードと 7 週間の運用データつきで記録しました。月額 API 費用を $480 から $145 まで下げています。
Claude エージェントに安全弁を仕込む：個人運営で暴走を止める三層キルスイッチ設計
個人運営の Claude エージェントで実際に経験したリトライ暴走 3 時間で $32 の損失を起点に、プロセス内ガード・プラットフォーム停止フラグ・観察層の三層キルスイッチを Cloudflare Workers + KV で組む設計記録。TypeScript の動くコードと運用メトリクス付き。
Apple Privacy Manifest を個人開発で取り回す — 依存ライブラリの追従漏れを Claude Code で防ぐ実装
Apple Privacy Manifest（PrivacyInfo.xcprivacy）の運用は、個人開発者が依存ライブラリのバージョンアップに振り回されやすい領域です。累計5,000万ダウンロードの iOS アプリ群を運用してきた経験から、Claude Code を使った追従漏れ検出・申請拒否対応・CI 組み込みまでの実装をまとめます。
Play Store 段階公開を Claude Code で自動監視する — v2.1.0 クラッシュ対応から学んだリリース戦略
Android アプリの段階公開（5%→100%）を Claude Code で自動監視するシステムの実装記録。Beautiful HD Wallpapers v2.1.0 での RecyclerView クラッシュ対応を例に、Crash-free Users 99.7% 基準の自動判定・ロールバック判断ロジックを詳解します。
Claude API で多言語レビュー返信を自動化した実装ログ — App Store 非公式制限との付き合い方
壁紙・ヒーリング系アプリを複数運営する個人開発者が、Claude APIで多言語レビュー返信を自動化した実装ログ。App Storeの8秒待機ルールや1セッション30件制限など、公式ドキュメントには書かれていない落とし穴と解決策を詳解します。
Claude API Messages Batches API でコストを半額にする — 個人開発者が学んだ非同期処理設計
Claude API の Messages Batches API を使って API コストを最大50%削減する非同期設計パターン。個人開発で実際に運用して気づいた設計判断・コスト試算・本番環境でのエラー処理まで実装コードとともに解説します。
Claude Code でクラッシュレポートから修正コミットまでの導線を引く — 個人開発のリリース後障害対応を仕組み化する
Crashlytics や Sentry に届くクラッシュレポートを Claude Code で自動診断し、修正コミットまでつなげる個人開発者向けの実装パイプラインを、今も自分が回している運用とコード例で具体的に書きます。
Claude Agent SDK の Transactional Outbox 実装 — 「副作用の取りこぼし」を本番でゼロにする設計
Claude Agent SDK で発生する「DBには書かれたのにメール/決済/通知が飛ばなかった」事故を防ぐため、Transactional Outbox パターンを Postgres と Cloudflare Queues を例に本番品質で実装する手順をまとめます。
「営業チームが欲しがる」AI自動化 — Claude Agent SDK で構築するマルチエージェント営業支援システム
Claude Agent SDK を使ってリード管理・提案書生成・フォローアップを自動化するマルチエージェント営業支援システムを本番レベルで構築する完全ガイド。コスト最適化・人間レビューゲート・CRM連携の実装例も詳細に解説します。
Claude in Chrome が思い通りに動かないときのトラブルシューティング
Claude in Chrome が止まる・クリックが効かない・結果が期待と違う。症状別の対処に加え、待機指示と検証ステップで完走率が62%から95%に変わった42回分の実測と、起動前チェック用のスクリプトをまとめました。
Claude Code × MCP で構築する個人開発 AI 自動化ハブ — 複数サービス横断の設計と実装
Claude Code と MCP を組み合わせ、GitHub・Notion・Slack を横断する個人開発向けの AI 自動化ハブを設計・実装します。サービス間の文脈維持・エラーハンドリング付きコード例・トークンコスト削減の実測までまとめました。
Claude Code で振る舞い駆動開発（BDD）を本番実装する — Gherkin シナリオ自動生成からチーム横断テスト文化の醸成まで
Claude Code を使った振る舞い駆動開発（BDD）の本番実装ガイド。Gherkin シナリオ自動生成、ステップ定義の自動化、Playwright/Cucumber 連携、非エンジニアとの協業体制まで、動作確認済みコードで解説します。
Claude API のツール実行エラーを Claude 自身に診断させる — 自己修正ループの設計と本番実装
Tool Use実装で避けられないツール実行エラーの対処法を解説。is_errorフラグを活用してエラー情報をClaudeに返し、自己診断・修正ループを実装する実践的なPythonコードと本番でのアンチパターンも紹介します。
「考えながら調べる」AIエージェントの作り方 — Claude API 拡張思考 × Tool Use 本番実装ガイド
Claude APIの拡張思考（Extended Thinking）とTool Useを組み合わせる実装パターンを詳解。頻出エラーの根本原因、リサーチエージェントの完全実装コード、本番でのコスト・タイムアウト設計まで体系的に解説します。
Bun × Claude API で本番運用するエッジAIサービス — Node.js移行の判断軸と落とし穴を回避する実装パターン
Claude APIをBun上で本番運用するための実装ガイド。Node.jsからの移行判断軸・組み込みSQLite/WebSocketの活用・ストリーミング最適化・典型的な落とし穴の回避策まで、動作するコードと実測値で解説します。
Cowork スケジュールタスクが黙って止まる理由と、自動で立ち直る仕組みの作り方
Coworkのスケジュールタスクが黙って止まる原因を、実測した終了コードとエラー文で切り分けます。safe.directory が失敗を遅らせる仕組み、書ける場所を先に決めるプリフライト、理由コード付きログまで扱います。
Claude Code 受託開発で単価を倍にする実践戦略 — 個人開発者が法人案件を獲るまで
Claude Code を業務に組み込んで受託開発の単価を実際に倍にした個人開発者の視点から、見積もり、ヒアリング、納品スピード、契約条件、信頼の作り方までをまとめた、独立志向の方向けの実践ガイドです。
Claude API で契約書レビュー自動化システムを構築する — リスク条項検出・差分追跡・修正提案を本番運用する実装ガイド
契約書レビューをClaude APIで自動化する際の壁は精度より信頼性にあります。pdfplumberとClaude Visionの使い分け、条項分割とJSON Schemaによる構造化出力、リスク条項検出のプロンプト設計、条項IDをキーにした差分追跡、引用付き修正提案まで本番運用の設計を通しで解説します。
Claude API × ローカルファースト同期エンジンで作るオフライン対応AIノートアプリ — Replicache/IndexedDB を使った本番設計
Claude API とローカルファースト同期エンジンを組み合わせ、オフラインでも動く AI ノートアプリを本番運用する設計を、Replicache・IndexedDB・Mutation Queue の実装パターンとともに具体的なコードで解説します。
Claude Code 時代の受託開発で単価を倍にする — 提案・見積・納品の実践戦略
開発が速くなったから安くする、は間違いです。Claude Codeを使い込むフリーランスが単価を維持・向上させるための、工数ベースから価値ベースへの見積もり転換、提案書の作り方、AI利用をクライアントに伝えるかの判断、単価交渉で使える具体的なフレーズまで実例で解説します。
Claude × Stripe Meter Events で従量課金 SaaS を構築する実装ガイド
Claude API のトークン消費量を Stripe Meter Events で従量課金として回収する、本番運用可能なアーキテクチャと実装コードを公開します。冪等性・上限制御・ダッシュボード可視化までカバーします。
Claude Code × データサイエンス — pandas・scikit-learn・機械学習プロジェクトをAIペアプログラミングで加速する
Claude Code をデータサイエンス・機械学習プロジェクトで活用する実践パターンを解説。EDA・特徴量設計・モデル評価・ハイパーパラメータチューニングまで、動作するコード例とともに本番レベルのMLワークフローを構築する方法を紹介します。
Claude API × LiteLLM でコスト最適化マルチプロバイダー AI ゲートウェイを本番設計する — フォールバック・A/B テスト・プロバイダー移行戦略
LiteLLMを使いClaude APIを中心とした本番マルチプロバイダーAIゲートウェイを構築。フォールバック設計・A/Bテスト・コストベースルーティング・プロバイダー移行戦略まで実装コード付きで解説。
Claude Code でゼロダウンタイム DB マイグレーションを設計する本番運用ガイド
Claude Code でゼロダウンタイム DB マイグレーションを設計する本番運用ガイド。Expand-Contract、NOT NULL 追加、カラムリネーム、バックフィル、サブエージェントレビューまで、本番で詰まらない手順を解説します。
Claude API のストリーミングを途中で止める — AbortController の正しい使い方と請求の仕組み
Claude API のストリーミングを AbortController で止めたとき、実際に請求される出力トークンを100回計測しました。中断ドリフトの実測値、close 未配線が生む月18.7ドルの差、プロキシのバッファリング問題までを Node.js と Python の実装つきで扱います。
Claude API の本番運用で予算上限を確実に守る — 日次トークン超過を検知して自動停止するサーキットブレーカー設計
Claude API のコストを「気づいたら月10万円超過」で終わらせない、サーキットブレーカーパターンの実装ガイドです。Cloudflare Workers + KV / Durable Objects で日次・月次予算を強制し、停止・劣化・通知の3戦略を切り替えるコードを示します。
Claude Code × Storybook で築く本番グレードのコンポーネント駆動開発 — Visual Regression とデザインシステム運用の実装パターン
Claude Code と Storybook を組み合わせて、コンポーネント駆動開発を本番グレードまで引き上げる実装ガイド。Story の自動生成、Visual Regression、Interaction Testing、CI 統合、デザインシステム運用までを実例コード付きで解説します。
Claude API のテレメトリを ClickHouse に流して分析する — 本番環境のコスト・遅延・エラーを可視化する設計ガイド
Claude API のリクエスト単位でコスト・遅延・トークン使用量を ClickHouse に蓄積し、Materialized View でリアルタイムダッシュボードを構築する本番運用設計を解説します。
Claude Code Skills を組み合わせる設計術 — 単一スキルでは届かない自動化を作る
Claude Code の Skills を1つずつ作るところから一歩進み、複数スキルを連携させて自動化を組む設計手法を解説します。Pipeline・条件分岐・メタスキルの3パターンとよくある落とし穴を実装例付きで詳述します。
Claude API で多言語翻訳 SaaS を本番運用する設計ガイド — 用語集・スタイル・ドメイン適応の実装
多言語翻訳SaaSをClaude APIで本番運用するための設計を通しで解説します。タグやプレースホルダーを失わせない前処理、用語集の注入と強制、スタイルガイドによるトーン制御、Few-shotでのドメイン適応、品質ゲートとコスト最適化まで、具体的なコードと運用ノウハウでまとめました。
Claude APIをCloudflare Queuesで非同期処理する：障害復旧と優先度制御を含めた本番設計
Claude APIをCloudflare Queuesで非同期処理する本番グレードのパイプライン設計を、Producer/Consumer両方の動作コード・障害時のリトライ戦略・優先度制御・コスト制御まで含めて解説します。
Claude Code の実行を OpenTelemetry で観測する — エージェント処理を本番品質で可視化する設計ガイド
Claude Code のエージェント処理を OpenTelemetry でトレースする本番設計ガイド。フック連携・ツール呼び出し計測・MCP 通信・コスト属性・サンプリングまで、実運用で詰まらないパターンを解説します。
Claude AI を本番運用の「デバッグ相棒」にする — ログ要約・原因仮説・再現コードを作らせる実践設計
個人開発者が深夜のアラートに一人で立ち向かう現実を踏まえ、Claudeをデバッグの相棒として本番運用するための具体的な設計図を、3つのプロンプト・前処理パイプライン・落とし穴の回避策まで通しで解説します。
Claude API のセマンティックキャッシュを本番投入する — 類似プロンプト判定としきい値設計、汚染防止
類似プロンプトへの応答を再利用するセマンティックキャッシュをClaude APIの本番に組み込む設計を一気通貫で解説します。embeddingと類似度しきい値の決め方、マルチテナント分離、キャッシュ汚染を防ぐガード層、フォールバックと劣化モード、効果を測る観測性の指標まで踏んだ地雷とともに紹介します。
Claude API × Inngest で耐障害性のある AI ワークフローを本番運用する — リトライ・冪等性・人間承認を組み込んだ実装ガイド
Claude API と Inngest を組み合わせて、リトライ・冪等性・人間承認・ファンアウトを TypeScript の動くコードで実装します。Next.js / Vercel / Cloudflare Workers に乗せられる軽量な耐障害ワークフローの設計指針です。
Claude API のプロンプトキャッシュがヒットしない時の診断手順
Claude API のプロンプトキャッシュが効いていない時、まず確認すべきは usage フィールドです。cache_read_input_tokens がゼロのまま増えない原因を、5つの典型パターンに沿って切り分けます。
Claude API のプロンプトをコードとして管理する — レジストリ・バージョニング・A/Bテストの本番運用ガイド
Claude API を本番運用していると必ず直面する「どの prompt が、いつ、誰に、どの version で配信されたか」を解決するためのレジストリ設計と、A/Bテスト・段階的ロールアウト・自動ロールバックまでを実装レベルで解説します。
Claude Code Hooks — 中核8フックの設計判断と、33イベントに増えた今の歩き方
Claude Code のフックは強力ですが、どのイベントで何ができるかが曖昧で、結局使いこなせないまま終わる人が多いです。私が半年運用して辿り着いた、フック種別ごとの設計判断と典型的な落とし穴を整理します。
Claude Code の Context Window 管理術 — 大規模リポで詰まらないための7つの実装パターン
大規模プロジェクトで Claude Code が止まる・遅くなる・文脈を見失う原因の多くは、Context Window の設計不足です。実運用で効果のあった7つのパターンを、計測スクリプトと運用ルールつきで解説します。
ハルシネーションを本番で抑える: Claude API 多層防御アーキテクチャの設計図
Claude API を本番投入したときに最後まで残るのが、ハルシネーション（事実誤認）への対処です。プロンプト工夫だけでは限界がある、という結論に至った私の運用記録から、入力・推論・出力・事後検証の4層で誤回答を抑える具体的な実装パターンを共有します。
Claude API のReplay駆動テスト — 本番応答を録画して回帰テストを成立させる設計パターン
非決定的なClaude APIの応答を録画・再生し、回帰テストを安定させるReplay駆動テストの設計です。Messages API・Streaming・Tool Use多段それぞれのカセット実装、メッセージハッシュをキーにする理由、CIへの録画ガード組み込み、本番障害の再現への応用まで扱います。
Claude Sonnet 4.6 と Opus 4.6 の使い分け — タスク別の実体験ベース選択ガイド
Sonnet 4.6 と Opus 4.6、どちらを使えば良いか迷う場面は意外と多いものです。両方を日常的に使い倒している立場から、タスク別の判断基準を共有します。Sonnet 5・Opus 4.8 への読み替えと、単価改定で動く損益分岐の再計算まで含めて扱います。
Claude API × WebSocket × Redis Pub/Sub でスケーラブルなリアルタイム AI チャットサーバーを構築する — Node.js 本番設計・マルチユーザー対応・コスト制御の実装
Claude API × WebSocket × Redis Pub/Sub でリアルタイム AI チャットサーバーを本番運用する設計と実装。SSE との判断基準、マルチインスタンス対応、停止遅延がユーザーごとの予算精度をどう崩すかまで、計測コードつきで扱います。
Claude Code のシークレット管理とトラスト境界設計 — エージェント時代の秘匿情報ハンドリング本番ガイド
Claude Code がシェルを掌握する時代の秘匿情報設計を、トラスト境界・注入パターン・流出防止フックの3軸で体系化。.env から MCP までの本番運用パターンと、よくある落とし穴を実装コード付きで解説します。
Claude API × Tauri 2 で本番デスクトップ AI アプリを構築する — Rust ブリッジ・SSE ストリーミング・配布までの実装
Tauri 2 と Claude API を組み合わせて、軽量で安全な本番デスクトップ AI アプリを構築する方法を解説。Rust 側でのキー保管、SSE ストリーミング、Tool Use 実装、コード署名と配布までを実装コード付きで体系的にまとめます。
Claude Code で Unity ゲーム開発を加速する — C# 生成・MCP 連携・実機検証
Unity プロジェクトで Claude Code を最大限活用するための実践ガイド。C# スクリプト生成、Editor 拡張、Unity MCP、シーン操作の自動化、テスト戦略までを体系的に解説します。
Claude API × Convex でリアクティブな AI アプリを本番構築する — データフロー設計とエージェントパターン
Convex のリアクティブデータベースと Claude API を組み合わせて、本番運用に耐えるチャット・エージェント系アプリを構築する方法をまとめました。スキーマ設計、Action/Mutation/Query の境界、ストリーミング、ツール状態管理、冷え始めの落とし穴まで、開発現場の判断軸を共有します。
Claude Code で壊れないAIコーディングを回す — Plan Mode・Hooks・Rewind・Subagent を統合した失敗前提の本番運用設計
Claude Code で本番リポジトリを触ると壊れる・戻せないという不安を解消する実装ガイド。Plan Mode・Hooks・Rewind・Subagent を1つのワークフローに統合し、失敗を前提に設計された本番運用パターンを実例で解説します。
Claude API × MCP で構築する有料コンサルティング SaaS の実装
個人で運営する有料コンサルティング SaaS の設計・実装・運用を完全解説。Claude API × MCP × Stripe × D1 KV を組み合わせた月10～30万円規模の収益構造、トークン従量課金の仕組み、実装コード、そして月商30万円まで成長させた際の学んだ実問題への対処法をお伝えします。
Claude Code エラー完全対処辞典 — 認証・決済・応答停止・ツール失敗を症状から逆引きする
Claude Code で実際に遭遇する 40 超のエラーパターンを、症状 → 原因 → 復旧手順の順で整理した実務向けハンドブックです。認証・決済・応答停止・ツール失敗・MCP・Hook まで、根本原因まで追える資料として活用いただけます。
Claude Agent SDK でシャドウモードを実装する — 本番影響ゼロでエージェント精度を測る段階的ロールアウト設計
AIエージェントを本番に出す前に精度を測りたい。でもユーザーに触れさせるしかない。この矛盾を解くのがシャドウモードです。Claude Agent SDK で既存フローに影響を与えずエージェントを並走させ、差分を記録し、段階的に昇格するまでの実装を解説します。
Claude API プロンプトインジェクション防御の設計パターン — 検出・サニタイゼーション・多層防御
ユーザー入力や外部データが混入する本番LLMアプリに必要なプロンプトインジェクション防御を体系的に解説します。信頼境界と命令チャネルの分離という設計原則から、入力サニタイゼーション、デリミタ戦略、出力バリデーション、マルチターン対策、投入前のレッドチーミングまで実装コード付きです。
Claude Agent SDK でプログレッシブデリバリーを実装する — カナリア・Feature Flag・自動ロールバックの本番パターン
Claude Agent SDKで構築したAIエージェントを本番へ安全にリリースするためのプログレッシブデリバリー実装パターン。カナリア配信・Feature Flag・SLOベースの自動ロールバックを組み合わせた実装コードと運用指針をまとめました。
Claude Code 個人開発エンジニアの収益を安定化させる顧客ポートフォリオ設計
単価の次に考えるべきは顧客構成です。受託を続ける個人エンジニアが収益の波を抑えるための顧客ポートフォリオ設計を、4象限モデルでの分類、月3万円リテイナーの入口プラン、契約書とSLA、四半期レビューの指標、チャーン防止の仕掛けまで実例ベースでまとめました。
Claude Agent SDK × Temporal.io で耐障害性のある長期実行AIワークフローを構築する — Durable Execution と補償トランザクションの本番設計パターン
Claude Agent SDKとTemporal.ioを組み合わせ、数時間〜数日単位で走るAIワークフローをクラッシュや再起動に耐えさせる本番設計を完全解説。Durable Execution・リトライ・補償・シグナル統合の実装パターン。
Claude Design → Claude Codeハンドオフ — デザインから本番実装までを一本化する
Claude DesignとClaude Codeを連結し、LP・ダッシュボード・ピッチ資料を本番実装まで仕上げるワークフローを検証しました。ハンドオフの内部仕様、本番に耐えるLP生成プロンプトの型、4回失敗したダッシュボード生成のパターン、受け入れ用スラッシュコマンド、5日間で測った数字を共有します。
エージェントに「承認ゲート」を差し込む — Claude API で Human-in-the-loop を本番運用する設計
自律エージェントの一部の判断だけを人間に委ねる承認ゲートを、Claude APIで本番に組み込む設計です。ゲートを入れる5つの場所、メッセージ履歴を保存した中断と再開、Slackやメールでの非同期通知、承認待ちの期限切れの扱い、監査ログに耐える構成まで動くコード付きで解説します。
Claude Code × Python ハイブリッド開発パターン集 — トークン50%削減の実装ガイド
Claude Code と Python を役割分担で組み合わせる実装パターンを、動くコードと共に7つ紹介します。ログ解析、データ変換、定期バッチ、CI/CD 統合まで、実際の本番運用で削減効果を検証した設計例です。
Claude Code で『モバイルアプリ収益ダッシュボード』を作る — AdMob・App Store Connect・Google Play Console の API 統合から日次レポート自動配信まで
AdMob・App Store Connect・Google Play Console の売上を1つのダッシュボードに統合し、日次レポートの自動配信までを Claude Code と実装した記録です。掲載パーサーを実測して見つけた集計欠陥3件と修正版も収録しています。
Claude Code で Next.js × Cloudflare Workers の本番運用を乗り越える — バンドルサイズ危機からエッジキャッシュ設計まで、実際に詰まった場所と解決策を全公開
Next.js アプリを Cloudflare Workers で運用するとき、Claude Code は単なるコード補完ツール以上の存在になります。62 MiB バンドル制限・エッジキャッシュ設計・Content Split Architecture など、実運用で詰まった問題と解決策を完全公開。
壁紙・ヒーリングアプリに Claude API を実装した全記録 — コンテンツキュレーションから多言語説明文生成まで
2014年から個人で壁紙・ヒーリング系アプリを開発してきた視点から、Claude APIを実際に組み込んだ実装例を全記録。コンテンツキュレーション・App Store文生成・タグ自動付与の3つの実装パターンをコード付きで解説します。
Claude Computer Use2026 — ブラウザ・デスクトップ・CLIを横断した自動化の全技術
macOSでの一般提供が始まったClaude Computer Useを実務に組み込むための手引きです。スクリーンショットと操作の繰り返しという動作の本質、セットアップ手順、コスト管理の要点、ブラウザとデスクトップの自動化ユースケース、本番環境へ組み込むアーキテクチャの考え方まで解説します。
Claude Code × Stripe で作るサブスクリプションSaaSの実装 — Webhook・権限管理・本番ハマりポイントの全記録
Claude Code と Stripe でサブスクリプションSaaSを本番投入するまでの実装記録。Cloudflare Workers での Webhook 署名検証、KV+Cookie の2層権限管理、verify-session の設計、Cookie 取得の正規表現が静かに失敗していた実測をコード付きで。
Claude Code × Cursor × Devin Desktop（旧 Windsurf）— 3ツールを使い分けるハイブリッド開発環境の実践設計
Claude Code・Cursor・Devin Desktop（旧 Windsurf）をタスク別に使い分ける設計手順。ディレクトリルールへ同期するスクリプトを、5回連続実行の実測つきで解説します。
Claude Code で作るiOS 18 ウィジェット & App Intents 実装ガイド
WidgetKit と App Intents の実装をClaude Codeで加速する。インタラクティブウィジェット・Live Activities・Siri連携まで、動くコードと落とし穴を網羅した実践ガイド。
Claude API × Apache Kafka でリアルタイムAI処理パイプラインを構築する：イベントストリームへのインテリジェント分析の組み込み
Apache Kafka のイベントストリームに Claude API を組み込む本番設計パターンを解説。スマートバッファリング・モデルルーティング・Dead Letter Queue の実装で、大規模リアルタイムAI処理を低コストで実現します。
「仕様書がテストになり、テストが実装になる」 — Claude Code で実現する Spec-Driven Development
YAML仕様書から Claude Code にテスト・実装・ドキュメントを生成させる実践記録。CI/CD統合に加え、仕様は正しいのに実装が壊れる bcrypt 72バイト問題を2バージョンで実測して示します。
Claude Code SDK でカスタム自律エージェントを実装する — 公式 CLI を超えた独自ループ設計の実践
Claude Code SDK の内部構造を理解し、公式 CLI では制御しきれない自律エージェントループを Python/TypeScript で実装します。ツール許可・エラー回復・ストリーミングに加え、課金変更後のコスト計測とモデル棚卸しまで、実運用で使っているパターンを共有します。
Claude API で作る GitHub PR レビューボット — Webhook統合からセキュリティスキャン・品質スコアリングまで実装
Claude API × GitHub Webhook で PR レビューボットを実装します。Tool Use で構造化スコアリング・セキュリティ検査・改善提案を自動化し、署名検証・デバウンス・レート制限・コスト管理まで実運用で得た知見をまとめました。
Claude Code のマルチエージェント並列実行 — Task ツールと SubAgent の実装パターンと運用の勘所
Claude Code の Task ツールと SubAgent による並列実行を、実測値つきで整理しました。分割判断の基準・検証つき集約ロジック・共有ディスクや陳腐化したクローンで踏んだ落とし穴まで、個人開発の運用から得た知見をお伝えします。
Claude API × Go言語 本番実装 — Anthropic Go SDK・並行処理・Tool Use・マイクロサービス統合
Anthropic Go SDK で Claude API を本番運用するための実装パターン。ストリーミング・goroutine による並行処理・Tool Use・Gin/Echo 統合・グレースフルシャットダウンまで、動作するコードとともに整理しています。
Claude Code と作る StoreKit 2 × SwiftUI の課金実装 — 審査を通る最小構成と運用の落とし穴
Claude Code を設計パートナーにした StoreKit 2 × SwiftUI の課金実装を、PurchaseManager・サーバー検証・ペイウォールUIまで通しで組み立てます。Ask to Buy や Transaction.updates の遅延など、公式ドキュメントが触れない運用の詰まりどころも扱います。
Cowork × Python データ分析自動化：pandas・Matplotlib で週次レポートを自動生成する実践パイプライン
CoworkのスケジュールタスクとPythonを組み合わせて、データ分析レポートを完全自動化する方法を解説します。pandas・Matplotlib・Google Sheets連携まで実務に直結する実装パターンを体系的に解説。
Claude API × Kotlin Multiplatform 実装ガイド — iOS/Android共通AIアシスタント機能を本番で動かす
Kotlin Multiplatform（KMP）でClaude APIを統合し、iOS・Android両方でAIアシスタント機能を本番品質に仕上げるまでの実装記録です。SSE終端の落とし穴・エラーイベント処理・expect/actualの整合性・テスト戦略までを扱います。
Claude API × NestJS で作るエンタープライズ AI バックエンド本番設計
NestJSのDIコンテナにAnthropic SDKを組み込み、TypeORMでの会話履歴永続化、SSEストリーミング、JWT認証、BullとRedisによる非同期処理までを実装します。クライアント側SSEパーサがチャンク境界で文字を落とす問題も、実測値とともに扱います。
Claude API アプリケーションのテスト戦略 — AI出力の品質をユニットテスト・統合テスト・E2Eテストで保証する
Claude APIを組み込んだアプリケーションで「AIの出力が変わってテストが壊れる」問題を根本解決する。モック・セマンティックアサーション・スナップショットテストを組み合わせた実践的テスト設計パターン。
Claude API インテリジェントモデルルーティング — Sonnet 4.6 / Haiku 4.5 自動選択でコストと品質を両立する設計パターン
リクエスト内容に応じてClaude Sonnet 4.6とHaiku 4.5を自動切り替えするインテリジェントルーティングの実装。分類器の設計からサーキットブレーカー、コスト監視まで本番運用パターンを網羅
Claude Code × Swift/iOS 本番アプリ開発 — Xcode連携・Clean Architecture・App Store公開まで
Claude Code を Xcode と連携させ、Swift/iOS アプリを本番品質で開発する手順。CLAUDE.md 設計・SwiftUI 実装・Clean Architecture・テスト自動生成・Fastlane CI/CD による App Store 公開までを扱います。
MCP エージェントの実装でつまずいた4箇所 — 集計ツール・並列実行・入力検証を実測で見直す
MCP サーバーとエージェントワークフローを個人開発で回す中で見つかった実装上の穴を、手元の実測値つきで整理しました。集計ツールの境界値、見せかけの並列実行、JSON 解析の失敗、ブロックリスト型の入力検証の限界を扱います。
Claude APIを使ったSaaS収益化戦略——月収10万円達成のロードマップ
Claude APIでSaaSを立ち上げ、月収10万円を目指すためのロードマップを描きます。高収益ニッチの見つけ方、API費用の計算と黒字化戦略、月額・従量・フリーミアムのプライシング設計、個人開発者でも再現できる集客、Next.jsとStripeを使った実装の要点まで体系的に整理しました。
Claude Mythos Preview と Project Glasswing——公開データで読む「発見より修正が詰まる」時代
Claude Mythos Preview と Project Glasswing について、Anthropic の公式発表で確認できる数字だけを整理しました。1万件超の脆弱性、修正側のボトルネック、そして招待を持たない開発者が公開モデルで今日から始められる走査の実装までをまとめています。
OpenAIからClaude APIへ移行する：コード変換から本番ロールアウトまでの実践アーキテクチャ（2026）
OpenAI GPT-4からClaude APIへ移行する手順を、認証・メッセージ形式・ストリーミング・ツール使用の変換パターンからエラーハンドリング、ダウンタイムゼロの段階的ロールアウトまで実装コード付きで整理します。
Claude Managed Agents を本番へ移すときに躓く境界 — Agent / Environment / Session の分離と、鍵をサンドボックスへ渡さない構成
Claude Managed Agents の本番設計を、SDK の実際の型で確かめながら整理します。サンドボックス制御・永続メモリ・認証情報・マルチエージェント・コスト計測が、それぞれどのオブジェクトに属しているかを扱います。
Claude Code と GitHub Copilot を併用する — 設計思想の違いと使い分けの実際
Claude Code と GitHub Copilot は設計思想が異なり、得意分野も重なりません。両者の限界を実装場面ごとに突き合わせ、併用を前提としたワークフローの組み立て方を整理しております。
Claude Code × Docker — DevContainer・マルチステージビルド・本番デプロイまで
Claude Code と Docker を組み合わせた本番級の開発ワークフロー。DevContainer 環境構築からマルチステージビルド最適化、GitHub Actions CI/CD、Kubernetes 本番デプロイまでを実際のコード例とともに扱います。
Claude Code × SvelteKit フルスタック開発：ゼロから本番デプロイまで
Claude CodeとSvelteKitを組み合わせたフルスタック開発の全工程を解説。Svelte 5 Runes・Drizzle ORM・Auth.js・Cloudflare Workers デプロイまでの実践的なワークフローを網羅します。
デザインシステムをClaude Skillsとして実装する：kintone事例に学ぶAI対応ドキュメント設計
サイボウズのkintone Design SystemをClaude Agent Skillsとして提供した事例を参考に、デザインシステムをAIが読めるSkillsとして実装する方法を詳しく解説します。MCPとの違い、SKILL.mdの設計原則、ドキュメント構造の最適化まで網羅。
Claude Extended Thinking が止まる・タイムアウトする問題の実践的な対処法
ClaudeのExtended Thinkingが途中で停止・タイムアウトする問題を、仕組みの理解から順に解きほぐします。問題パターン別のトラブルシューティング、本番環境での堅牢なエラーハンドリング設計、出力品質を高めるプロンプト設計、安定稼働のためのチェックリストまで整理しました。
Claude API × Electron デスクトップAIアプリ本番実装 — セキュアなキー管理・ストリーミング・自動アップデート・収益化まで
Electron × Claude APIでデスクトップAIアプリを本番リリースするための完全ガイド。keytarによるAPIキー管理、IPC設計、ストリーミング実装、electron-updater自動更新、試用版→有料版の収益化戦略まで実装コード付きで解説します。
Claude Code で iOS テスト基盤を組み直す — XCTest・Swift Testing・XCUITest の役割分担
Claude Code で iOS アプリのテスト基盤を一から組み立てた手順です。XCTest・Swift Testing・XCUITest の使い分け、Xcode Cloud での CI 自動化、カバレッジ 80% 台を維持するための判断基準をまとめました。
Claude AI でフリーランス・クリエイターが収益を伸ばす2026：ライター・デザイナー・動画制作者の実践戦略
Claude AI を使ってフリーランスや個人クリエイターが収益を最大化する実践的な方法を解説。ライター・デザイナー・動画制作者それぞれの具体的な活用法とプロンプト例を網羅した2026年版保存版ガイド。
Claude API × Webhook・非同期処理のエラーとリカバリー戦略
Claude API をWebhookや非同期処理に組み込む際のエラーパターンを網羅。タイムアウト・重複処理・冪等性・デッドレターキューまで、本番環境で求められるリカバリー戦略を実装例つきで徹底解説します。
Claude Code × Go言語 本番グレードREST API開発 — Gin・GORM・Docker・GitHub Actionsで構築するモダンバックエンド
Claude CodeとGo言語を組み合わせてREST APIを本番品質で構築する完全ガイド。Gin・GORM・PostgreSQLによるClean Architecture設計から、Docker化・GitHub Actions CI/CDまでを実践的なコード例とともに解説します。
Claude API × LangGraph 本番品質ステートフルエージェント構築ガイド — グラフベース設計・永続化・ヒューマンインザループの実装
LangGraphとClaude APIでステートフルエージェントを本番運用するための実装パターン集。from_conn_stringがcompile()で落ちる原因、recursion_limitの既定値変更、interrupt()再開の落とし穴まで、手元で検証した挙動と共に整理します。
Claude Code で Android / Kotlin アプリを Google Play 公開まで持っていく実装ノート
個人で長年運営してきたAndroidアプリ群の現場から得た、Claude Codeで本番品質を保つ実装パターン。Compose × Hilt × Roomの設計判断、ProGuardクラッシュ対応、Google Play公開直前の14項目チェックリストまでをまとめます。
Claude Code × Flutter 実践アプリ開発 — Dart × AI で加速するモバイル開発
Claude Code を Flutter 開発に活かす実践ガイド。Dart コード自動生成から状態管理・UI設計・テスト自動化・App Store公開まで、個人開発者が月収を伸ばすための完全ロードマップを解説します。
Vertex AI × Claude エンタープライズ統合：プロンプトキャッシング・マルチモーダル・エージェント設計まで
Google Cloud Vertex AI と Claude を組み合わせたエンタープライズ向け実装を体系的に解説。プロンプトキャッシング・BigQuery ログ・マルチモーダル処理・エージェント設計など、本番運用で必要な全技術を網羅します。
Claude Code × Python FastAPI 本番開発2026 — 設計・型安全コード生成・pytest自動化・Dockerデプロイまで
Claude Code を AI ペアプログラマーとして使い、FastAPI の本番 API サーバーを設計からデプロイまで組み上げた記録です。Pydantic v2・pytest・Docker・CI/CD の実装パターンを扱います。
Claude API × pgvector 永続メモリエージェント実装ガイド：PostgreSQL + Redis で構築する階層型記憶システム
PostgreSQL + pgvector + Redis を組み合わせて Claude API に永続記憶を実装する完全ガイド。ベクトル検索による関連記憶の取得、会話コンテキストの管理、本番デプロイまでを徹底解説します。
Claude Code × Next.js 15 App Router 本番開発：RSC・Server Actions・認証・テスト・デプロイまで
Claude CodeとNext.js 15 App Routerを組み合わせた本番開発の完全ガイド。RSC設計・Server Actions・データフェッチング戦略・Auth.js v5認証・Vitestテスト・Cloudflareデプロイまで、実務で使える実装パターンを網羅します。
Claude Code × Drizzle ORM で実現する型安全データベース開発2026
Claude CodeとDrizzle ORMを組み合わせた型安全なPostgreSQLデータベース開発を徹底解説。スキーマ設計からマイグレーション自動化、クエリ最適化、本番環境デプロイまでプロ向け実装ノウハウを網羅します。
MCPサーバーの本番デプロイ・セキュリティ・収益化 — 独自MCPをSaaSとして展開する実践ロードマップ
MCPサーバーを本番環境で安全に運用し、収益化するまでの実装パターンです。OAuth 2.0 認証、レート制限、Stripe 連携、CI/CD、Cloudflare Workers への本番デプロイを扱います。
Claude で構築するリアルタイム市場調査エージェント — 競合分析・価格監視・トレンド検出を完全自動化
ClaudeのWeb検索・構造化出力・ツール呼び出しを組み合わせて、市場調査を自動化するエージェントを構築します。競合分析・価格監視・トレンド検出という3つのエージェントの実装をステップごとに示し、アーキテクチャの考え方から具体的なコードまでを詳しく解説します。
Claude API × GitHub Actions：コードレビュー・テスト生成・ドキュメント自動化の本番CI/CDパイプライン設計ガイド
GitHub Actions に Claude API を組み込み、コードレビュー・テスト自動生成・PR要約・ドキュメント自動生成を実現する本番CI/CDパイプラインの完全設計ガイド。コスト最適化・セキュリティ・レート制限対策まで網羅。
Claude Code + Figma MCP 実装ガイド：AIデザインツール連携で個人制作を自動化する
Stitch・Figma Make・Claude Code を組み合わせたプロ実践ワークフローの全手順。Design.md の体系化、Figma MCP の詳細仕様、コンポーネント自動生成の最適化まで解説します。
Claude Sonnet 4.6 — 1Mトークン・Computer Use・Extended Thinking を本番で使いこなす実装パターン
2026年2月リリースの Claude Sonnet 4.6 を徹底解剖。1Mトークンコンテキスト・Computer Use 72.5点・Extended Thinking の実装から、Opus 4.6 との使い分け・コスト最適化・本番運用パターンまで実装コード付きで完全解説します。
Anthropic APIコスト削減：月額費用を50〜70%削減する最適化技術
Anthropic APIの月額コストを50〜70%削減するための完全最適化ガイド。Prompt Caching・モデル選定・バッチ処理・トークン削減の4つの軸で、本番運用中のアプリに今すぐ適用できる具体的な実装コードを公開します。
Claude Code の PowerShell ツール — Windows ネイティブ開発で WSL を経由しない選択肢
Claude Code の PowerShell ツールを有効化する正しい方法と、Auto Mode 既定化後に Windows だけで起きる確認プロンプトの非対称を整理しました。8月に3度動いた権限チェックの現状、WSL2 との使い分け、無人実行の安全弁までを実装例つきで扱います。
Claude Code worktreeで並列開発を加速する
Claude Code の worktree で複数タスクを安全に並行させるための実装メモ。ブランチを物理的に分離してコンテキストスイッチを軽くする手順を、実際に運用してわかった勘所とともに整理します。
Claude API Messages Batches 実装ガイド：非同期バッチ処理でコストを最大50%削減
Claude API の Messages Batches API を本番で回すための実装メモ。ポーリング設計・custom_id の複合キー・29 日で結果が消える仕様・コスト実測まで、3 か月動かして分かったことをまとめました。
Claude Code HTTP Hooks × GitHub Actions 完全統合ガイド — 自動コードレビュー・テスト・デプロイを実現する本番設計パターン
Claude Code の HTTP Hooks を GitHub Actions と統合し、自動コードレビュー・品質チェック・デプロイまでを一気通貫で自動化する本番設計パターンを詳細なコード付きで解説します。
Claude API × Supabase でプロダクション対応AIアプリを構築する — pgvector RAG・リアルタイム同期・Row Level Security 統合の実装パターン
Claude API と Supabase を組み合わせてプロダクション対応のAIアプリを構築する実践ガイド。pgvector による RAG・リアルタイム同期・Row Level Security でマルチテナント対応のセキュアなAIアプリを実装する。
Claude Cowork × MCP サーバー完全統合ガイド — Slack・Notion・GitHub を繋ぐ業務自動化エコシステムの設計と本番運用パターン
CoworkにMCPコネクターを統合し、Slack・Notion・GitHubを跨ぐ業務自動化エコシステムを構築する実践ガイドです。コネクターの追加と管理、主要サービスごとの活用パターン、スキルやスケジュールタスクと組み合わせた本番運用の設計までを通しで解説します。
Claude Mythos — Anthropic 新世代フロンティアモデル
Anthropicがステップチェンジと表現する新世代フロンティアモデルClaude Mythosを解説します。基本性能、新設されたCapybaraティアとAPI統合の方法、サイバーセキュリティ能力の評価、Opus 4.6からの移行戦略、実務での活用戦略までを一望できる内容です。
Claude API で自己修復型AIエージェントを構築する — エラー検出・自動リカバリ・グレースフルデグラデーションの本番実装パターン
障害を自動検出して自己修復する本番向けAIエージェントをClaude APIで構築します。エラーの7分類と最適なリカバリ戦略、指数バックオフ付きリトライ、コンテキスト圧縮による自動回復、Supervisorパターンでのマルチエージェント修復、ツール呼び出しのフォールバックチェーンまで実装します。
Claude API ストリーミング × リアルタイムチャットUI 本番実装ガイド
Claude APIのストリーミングレスポンスとServer-Sent Eventsを活用し、Next.js App RouterでリアルタイムチャットUIを本番品質で組み上げる手順を、SSEプロトコル・Tool Use統合・接続復旧・コスト最適化まで通しで整理します
Claude API Web Search × Dynamic Filtering × Citations で検索拡張型AIアシスタントを構築する実装ガイド
Claude API の Web Search Tool・Dynamic Filtering・Citations API を組み合わせ、出典付きで正確な回答を返す検索拡張型AIアシスタントの本番実装パターンを解説します。
Claude API の 429 エラーを 6 サイト同時運用で観測して書き直した本番リトライの実装
Claude API で立て続けに 429 が出るとき、現場で本当に効くのは Retry-After だけに頼らないリトライ設計です。6 サイトの自動投稿パイプラインで観測した発生分布、ジッター付き指数バックオフ・トークンバケット・冪等性キーの実装、Batch API への切り替え判断基準までを実体験ベースでまとめました。
Claude MCP ハイブリッドアーキテクチャ入門 — 決定論的ツールとAI推論を組み合わせる設計パターン
決定論的ツールとAI推論を組み合わせるClaude MCPハイブリッドアーキテクチャの設計パターンを解説します。MCPサーバーをゼロから構築する前提知識、3層構成での役割分担、Andrew Ng提唱のTool Useパターンの実装への活かし方を、売上分析エージェントの実践例とともに紹介します。
Claude API Think Tool — エージェントのインターリーブド推論でツール呼び出し精度を劇的に向上させる
Claude APIのThink Toolパターンを徹底解説。Extended Thinkingとの違い、エージェントループでのインターリーブド推論の実装方法、ツール呼び出し精度を最大54%向上させる本番設計パターンを詳しく紹介します。
Claude 長期記憶 MCP — パーソナライズドAIの本番実装
会話の続きから話せるパーソナライズドAIを実現する、MCPベースの長期記憶システムの本番実装を解説します。メモリツールの定義、ベクトルDBの実運用メトリクスと規模別の選定、プライバシー保護、Embeddingモデル更新の落とし穴まで、完全な実装例と運用知見を交えて踏み込みます。
Claude API で Text-to-SQL インテリジェントエージェントを構築する — スキーマ推論・クエリ最適化・セキュア実行の本番実装ガイド
自然言語の問いからSQLを自動生成・実行するText-to-SQLエージェントをClaude APIで構築します。データベース構造を自動で理解するスキーマ推論、Tool Useパターンでの生成エンジン、セキュリティの要となるSQLバリデーションまで、本番レベルの実装をアーキテクチャ設計から順に解説します。
Claude API 音声エージェント本番アーキテクチャ構築ガイド
Whisper/DeepgramとClaude APIを束ねた音声エージェントを、Cloudflare WorkersとGoogle Cloud Runの両方で運用してきた個人開発者の実体験から、レイテンシ予算・コスト逆算・障害切り替え・本番監視の判断材料を整理しました。
Claude Code × Playwright で E2E テストを本番運用に乗せる — 6サイト並行運用で測った数値・落とし穴・判断基準
Claude Code と Playwright を組み合わせて E2E テストを本番運用するための実装パターンと、6サイト並行運用で実測した数値（フレーキー率 15.3% → 0.42%、Page Object 生成 4時間 → 18分）。Cloudflare Workers/Pages preview deployment 下での落とし穴と、個人開発者がテストを導入する判断基準まで踏み込んで解説します。
Claude Code チーム開発 — CLAUDE.md・Git Hooks・レビュー自動化で実現するAIペアプログラミング
Claude Code をチーム開発に導入し、CLAUDE.md によるプロジェクト共有、Git Hooks 連携、コードレビュー自動化まで実践的に解説。AIペアプログラミングで開発効率を最大化する方法を学びましょう。
Claude Computer Use macOS
Claude Computer Useの内部アーキテクチャとmacOS環境での実装方法、APIを使ったデスクトップ自動化、セキュリティ考慮事項を網羅。実践的なコード例で本番運用に対応できる知識を習得できます。
Claude API プロダクション耐障害設計パターン — モデルルーティング・サーキットブレーカー・フォールバック戦略の実装ガイド
Claude APIを本番運用で支える耐障害設計の実装パターン。サーキットブレーカー、モデルルーティング、フォールバックチェーン、リトライ戦略、ディザスタリカバリをTypeScriptの実装コードと、Dolice Labs 4サイト並行運用で得た運用知見で整理しました。
Claude API × OpenTelemetry でAIアプリケーションのオブザーバビリティを構築する
Claude APIを使ったAIアプリケーションにOpenTelemetryを統合し、トレーシング・メトリクス・ログを一元管理する本番実装パターンを解説します。トークン使用量、レイテンシ、エラー率の可視化からコストアラートまで網羅。
Cowork スキル×スケジュール活用: 業務自動化の設計パターンと実践テクニック
Coworkのスキル機能とスケジュール実行を組み合わせた高度な業務自動化パターンを解説。営業レポート・日報集約・KPI追跡など複数のユースケースを設計パターンとして体系化し、MCPコネクタの効果的な活用法も紹介します。
Claude API リアルタイムマルチモーダルエージェント構築ガイド
Vision + Tool Useを統合したリアルタイムマルチモーダルエージェントの構築方法を実装レベルで解説。ストリーミングマルチモーダルパイプライン、本番環境でのエラーハンドリング、コスト最適化パターンを含む。
Claude API × Cloudflare Workers でエッジAIマイクロサービスを構築する
Claude APIとCloudflare Workersを組み合わせて、低レイテンシ・高スケーラビリティのAIマイクロサービスを構築する方法を解説。エッジコンピューティングによるAIアプリケーション設計パターンを実装コード付きで紹介します。
Claude Code Hooks — 開発ワークフローを自動化する実践テクニック集
Claude Code Hooksを使って開発ワークフローを自動化する実践テクニックを解説。PreToolUse・PostToolUseフックの設定方法から、コードレビュー自動化、セキュリティチェック、デプロイパイプライン連携まで網羅します。
Claude Files API — ファイルを一度アップロードして何度でも参照する方法
Claude Files APIを使えば、PDF・画像・テキストを一度アップロードするだけで複数のAPI呼び出しから参照できます。Python・TypeScriptの実装例、本番運用に耐える再試行処理、トークンコストの見積もり、運用知見まで詳しく解説します。
Claude × 画像生成AI — アプリ用ビジュアル素材の作成から編集までの
Claudeの画像生成機能でアプリ用のイラスト・背景・UIアイコンを制作する流れをまとめました。素材別のプロンプト例、生成品質を上げるテクニック、Figmaへの取り込みと最適化、SVG化と形式選択、タスク管理アプリを例にした素材一式の実装例、他サービスとの比較まで扱います。
Claude × Figma × Stitch × Canva — アプリアイコンのデザイン比較と最適化ワークフロー
Figma・Stitch・Canvaの3ツールで同じアプリアイコンを実際に制作し、特性・操作性・AI連携を比較しました。ケーススタディに基づく比較表、Claudeを活用したデザインレビューワークフロー、実装時間の分析、プロジェクトに応じた使い分けの基準までを実践的に解説します。
Claude の artifact でダッシュボードを作る — CSV を貼る前に集計する理由と、実運用で落ち着いた構成
Claudeのartifactでダッシュボードを作るとき、生CSVをそのまま貼らずに前処理してから渡す理由を説明します。178KBを3.1KBに圧縮する集計、データ契約の先行宣言、実際に回しているReactコンポーネントのコード、色指定の注意点など、実運用で落ち着いた構成をまとめました。
AI ツール完全索引 2026【後編】— 開発者のための API・SDK・収益化ツール総まとめ
開発者・クリエイター向けの AI ツール索引・後編。Claude API、MCP サーバー、Stripe 連携、Firebase、Cloudflare、Kindle KDP など、本番開発・収益化に使えるツールを網羅。
Claude 開発ベストプラクティス総集編 — 29本のプレミアム記事から厳選した実践テクニック集
Claude Lab の全プレミアム記事から厳選したベストプラクティスを1記事に凝縮。API設計、Claude Code ワークフロー、Cowork 自動化、収益化戦略、プロンプト設計の実践テクニック集。
Claude Code × SaaS 開発 — 個人開発者のための月額収益化パイプライン
Claude Code を使って SaaS プロダクトを個人で開発し、Stripe サブスクリプションで月額収益を得るまでの完全パイプライン。アイデア検証からMVP構築、決済実装、マーケティング自動化まで。
Unity × Claude Code 実践ワークフロー — シェーダー自動生成からCI/CDまで【上級編】
Unity 開発に Claude Code を組み込んで半年運用した実体験から、URP シェーダー自動生成・エディタ拡張・GitHub Actions CI/CD・実機パフォーマンス測定の実装と、サンプルでは見えない運用上の落とし穴を、動くコードと実測値つきで整理します。
OpenClaw × Claude でAIパートナーを作る — メッセージアプリにClaudeを住まわせる方法
オープンソースAIエージェント OpenClaw と Claude を組み合わせて、LINE・Discord・WhatsApp で動く自分だけのAIパートナーを構築する方法を徹底解説。セットアップからカスタマイズまで完全網羅。
Claude Cowork スケジュールタスク — 定期実行・リマインダー・自動レポートの作り方
Claude Cowork のスケジュールタスクで、定期実行・ワンタイムリマインダー・自動レポート生成を設定する手順。cron 式の書き方から、空打ち・タイミング分散・冪等性まで、実運用でつまずいた勘所を添えて整理しました。
Claude API 高度なツール使用：Tool Search・Programmatic Tool Calling・Tool Use Examples で大規模エージェントを構築する
Claude API の Tool Search Tool・Programmatic Tool Calling・Tool Use Examples を、ベータヘッダーの指定から実装まで通しでまとめました。Anthropic が公表した削減率の読み方と、この3機能を使わない方がよい場面も併せて記録しています。
Claude Haiku 4.5 — 最速・最安モデルでリアルタイムAIアプリを構築する
Claude Haiku 4.5の実力を実測ベースで整理。200Kコンテキスト・SWE-bench 73.3%・拡張思考対応・$1/$5の低価格。Sonnet/Opusとの使い分け方からPrompt Caching・Batch APIまで実例コード付きで紹介。
Claude API × Stripe で SaaS を構築 — AI サブスクリプションサービスの収益化
Claude APIとStripeを組み合わせてAI SaaSを構築・収益化する道筋を実践的に解説します。ビジネスモデルと課金アーキテクチャの設計、APIコスト管理、Webhookでのサブスクリプション管理、解約防止の施策、Next.jsを使った実装コード例、収益最大化のポイントまで扱います。
Claude API ストリーミング・ツール使用本番運用 — 並列呼び出し、エラー処理、リトライ戦略
エージェントワークフローを本番で動かすためのClaude APIストリーミングとツール使用の実践パターンを解説します。並列ツール呼び出し、エラー処理の設計、スケールに耐えるリトライ戦略、リソース最適化、監視と観測性まで、プロトタイプと本番システムを分ける要素を順に押さえます。
マルチモーダル入力ガイド — Claude API で画像・PDF を活用する
Claude APIで画像やPDFを扱うマルチモーダル入力の基本を整理します。画像のサイズ制限と複数送信、PDF入力、Files APIの使い分け、プロンプトキャッシングとの併用まで、運用して初めて分かるコストと速度の勘所を実測を交えて解説します。