Claude Code 活用実践研修 提供：株式会社ギブリー
Givery / 2 day hands-on

Claude Code 活用実践研修

本研修のハンズオン題材は、架空クライアント株式会社マツカゼ製薬の海外子会社向け CRM 刷新案件（MTKZ-CRM-2026）の案件ヘルスチェックダッシュボードです。
React + TypeScript（フロント）と FastAPI + SQLite（バック）の最小構成のスタブを起点に、CLAUDE.md / Skills / Subagents / Hooks / MCP を 2 日間で投入し、運用に耐える形まで磨き込みます。

開催
第 1 回 2026 年 5 月 18 日〜19 日
第 2 回 2026 年 6 月 25 日〜26 日
形式
オンサイト・ハンズオン中心
2 日間 / 実働 7 時間 × 2
規模
10 名（Claude Code 既使用者）
講師
安田 光喜（株式会社ギブリー）
題材を見る → Day 1 タイムテーブル 配布資料ダウンロード
SECTION 01

ハンズオンデータの構成

配布 ZIP pwc-cc-handson_受講者用.zip を解凍すると、以下の構成で展開されます。Day 1 開始時点では .claude/ 配下はスタブで、研修中に育てていきます。完成形は pwc-cc-handson_完成形.zip 側を参照。

handson/
├── docs/                              当日参照ドキュメント
│   ├── 01_オリエンテーション.md
│   ├── 02_ハンズオンガイド_Day1.md
│   ├── 03_ハンズオンガイド_Day2.md
│   ├── 04_事前セットアップガイド.md
│   └── 05_運営マニュアル_講師向け.md
├── starter/                           Day 1 開始時の状態
│   ├── backend/                       FastAPI + SQLite + Anthropic SDK
│   ├── frontend/                      React 18 + TypeScript + Vite
│   ├── docs/source-materials/         ヒアリング起こし 3 名分（架空案件）
│   ├── docs/api-spec.md               REST API 仕様
│   ├── CLAUDE.md / AGENTS.md / DESIGN.md
│   └── .claude/                       スタブのみ（Day 1 で育てる）
├── samples/completed/                 Day 2 終了時の到達状態（完成形）
├── exercises/                         演習詳細（Day1 7 本 + Day2 7 本）
│   ├── day1/exercise1-claude-md.md ... exercise7-autonomous.md
│   └── day2/exercise1-reflection.md ... exercise7-share-and-keep-learning.md
├── bonus/                             別テーマ素材（β / γ / δ）
│   ├── beta_議事録ToDo抽出/
│   ├── gamma_提案QAビルダー/
│   └── delta_監査チェック自動化/
└── output/                            生成結果置き場（受講者が作る）
SECTION 02

研修終了時の到達点

CLAUDE.md を 5 項目以内で書き、@AGENTS.md でモジュール分割できる
Skills（risk-classifier / transcript-extractor 等）を作り、Custom Command（/analyze-transcript）から呼び出せる
Subagents（code-reviewer / security-auditor）で並列レビューを回し、親コンテキストを汚さずに作業できる
Haiku 4.5 / Sonnet 4.6 / Opus 4.7 の 3 モデルでコスト・精度差を実測し、用途に応じて切り替えられる
Hooks（PreToolUse / PostToolUse / Stop）で危険コマンド阻止・自動フォーマット・差分サマリーを仕掛けられる
Cron / launchd / タスクスケジューラで /weekly-report を非対話起動できる
MCP（filesystem / sqlite）で外部リソースを Claude Code から直接参照できる
DESIGN.md でフロント画面を磨き、配色・タイポ・コンポーネント方針を 1 ファイルで管理できる
自律開発（120 分）で、ヒアリング起こしから新機能を要件定義 → 設計 → 実装まで自分で動かせる
SECTION 03

2 日間のタイムテーブル（要約）

各日 9:00〜17:00、実働 400 分。詳細は Day 1 / Day 2 タブを参照してください。

Day 1：機能を 1 つずつ投入しながら α を作る

時間セッション内容
[30min]S01 オープニング環境確認、配布物チェック、自己紹介
[90min]S02 ベストプラクティス講義CLAUDE.md / Skills / Subagents / Hooks / MCP / コスト管理 / レビュー基盤化
[150min]S03 ハンズオン①（Ex1〜6）CLAUDE.md → Skills → Subagents → code-reviewer → security-auditor → 3 モデル比較
[120min]S04 ハンズオン②（Ex7）自律開発：起こしから新機能を 1 つ自分で要件定義 → 設計 → 実装
[10min]クロージング提出物確認、Day 2 朝の宿題

