Claude CLI とサブエージェントによる開発効率化ガイド
本ドキュメントでは、Claude CLI の導入方法と、開発に強力な効果を発揮する
サブエージェント（Sub-Agent）活用の実践方法についてまとめる。
目的は以下の通り：
- ローカル環境に Claude CLI を導入して“プロジェクトを理解させる”
- Sub-Agent により、要求仕様 → 設計 → 実装 → レビュー を一気通貫で支援させる
- AI を「質問に答える存在」ではなく、「一緒に開発する相棒」として活用する
1. Claude CLI の概要
Claude CLI（Claude Code）は、ターミナル上で動作する プロジェクト理解型AIエージェント。
特徴は以下：
- プロジェクトフォルダを読み込み、コード構造を理解できる
- ファイル編集（Edit）・説明（Explain）・改善提案が可能
- 会話形式での指示ができ、修正案の diff を提示
- バージョン管理されたコードと非常に相性が良い
2. Claude CLI の導入方法
2.1 macOS / Linux（推奨）
curl -fsSL https://claude.ai/install.sh | bash
2.2 macOS（Homebrew）
brew install --cask claude-code
2.3 Windows（PowerShell）
irm https://claude.ai/install.ps1 | iex
2.4 npm（Node.js 18+）
npm install -g @anthropic-ai/claude-code
2.5 初回セットアップ
cd /path/to/project
claude
ブラウザが開き、Claudeアカウントによる認証を行うことで利用可能になる。
3. Claude CLI が開発に向いている理由
3.1 「プロジェクトを丸ごと理解させる」ことができる
フォルダを読み込ませると、以下を AI が把握する：
- ディレクトリ構造
- ファイル関係
- コードの依存関係
- 設計意図まで推測
そのため、質問したときの回答精度が高くなる。
例：
このサービス層の責務を整理してください。
users.service.ts のロジックを repository に移すべきか判断してください。
4. サブエージェント（Sub-Agent）の活用
Claude CLI の真の強みが サブエージェント（Sub-Agent）。
サブエージェントは以下の目的に特化した“小さなAIワーカー”を
複数同時に動かすための仕組み。
4.1 サブエージェントができること
- 要求仕様から spec.md のドラフトを生成
- 設計意図を整理し architecture.md を作成
- 実装計画（schedule.md）を自動生成
- API一覧・ER図などの技術文書を AI が継続的に管理
- 既存コードの改善点を自動レビュー
- リファクタリングの候補を出す
- 全ての成果物を「同じ世界観」で統一
特に開発フローにおける反復作業が劇的に減る。
4.2 サブエージェント実行イメージ
claude
# Sub-Agent を作成して、役割を定義
「あなたはこのプロジェクトのアーキテクトです。
要求仕様をまとめ、spec.md を作成してください。」
「あなたはレビュワーです。
生成された spec.md の矛盾を検出してください。」
「あなたは実装計画担当です。
spec.md をもとに schedule.md を作成してください。」
これらのエージェントを同時並行で動かすことにより、
実開発で必要な文書を自動生成し統一できる。
5. 開発ワークフローと Claude CLI＋Sub-Agent の組み合わせ
以下のような流れが最適：
1. 要求仕様作成（spec.md）
↓
2. 設計作成（designdoc.md）
↓
3. 実装計画（schedule.md）
↓
4. 詳細Todo生成
↓
5. 実装
↓
6. サブエージェントによるコードレビュー
この一連の作業を Claude に任せることで、
人間は「判断」や「意思決定」に集中できる。
6. 実際のサブエージェント活用例
6.1 要求仕様生成
このプロジェクトの目的は○○です。
必要な機能一覧を整理し spec.md を生成してください。
6.2 設計書生成
spec.md を踏まえて設計を行ってください。
API一覧、DB設計、処理フローを含めて designdoc.md を生成してください。
6.3 実装計画
designdoc.md をもとに実装のフェーズを計画し、
task breakdown した schedule.md を作成してください。
6.4 Todoリスト生成
schedule.md を基に詳細Todoを生成し、優先度順に並べてください。
6.5 コードレビュー
このPRの差分を読み込み、改善案を出してください。
7. Claude CLI + Sub-Agent のメリットまとめ
- ドキュメントが常に最新に保たれる
- プロジェクト全体の思考を一貫して管理できる
- メンバーが増えても情報共有のギャップが減る
- 手戻りが減り、設計・実装がスムーズになる
- 人間が「考えるべきこと」に集中できる