はじめに
「一人で開発しているけど、やりたいことに対して圧倒的に時間が足りない」——個人開発者なら誰もが感じるこの壁を、Claude Codeは根本から変えてくれます。
Claude Codeは単なるコード補完ツールではありません。ターミナル上で動作するAIエージェントとして、ファイルの読み書き、Git操作、コマンド実行までを自律的にこなします。個人開発において、これは「もう一人の開発メンバー」を手に入れるのに等しい体験です。
この記事では、Claude Codeを個人開発に本格導入するための実践的なワークフローを、具体的なテクニックとともに紹介します。公式ドキュメントの焼き直しではなく、実際に個人開発で使い込んできた知見をベースにしています。
Claude Codeが個人開発に最適な理由
個人開発でClaude Codeが特に威力を発揮する理由は、以下のポイントにあります。
- 既存の開発環境をそのまま使える: VSCodeやお気に入りのエディタ、ターミナルをそのまま利用可能。新しいIDEへの移行は不要です
- プロジェクト全体を理解してくれる: リポジトリ内のファイル構造やコードを読み取り、文脈を踏まえた提案をしてくれます
- 自律的にタスクをこなす: 「このバグを直して」と指示するだけで、関連ファイルの調査→修正→テスト実行まで一気通貫で進めてくれます
- Git操作も任せられる: ブランチの作成、コミット、PRの作成まで、開発フロー全体をカバーします
公式のベストプラクティスでも、Claude Codeは「リサーチと計画」「実装」「検証」のサイクルを回すことが推奨されています(Best Practices for Claude Code)。
CLAUDE.mdで「プロジェクトの地図」を渡す
個人開発でClaude Codeの効果を最大化する最初のステップは、CLAUDE.mdの整備です。これはプロジェクトルートに置くMarkdownファイルで、Claudeがセッション開始時に自動的に読み込む「指示書」のようなものです。
CLAUDE.mdに書くべき内容
効果的なCLAUDE.mdには、以下の情報を含めましょう。
プロジェクトの概要
- 何を作っているのか(WHY)
- 技術スタック(フレームワーク、言語、主要ライブラリ)
- ディレクトリ構造の説明
開発ルール
- コーディング規約(命名規則、ファイル構成など)
- コミットメッセージのフォーマット
- テストの方針
よく使うコマンド
- ビルドコマンド(
npm run buildなど) - テスト実行コマンド
- 開発サーバーの起動方法
過去の失敗と学び
- 「このライブラリのバージョンXではYが動かない」
- 「この設定を変えると本番環境で問題が起きる」
CLAUDE.mdの具体例
# MyApp - 個人家計簿アプリ
## WHY
月々の支出を可視化し、節約ポイントを自動提案するWebアプリ。
## 技術スタック
- Next.js 15 (App Router)
- TypeScript
- Tailwind CSS
- Supabase (認証・DB)
- Vercel (デプロイ)
## ディレクトリ構造
- src/app/ - ページコンポーネント
- src/components/ - 共通コンポーネント
- src/lib/ - ユーティリティ・API呼び出し
- src/types/ - 型定義
## 開発コマンド
- npm run dev - 開発サーバー起動
- npm run build - ビルド
- npm run test - テスト実行
- npm run lint - リント
## コーディング規約
- 関数コンポーネント + TypeScript必須
- CSS-in-JSは使わない(Tailwind CSS)
- APIクライアントはsrc/lib/api/に集約
## 注意事項
- Supabaseのクエリはサーバーコンポーネントで実行すること
- 環境変数はnext.config.jsで公開範囲を制限することAnthropicの開発チーム自身も、各チームがCLAUDE.mdをGitで管理し、過去のミスや改善点を蓄積していることが知られています。CLAUDE.mdは「生きたドキュメント」として継続的に更新することが重要です。
ドキュメント駆動開発で精度を上げる
Claude Codeに「なんとなくこういうの作って」と指示するのと、明確な仕様ドキュメントを渡すのとでは、出力品質が天と地ほど違います。
ドキュメント駆動開発の基本的な流れ
- 仕様ドキュメントを先に書く: 何を作るか、どう動くべきかを明文化する
- CLAUDE.mdからドキュメントを参照させる: Claudeが仕様を読んだ上でコードを書く
- 実装後にドキュメントを更新: 実装で変わった部分をドキュメントに反映する
docsフォルダの構造例
ドキュメントを整理するために、番号付きフォルダで構造化するアプローチが有効です。
- docs/10_product/ — なぜ作るか(プロダクト要件、ユーザーストーリー)
- docs/20_design/ — 何を作るか(画面設計、データモデル)
- docs/30_technical/ — どう作るか(アーキテクチャ、API設計)
- docs/40_operations/ — どう運用するか(デプロイ手順、監視設定)
番号付きにすることで、Claudeが自然な思考順序(WHY → WHAT → HOW)でドキュメントを読み解けるようになります。
個人開発での最小限ドキュメントセット
「24個もドキュメントを書くのは大変…」という方も安心してください。個人開発では、以下の最小セットで十分効果を発揮します。
- CLAUDE.md: プロジェクト全体の概要とルール
- docs/requirements.md: 機能要件の一覧(箇条書きでOK)
- docs/architecture.md: 技術設計の概要
この3つがあるだけで、Claudeの出力精度は格段に向上します。重要なのは完璧なドキュメントを書くことではなく、「Claudeが推測しなくて済む情報」を明文化しておくことです。
Plan Modeで設計→実装の流れを作る
Claude CodeにはPlan Mode(Shift+Tab で切り替え)という機能があり、コードを書かずに設計だけを議論できます。
個人開発でのPlan Mode活用フロー
- Plan Modeで設計を詰める: 「ユーザー登録機能を実装したい。どういう設計にすべき?」と相談
- Claudeの提案を吟味: ファイル構成、データモデル、APIエンドポイントの設計を確認
- 納得したら実装モードへ: 設計が固まったら通常モードに切り替え、auto-accept(Shift+Tab 2回)で一気に実装
この「設計→実装」の2段階アプローチにより、やり直しが大幅に減ります。Anthropicの開発者自身も「Plan Modeで行ったり来たりして設計を固めてから、auto-acceptモードで一気に実装する」ワークフローを推奨しています。
サブエージェントで並列開発する
個人開発で特に強力なのが、サブエージェントによる並列作業です。
サブエージェントとは
サブエージェントは、メインのClaudeセッションから独立したコンテキストウィンドウを持つ子タスクです。メインのClaudeが「調査タスク」「テスト作成タスク」などを並行して走らせることができます。
並列開発の実践例
複数のターミナルでClaude Codeを同時に動かす方法があります。
- ターミナル1: フロントエンドの新機能を実装
- ターミナル2: バックエンドのAPI追加
- ターミナル3: テストコードの作成
ポイントは、各セッションが異なるGitチェックアウトを使うことです。同じブランチで複数のClaudeが同時にファイルを編集すると競合が発生するため、worktreeやブランチを分けて作業し、後からマージするのがベストプラクティスです。
サブエージェントのモデル設定
コスト最適化のため、サブエージェントには軽量なモデルを割り当てることも可能です。
# メインセッションはOpus、サブエージェントはSonnetを使う
export CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-4-6メインの設計判断には高性能モデル、リサーチやテスト作成などの定型作業には軽量モデルを使い分けることで、トークンコストを抑えつつ効率を最大化できます。
Hooksで開発フローを自動化する
Hooksは、Claude Codeの特定のイベントに対して自動的にコマンドやプロンプトを実行する機能です。個人開発では、以下のような活用が効果的です。
実践的なHooks設定例
コミット前の自動リント
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash(git commit)",
"hooks": [
{
"type": "command",
"command": "npm run lint"
}
]
}
]
}
}ファイル変更後の自動テスト
Claudeがファイルを編集するたびに関連テストを実行させることで、壊れたコードをすぐに検知できます。
Hooksの3つのタイプ
- command: シェルコマンドを実行(リント、テスト、ビルドなど)
- prompt: Claudeに追加プロンプトを送信(レビュー指示など)
- agent: サブエージェントを起動(調査、検証タスクなど)
詳しくはClaude Code公式ドキュメントを参照してください。
カスタムスラッシュコマンドで作業を効率化する
.claude/commands/フォルダにMarkdownファイルを置くことで、独自のスラッシュコマンドを定義できます。個人開発で役立つコマンド例を紹介します。
よく使うカスタムコマンド
コードレビューコマンド(.claude/commands/review.md)
直前のコミットの変更内容をレビューしてください。
以下の観点でチェックしてください:
- バグの可能性
- パフォーマンスの問題
- セキュリティリスク
- コーディング規約への準拠リリースノート生成コマンド(.claude/commands/release-note.md)
最新のタグから現在までのコミットログを確認し、
ユーザー向けのリリースノートをMarkdownで生成してください。これらのコマンドはGitで管理できるため、プロジェクトの成長とともにコマンドも充実させていけます。
個人開発での料金プランの選び方
Claude Codeを個人開発で使う場合、料金プランの選択も重要です。
Proプラン(月額$20)
- 週に数回程度の開発なら十分
- 5時間ごとのメッセージ制限あり
- まずはこのプランで試してみるのがおすすめ
Maxプラン(月額$100〜$200)
- 毎日Claude Codeで開発する場合はこちら
- Proプランの5倍〜20倍の使用量
- 個人開発を本格化させたい場合に最適
APIキー利用
- 使った分だけ課金される従量制
- 大量のトークンを使う場合はコストに注意
- 細かくコストを管理したい方向け
個人開発の場合、まずProプランで始めて、使用量に応じてMaxへアップグレードするのが現実的です。
実践的なワークフロー:新機能開発の一連の流れ
ここまでのテクニックを組み合わせた、新機能開発の具体的なワークフローを紹介します。
ステップ1: 要件を整理する
docs/requirements.mdに新機能の要件を箇条書きで追加ステップ2: Plan Modeで設計
Claude: 「docs/requirements.mdの新機能について、実装設計を提案して」
→ ファイル構成、データモデル、API設計を議論ステップ3: 実装
設計に納得したら通常モードに切り替え
Claude: 「設計に沿って実装を進めて。テストも一緒に書いて」ステップ4: レビューとテスト
/review で自動レビュー
テスト実行で品質確認ステップ5: コミットとPR作成
Claude: 「変更内容をコミットして、PRを作成して」この流れを繰り返すことで、一人でも組織的な開発プロセスを維持できます。
まとめ
Claude Codeは個人開発のあり方を根本から変えるツールです。ポイントを振り返ります。
- CLAUDE.mdを整備する: プロジェクトの地図をClaudeに渡すことが最初の一歩
- ドキュメント駆動で進める: 仕様を明文化してからコードを書かせると精度が飛躍的に上がる
- Plan Modeで設計を固める: いきなり実装せず、設計を詰めてから一気に書かせる
- 並列開発で生産性を倍増: サブエージェントや複数セッションで同時作業
- HooksとカスタムコマンドでDX向上: 繰り返し作業を自動化する
一人でも、チーム開発と同じ品質・速度でプロダクトを作れる時代が来ています。まずはCLAUDE.mdの整備から始めてみてください。