Claude Code
ターミナルで動く AI コーディング支援ツール Claude Code の実践記事です。導入手順、CLAUDE.md の設計、サブエージェント、フック、CI 連携、詰まりやすいエラーの解決まで扱います。自動化やヘッドレス運用の記事も揃えています。
リリースゲートを Claude Code に任せる — 「通った理由」が読めるデプロイ前検証の組み立て方
CIが緑でもリリース直前の事故は起きます。Claude Codeに「通った理由・止めた理由」を文章で書かせる7項目のリリースゲートを、環境変数チェックやマイグレーション安全性の実装例、警告疲れを避ける赤の出し方、リリースノートへの接続、ロールバック手順の同梱まで紹介します。
Claude Code の /clear と /compact を使い分ける — 長時間作業を止めない切り替え術
Claude Code の /clear と /compact、どちらを使うべきか迷ったときの判断基準を、長時間セッションの実体験から整理しました。会話の汚染を抜く時と、文脈を残しながら余白を作る時の見分け方が分かります。
Claude Code × Storybook で築く本番グレードのコンポーネント駆動開発 — Visual Regression とデザインシステム運用の実装パターン
Claude Code と Storybook を組み合わせて、コンポーネント駆動開発を本番グレードまで引き上げる実装ガイド。Story の自動生成、Visual Regression、Interaction Testing、CI 統合、デザインシステム運用までを実例コード付きで解説します。
Claude Code で Stripe Webhook をローカルで安全にテストする3つの実用パターン
Stripe Webhookの署名検証・冪等性・再送のテストをローカルで安全に進める3つのパターンを、Claude Codeと組み合わせて解説します。stripe listenでの転送、本物のペイロードをファイル化して再生する方法、リトライをまとめて検証する構成を実装コード付きで紹介します。
Claude Code で flaky test を体系的に潰す段階的アプローチ
「再実行したら通った」で済ませてきた flaky test を、Claude Code を使って体系的に分析・修正する手順を紹介します。原因分類から再現スクリプトまで、本番運用で機能しているパターンをまとめました。
Claude Code Skills を組み合わせる設計術 — 単一スキルでは届かない自動化を作る
Claude Code の Skills を1つずつ作るところから一歩進み、複数スキルを連携させて自動化を組む設計手法をお伝えします。Pipeline・条件分岐・メタスキルの3パターンとよくある落とし穴を実装例付きで詳述します。
AI エージェントが即座に活躍できるコードベース設計図
Claude Code をはじめとする AI エージェントが、初見のリポジトリでも迷わず開発に貢献できるコードベース設計の実践ガイド。CLAUDE.md・契約境界・ガードレール・テスト戦略まで体系化します。
Claude Code が .gitignore のファイルを検索しない理由と、必要なときに見つける方法
.env.example や dist/ が Claude Code の Glob/Grep に引っかからないとき、原因は .gitignore です。挙動の理由と、Read ツール・--no-ignore・一時的な除外解除の3つの突破口を具体的に解説します。
Claude Codeでフロントエンドのアクセシビリティ監査を自動化する — axe-coreとプルリクのコメント連携で運用に乗せる
リリース直前に後回しになりがちなアクセシビリティ監査を、Claude Codeとaxe-coreで仕組み化します。CLIから動かす土台づくり、スキルとしての登録、PreCommitフックでの漏れ防止、GitHub ActionsによるPRへの自動コメントまで、日々の運用に乗せる具体的なワークフローです。
Claude Code の実行を OpenTelemetry で観測する — エージェント処理を本番品質で可視化する設計ガイド
Claude Code のエージェント処理を OpenTelemetry でトレースする本番設計ガイド。フック連携・ツール呼び出し計測・MCP 通信・コスト属性・サンプリングまで、実運用で詰まらないパターンをお伝えします。
Claude Code の自動アップデートが効かない時の診断手順 — claude --version が古いまま動かない問題を切り分ける
Claude Code をアップデートしたはずなのに claude --version が古いまま、新機能が出てこない、という症状の根本原因を切り分けるための実践的な診断手順をまとめました。PATH 衝突、ローカルキャッシュ、nvm の切替、社内プロキシなどケース別に解説します。
Claude Code を午前と午後で別人格にする — 探索と実装を分けたワークフロー設計
同じClaude Codeを同じ設定で一日中使うと、どこかで思考の質が落ちます。午前は探索と批判に特化させ、午後は実装と完成に特化させる別人格運用を、それぞれのCLAUDE.mdの書き分けと、切り替えをコマンド一発にする工夫まで含めて個人開発の実例で紹介します。
Claude Code が途中でタスクを諦める問題 — 完走させるプロンプト設計と検証ループ
「完了しました」と言いながら実は半分しか終わっていないClaude Codeを完走させる方法です。途中で完了と判断してしまう理由の分析、完了条件を明示するプロンプトの3要素、自動検証ループの実装パターン、Hooksとの組み合わせ、実際に使っているテンプレートまで公開します。
Claude Code の /init で生成された CLAUDE.md を実用レベルに磨き上げる4ステップ
/initが生成するCLAUDE.mdは、そのままでは「あって当たり前のこと」しか書かれていません。当たり前を削る、やってほしくないことを明記する、プロジェクト固有の判断基準を足す、実例で型を示すという4ステップで実用レベルに磨き上げる方法を、最小テンプレートとともに共有します。
Claude Code に画像とスクリーンショットを貼り付けて UI バグを直す実践ワークフロー
UIバグは言葉で説明するより画像を見せる方が速く直ります。Claude Codeに画像やスクリーンショットを渡す3つの方法、実プロジェクトで効くプロンプトの型、貼り付け時に詰まりやすい3つのポイントまで、CLI操作とファイル参照を交えた実践ワークフローとして解説します。
Claude Code で週末MVP開発 — 48時間で作って初売上を立てるまでの全工程
金曜の夜に思いついたアイデアを、月曜の朝までに課金可能なプロダクトへ——Claude Codeで週末48時間のMVP開発を進める全工程です。アイデア検証、プロジェクト初期化、コア機能実装、Stripe最小決済の組み込み、デプロイとローンチ準備までを時間割と実際のプロンプト付きで解説します。
Claude Codeでスライド生成を30分で自動化する実践ワークフロー
スライド作成の時間の多くはレイアウト調整と整形に費やされています。Claude Code SkillsとMarkdown中間フォーマットを組み合わせ、企画からGoogle Slides出力までを30分で終える自動化ワークフローを、3ステップの流れと実際にかかった時間の記録つきで解説します。
自分のコードを「他人のコード」として読ませる — Claude Code に厳しいレビューを引き出す質問設計
自分で書いたコードを自分でレビューすると、不思議と粗が見えなくなります。Claude Code を『他人のコードを読みに来た中堅レビュアー』として召喚するための質問設計と、私が実装現場で使っているプロンプトを公開します。
Claude Code を「設計のスパーリング相手」に変える質問の作法
Claude Codeを単なるコード生成器ではなく、設計を一緒に考えるスパーリング相手として使うための質問の作法です。最初の3行で対話の質が決まる理由、比較できる選択肢を引き出す問いの形、同意されないことを前提にする姿勢、設計対話をCLAUDE.mdへ蓄積する習慣を共有します。
Claude Code Hooks — 中核8フックの設計判断と、33イベントに増えた今の歩き方
Claude Code のフックは強力ですが、どのイベントで何ができるかが曖昧で、結局使いこなせないまま終わる人が多いです。私が半年運用して辿り着いた、フック種別ごとの設計判断と典型的な落とし穴を整理します。
Claude Code の Context Window 管理術 — 大規模リポで詰まらないための7つの実装パターン
大規模プロジェクトで Claude Code が止まる・遅くなる・文脈を見失う原因の多くは、Context Window の設計不足です。実運用で効果のあった7つのパターンを、計測スクリプトと運用ルールつきで解説します。
Claude Code の `claude --resume` が前回のセッションを復元できない時の対処法
Claude Code の --resume / --continue で前のセッションが復元できない時に確認すべき場所を、セッションファイル・設定・バージョン差・マシン跨ぎの順に整理した実用ガイドです。
Claude Code を pnpm モノレポで使いこなす — --filter と dlx の組み合わせ
pnpm のモノレポで Claude Code を運用すると、別パッケージにまで手が伸びてしまう問題が起きがちです。--filter と dlx の正しい使い分け、.claude/settings.json での権限設計、CLAUDE.md への記述ルールまで、現場で詰まりやすいポイントを順に整理します。
Claude Code の「Authorization Failed」エラーを解きほぐす — OAuth・MCP・dynamic client registration の全体像
Claude Code を使っていて突然出る「authorization failed」「incompatible auth server: does not support dynamic client registration」というエラー。MCPサーバーやOAuth周りの噛み合わせを丁寧にひも解いて、現場で使える対処手順をまとめます。
CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を有効にすべきか — Windows 開発で実際に試した判断基準
Windows 環境で Claude Code を動かすとき、CLAUDE_CODE_USE_POWERSHELL_TOOL=1 環境変数を有効にすべきか迷う場面があります。私が複数のプロジェクトで両方試して見えた判断基準を整理しました。
Claude Code でテスト駆動開発を実装する — エージェントと書く TDD ワークフロー
Claude Code に「先にテストを書いてもらう」という制約を加えると、エージェントの暴走が止まり、生成コードの質が劇的に変わります。私が半年間試行錯誤して辿り着いた、エージェント時代の TDD ワークフローを共有します。
Claude Code で個人開発の『単価』を設計する — 収益化までの待ち時間を短くする思考法
個人開発の収益化が遠く感じる原因は、技術ではなく『単価設計』と『リードタイム』にあります。Claude Code を使ってMVPを最短で形にし、最初の収益までの距離を縮める実践的な思考法をまとめました。
Claude Code に依存ライブラリのアップグレードを任せる — 破壊的変更を見落とさない検証ループの設計
個人開発で 30 を超える依存ライブラリを抱えると、月一の一括アップグレードが恐怖の儀式になります。Claude Code に任せられるところと、人間が手放してはいけない判断を切り分け、破壊的変更を本番に漏らさない検証ループを実例で整理します。
Claude Code の .claude/ ディレクトリをチームで共有する設計 — Git管理する範囲と個人設定の境界
Claude Code の .claude/ をチームで共有する時、どのファイルを Git に入れて、どこを個人設定に残すか。実プロジェクトで得た境界線と .gitignore テンプレートをまとめます。
Claude Code のシークレット管理とトラスト境界設計 — エージェント時代の秘匿情報ハンドリング本番ガイド
Claude Code がシェルを掌握する時代の秘匿情報設計を、トラスト境界・注入パターン・流出防止フックの3軸で体系化。.env から MCP までの本番運用パターンと、よくある落とし穴を実装コード付きで解説します。
Claude Code Hooksが無限ループする問題 — PostToolUseが自己発火するときの止め方
Claude Code の Hooks を仕掛けたら、ツール呼び出しが止まらなくなった。PostToolUse が自分で書き換えたファイルを再び拾って延々と発火し続ける、典型的な無限ループの原因と止め方を実例ベースで解説します。
Claude Code で Unity ゲーム開発を加速する — C# 生成・MCP 連携・実機検証
Unity プロジェクトで Claude Code を最大限活用するための実践ガイド。C# スクリプト生成、Editor 拡張、Unity MCP、シーン操作の自動化、テスト戦略までを体系的に解説します。
Claude Code × uv で Python 環境を瞬速構築する — pip より 10 倍速いパッケージ管理の現場活用
Rust製の高速Pythonパッケージマネージャー「uv」をClaude Codeと組み合わせた開発環境構築を解説。pipの10〜100倍速い環境セットアップと、Claude Codeによる依存関係管理の自動化を実践的に紹介します。
Claude Code の --print と --output-format json で CI/CD パイプラインを自動化する
Claude Code の --print フラグと --output-format json オプションを使い、CI/CD パイプラインに AI 判断を組み込む実践ガイド。GitHub Actions でのコードレビュー自動化、PR コメント生成、テスト失敗解析まで、動作するコードで解説します。
Claude Code の git 操作が `index.lock` で詰まる時、VM・CI 環境で必ず効く3つの回避策
Claude Code が VM や CI 環境で git add や git commit を実行した時に `Unable to create '.git/index.lock'` で停止する問題の根本原因と、現場で効く3つの回避策を解説します。
Claude Code の --add-dir で複数リポジトリを横断編集する実践パターン
Claude Code の --add-dir フラグで複数リポジトリを同時に編集する具体的な手順。フロントエンドとバックエンドをまたぐ API 変更、monorepo 化していない複数サービスの一括修正などを安全に進めるコツをまとめます。
Claude Code で壊れないAIコーディングを回す — Plan Mode・Hooks・Rewind・Subagent を統合した失敗前提の本番運用設計
Claude Code で本番リポジトリを触ると壊れる・戻せないという不安を解消する実装ガイド。Plan Mode・Hooks・Rewind・Subagent を1つのワークフローに統合し、失敗を前提に設計された本番運用パターンを実例で解説します。
自作 MCP サーバーのログが消える — Claude Code で stderr を正しく拾う
Claude Code で自作の MCP サーバーを書いていて、console.log を足したのにログがどこにも出ない。実はサーバー自体が応答しなくなっている、という落とし穴の正体と、stdio を汚染しない正しいログ出力の置き換え方をまとめました。
Claude Code のサブエージェントが結果を返さない時の診断手順
Claude Codeのサブエージェントが結果を返さない・止まったように見えるときの診断フローです。症状を分類する最初の3つの質問、ツール呼び出しの無限ループ、エラーが親に伝わらないパターン、出力スキーマの不在による内容ズレ、.claude/agents/のリロードまでコード例つきで解説します。
Claude Code の TodoList はタスク粒度で品質が決まる — 実装で効いたパターン集
Claude Code の TodoList ツールは使い方を誤ると逆効果になります。タスクの粒度・検証ステップの設計・更新タイミングの3つの観点から、実務で成果が出た使い分けパターンをまとめました。