Claude Code 中級者向け講座
ワークフローに組み込む 10 モジュール

このコースの位置づけ

初心者コースで Claude Code を触ったことがある人が、日常のワークフローに組み込まれた相棒に昇格させるためのコース。ターミナル / VS Code / JetBrains のいずれかに慣れており、Git と Docker の基本操作ができることを前提とする。

10 モジュール、各 30–60 分、合計 6–8 時間。全モジュール完走後、上級 (Team / Enterprise / Agent SDK / Bedrock) へ進める。

Module 1 · CLAUDE.md でプロジェクト文脈を Claude に覚えさせる

所要: 40 分 · 難易度: ★★☆ · 前提: 自分のプロジェクトが 1 つあること

🎯 ゴール

プロジェクトルート直下の CLAUDE.md を書くことで、Claude が毎回「このプロジェクトはどういうものか」を読み込んでから応答できる状態を作る。

📖 内容

CLAUDE.md は、プロジェクトルート直下に置く「Claude へのコンテキスト指示書」。Claude Code はセッション開始時に自動でこのファイルを読み、コーディング規約、プロジェクト固有の慣習、避けるべきこと等を把握してから作業を始める。

推奨セクション:

• プロジェクト概要: 何を作っているか、誰のためか、スタック
• コーディング規約: 命名、import 順、フォーマッタ、linter
• よく使うコマンド: npm run dev, make test, docker compose up 等
• 避けるべきこと: 触ってはいけないファイル、deprecated API、旧パターン
• テストの流れ: テスト環境のセットアップ、カバレッジ目標

💬 プロンプト例

🛠 ハンズオン手順

1. 既存のプロジェクト 1 つを開く
2. 上記プロンプトで CLAUDE.md のドラフトを生成させる
3. プロジェクトルートに CLAUDE.md を配置
4. 新規セッションで「このプロジェクトについて要約して」と聞く
5. 同じ質問を CLAUDE.md なしの別プロジェクトでも試し、応答の差を観察

✅ チェックポイント

• Claude がプロジェクト固有の慣習 (命名、テストコマンド等) を理解して応答する
• 「このファイルは触らない」等の禁止事項を守る

💡 ワンポイント

CLAUDE.md は生きたドキュメント。プロジェクトが進化したら Claude に「今の CLAUDE.md を最新に更新して」と頼むと良い。また、チーム共有する場合は Git 管理、個人メモは CLAUDE.local.md (gitignore) に分ける。

Module 2 · .claude/ ディレクトリで設定を細かく制御

所要: 40 分 · 難易度: ★★☆ · 前提: Module 1 完了

🎯 ゴール

プロジェクトごとに .claude/settings.json を配置し、ツール権限 (Bash コマンド許可/拒否) を細かく制御できるようになる。

📖 内容

• .claude/settings.json: チーム共有の設定 (Git 管理)
• .claude/settings.local.json: 個人設定 (gitignore 対象)
• /permissions コマンド: 現在の許可状態の確認・変更
• 権限モード: ask (毎回聞く) / allow (自動実行) / deny (ブロック)
• カスタムプロンプト: .claude/commands/xxx.md にコマンド化して保存

💬 プロンプト例

🛠 ハンズオン手順

1. .claude/settings.json をプロジェクトに作成
2. npm / yarn / pnpm 系を allow に
3. rm -rf, sudo, curl | sh を deny に
4. 未定義のコマンドは ask のまま
5. 3 パターン (allow / ask / deny) を意図的に発動させて挙動を確認

✅ チェックポイント

• npm コマンドは確認なしで動く
• 想定外の危険コマンドは確実にブロックされる
• /permissions で現在の許可状態を可視化できる

💡 ワンポイント

本番データベース・本番サーバへの接続コマンドは絶対に allow に入れない。ask のままにして、毎回ヒューマン in the loop で判断する。これが deep-api-keys.html で扱う「最小権限」の原則。

Module 3 · カスタム slash commands の作成

所要: 30 分 · 難易度: ★★☆ · 前提: Module 2 完了

🎯 ゴール

自分のワークフロー (PR 作成、リリースノート生成、依存 update など) を 3 つカスタム slash command 化し、/your-command で即実行できるようにする。

📖 内容

.claude/commands/pr.md のようなファイルを置くと、/pr としてプロジェクト内で呼び出せるようになる。ファイル形式は YAML frontmatter + Markdown body。

