すべての記事
Claude Agent SDK で複数 MCP サーバを束ねるときのツール名衝突 — 名前空間と動的調停の設計
GitHub MCP と Linear MCP の create_issue が同居したとき、Sonnet 4.6 はどちらを呼ぶか分かりません。複数 MCP を束ねる Claude Agent SDK アプリで踏むツール名衝突の構造と、TypeScript で書ける Reconciler の実装、本番で踏んだ失敗パターンまでをまとめます。
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 の動くコードと運用メトリクス付き。
Claude in Chrome で Crashlytics の週次レビューを 2 週間続けた所感
Firebase Crashlytics のダッシュボードを Claude in Chrome に開かせて、週に一度まとめて見る運用を 2 週間続けてみました。自動化と人間判断の境界線がどこに落ちつくのか、累計 5,000 万 DL の壁紙アプリを 1 人で運用してきた経験から書きます。
Apple Privacy Manifest を個人開発で取り回す — 依存ライブラリの追従漏れを Claude Code で防ぐ実装
Apple Privacy Manifest(PrivacyInfo.xcprivacy)の運用は、個人開発者が依存ライブラリのバージョンアップに振り回されやすい領域です。累計5,000万ダウンロードの iOS アプリ群を運用してきた経験から、Claude Code を使った追従漏れ検出・申請拒否対応・CI 組み込みまでの実装をまとめます。
Claude Code の Bash ツールで cd や export が引き継がれない時の対処
Claude Code の Bash ツールで cd や export が次のコマンドに反映されない症状の原因と、実務で使える5つの対処パターンを実例とともに整理しました。
AdMob メディエーション 3 社追加を Claude と進めた実録 — 4 アプリ同時対応で分かった W-8BEN と eCPM の落とし穴
Unity Ads・Liftoff・InMobi の3社を iOS 4 アプリへ同時に追加したときの実記録。W-8BEN 提出フロー・ATT プロンプト順序・AppLovin MAX ウォーターフォール設定まで、Claude に伴走してもらいながら分かった落とし穴を共有します。
Play Store 段階公開を Claude Code で自動監視する — v2.1.0 クラッシュ対応から学んだリリース戦略
Android アプリの段階公開(5%→100%)を Claude Code で自動監視するシステムの実装記録。Beautiful HD Wallpapers v2.1.0 での RecyclerView クラッシュ対応を例に、Crash-free Users 99.7% 基準の自動判定・ロールバック判断ロジックを詳解します。