How-to 10分で読める

🧠

Claude Code 完全実践ガイド｜インストールから自律型開発フローまで【2026年版】

Claude Code の導入から実運用までを一気通貫で解説。サブエージェント・Hooks・MCP を使いこなし、シニアエンジニアの開発生産性を大きく押し上げる実践テクニック集。

公開 2026.04.13 · 更新 2026.05.17 · AIpedia 編集部（執筆：Ao）

Claude Code はエンジニアの生産性を根本から変えるツールですが、CLI ベースで学習曲線があるため、最初の1週間で挫折する人が少なくありません。本記事では編集部エンジニアが実運用で得た知見をもとに、インストールから自律型開発フローまでの最短経路を解説します。

3行で分かる Claude Code

Anthropic 公式の CLI ツール、Opus 4.7 をそのまま活用
リポジトリ全体を理解して自律的に複数ファイル改修できる
サブエージェント・Hooks・MCP で拡張性が無限

導入：最初の30分

インストール

npm install -g @anthropic-ai/claude-code

または macOS なら brew install claude-code で一発。

プラン契約

Pro（月¥3,000）：個人開発の標準
Max（月¥15,000）：ヘビー利用＋API従量込
API 従量：使った分だけ、初期コストゼロ

最初のプロジェクトで試す

cd ~/your-project
claude

これだけで、カレントディレクトリ全体を文脈に取り込んだ対話が開始されます。

最初の1週間で習得すべき基本操作

Pattern 1：読んで理解する

このリポジトリの認証周りの実装を全部読んで、どういう流れか要約して

→ 複数ファイルを横断して読み取り、構造を要約してくれる

Pattern 2：変更を指示する

app/api/login のエラーハンドリングを全部 try-catch で統一して、
ログは structured logging で出すように書き換えて

→ 複数ファイルを自律的に編集

Pattern 3：テストを書かせる

src/utils/validator.ts の全関数に Jest テストを追加して、
エッジケースもカバーして

→ テストコードを生成 → 実行 → 失敗なら自己修正

中級：設定ファイルでパワーアップ

`.claude/settings.local.json`

プロジェクトごとに Claude Code の挙動をカスタマイズ：

{
  "permissions": {
    "allow": ["Bash(npm test:*)", "Bash(npm run build)"],
    "deny": []
  }
}

CLAUDE.md で文脈を固定化

プロジェクトルートに CLAUDE.md を置くと、全セッションで自動読み込み。アーキテクチャ方針・コーディングルール・禁止事項を書いておくと効率が劇的に上がります。

上級：サブエージェントで並列化

複雑なタスクは専用のサブエージェントに委譲。例：

code-reviewer：変更差分を読んでレビューする専用
test-runner：テスト実行＆失敗解析の専用
docs-writer：ドキュメント整備の専用

/agents

コマンドでサブエージェント一覧を確認・編集できます。

最上級：Hooks で開発ワークフロー自動化

保存時・コミット前・ツール実行後などのフックポイントでスクリプトを自動実行：

コード変更後に自動でテスト実行
コミット前に Lint + Format を強制
危険コマンド（rm -rf など）を実行前に停止

.claude/settings.json で設定：

{
  "hooks": {
    "PreToolUse": [{"matcher": "Bash", "hooks": [{"type": "command", "command": "/path/to/script.sh"}]}]
  }
}

MCP（Model Context Protocol）で外部連携

Claude Code に Slack・GitHub・PostgreSQL などを繋げ、Claude がそれらのツールを自律的に操作できるように。

.mcp.json 設定例：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://..."]
    }
  }
}

よくある失敗と対策

いきなり複雑なタスクを投げる → まず小さい変更で挙動を掴む
Git 管理していないリポジトリで使う → 必ず Git 管理下で。ロールバック前提
Permission 設定を緩くしすぎる → 意図しないファイル変更のリスク

Cursor との使い分け

用途	推奨
日常のコード書き込み	Cursor
大規模リファクタ	Claude Code
IDE 内完結	Cursor
ターミナル＋マルチセッション	Claude Code

両方併用する開発者が増加中です。

編集部の実体験：本サイト構築で実際にやっている Claude Code 運用

本記事の編集を担当する Ao は、本サイト（ai-pedia.jp）の開発をCursor + Claude Code 併用で行っています。記事生成スクリプト、SNS パック自動生成、SEO 最適化、ビルドエラー対応など、ほぼすべてのタスクを Claude Code に任せた経験から、率直な使用感を共有します。

想定通りだった点

1. CLAUDE.md の威力が桁外れ プロジェクトルートの CLAUDE.md に「コーディング規約 / 禁止事項 / 主要パスのマップ / 過去の失敗事例」を書き込んだ結果、Claude Code が同じミスを2度しなくなる。これは Cursor の .cursorrules を超える効果です。

2. サブエージェント分業が想像以上に効く 本サイトでは code-reviewer（差分レビュー専用）・test-runner（テスト実行＆失敗解析）・explore（コードベース探索）の3つを運用。1タスクを複数 AI に分業させると、人間の意思決定回数が減って疲労が激減します。

3. Hooks でうっかり事故を回避 PreToolUse フックで「rm -rf を含むコマンドは確認プロンプトを挟む」と設定。過去にうっかり消した経験がある人ほど効きます。