例 (.claude/commands/review-pr.md):

---
description: Review the current PR diff for quality issues
---
git diff main...HEAD を見て、以下の観点でレビューして:
- 命名・可読性
- エラーハンドリング
- テスト漏れ
- セキュリティ上の懸念
結果は優先度順に箇条書きで。

💬 プロンプト例

🛠 ハンズオン手順

1. 自分のワークフローから 3 つ選ぶ (例: /release-notes, /deps-update, /review-pr)
2. 各コマンドを Claude に作らせる
3. .claude/commands/ 配下に配置
4. 新規セッションから /your-command で呼び出して動作確認

✅ チェックポイント

• 3 つのカスタムコマンドが / 補完に出る
• 各コマンドが期待どおりのアウトプットを出す

💡 ワンポイント

frontmatter に allowed-tools を書くと、そのコマンド中で使えるツールを限定できる (例: Bash(git diff:*) のみ)。組織配布するコマンドほど権限を絞っておく。

Module 4 · MCP server を 1 つ接続 (Google Drive)

所要: 50 分 · 難易度: ★★★ · 前提: Claude Desktop インストール済み

🎯 ゴール

Google Drive MCP server を Claude Desktop に接続し、実際の Drive ファイルを Claude から検索・要約できるようにする。

📖 内容

MCP (Model Context Protocol) は、外部ツール・データソースを Claude に接続するための標準プロトコル。詳細は deep-mcp.html を参照。

2026 年時点では Desktop Extensions (.dxt ファイル) でワンクリックインストールが可能。JSON 編集は不要。

インストール手順:

1. 公式 MCP カタログから Google Drive Extension (.dxt) をダウンロード
2. Claude Desktop の Settings → Extensions にドラッグ&ドロップ
3. OAuth 認証フロー (ブラウザが開く) を完了
4. 接続完了後、セッション内で Drive にアクセス可能

💬 プロンプト例

🛠 ハンズオン手順

1. Google Drive MCP をインストール
2. 自分の Drive で OAuth 認証
3. 実在する自分のファイルを検索・要約させる
4. 存在しないファイル名でエラー挙動を確認

✅ チェックポイント

• Drive 内のファイルを検索できる
• 読み取ったファイル内容を要約できる
• 権限のないファイルには適切にエラーが返る

💡 ワンポイント (トラブルシュート)

• 認証切れ: Extensions 設定から再認証。トークン有効期間は通常 1 時間〜1 日
• 権限エラー: OAuth スコープに drive.readonly のみ含まれているか確認
• 検索が遅い: Drive API はレート制限あり、一度に 100 件まで

Module 5 · Skills の活用と自作

所要: 50 分 · 難易度: ★★★ · 前提: Module 4 完了

🎯 ゴール

公式 Skills を使いつつ、skill-creator を使って自分用のスキルを 1 つ作り、次回セッションでも自動発動する状態にする。

📖 内容

Skills は、Claude に特定領域の専門手順を与えるメカニズム。各スキルは SKILL.md + 補助ファイルで構成され、progressive disclosure (必要なときだけ読み込まれる) の仕組みで context を節約する。

公式 Skills の例: skill-creator (スキルを作るスキル)、pdf, docx, xlsx (オフィス文書操作)、mcp-builder (MCP サーバ構築支援) など。

スキルの本体は SKILL.md:

---
name: mixi-weekly-report
description: MIXI の週次報告書を書くスキル。テンプレ + チェック項目を含む。
---
# 週次報告書の書き方
## テンプレート
...
## 必須チェック項目
- [ ] 今週の主要成果 3 点
- [ ] 来週の優先タスク 3 点
...

💬 プロンプト例

🛠 ハンズオン手順

1. skill-creator を起動
2. 自分の業務で繰り返し行う作業を 1 つ選ぶ (週次報告、コードレビュー、議事録等)
3. テンプレ + チェック項目を入れて SKILL.md を生成
4. プロジェクト .claude/skills/ または global に配置
5. 新規セッションで該当作業を依頼 → スキルが自動発動するか確認

✅ チェックポイント

• 作ったスキルが次のセッションでも自動発動する
• description を適切に書いているので、関連タスクで正しく呼ばれる

💡 ワンポイント