Day 2：運用に耐える形に仕上げる

時間セッション内容
[20min]S05 Day 1 リフレクション提出物の全体共有、良い指示パターン抽出
[50min]S06 並列実行と Subagent 深掘りEx1：3 起こしを並列処理して 1 ターン化
[50min]S07 Hooks 自動化Ex2：PreToolUse / PostToolUse / Stop の 3 種類
[40min]S08 Cron / 定期実行Ex3：cron / launchd / タスクスケジューラで /weekly-report
[40min]S09 MCP 応用Ex4：filesystem / sqlite を Claude Code に接続
[30min]S10 DESIGN.md 導入Ex5：8 セクションでフロント画面を磨く
[100min]S11 仕上げ実装（A / B / C 選択）Ex6：α 完成度向上 ／ 自社テーマ ／ 別テーマ再挑戦
[60min]S12〜S13 共有・情報源探索Ex7：1 人 3 分デモ + 公式情報源を一緒にブックマーク
[10min]クロージングネクストアクション宣言、フォローアップ案内
研修開始前 / [10min]

当日の環境チェック

配布資料『事前セットアップガイド』の Definition of Ready を、当日朝に 10 分で確認する画面です。詰まったら早めに講師へ挙手してください。代替経路はその場で案内します。

SECTION 01

環境確認 6 項目

研修開始前 [10min] で、下記 6 項目をご自身の手元で確認してください。1 項目でも「動かないとき」に該当する場合は、その時点で挙手してください。

#確認項目確認操作動かないとき
1VSCode が PATH 経由で起動するターミナルで code --versionVSCode を再インストール／PATH の追加にチェック
2Claude Code CLI が起動するclaude --version でバージョン表示公式インストーラ code.claude.com/docs/en/setup から再インストール
3Claude Code の認証が通る解凍ディレクトリで claude を起動し、Pro / Max ログインまたは社内中継基盤への接続が成立claude /logout で再ログイン／中継基盤経由の場合は ANTHROPIC_BASE_URL を確認
4Python 3.11 以上が動作python3 --version が 3.11 以上Microsoft Store / 公式サイトから 3.11 系をインストール
5受講者用 ZIP を解凍済み解凍先で ls または dir で README.md / CLAUDE.md / backend/ / frontend/ が見えるパス長が長い場合は短いパス（例：C:\work\ 直下）に置き直す
6バックエンド起動確認cd backend && uvicorn app.main:app --reload --port 8000 後に http://localhost:8000/health が {"status":"ok"}python -m app.seeds で seeds 投入を再実行／ backend/data/health.db を削除して作り直す
フロントエンドの起動について

フロントエンド（frontend/）の起動は Day 1 の S03 ハンズオン中に Claude Code に依頼します。Node.js が手元にない受講者でも、Claude Code に「frontend の開発サーバーを起動できる状態にして」と指示すれば、必要な環境構築から起動まで案内してもらえます。事前準備としては Python 側のみ確認できれば OK です。

SECTION 02

Claude Code が応答しない場合

  1. which claude（Windows: where claude）で PATH を確認
  2. ターミナルを再起動／VSCode を再起動（5 秒で復旧することが多い）
  3. Pro / Max サブスクリプション利用なら claude /logout 後に再ログイン
  4. 社内中継基盤経由なら echo $ANTHROPIC_BASE_URL で値を確認、基盤側のステータスを社内ポータルで確認
  5. 復旧しない場合は研修事務局（Givery 加藤）まで連絡。当日朝 10 分内に解決しなければ S01 中の個別ブースで対応
SECTION 03

社内ネットワーク／プロキシ／証明書

PwC 様社内ネットワークは外部接続にプロキシ・SSL インスペクション・ホワイトリストが介在します。本研修は社内ネットワークから直接インストール可能なケースと、社内 LLM 中継基盤経由でのみ Claude API に接続できるケースの両方をカバーしています。

プロキシ

環境変数 3 点セット

export HTTPS_PROXY=http://proxy.example.com:8080
export HTTP_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
Windows は PowerShell プロファイルまたはシステム環境変数
社内証明書

pip に取り込む

pip config set global.cert /path/to/corporate-ca.pem
Claude Code 自体は Node.js / npm に依存しないため証明書取り込みは pip のみで OK
中継基盤

BASE_URL 切替

export ANTHROPIC_BASE_URL="https://<社内中継>/v1"
# 認証ヘッダ等は中継基盤側のドキュメントに従う
Anthropic API キーの個別発行は不要
確認

切替の見え方

