Claude Code
ターミナルで動く AI コーディング支援ツール Claude Code の実践記事です。導入手順、CLAUDE.md の設計、サブエージェント、フック、CI 連携、詰まりやすいエラーの解決まで扱います。自動化やヘッドレス運用の記事も揃えています。
予告された課金変更が直前で保留された——切り替えを急がない自動運用の設計
6/15に発効するはずだった課金変更が当日に保留されました。告知日を信じてパイプラインを切り替えると、撤回時に二重で壊れます。実行時シグナルでカットオーバーを判断する設計を、実装コードとともに残します。
予告された課金変更が直前で撤回されたとき、設定を一行も書き換えずに済ませる
発効するはずだった課金変更が当日に撤回される——そんな事態でも設定を一行も書き換えずに済ませるための設計です。プラットフォームの挙動を一箇所のフラグに集約する方法、適用時の月額差分を実測から先に出す手順、撤回を「保留のまま」にする考え方、先回り改修が招く事故を記録します。
デプロイ直後に「500」と出るのに curl は 200 を返す — Next.js のエラー境界が ChunkLoadError を取り違えていた話
本番のNext.js記事ページがブラウザで「500 Internal Server Error」と表示されるのにcurlでは200。原因はサーバーではなくChunkLoadErrorとerror.tsxの誤表示でした。切り分け手順と自動リロードを組み込んだ修正を記録します。
Claude Code の大規模リファクタを 1 コミット単位で巻き戻せる状態に保つ — チェックポイント設計とロールバック検知の実装メモ
Claude Code に大規模リファクタを任せると速さの裏でレビュー不能な巨大 diff が積み上がります。チェックポイントをマニフェストで管理し、コミット粒度を pre-push で機械的に強制し、ロールバック判断を Observability に紐づける——個人開発と受託で固めてきた実装メモです。
課金変更2日目 — headless 工程の実コストが事前見積もりからどれだけズレたか
6月15日の課金変更で headless 実行が月次クレジットに切り替わりました。発効2日目に工程別の実コストを集計したところ、ある工程だけ見積もりの約2倍。計測の仕組みと、1工程をサブスク枠へ戻した判断を記録します。
PR ごとに走る CI が月次クレジットを溶かす前に — Claude Code GitHub Actions の消費を抑える3層ガード
6/15 から Claude Code GitHub Actions は繰越なしの月次クレジットで課金されます。全PRでレビューを走らせると月初に枯れます。実行条件・1回の上限・消費の可視化という3層で、CIを止めずに消費を抑えた設計と動くワークフローをまとめました。
Claude Code のプラグインをマーケットプレイスから探して入れる — 中身を読んでから信頼する手順
Claude Code のプラグインをマーケットプレイスから探して導入する実践手順です。/plugin の使い方に加えて、install 前に束ねられた中身を読んで安全性を確かめる勘所と、User/Project スコープの選び分けまで整理します。
サブエージェントの出力を採点し、不合格なら作り直させる SubagentStop フック
サブエージェントの成果物に時々ルール違反が混じる問題へ、SubagentStopフックで自動採点と再依頼を組み込みます。採点基準をJSONルーブリックに固定する理由、トランスクリプトを読む採点器の実装、無限ループを防ぐガード、運用して見えた実務的な勘所を動くコード付きで整理します。
繰越されない月次クレジットを月初に枯らさず月末に余らせない — バーンレート配分スケジューラの設計
繰越のない月次クレジットは、使いすぎても使い残しても損になります。残量と経過日数からバーンレートを算出し、ヘッドレス実行のペースを自動調整するスケジューラの設計を、個人開発の自動運用で実測した数値とともにまとめました。
Claude Code の Hooks で品質ゲートを壊さず回す — exit code の意味・ブロック挙動・観測設計の実装メモ
Claude Code Hooks を自動化の安全弁として運用するための実装メモ。exit code 0/2/その他の使い分け、JSON 出力による決定制御、ブロックが暴発したときの切り分け、観測ログの設計までを実例で整理します。
課金変更の前夜に、headless 実行の消費を1週間だけ計測した記録
6/15 から headless Claude Code が月次クレジットへ移るのを前に、自分の無人実行が実際に何トークン消費しているかを1週間ログに残し、どのプランで足りるかを数字で判断した手順をまとめました。
6/15 の Claude Code 課金変更で、headless 実行はどう変わるのか
2026年6月15日から Agent SDK・headless の claude -p・GitHub Actions・サードパーティエージェントが月次クレジットへ移行します。自動化を回している個人開発者が、どの工程を残し、どの工程を見直すかを整理しました。
モデルの自動アップグレードでクレジットを使い切らないために — enforceAvailableModels で実行モデルを固定する
6月15日の課金変更で月次クレジットは繰越なしに移行します。サブエージェントやフォールバックが意図せず上位モデルへ上がってクレジットを溶かさないよう、enforceAvailableModels で実行モデルを管理側から固定する設計と検証手順をまとめました。
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つの契約を入れて品質を立て直した実装記録です。
サブエージェントの入れ子は何階層が実用的か — 5階層ネスト解禁後に委譲構造を見直した記録
Claude Codeのサブエージェントが最大5階層まで入れ子にできるようになりました。実際に深い委譲を組んで「伝言ゲーム問題」による要約減衰とコスト増を確かめ、責務が3種類なら3階層で止めるという結論に至った過程と、深い委譲で守っている実務ルールを共有します。
編集した SKILL.md が反映されない — /reload-skills と .claude/skills 自動ロードで再起動なしに差し替える
SKILL.md を編集しても実行中のセッションには反映されません。.claude/skills 自動ロードと /reload-skills、SessionStart フックを組み合わせた再起動なしの差し替え運用と、版番号による検証手順を実運用の経験から整理します。
Claude Code の fallbackModel を三段構成にする — 過負荷の朝でも止まらない無人実行の設計記録
Claude Code の fallbackModel を三段構成で運用し、過負荷時も夜間バッチを止めない設計を実測つきでまとめます。実行モデルの記録方法、下位モデルに落ちた日の品質差への備え、deny ルール併用まで。
Android でペイウォールとレビュー誘導が重なって表示される競合を ModalGate で解決した実装メモ
ペイウォール・レビュー誘導・リワード広告案内の3つのダイアログが同時に表示される競合を、優先度付きの中央ゲート（ModalGate）で解決した実装メモです。Claude Code とのレビューで見つかった閉じ漏れの3経路と Kotlin 実装例を紹介します。
Android の戻るボタン広告ゲートを入れ子から並列独立構造へ — Claude Code と進めた終了フロー再設計の記録
戻るボタンの広告が「出ない」と「出すぎる」を同時に起こした原因は、入れ子分岐に埋め込まれた暗黙の優先度でした。壁紙アプリ v2.1.0 で広告ゲートを並列独立構造へ作り直した過程を、Kotlin実装・Claude Codeへの依頼内容・テストまで含めて記録します。
Claude Code が破壊的なコマンドを打つ前に止める — PreToolUse フックの事前検査
長時間の自動実行中に rm -rf や force push が紛れ込む不安を、PreToolUse フックの事前検査で解消した記録です。settings.json の設定、検査スクリプト、exit code 2 でブロックされた後の Claude の挙動、誤検知の調整までを実例で示します。
git add -A が .bak バックアップまで巻き込む — in-place 修正スクリプトと自動コミットの落とし穴
sed -i や自作の --fix スクリプトが残す .bak バックアップを git add -A が無言で取り込み、本番リポジトリに混入させてしまう問題。なぜ気づきにくいのか、scoped add と .gitignore でどう塞ぐかを実例で整理します。
前回の記事本文が別の記事に紛れ込む — 固定名の一時ファイルに残る残骸の罠
Claude Code の自動化で、固定名の一時ファイルに前回の中身が残り、まったく別の記事に古い本文が混入する。書き込みが無音で失敗する仕組みと、ユニーク名＋挿入後の grep 照合で防ぐ方法を記録します。
Crashlytics の「Missing dSYM」をClaude Codeで潰した実装メモ
Firebase を SPM へ移行した直後、Crashlytics のクラッシュが記号化されず address のまま並びました。Missing dSYM 警告の原因をClaude Codeで切り分け、再発しないアップロード経路を組むまでの実作業メモです。
Claude Code で .xcresult を解析し、iOS テスト失敗を最短で特定する実装メモ
Xcode 16 で xcresulttool のレガシー JSON が廃止され、.xcresult からテスト失敗を機械的に取り出す手順が変わりました。新しい test-results フォーマットを jq で整形し、Claude Code に渡して失敗原因と該当コードまで一気に絞り込む実装を、6アプリ並行運用の実体験とともにまとめます。
Claude Code で git push が「成功」したのに反映されない — commit が無音で失敗する罠
git push がエラーを出さず Everything up-to-date と表示されるのに、変更がリモートに反映されない。clone 直後の identity 未設定で commit が無音失敗する原因と、SHA 照合で確実に検証する方法を解説します。
Claude Code で「Credit balance is too low」が出る時の原因と対処
Claude Code を起動した瞬間に「Credit balance is too low」と返ってきて作業が止まる。サブスクリプションには加入しているのに、なぜか API のクレジット残高を見に行ってしまう——この食い違いの正体と、認証経路の切り替え・残高補充・自動チャージの設定までを、実運用の手順で順番に整理します。
Claude on Xcode と Claude Code を、iOS 個人開発の日常で 2 週間使い分けた所感
Xcode に常駐する Claude on Xcode と、ターミナルで動く Claude Code を、壁紙アプリの実務で 2 週間並行して使いました。どちらをどの作業に充てると手が止まらないのか、実際の振り分けと判断基準を残します。
Claude Code から git push すると 403 Write access to repository not granted が出るときの対処
Claude Code の自動化で GitHub に push すると 403『Write access to repository not granted』が出る原因を、classic PAT と fine-grained PAT の違いから整理し、リポジトリアクセス・Contents 権限・組織承認の確認手順を解説します。
Claude Code を相棒に Firebase を CocoaPods から SPM へ移したときの実装メモ
個人開発の iOS アプリで Firebase を CocoaPods から Swift Package Manager へ移行した記録です。Claude Code に何を任せ、何を自分で判断したか、Crashlytics の dSYM でつまずいた点まで率直にまとめました。
Claude Code のコンテキスト上限エラーが出たときの原因と対処
長時間のClaude Codeセッションでコンテキスト上限に達して止まったときの対処を実体験から解説します。/compactによる会話圧縮と--continueでの再開の使い分け、タスクを小さく分割する設計、コンテキストを節約する習慣、/clearとの違いまで順に整理しました。
Claude Code と Claude in Chrome の使い分け — 運用で見えた境界線
個人でアプリを運営していると、エディタとブラウザの行き来が集中力を削ります。Claude Code と Claude in Chrome をどちらに任せるかで整理した 1 ヶ月の運用と、境界が曖昧だった領域の判断基準を、実数値とあわせて記録しました。
効くスキルの設計 — テンプレート固定と判断基準で Claude Code の出力を安定させる
Claude Code のスキルで毎回ブレる出力を安定させるための実践設計。いつ使うかの明示、判断基準テーブル、references テンプレートでの品質固定、トレーサビリティ規則を、実運用のコード付きで解説します。
SKILL.md の後半が読まれていなかった話 — 200行に収める設計と progressive disclosure
Codex CLI が SKILL.md を約220行で読み止める観測をきっかけに、エージェントが実際に読む長さと、SKILL.md を200行以内に収める設計・references への退避の考え方を整理しました。
Dynamic Workflow を自作する — phase / agent / pipeline で再現可能な調査パイプラインを書く
Claude Code の Dynamic Workflow を自作するための実践ガイド。phase / agent / pipeline / parallel のプリミティブ、JSON Schema による出力の固定、敵対的検証パターンの移植、トークンコストの設計までをコード付きで解説します。
git の detected dubious ownership が出てコマンドが止まるときの原因と対処
Claude Code やコンテナ・CI でgitを動かすと突然出る「detected dubious ownership in repository」の原因を整理し、safe.directory設定から所有権の根本対処までを実例で解説します。
Claude Code の Dynamic Workflow を動かして掴んだ、サブエージェント並列実行の勘所
Claude Code v2.1.154 で入った Dynamic Workflow を実際に動かし、/deep-research の流れ、有効化、/workflows での進行確認、ワークフローの保存までを個人開発の視点で整理しました。
完了条件を1行で渡してClaude Codeを自走させる — 4サイト記事生成パイプラインの設計と実装
Lab 4サイトで稼働している記事生成パイプラインの内部設計を、E2E駆動の完了条件と5回ループ上限を軸に整理しました。article_gate.py の合否を Done-when として渡すことで、Claude Code を毎日16本の記事生成で安定運用しています。
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 との具体的なやり取りを残しました。