スキルの description は Claude が「いつこのスキルを使うか」の判断材料。いつ使うべきか・使うべきでないかを具体的に書くと発動精度が上がる。詳細は deep-mcp.html の Skills セクション も参照。

Module 6 · Subagent で並行タスクを回す

所要: 40 分 · 難易度: ★★★ · 前提: Module 5 完了

🎯 ゴール

1 セッション内で Subagent を並行起動させ、独立した複数タスクを同時に処理できるようになる。

📖 内容

Subagent は、親エージェントが子エージェント (Subagent) にタスクを dispatch する仕組み。Task tool 経由で呼び出され、各 Subagent は独立した context を持って並列実行される。

利点:

• 並列実行で時間短縮
• context 汚染の回避 (子の調査ログが親に流れ込まない)
• 複数視点の同時取得 (例: セキュリティ / パフォーマンス / 可読性を別エージェントで)

制約:

• Subagent 間は直接通信しない (情報共有は親経由のみ)
• 各 Subagent は終了時にサマリを親に返す

💬 プロンプト例

🛠 ハンズオン手順

1. 独立した 2 タスクを用意 (例: フロントエンドのリファクタ提案 / バックエンドのリファクタ提案)
2. 親エージェントに「Subagent 2 つで並行処理して」と指示
3. 並列実行ログを観察
4. 親が両方の結果を統合してサマリを返すか確認

✅ チェックポイント

• 1 セッションで複数視点を同時に得られる
• 親のメイン context が子の調査ログで汚染されない

💡 ワンポイント

Subagent は依存関係のない独立タスクにのみ使う。連続ステップ (A の結果を使って B する) には不向き。その場合は親エージェント内で順次処理する方が正しい。

Module 7 · Worktree で並行ブランチ開発

所要: 45 分 · 難易度: ★★★ · 前提: Git の基本操作

🎯 ゴール

Git worktree を使って、1 リポジトリ内で複数ブランチを別ディレクトリにチェックアウトし、Claude Code の Parallel Sessions と組み合わせて並行開発できるようになる。

📖 内容

Git worktree は、同一リポジトリ内で複数のブランチを異なるディレクトリに同時チェックアウトする機能。

git worktree add ../myproj-feature-a feature-a
git worktree add ../myproj-feature-b feature-b
git worktree list

Claude Code Desktop は新規セッション開始時に自動で worktree を作る (Parallel Sessions 機能)。手動で git worktree を叩かなくても、別セッション同士が干渉しない。

💬 プロンプト例

🛠 ハンズオン手順

1. 既存プロジェクトを用意
2. 2 つの独立した feature を選ぶ
3. Claude Code Desktop で Parallel Session を 2 つ開始
4. 各セッションで異なる feature を依頼
5. 片方のセッションの変更がもう片方に漏れないことを確認
6. 終了時は git worktree remove <path> で掃除

✅ チェックポイント

• worktree が自動生成される
• セッション間で作業ツリーが干渉しない
• 各ブランチが独立してコミット可能

💡 ワンポイント

worktree は同じブランチを 2 箇所に同時チェックアウトできない制約がある。並行作業したいなら必ず別ブランチを切る。また、node_modules / vendor 等は各 worktree で別インストールが必要なので、初回は時間がかかる。

Module 8 · Plan mode を Git workflow に組み込む

所要: 30 分 · 難易度: ★★☆ · 前提: Module 3 完了

🎯 ゴール

Plan mode を日常の Git workflow (issue → 実装 → レビュー → コミット) に組み込み、Plan → Approve → Implement → Self-review の 4 段階を習慣化する。

📖 内容

Plan mode は、Claude がファイルに触れずに「どう変更するか」の計画を先に立てるモード。Shift+Tab で切り替えるか、/plan スラッシュで起動。

推奨ワークフロー:

1. Plan: issue の内容を貼り、Plan mode で対応方針を提案させる
2. Approve: 方針に合意するか、修正を依頼
3. Implement: 承認後に実装モードへ切り替え
4. Self-review: カスタム /review-code (Module 3 で作成) で自己レビュー
5. commit + push

💬 プロンプト例

🛠 ハンズオン手順

1. 自分のリポジトリから実 issue を 1 本選ぶ
2. Plan mode で方針提案
3. 気になる点を 2–3 往復で詰める
4. 承認 → 実装モードへ
5. 実装後 /review-code で自己レビュー
6. 修正を入れてコミット