中継基盤経由かサブスクリプション経由かは echo $ANTHROPIC_BASE_URL で確認できます。空ならサブスクリプション経由、URL が出れば中継基盤経由。研修中はどちらかに統一しておくと混乱が減ります。

ハンズオン題材 / 全員共通

案件ヘルスチェックダッシュボード（MTKZ-CRM-2026）

架空クライアント株式会社マツカゼ製薬の海外子会社向け CRM 刷新案件を題材にしたハンズオン用 Web アプリです。ヒアリング起こしや週次レポートを起点に、案件のリスクを構造化してダッシュボードに可視化します。

SECTION 01

プロジェクト概要（架空案件）

クライアント

株式会社マツカゼ製薬（架空）

東証プライム上場の医薬品メーカー（架空）。海外子会社 12 社で営業領域の CRM が分断され、四半期決算の連結が手作業になっていた状況を、全社統合 CRM 刷新で解消する案件。社内コードは MTKZ-CRM-2026。

PMO のお題

案件のリスクを「構造化して」見たい

週次のステータスメールが長文化し、「結局どこで何が詰まっているのか」を経営報告で 5 分で説明できない状態。ヒアリング起こしから論点を抽出し、severity（重み）付きで Risk テーブルに登録、ダッシュボードで一覧する。

技術スタック

FastAPI + React

フロントエンドは React 18 + TypeScript 5 + Vite + Tailwind + Recharts、バックエンドは FastAPI 0.110 系 + SQLAlchemy 2.x + SQLite + Anthropic Python SDK。テストは Vitest（フロント）と pytest（バック）。

受講者の役割

PMO エンジニア

受講者は「マツカゼ製薬本社 PMO 配下の社内エンジニア」として、Claude Code を相棒にダッシュボードを育てます。設計判断は受講者、Claude Code は判断材料を提示する側。

SECTION 02

主要素材（リポジトリの読みどころ）

受講者用 ZIP に同梱されているファイルのうち、特に重要な 5 点。

handson/starter/
├── docs/source-materials/interview-transcripts/
│   ├── 01_tanaka.md         70 分／プロジェクトマネージャ ヒアリング
│   ├── 02_sato.md           65 分／海外子会社IT責任者 ヒアリング
│   └── 03_yamada.md         55 分／業務側エース ヒアリング
├── docs/api-spec.md         REST API 仕様（projects / risks / metrics）
├── backend/data/health.db   SQLite（Project 3 件 / Risk 5 件の seed 済み）
├── DESIGN.md                UI/UX 方針（Day 2 後半 S10 で投入）
└── CLAUDE.md / AGENTS.md    プロジェクト規約（Day 1 で育てる）
ヒアリング起こし 3 名分の使い方

Day 1 Exercise 2 で transcript-extractor Skill を作り、Exercise 3 の /analyze-transcript から呼び出します。1 ファイルあたり input 4,000〜7,000 / output 1,500〜2,500 tokens を目安に消費。Exercise 6 では Haiku / Sonnet / Opus の 3 モデルで同じ抽出を回し、コスト差を実測します。

SECTION 03

完成形リポジトリの構成

配布 ZIP pwc-cc-handson_完成形.zip（Day 2 終了時の到達状態）に同梱されている .claude/ 配下の構造です。Day 1 Exercise 1 から順に、これを再構築していきます。

Skills

3 種類

  • risk-classifier：severity / category 判定
  • transcript-extractor：起こしから論点抽出
  • api-spec-checker：実装と仕様の差分検出
Subagents

3 種類

  • code-reviewer：差分レビュー（Edit/Write 権限なし）
  • security-auditor：脆弱性検出
  • risk-extractor：起こし並列処理ワーカー
Custom Commands

5 種類

  • /analyze-transcript {path}
  • /add-endpoint {name}
  • /review-changes
  • /security-scan
  • /weekly-report（Cron 用）
Hooks

3 系統

  • PreToolUse Bash：危険コマンド阻止
  • PostToolUse Edit：ruff format / prettier
  • Stop：トークン消費 + 差分サマリー
MCP

2 系統

  • filesystem：docs/ 配下を読む（公式リファレンス実装）
  • sqlite：backend/data/health.db に問い合わせ（コミュニティ実装 mcp-server-sqlite を uvx 起動）
公式 MCP リファレンスサーバーの最新ステータスは github.com/modelcontextprotocol/servers を参照
DESIGN.md

UI/UX 方針

同系色濃淡 2 系統（ブランドディープ × ミッド）、信号機カラー禁止、severity の表現は背景色 vs ボーダーの段階表現。Day 2 後半 S10 で導入。

