すべての記事
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 Code Hook が `command timed out` で失敗するときの timeout 設定と分割実行のコツ
Claude Code の Hook が `command timed out` で発火しても完了しない問題を、timeout 設定の見直し・分割実行・バックグラウンド化の3アプローチで実用的に解決する手順をまとめます。
AdMob のフロアプライス調整を Claude in Chrome で 3 週間続けた所感
AppLovin MAX のメディエーション追加後に始まった、フロアプライスの細かい上下調整。4 アプリ × 3 週間の運用を Claude in Chrome に伴走してもらった所感を、数値を交えてまとめました。
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 Code が『テスト全通過』と報告したのに CI で落ちる — 終了コードを正しく拾うための検証設計
ローカルでは『テスト全通過』と報告された変更が、push 後の GitHub Actions で真っ赤になる。原因の多くは Claude Code 側ではなく、シェルとテストランナーの終了コード解釈にあります。実例ベースで切り分け方を整理しました。
Claude Code のカスタムサブエージェントを5つ作って2つに絞り込んだ、半年の運用所感
Claude Code のカスタムサブエージェントを半年間、6サイト並行運営の現場で動かし続けた結果、残った2つと捨てた3つを記録します。description の書き方や、機能するエージェントと機能しないエージェントの境目を、実体験に沿って整理しました。
Claude エージェントのツール返り値を圧縮する — 巨大レスポンスを文脈に積まずに集約する設計
データベースの数千行、Webスクレイプ後のHTML、ファイル読み込みの数MBといった巨大なツール出力をそのまま Claude に渡すと文脈が破裂し、コストも品質も同時に悪化します。スキーマ縮約・サマリ・参照渡しの3層で圧縮する本番アーキテクチャを実装パターン付きで整理しました。
Claude API のチャット履歴を階層サマライズする：3 段階圧縮でトークンを 70 % 削減した設計
壁紙アプリのインアプリ AI チャットで増え続ける履歴トークンを抑えるため、直近ターン・中期エピソード・長期エンティティの 3 層に分けて圧縮する設計を、TypeScript の動くコードと 7 週間の運用データつきで記録しました。月額 API 費用を $480 から $145 まで下げています。
Claude Code の WebFetch が 403 や空ページを返す時の原因と対処
Claude Code の WebFetch が 403 を返したり、本文が抜けた空のページを返す現象には、いくつか定番の原因があります。Cloudflare のボット検知、クライアントレンダリング、ドメイン許可リスト、キャッシュの4点を切り分けながら、それぞれの実用的な対処法を整理します。
Claude エージェントに安全弁を仕込む：個人運営で暴走を止める三層キルスイッチ設計
個人運営の Claude エージェントで実際に経験したリトライ暴走 3 時間で $32 の損失を起点に、プロセス内ガード・プラットフォーム停止フラグ・観察層の三層キルスイッチを Cloudflare Workers + KV で組む設計記録。TypeScript の動くコードと運用メトリクス付き。