✅ チェックポイント

• Plan → Implementation → Self-review の 3 段階が習慣化
• 実装前に方針を合意できるため、手戻りが減る

💡 ワンポイント

Plan mode は「デカい変更」に効果が高い。1 行修正では逆にオーバーキル。目安は「3 ファイル以上を触る」「テスト追加が発生する」「アーキに影響する」のいずれかを満たすとき。

Module 9 · Hooks で自動化 (pre-commit format 等)

所要: 40 分 · 難易度: ★★★ · 前提: Module 2 完了

🎯 ゴール

Hooks を設定し、「ファイル編集後に自動で prettier 実行」「セッション終了時に自動で git status 表示」などのワークフロー自動化を実現する。

📖 内容

Hooks は、settings.json で pre/post アクションを定義できる仕組み。手動で lint や format を叩く必要がなくなる。

代表的な Hook イベント:

• PreToolUse: ツール実行前 (危険操作のブロック、追加確認)
• PostToolUse: ツール実行後 (lint / format 自動実行)
• Stop: セッション終了時 (サマリ保存、通知)
• UserPromptSubmit: ユーザ入力時 (ログ取り、inject)

例 (.claude/settings.json):

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write ." }
        ]
      }
    ]
  }
}

💬 プロンプト例

🛠 ハンズオン手順

1. PostToolUse Hook で prettier / eslint --fix を自動実行
2. Stop Hook で git status と変更ファイル数を表示
3. 実際にファイル編集 → Hook が発火するか確認
4. Hook が失敗したときの挙動 (ブロックされるか、警告のみか) も確認

✅ チェックポイント

• 手動で format コマンドを叩かなくなった
• セッション終了時に変更サマリが自動表示される

💡 ワンポイント

Hook で重い処理 (全テスト実行など) を走らせると作業テンポが落ちる。軽量な format / lint に留め、全テストは CI に任せる設計が基本。グローバルグローバル設定は ~/.claude/settings.json、プロジェクト設定は .claude/settings.json。

Module 10 · 自分の月次業務に Claude Code を 1 本組み込む

所要: 60 分 · 難易度: ★★★ · 前提: Module 1–9 完了

🎯 ゴール

自分の実業務 (月次レポート、予算計画、コードレビュー、OKR 進捗確認など) を 1 つピックアップし、CLAUDE.md + カスタム slash command + Skill のうち 2 つ以上を組み合わせて、月次運用ルーチンとして Claude Code に組み込む。

📖 内容

このモジュールは「中級コースの集大成」。ここまでで覚えた部品 (CLAUDE.md / .claude/commands / Skills / MCP / Hooks) から 2 つ以上を選び、自分の月次業務 1 本を自動化する。

設計すべきポイント:

• いつ走らせるか: 月初 / 月末 / 特定の日
• インプット: どこからデータを取るか (Drive / GitHub / ローカルファイル)
• アウトプット: どこに出すか (PR / Drive / Slack 下書き)
• レビュー責任: 最終確認は誰がするか
• 更新ポリシー: テンプレが変わったら誰が更新するか

💬 プロンプト例

🛠 ハンズオン手順

1. 自分の月次業務を 1 つ選ぶ
2. 必要な部品を 2 つ以上選定 (CLAUDE.md / slash command / Skill / MCP / Hook)
3. 各部品を実装・配置
4. エンドツーエンドで一度通す
5. レビュー責任者 / 更新タイミング / 失敗時の fallback を文書化

✅ チェックポイント

• 次の月次運用でこのフローがそのまま回る状態
• 部品 2 つ以上を組み合わせている
• 人間のレビューポイントが明確

💡 ワンポイント / Next Step

月次業務を 1 本組み込めたら中級卒業。ここから先 (チーム展開、Agent SDK でのプログラマブル統合、Bedrock での日本リージョン運用、SSO / SCIM / 監査) は course-advanced.html で扱う。

中級者卒業チェックリスト

下記 10 項目すべてにチェックが入ったら、あなたは Claude Code 中級を卒業。上級講座 (Team / Enterprise / Agent SDK / Bedrock / 組織運用) に進める。

※ 本資料は 2026 年 4 月 21 日時点の情報に基づく。Claude Code の仕様・UI は頻繁に更新されるため、最新は公式ドキュメントで確認すること。