Day 1 ／ 9:00 - 17:00 ／ 実働 400 分

Day 1：機能を 1 つずつ投入しながら α を作る

雛形リポジトリに対し、CLAUDE.md → Skills → Subagents → code-reviewer → security-auditor → 3 モデル比較 → 自律開発 と機能を段階的に投入します。「整備した状態」と「素朴な状態」の差分を毎演習で確認するのが本日の学習スタイルです。

SECTION 01

タイムテーブル（詳細）

開始終了区分演習・内容
09:0009:30S01 オープニング環境確認、配布物チェック、自己紹介
09:3011:00S02 ベスプラ講義（座学）CLAUDE.md（20）／ Skills（20）／ Subagents（20）／ Hooks 概念（10）／ MCP 概念（10）／ コスト+レビュー（10）
11:0011:10休憩10 分
11:1011:35S03-1Exercise 1：CLAUDE.md（最小 → 規約追記）
11:3512:00S03-2Exercise 2：Skills（risk-classifier / transcript-extractor）
12:0012:25S03-3Exercise 3：Subagents（risk-extractor）+ Command（/analyze-transcript）
12:2512:30振り返り（午前）—
12:3013:30昼休憩—
13:3013:55S03-4Exercise 4：Subagent（code-reviewer）+ Command（/review-changes）
13:5514:20S03-5Exercise 5：Subagent（security-auditor）+ Command（/security-scan）
14:2014:40S03-6Exercise 6：モデル切替（Haiku 4.5 / Sonnet 4.6 / Opus 4.7）とコスト計測
14:4014:50休憩10 分
14:5016:50S04 自律開発Exercise 7：起こしから新機能を 1 つ自分で要件定義 → 設計 → 実装（120 分）
16:5017:00クロージング提出物確認、Day 2 朝の宿題
SECTION 02

演習 7 本（Day 1）

各演習は 学習目標 / 前提条件 / 使用ファイル / 手順 / AI への指示例 / 期待結果 / 動作確認コマンド / 考察 / 詰まったときのヒント / 発展課題 の 10 段構造。順番に上から実行してください。

Ex 1 ／ [25min]

CLAUDE.md：プロジェクト規約の常時参照

最小の CLAUDE.md（プロジェクト概要 + 役割分担 + コーディング規約 + 禁止事項）を書き、@AGENTS.md で他エージェント向けの md を取り込む。10 項目超えると Claude が守らない傾向があるため、5 項目以内に絞る。

使用ファイル：CLAUDE.md / AGENTS.md
Ex 2 ／ [25min]

Skills：再利用可能な指示の切り出し

.claude/skills/risk-classifier/SKILL.md と transcript-extractor/SKILL.md を作成。frontmatter の description に「いつ呼び出すか」の判断基準として機能する具体名詞（severity / Risk / transcript）を 2 つ以上含める。

入出力フォーマットを必ず具体例つきで書く
Ex 3 ／ [25min]

Subagent + Custom Command で並列処理

.claude/agents/risk-extractor.md を定義し、tools を最小限（Read / Grep）に絞る。.claude/commands/analyze-transcript.md から起こし 3 ファイルを並列で投げて 1 ターン化。Risk テーブルへ自動登録（5 件 → 5 + N 件）。

並列起動時は親が JSON だけ受け取る設計
Ex 4 ／ [25min]

code-reviewer Subagent

レビュー観点を Subagent 化。CLAUDE.md / DESIGN.md / api-spec.md に照らした規約遵守チェック。tools から Edit / Write を外してレビュー専用 = 修正できない権限分離を実現。

severity 4 段階（CRITICAL / MAJOR / MINOR / INFO）で統一
Ex 5 ／ [25min]

security-auditor Subagent

ハードコード秘密 / SQL インジェクション / XSS / 依存古さ / ログ漏えいを検出。仕込み済みの違反コード（api_key = "sk-ant-fakekey-..." 等）を検出できることを確認。/security-scan から呼ぶ。

偽陽性抑制：# security-scan: ignore コメントで局所スキップ
Ex 6 ／ [20min]

3 モデル比較（Haiku 4.5 / Sonnet 4.6 / Opus 4.7）

同じ /review-changes を 3 モデルで実行し、所要時間 / 検出件数 / コスト（/cost）を実測。Haiku は Sonnet の 60〜70% 精度、Opus は Sonnet の 110〜120% 精度。コストは Haiku = Sonnet/5、Opus = Sonnet × 5 程度。

用途：Haiku=単純判定、Sonnet=常用、Opus=重要レビュー
Ex 7 ／ [120min]

