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 の WebFetch が 403 や空ページを返す時の原因と対処
Claude Code の WebFetch が 403 を返したり、本文が抜けた空のページを返す現象には、いくつか定番の原因があります。Cloudflare のボット検知、クライアントレンダリング、ドメイン許可リスト、キャッシュの4点を切り分けながら、それぞれの実用的な対処法を整理します。
Claude Code でAndroid の RecyclerView クラッシュを28日間で根治した記録
Beautiful HD Wallpapersのv2.0.0リリース後、RecyclerViewのIndexOutOfBoundsExceptionが28日で50ユーザー以上に発生。Claude Codeとの対話で防御的コピーによる根治法を発見した実録。
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 の Glob と Grep が0件を返すときの原因切り分け
Claude Code の Glob/Grep ツールがファイルを見つけられないとき、.gitignore除外・隠しファイル・パターン記法の落とし穴を切り分け、適切な代替手段で確実に発見する手順をまとめます。
Claude Code の Read ツールで大きなファイルが途中で切れる — offset と limit の使い分けと bash 併用の判断基準
Claude Code の Read ツールが2000行で切り捨てたまま気づかず、grep結果がズレた経験から得た offset/limit の使い分けと、bash で代替すべきケースの判断基準をまとめます。
Claude Code Skill を無人で動かす設計 — 許可ダイアログで止まらない3つの実装パターン
Claude Code のスキルをスケジュール実行や CI で動かしたとき、許可ダイアログが出て途中で固まる現象に何度もぶつかってきました。Read/Write 系ツールに依存せず bash で完結させる、3つの実装パターンを実体験から共有します。