Claude Code
ターミナルで動く AI コーディング支援ツール Claude Code の実践記事です。導入手順、CLAUDE.md の設計、サブエージェント、フック、CI 連携、詰まりやすいエラーの解決まで扱います。自動化やヘッドレス運用の記事も揃えています。
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 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 Code Bash ツールで /tmp が Permission denied になる時の対処 — $HOME/repos フォールバックパターン
Claude Code のサンドボックス Bash で git clone が `Permission denied` で止まる症状の原因と、$HOME/repos へ自動退避させる実装パターンを、4サイト並行運用での実体験とともに整理します。
Xcode の警告を Claude Code で4週間かけてゼロにした個人開発の所感
長年の個人開発で累積したXcode警告を、Claude Codeと一緒に4週間かけてゼロにした記録です。スプリント前に決めたこと、機械的に潰せる警告から削る週ごとの方針、AIに任せた領域と人間が判断を残した境界、つまずきと回避策、数値で振り返る効果までを具体的に共有します。
Claude Code で日本語ファイルが文字化けする時の対処 — Shift-JIS と UTF-8 を見分けて安全に変換する
Claude Code の Read ツールで日本語ファイルを開いた時に文字化けする原因と対処を、エンコーディング判定から iconv 変換までの実践手順で整理しました。Shift-JIS の CSV やレガシー Windows ログを扱う日本語環境での運用ノウハウです。
Chrome DevTools for agents 1.0 を Claude Code から呼び出す手順メモ
GoogleがChrome DevTools for agents 1.0を安定版として公開しました。Claude Code から MCP と CLI のどちらで呼ぶべきか、Antigravity 2.0 にバンドルされた版との違い、個人開発で実際に使った所感をまとめます。
Claude Code の「File has been modified since read」エラーが止まらないときに見直した3つの設定
Claude Code を長時間動かしていると突然頻発し始める File has been modified since read エラー。原因はほぼ3つに絞れます。私の環境で実際に効いた対処をまとめました。
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 Code Skills を毎日の開発に組み込むときに、私が見ている 5 つの選定軸
公開されている Claude Code Skills は数が増え続けています。個人でいくつかのサイトを Claude Code で運用している立場から、毎日の開発フローに残った Skill と、結局外した Skill を分けた判断軸を整理します。superpowers・dig/decomposition・drawio・自作 Skill の使い分けを実例で紹介します。
Claude Code で連続する Edit が連鎖的に失敗するときの直し方 — old_string が消える・重複する問題
Claude Code が同じファイルへ Edit を連続で投げると、2件目以降が突然『not found』や『not unique』で落ちることがあります。原因は順序依存とコンテキスト二重化で、Read 再実行と分割パッチで救えます。
Claude Code「Tool result could not be submitted」を冷静に切り抜ける手順
Claude Code で長いツール返答や MCP 応答待ちのときに突然出る『Tool result could not be submitted』。原因の本当のところと、私が個人開発の現場で実際に使っている復旧手順をまとめました。
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 年回してきた運用感覚に落とし込んだ構成と落とし所をまとめます。
壁紙アプリ 4 本の月次コンテンツ更新を Claude Code に任せた 3 ヶ月の所感
Beautiful HD Wallpapers をはじめとする壁紙アプリ 4 本の月次コンテンツ更新を、2026 年 2 月から Claude Code に任せ始めました。新しい壁紙の追加・カテゴリ分類・メタデータ更新を 3 ヶ月続けてみて気づいた、AI に任せられる範囲と、自分の手を残しておきたい範囲の境界について書きます。
Claude Code が書き出す MDX のフロントマターで YAML パースエラーが出る原因と対処
Claude Code に MDX 記事を量産させていると、ある日突然 YAML パースエラーで build が落ちます。ダブルクォート内のダブルクォート、引用符を含む日本語、コロンを含むタイトル — 引っかかる原因と、実運用で安定する5つの書き方を整理しました。
Claude Code Hooks と SwiftLint を組み合わせて iOS 個人開発の品質ゲートを6週間運用した記録
壁紙アプリと癒し系アプリの保守で、Claude Code の PostToolUse Hook と SwiftLint を組み合わせ、個人開発の品質ゲートを6週間運用した記録です。導入の動機から実装、運用してわかった調整ポイントまでを率直に書き残します。
Claude Code Hook が `command timed out` で失敗するときの timeout 設定と分割実行のコツ
Claude Code の Hook が `command timed out` で発火しても完了しない問題を、timeout 設定の見直し・分割実行・バックグラウンド化の3アプローチで実用的に解決する手順をまとめます。
Claude Code が『テスト全通過』と報告したのに CI で落ちる — 終了コードを正しく拾うための検証設計
ローカルでは『テスト全通過』と報告された変更が、push 後の GitHub Actions で真っ赤になる。原因の多くは Claude Code 側ではなく、シェルとテストランナーの終了コード解釈にあります。実例ベースで切り分け方を整理しました。
Claude Code のカスタムサブエージェントを5つ作って2つに絞り込んだ、半年の運用所感
Claude Code のカスタムサブエージェントを半年間、6サイト並行運営の現場で動かし続けた結果、残った2つと捨てた3つを記録します。description の書き方や、機能するエージェントと機能しないエージェントの境目を、実体験に沿って整理しました。
Claude Code の WebFetch が 403 や空ページを返す時の原因と対処
Claude Code の WebFetch が 403 を返したり、本文が抜けた空のページを返す現象には、いくつか定番の原因があります。Cloudflare のボット検知、クライアントレンダリング、ドメイン許可リスト、キャッシュの4点を切り分けながら、それぞれの実用的な対処法を整理します。
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が次のコマンドに反映されないのは、1回ごとに独立したシェルで起動する仕様のためです。&&で1行に束ねる、絶対パスを徹底する、環境変数をインラインで渡す、CLAUDE.mdに置くなど、実務で使える5つの対処パターンを整理しました。
Play Store 段階公開を Claude Code で自動監視する — v2.1.0 クラッシュ対応から学んだリリース戦略
Android アプリの段階公開（5%→100%）を Claude Code で自動監視するシステムの実装記録。Beautiful HD Wallpapers v2.1.0 での RecyclerView クラッシュ対応を例に、Crash-free Users 99.7% 基準の自動判定・ロールバック判断ロジックを詳解します。
CocoaPods 廃止まで残り半年 — Beautiful HD Wallpapers の Firebase SPM 移行を Claude Code でやり切った記録
2026年10月に Firebase Apple SDK の CocoaPods 配信が停止されます。4本のiOSアプリを個人で運営している廣川政樹が Beautiful HD Wallpapers を先行移行した経験と、Claude Code が詰まりをどう突破してくれたかを記録しました。
Claude Code でAndroid の RecyclerView クラッシュを28日間で根治した記録
Beautiful HD Wallpapersのv2.0.0リリース後、RecyclerViewのIndexOutOfBoundsExceptionが28日で50ユーザー以上に発生。Claude Codeとの対話で防御的コピーによる根治法を発見した実録。
Claude Code で SwiftUI アニメーションの迷いをなくす — 5,000万DL壁紙アプリで実践したプロンプト設計
SwiftUI アニメーションの実装でClaude Codeをどう活用するか。Beautiful HD Wallpapers（累計5,000万DL超）の開発現場で実際に使ったプロンプトパターンと、Before/Afterコード例を具体的に紹介します。
Claude Code で nvm/pyenv/asdf が認識されない - シェル初期化の仕組みと4つの解決策
Claude Code でnvm・pyenv・asdfが使われず「node: command not found」「python version mismatch」が出る問題の原因と解決策を解説します。シェル初期化の仕組みを理解することで根本解決できます。
個人アプリの README を Claude Code で書き直した — コードより先に整えるべきものがあった
Claude Code を使って放置していた個人アプリの README と技術ドキュメントを刷新した経験を共有します。コードから自動生成する手順と、GitHub と App Store の第一印象を変えるドキュメント設計の実践ノートです。
Claude Code の Bash ツールで `npm run dev` や `docker run` が止まる — 長時間実行プロセスの正しい扱い方
Claude Code で npm run dev や docker run を実行すると Bash ツールがハングする問題の原因と解決策。バックグラウンド実行・タイムアウト設定・プロセス管理の実践的な手順を解説します。
APIキーを誤って git commit してしまった時の緊急対応手順 — Claude Code を使った履歴削除とキーローテーション
.envのAPIキーを誤ってgit commitしてしまったときの緊急対応手順です。最初の5分で行うキーのローテーション、被害範囲の確認、git履歴からの完全削除、GitHubのシークレットスキャンニングアラートの解除、.gitignore整備を含む再発防止までClaude Codeを使って実践的に解説します。
iOS アプリの Localizable.strings を Claude Code で管理する — 個人で複数アプリを運営するときのローカライズフロー
壁紙アプリを複数運営している個人開発者が、Localizable.stringsの管理をClaude Codeで省力化した実際のワークフロー。新しいキーの追加から翻訳品質チェックまで、一人で回すときの現実的なアプローチを書きます。
Claude Code MCP サーバーが起動しない — "spawn ENOENT" エラーの原因は PATH の罠だった
Claude Code で MCP サーバーを設定したのに「spawn npx ENOENT」「spawn uvx ENOENT」が出て起動しない。この厄介なエラーの根本原因は Claude Code が使う PATH と、あなたのシェルの PATH が別物だという点にあります。診断から修正まで解説します。
Claude Code でクラッシュレポートから修正コミットまでの導線を引く — 個人開発のリリース後障害対応を仕組み化する
Crashlytics や Sentry に届くクラッシュレポートを Claude Code で自動診断し、修正コミットまでつなげる個人開発者向けの実装パイプラインを、今も自分が回している運用とコード例で具体的に書きます。
Claude Code の SKILL.md に grep ガードを仕込んで、AI 生成記事のテンプレ語句を push 前に弾く
Claude Code の Skill にプロンプトだけで品質指示しても、毎日大量に記事を生成していると徐々にテンプレ語句がすり抜けてきます。SKILL.md の最終ステップに grep ガードを差し込んで、違反を検出したら再生成に戻す仕組みを、4サイト運用の実例から紹介します。