自律開発：起こしから新機能を 1 つ

ヒントのみ提供。受講者本人の試行錯誤が学習。最初の 10 分で「ゴール 3 行」を書き、スコープを絞ってから着手。詰まりが 10 分以上続く場合のみ講師が介入。

候補例：A 週次レポート自動生成 / B Risk フィルタ拡張 / C 起こし要約のチャット
SECTION 03

提出物（Day 1 終了時）

提出方法は当日アナウンス。社内チャット DM またはメール。

動く成果物（バックエンド + フロントエンドが起動し、Exercise 7 で追加した機能が画面で確認できる状態）
README.md に追記：何を作ったか / どんな指示を使ったか（5 行以内）
印象に残ったプロンプト 3 つ（一番効いた／一番苦戦した／Ex1 と比べて明らかに進化した）
/review-changes と /security-scan の出力（CRITICAL / MAJOR の件数）
Day 2 ／ 9:00 - 17:00 ／ 実働 400 分

Day 2：運用に耐える形に仕上げる

Day 1 の成果物（α）を起点に、並列 Subagent / Hooks / Cron / MCP / DESIGN.md を投入して運用品質まで磨き込みます。仕上げの 100 分は A（α 完成度向上）／ B（自社業務テーマ）／ C（別テーマ再挑戦）から選択。

SECTION 01

タイムテーブル（詳細）

開始終了区分演習・内容
09:0009:20S05 リフレクションExercise 1：Day 1 提出物の振り返り、良い指示パターン抽出
09:2010:10S06 並列 AgentExercise 2：3 起こしを並列処理して 1 ターン化
10:1010:20休憩10 分
10:2011:10S07 HooksExercise 3：PreToolUse / PostToolUse / Stop の 3 種類
11:1011:50S08 CronExercise 4：cron / launchd / タスクスケジューラで /weekly-report 自動実行
11:5012:30S09 MCPExercise 5：filesystem / sqlite を Claude Code に接続
12:3013:30昼休憩—
13:3014:00S10 DESIGN.mdExercise 6 前半：UI/UX 方針 8 セクションを導入
14:0015:40S11 仕上げExercise 6 後半：A / B / C のいずれかで 100 分の仕上げ実装
15:4015:50休憩10 分
15:5016:20S12 共有Exercise 7 前半：1 人 3 分デモ、5 段階の生成物を並べて比較
16:2016:50S13 情報源Exercise 7 後半：公式情報源を一緒にブックマーク、月 1 のキャッチアップ習慣をカレンダー登録
16:5017:00クロージングネクストアクション宣言、講師総括
SECTION 02

演習 7 本（Day 2）

Ex 1 ／ [20min]

Day 1 リフレクション

講師選定の 2〜3 名の発表 + 全体への良い指示パターン共有。「昨日の自分の指示を今日書き直す」観点で 2 日目に臨む。

Ex 2 ／ [50min]

並列 Subagent の応用

3 起こしを 1 ターンで並列処理。「指示の粒度を変えずに規模を大きくする」と詰まることを体感し、適切な分割設計の重要性を実感する。

Ex 3 ／ [50min]

Hooks 自動化（3 種類）

PreToolUse（rm -rf / git push --force / git reset --hard 検出 → 停止）／ PostToolUse（Python は ruff format、TypeScript は prettier --write）／ Stop（セッション終了時にトークン消費 + 差分サマリー出力）。

.claude/.bak を取ってから編集する習慣を
Ex 4 ／ [40min]

Cron 定期実行

絶対パスで claude バイナリ指定（which claude）／% エスケープ（%Y → \%Y）／最初の登録テストは「毎分実行」で 5 分観察。非対話起動はサブスクで不可、社内中継基盤の認証情報を .env から読む形で。

Ex 5 ／ [40min]

MCP 実践（filesystem / sqlite）

.mcp.json に filesystem（npx -y @modelcontextprotocol/server-filesystem ./docs/source-materials）と sqlite（uvx mcp-server-sqlite --db-path backend/data/health.db）を宣言。/mcp で connected を確認。

書き込み系 MCP は本研修では扱わない。playwright は S09 でデモ範囲として紹介
Ex 6 前半 ／ [30min]

DESIGN.md 導入

UI/UX 方針 8 セクション（バイブデザイン / 配色 / タイポ / レイアウト / コンポーネント / アクセシビリティ / アニメーション / アンチパターン）を投入。同系色濃淡 2 系統で信号機カラーを禁止。

Ex 6 後半 ／ [100min]

仕上げ実装（A / B / C 選択）

  • A：α 完成度向上（追加機能のスクリーンショット 1 枚）
  • B：自社業務テーマで新規プロトタイプ（要件メモ 10 行 + 動作スクショ 1 枚）
  • C：別テーマ素材（β / γ / δ）で再挑戦（README に何を作ったか 5 行）
迷ったら A。Day 1 の続きで作業負荷が低く、最も完走率が高い
Ex 7 ／ [60min]

共有・公式情報源探索

1 人 3 分デモ → 公式情報源を一緒に開く。翌週・翌月・3 か月後の自分宛アクション 3 つを宣言。月 1 の Changelog 読みをカレンダーに登録。

SECTION 03

デモ切替判断（社内環境制約への配慮）

社内ネットワークの制約で受講者環境では実行できない演習があります。動く方は手を動かし、難しい場合は講師の画面共有でデモに切り替わります。手順書は完成形まで記載されているため、持ち帰り検証用にも使えます。

演習OK ならハンズオンNG ならデモ
Ex 3（Hooks）Bash（macOS / WSL2 / Git Bash）が動く、chmod +x できるmacOS 講師環境で実演
Ex 4（Cron）cron / launchd / タスクスケジューラ登録権限がある講師環境で実演
Ex 5（MCP）npx + uvx が外部レジストリへ通信可能講師環境で実演
2 日間を通して身体化したい考え方

7 つのベストプラクティス概念

Day 1 S02 の座学（90 分）で扱う基本概念です。当日は本タブと座学編 PDF を投影して進めます。受講者は研修中・研修後の振り返り用としてここを参照してください。

SECTION 01

CLAUDE.md：プロジェクト規約の常時参照

CLAUDE.md は Claude Code が起動時に自動で読み込むプロジェクトの「設計図」です。書く内容は次の 4 種類に絞り、5 項目以内に保ちます。

1

プロジェクト概要

3〜5 行で。技術スタックと役割をひと目でわかる粒度。

2

レイヤー構成と依存方向

backend/app/ の階層（api → services → repositories → models）など。

3

コーディング規約

5 項目以内。マジックナンバー禁止、50 行超関数の分割、不変性、早期リターン、コメント方針。

4

禁止事項

API キーのハードコード、git push --force の自動実行、exercises/**/answers/ の読み込み等。

10 項目を超えると Claude が守らない

@AGENTS.md や @DESIGN.md で他の md を取り込む形で分割し、本体は短く保ちます。AGENTS.md は GitHub Copilot / Cursor / Codex などの他エージェントとの共通ガイド、DESIGN.md は UI/UX 専用、というように役割を分けます。

SECTION 02

Skills：再利用可能な指示の切り出し

.claude/skills/<name>/SKILL.md に YAML frontmatter + 本文で記述します。frontmatter の description が「いつ呼び出すか」の判断基準として機能するため、1 行で具体名詞を 2 つ以上含めて書きます。

判定

severity / priority

入力に対し severity ラベル（CRITICAL / MAJOR / MINOR / INFO）を返す。

構造化抽出

テキスト → JSON

長文ヒアリング起こしから論点・決定事項・宿題・固有名詞を JSON で。

フォーマット変換

仕様書 ↔ 実装

API 仕様 md と実装コードを突き合わせて差分を返す。

SECTION 03

Subagents：並列実行とコンテキスト保護

.claude/agents/<name>.md に定義。tools フィールドで権限を絞り込み、レビュー系には Edit / Write を渡さないことで「修正できないレビュアー」を作ります。model を frontmatter に書けばエージェント単位でモデル固定。

並列起動のコツ

並列起動時は親が JSON だけ受け取る設計にします。Subagent の本文に「JSON 以外の説明文を付けない」と明記し、出力例を 1 つ以上載せる。それでも崩れる場合は Sonnet 以上のモデルに切り替えてください（Haiku は厳密フォーマット出力が苦手）。

SECTION 04

Hooks：振る舞いに自動化線を引く

.claude/settings.json の hooks セクションで宣言します。exit code 2 で「ブロック」、0 で「通過」。Hook が暴走するとセッションが回らなくなるため、.claude/.bak を取ってから編集する習慣を身につけます。

PreToolUse

危険コマンド阻止

rm -rf / git push --force / git reset --hard を検出して停止。

PostToolUse

自動フォーマット

Python は ruff format、TypeScript は prettier --write。Edit 後に走らせる。

Stop

差分サマリー

セッション終了時にトークン消費とステージ済み差分の要約を出力。

SECTION 05

MCP：外部リソースの公式接続

Model Context Protocol。.mcp.json で MCP サーバーを宣言します。書き込み系を渡す場合の影響を必ずチームで合意してから本番投入してください。

公式リファレンス

filesystem

@modelcontextprotocol/server-filesystem（公式）。指定ディレクトリの読み書き。

コミュニティ実装

sqlite

公式の sqlite サーバーは archived。コミュニティ実装 mcp-server-sqlite を uvx で起動するのが現状の定石。

公式

git

リポジトリ操作。書き込み権限を渡す場合は要注意。

公式

playwright

ブラウザ自動操作。Day 2 S09 でデモ範囲として紹介。

最新ステータス：github.com/modelcontextprotocol/servers
SECTION 06

コスト管理とモデル選択

3 モデルを使い分け、トークン消費を見える化します。

Haiku 4.5
単純置換 / フォーマット / CI 前段ふるい
Sonnet の 60〜70% 精度、コストは Sonnet の 1/5
Sonnet 4.6
常用：コーディング / レビュー / 分析
本研修のデフォルト
Opus 4.7
重要 PR レビュー / 大規模リファクタ / 横断分析
Sonnet の 110〜120% 精度、コストは Sonnet の 5 倍
トークン消費の目安

1 セッション 50,000〜100,000 が通常範囲、100,000 超ならコンテキストの再構築を検討。ヒアリング起こしのフルテキストを毎回投入しない。/analyze-transcript 経由で要約版を渡し、/cost で都度確認します。

SECTION 07

verification loop：レビュー基盤化

レビュー観点を Subagent 化することで、人間レビュアの負荷を下げ、観点の取りこぼしを防ぎます。本研修では code-reviewer / security-auditor の 2 種類を作ります。severity 4 段階（CRITICAL / MAJOR / MINOR / INFO）を統一基準として使います。

code-reviewer

規約遵守チェック

CLAUDE.md / DESIGN.md / api-spec.md に照らした遵守チェック。tools から Edit/Write を外し、修正できない権限分離。

security-auditor

脆弱性検出

ハードコード秘密 / SQL インジェクション / XSS / 依存古さ / ログ漏えい。Day 1 の仕込み済み違反コードを検出。

verification loop とは

Boris Cherny 自身が公言している「実装 → レビュー Subagent → 修正 → レビュー Subagent → 完了」のループ。Anthropic 内部では verification loop の整備で品質が 2〜3 倍になると報告されています。anthropic.com/engineering

Day 2 Exercise 6 後半 ／ 選択肢 C

別テーマで再挑戦（β / γ / δ）

Day 2 後半で「α 完成度向上 / 自社業務テーマ / 別テーマ再挑戦」の 3 択から選ぶ仕上げ実装。「別テーマで復習したい」人向けに、別ジャンルの起点素材を 3 種類用意しています。配布 ZIP 別テーマ素材.zip に同梱。

SECTION 01

3 つの別テーマ

β

議事録 ToDo 抽出

会議議事録の長文から「誰が」「いつまでに」「何をする」を構造化抽出する Skill + Command。Day 1 で作った transcript-extractor の応用テーマで、入出力が変わるだけで設計の型は同じ。

配布：handson/bonus/beta_議事録ToDo抽出/
γ

提案 Q&A ビルダー

提案書（PDF）と過去案件の Q&A 集から、新規 RFP に対する想定 Q&A をドラフトする。RAG 的な検索 + 構造化出力 + Subagent 並列処理が組み合わさるテーマ。

配布：handson/bonus/gamma_提案QAビルダー/
δ

監査チェック自動化

監査チェックリスト（Markdown）に基づき、対象リポジトリのソースコードを走査して違反箇所を severity 付きで報告。code-reviewer + security-auditor の応用。

配布：handson/bonus/delta_監査チェック自動化/
SECTION 02

推奨の進め方（100 分）

  1. 最初の 10 分で「ゴール 3 行」を書く。スコープを絞る
  2. α で作った Skills / Subagents / Commands のうち、流用できるものを 1 つ以上引き継ぐ
  3. 新しく作る Skill / Subagent は 1 つだけに絞る（時間内に完走するため）
  4. 残り 20 分で /review-changes と /security-scan を回し、最低限の品質ゲートを通す
  5. README に「何を作ったか」「どんな指示を使ったか」を 5 行で記録
配布物 / 公式情報源 / よくある詰まり

Tips & ダウンロード

配布資料 PDF、本研修で参照する公式情報源、よくある詰まりへの即応マニュアルを集約します。研修後のキャッチアップ用としても使ってください。

SECTION 01

配布資料 PDF（5 本）

研修当日のオフライン参照と、研修後の読み返し用。本サイトと PDF は同一内容で、フォーマットの違いだけです。

受講者向け

01 事前セットアップガイド

OS 別インストール手順、認証、社内ネットワーク対応。研修日の 3 営業日前までに完了。

PDF を開く →
受講者向け

02 オリエンテーション 座学編

Day 1 S02 で投影。CLAUDE.md / Skills / Subagents / Hooks / MCP / コスト / レビューの 7 概念。

PDF を開く →
受講者向け

03 ハンズオンガイド Day 1

Day 1 タイムテーブル、演習 7 本、トラブルシューティング、API 仕様、コマンドリファレンス。

PDF を開く →
受講者向け

04 ハンズオンガイド Day 2

Day 2 タイムテーブル、演習 7 本、デモ切替判断、別テーマ素材の使い方。

PDF を開く →
講師向け

05 運営マニュアル（講師向け）

司会進行、詰まりポイント対処、デモ切替判断、締めメッセージ。受講者には配布しません。

PDF を開く →
SECTION 02

公式情報源（研修後のキャッチアップ用）

Anthropic

Claude Code Docs

Setup / Best Practices / Sub-agents / Hooks の公式ドキュメント。

code.claude.com/docs
Anthropic

Changelog

月 1 回の Changelog 読みを 30 分カレンダー登録するのが推奨。

code.claude.com/docs/en/changelog
Anthropic

Engineering Blog

verification loop / context engineering / autonomous agent 系の知見。

anthropic.com/engineering
Anthropic

Models Overview

Haiku 4.5 / Sonnet 4.6 / Opus 4.7 のスペック・料金。

platform.claude.com/docs/en/about-claude/models/overview
MCP

Reference Servers

公式 MCP サーバーの最新ステータス（archived 含む）。

github.com/modelcontextprotocol/servers
MCP

仕様書

MCP 自体の仕様。自前 MCP サーバーを社内に立てる場合の参照元。

modelcontextprotocol.io
Anthropic

Cookbook

Claude API の実装サンプル集。Skills / Subagents の応用例も含む。

github.com/anthropics/anthropic-cookbook
SNS

X / Discord

@AnthropicAI（公式アナウンス）／ @claudeai（プロダクト関連）／ Anthropic Developer Server（Discord）。

SECTION 03

よくある詰まりへの即応マニュアル

症状確認対処
claude が起動しないwhich claude で PATHターミナル再起動。それでもダメなら公式インストーラを再実行
認証エラーPro / Max のログイン状態、または ANTHROPIC_BASE_URLサブスクは claude /logout 後に再ログイン。中継基盤経由なら基盤側のログを確認
uvicorn 起動失敗python -m app.seeds 実行済みかseeds 再投入。backend/data/health.db を削除して再作成
フロントエンド起動失敗Node.js が手元にあるかClaude Code に「frontend の開発サーバーを起動できる状態にして」と指示すれば、必要な環境構築から起動まで案内してもらえる
Hook が動かないshebang / 改行コード / 実行権限chmod +x と LF 改行確認。Windows は WSL2 / Git Bash 切替
cron が実行されない絶対パスと % エスケープwhich claude で絶対パス取得、%Y を \%Y に修正
MCP が connected にならない.mcp.json の構文jq . .mcp.json で構文チェック、Claude Code のログを確認
Skill が呼び出されないdescription が抽象的すぎる1 行で具体名詞を 2 つ以上含める。severity / Risk / transcript 等
Subagent が JSON にならない本文の指定「JSON 以外の説明文を付けない」と明記、出力例を 1 つ以上載せる。崩れる場合は Sonnet 以上に切替
SECTION 04

研修後のキャッチアップ習慣

  1. RSS リーダー（Feedly 等）に Anthropic ブログを登録
  2. X 公式 2 アカウントの通知 ON（@AnthropicAI / @claudeai）
  3. 月 1 回 30 分の Changelog 読み（カレンダー登録）
  4. 社内チャット「Claude Code 情報源」チャンネル開設
  5. 月 1 振り返りミーティング（受講者間で）
Day 2 クロージングメッセージから

「Claude Code はコードを書く道具ですが、扱える対象はコードに限りません。今日触れた CLAUDE.md / Skills / Subagents / Hooks / MCP の組み合わせは、文章を書く、データを整理する、業務フローを設計する、研修資料を作る、といった対象にも同じ形で適用できます。これから半年でまた変わります。今日ブックマークした 3 つの URL と、月 1 の Changelog 読みの 30 分を、まずは 3 か月続けてみてください。」