ハンズオンガイド
演習3本とミニ演習7本

教材サイト https://0817cc.give-app.net から nid-claudecode-handson_受講者用.zip をダウンロードします。Git の操作はありません。

日本語とスペースを含まないパスに展開します。Windows は C:\work\、Mac は ~/work/ のような場所です。日本語やスペースを含むパスに置くと、統合ターミナルでの実行や設定ファイルのパス指定でつまずきます。展開先に nid-claudecode-handson_受講者用 フォルダができていることを確認してください。

VSCode の「ファイル > フォルダーを開く」で 演習1_Lv1_集計ツール を選びます。配布フォルダの一番上は開きません。

「このフォルダー内のファイルの作成者を信頼しますか?」と出たら「はい、作成者を信頼します」を選びます。制限モード（Restricted Mode）のままだと拡張が動きません。

エディタ右上の Spark アイコンをクリックします。ファイルを開いていないときは、ウィンドウ右下の Claude Code からも開けます。パネルが出ない場合は、コマンドパレット（Windows Ctrl+Shift+P／Mac Cmd+Shift+P）で Developer: Reload Window を実行します。

入力欄が使える状態であればサインイン済みです。サインインを促す表示が出た場合は、事前セットアップガイドの手順で入り直してください。

パネルに「このフォルダに何が入っているか教えてください」と打ち、返答が返ることを確認します。ここまでで準備は完了です。

確認: フォルダ名が 演習1_Lv1_集計ツール になっていること、権限モードの表示が Manual になっていることの2点を見てください。

展開した配布フォルダの中の、次の2つのフォルダです。フォルダごと、中身をそのまま移します。

nid-claudecode-handson_受講者用/.claude/skills/claude-code-setup/
nid-claudecode-handson_受講者用/.claude/skills/skill-creator/

ご自身のホームの .claude/skills/ です。skills フォルダが無い場合は自分で作ります。

手段は2つあります。どちらでも構いません。

• エクスプローラまたは Finder で、フォルダをドラッグしてコピーする
• いま開いている 演習1_Lv1_集計ツール のパネルで Claude に頼む。.claude 配下への書き込みなので毎回確認が入ります。保護パスの挙動をそのまま体験できます

コピー後の形はこうなります。

<ホーム>/.claude/skills/claude-code-setup/
<ホーム>/.claude/skills/skill-creator/

コマンドパレット（Windows Ctrl+Shift+P／Mac Cmd+Shift+P）から Developer: Reload Window を実行します。SKILL.md の追加は同じセッションでも反映されますが、claude-code-setup はプラグインとして読まれるため、反映が次のセッションからになります。

Context usage の位置を確かめます。いま何パーセント残っているかをメモします。

Account & Usage を開きます。バーの位置と、内訳の項目を見ます。開始時点の値をメモします。

モデル切替を開き、表示名と説明が並ぶことを見ます。今日はここを変えずに進めます。

権限モードのメニューを開き、Effort の行を見ます。いまのレベルを確かめます。

権限モードが Manual であることを確認します。本日はこのモードで進めます。演習3 でだけ Plan に切り替えます。

考える: Account & Usage の内訳のうち、自分の環境で一番大きいのはどれでしたか。コンテキストが減る速さは何で決まると思いますか。

VSCode の「ファイル > 開く」で設定ファイルを開き、「名前を付けて保存」で settings.json.bak として同じフォルダに保存します。ファイルが無い方は、この時点では作りません。

同じ手順で、Windows は %USERPROFILE%\.claude\CLAUDE.md、Mac は ~/.claude/CLAUDE.md を CLAUDE.md.bak として保存します。

個人設定の settings.json に、取り返しのつかないコマンドを止める設定を入れます。演習2 はプロジェクト側の設定を持たないため、安全網はここで持たせます。すでに permissions がある方は、deny の配列へ7行を追記します。

{
  "permissions": {
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(rm -fr:*)",
      "Bash(sudo:*)",
      "Bash(mkfs:*)",
      "Bash(dd:*)",
      "Bash(shutdown:*)",
      "Bash(reboot:*)"
    ]
  }
}

同じ内容は配布フォルダの .claude/settings.json にも入っています。そちらからコピーしても構いません。

保存後、VSCode が JSON のエラーを出していないことを確認します。赤い波線が出ていたら、カンマの位置と括弧の対応を見てください。

VSCode で ~/.claude/CLAUDE.md（Windows は %USERPROFILE%\.claude\CLAUDE.md）を開きます。無ければ新規作成します。.bak は節5 で取ってあります。

次の内容をファイルの末尾に追記します。すでにある行は1行も消しません。同じ内容は配布フォルダの ミニ演習/ユーザー設定CLAUDE_md/追記する内容.md にもあります。

## ツールを使う直前の1行

ファイル編集・コマンド実行・検索のツールを呼ぶ直前に、次の1行だけを出力します。前置き・敬語・補足説明は書きません。

要約：使用するツール

「使用するツール」の位置には、これから呼ぶツールの名前を書きます。

要約：使用するツール は研修で指定された文言です。項目を足したり、順番を変えたりしないでください。コロンは全角です。

設定ファイルの内容は会話の開始時に読み込まれます。パネルで新しい会話を始めてください。

「data/work_log.csv の先頭3行を見せてください」のように、読むだけの依頼を出します。

考える: 1行が出なかった回があった場合、指示のどこが曖昧だったと思いますか。この指示を自社のリポジトリに置くとしたら、ユーザー層とプロジェクト層のどちらに置きますか。

ホームの .claude/ に statusline.py を新規作成します。標準入力の JSON から上の3つを取り出し、1行で出力します。完成品が配布フォルダの ミニ演習/statusline/statusline.py にあります。自分で書いても、完成品を写しても構いません。

ミニ演習/ は VSCode で開いたフォルダの外にあるため、エクスプローラのドラッグでは持ってこられません。次のどちらかで移します。

• エクスプローラ（Windows）または Finder（Mac）で ミニ演習/statusline/statusline.py をコピーし、%USERPROFILE%\.claude\ または ~/.claude/ に貼り付ける
• VSCode で ミニ演習/statusline/statusline.py を開き、中身を全部コピーして、新規ファイルとして ~/.claude/statusline.py に保存する

~/.claude/settings.json に statusLine を追記します。type は "command"、command にインタプリタとスクリプトのパスを書きます。Mac と Windows で書き方が違います。1つの設定で両方を賄うことはできません。同じ内容は ミニ演習/statusline/settings断片.json と docs_参照元/設定断片/statusline_settings断片.json にあります。

Mac の場合です。~ が使えます。

"statusLine": {
  "type": "command",
  "command": "python3 ~/.claude/statusline.py"
}

Windows の場合です。絶対パスで、区切りはスラッシュにします。<ユーザー名> はご自身のものに置き換えます。

"statusLine": {
  "type": "command",
  "command": "python C:/Users/<ユーザー名>/.claude/statusline.py"
}

統合ターミナルで py しか通らない環境では、python の部分を py に変えます。

統合ターミナルで、模擬の JSON をスクリプトに流します。1行が出て、終了コードが 0 になることを確かめます。模擬 JSON を流す確認コマンドは、Windows と Mac の両方を hints/M3_statusline_hint.md に載せてあります。

~/.claude/settings.json を開き、VSCode がエラーを出していないことを確認します。前のキーの行末にカンマが必要な点に注意してください。

考える: コンテキスト消費率を自分で計算する場合、入力トークンのどれを足しますか。output_tokens を含めない理由も考えてください。cost.total_cost_usd は請求と一致しない概算です。では何のために見る数字でしょうか。

VSCode の「ファイル > フォルダーを開く」で 演習1_Lv1_集計ツール を開き、信頼を選びます。昼休憩の前に開いていた方も、ここでもう一度開き直します。午前に入れたユーザー設定が、新しいセッションでも効いていることを確かめる回でもあります。

Spark アイコンでパネルを開きます。統合ターミナル（Windows Ctrl+@／Mac Cmd+@）も開いて、Python の名前を確かめておきます。Windows は py -V、Mac は python3 -V です。

CLAUDE.md をエディタで開いて中身を読み、書かれている前提がいくつあるかを数えます。この時点で、どの行が今日の実装に効くかを予想してください。

このフォルダには CLAUDE.md が既にあるため、追記の提案が差分で出ます。既存の行を削る提案は却下してください。判断に迷ったらいちど却下し、「既存の行は変えずに、不足している項目だけ追記してください」と言い直します。

/context に Memory files の一覧が出る環境なら、そこで確認します。出ない場合は「CLAUDE.md に書いてある Path(__file__).parent という語を含めて、このプロジェクトの前提を3つ挙げてください」と聞き、書いた語が返るかで判断します。どちらか片方で足ります。

data/work_log.csv の列構成と行数を報告させます。/ のメニューに出ない場合は、自然文で「read-data の Skill を使ってください」と頼みます。

実装に入る前に、読み込み・集計・表示の分け方と、集計結果を保持するクラスの持たせ方を相談します。いきなり実装させず、方針を言葉にさせてください。

差分は1件ずつ読んで承認します。まとめて承認しないでください。権限モードは Manual のまま進めます。

統合ターミナルで実行して、合計を検算します。実行は python3 aggregate.py（Windows は py aggregate.py）です。作業ディレクトリは開いたフォルダなので、パス指定は不要です。

演習1_Lv1_集計ツール/CLAUDE.md の末尾に見出しを付けて、次の3行を書きます。ラベルは逐語で指定します。コロンは半角です。

要約: この応答でしたことを1文
読んだファイル: 読んだファイルのパスをカンマ区切り。無い場合は なし
使ったハーネス: CLAUDE.md / Skill名 / Subagent名 / Hook名 をカンマ区切り。無い場合は なし

演習1 の発展課題（作業種別ランキングの書き出し）を依頼します。すでに終えている方は、その続きで構いません。

応答の末尾に3行が、指定の順で付くかを見ます。「使ったハーネス」に、実際に呼んだ Skill の名前が入っているかも見てください。

圧縮のあとも3行が続くかを見ます。プロジェクト直下の CLAUDE.md は、圧縮を越えてディスクから読み直されます。

考える: 「無い場合は なし」まで書いた効果はありましたか。ユーザー層の1行とプロジェクト層の3行が両方出るとき、順番はどうなりましたか。

VSCode の「ファイル > フォルダーを開く」で 演習2_Lv2_不具合修正 を開き、信頼を選びます。信頼していないと、あとで作る .claude/settings.json のフックが効きません。エクスプローラで .claude/ も CLAUDE.md も無いことを目で確かめてください。

統合ターミナルで、Windows は py -V、Mac は python3 -V を実行します。3.10 以降を返す方の名前を、この演習の間ずっと使います。

そのまま実行します。データの場所はスクリプトが自分の位置から解決するので、カレントディレクトリを移動する必要はありません。

py monthly_report.py 2026-07

Mac は次のとおりです。

python3 monthly_report.py 2026-07

出た症状をそのまま読みます。まだ直しません。

何も無い状態から CLAUDE.md が作られる様子を見ます。200行を超えていたら削ります。長いほどコンテキストを食い、守られにくくなります。

Claude Code に原因の調査だけを頼みます。この時点では修正させません。何が起きているかを日本語で説明させます。

差分を1件ずつ読んで承認します。

もう一度実行して、次の症状が出ることを確認します。ここまでで自分がパネルに打った指示を見返し、行数を数えます。同じ前提（値の扱い方、実行して確認すること、出力の書式を変えないこと）を何回書いたかも数えてください。

数えるのはパネルに自分が打った文だけです。Claude の応答は数えません。空行も数えません。

docs_参照元/コーディング規約_ひな型.md を、演習2_Lv2_不具合修正/docs/コーディング規約.md としてコピーします。docs フォルダが無ければ作ります。docs_参照元/ は開いたフォルダの外なので、エクスプローラまたは Finder でコピーするか、VSCode で開いて中身をコピーして新規保存します。

直すのは2つだけです。機械が読む設定の max_line_length の値と、人が読む説明のうち1行です。ほかは触りません。

パネルで、フックを作るよう依頼します。依頼文には次の4つを必ず入れてください。

• 発火は Python ファイルの編集直後（PostToolUse、matcher は Write|Edit|MultiEdit）
• 判定の正本は docs/コーディング規約.md の設定ブロック
• 違反があれば会話に指摘が返ること
• 指摘は最大3点まで

本線は type: "prompt" の PostToolUse にします。シェルを使わないので、Windows の Git Bash の有無や python と python3 の違いに左右されません。prompt の中には $ARGUMENTS を入れてもらいます。フックへの入力の JSON がここに入り、どのファイルが編集されたかを判定に使えます。

生成された .claude/settings.json の差分を1行ずつ読みます。.claude 配下への書き込みなので、権限モードに関わらず確認が入ります。

わざと規約に反するコードを書かせて、指摘が会話に出るかを見ます。指摘に従って直すと、次の編集で指摘が出なくなることも確かめます。

考える: 「最大3点まで」を入れなかったら何が起きると思いますか。このフックは、予防（ガイド）と事後の検知（センサー）のどちらでしょうか。判断が LLM 側にあるか、決められた手順で機械的に決まるかという軸で見ると、どちらに入りますか。

規約とフックが効いている状態で、残っている症状を修正させます。フォルダは開いたままです。開き直す必要はありません。

フックの指摘が会話に返ってくることを確認します。指摘が出たら、それに従って直します。指摘は1回の実行で最大3点までです。3点を直すと、次の編集で残りが次の3点として出ます。

最後までエラーなく実行できることを確認し、表示された合計を自分の手計算と突き合わせます。合計時間は 80.0 時間、メンバーは5名です。実行が通ったことだけで完了と判断しないでください。

後半で自分が打った指示の行数を数え、節11 の表に書き込みます。前半と比べて1行で記録してください。

考える: 減った行数は、誰が代わりに書いていたことになりますか。減った分のうち、規約が担った部分とフックが担った部分を分けて言えますか。

VSCode の「ファイル > フォルダーを開く」で 予備_チケット管理 を開き、信頼を選びます（項目21）。このフォルダには CLAUDE.md も .claude も docs もありません。M7 で自分が入れる前の状態です。エクスプローラで確かめておいてください。

skill-creator の SKILL.md は英語で34KB あります。読み込むだけでコンテキストを大きく使うため、前の会話を残したまま呼ぶと圧縮が走ります。必ず先に /clear してください。

依頼文には次の3つを必ず入れます。

• 日本語で質問してください（SKILL.md が英語のため、英語で聞き返してくることがあります）
• 評価（eval）とテストケースの実行はしない。SKILL.md を書くところまでで止める
• 対象は「Python スクリプトを実行して落ちたところから、原因を調べ、1件ずつ直し、再実行して合計を検算する」流れ

/ のメニューに出ない場合は、自然文で「skill-creator を使ってください」と書いて呼びます。

何をできるようにするか、いつ発火するか、出力の形式、テストケースを作るかの4点を聞かれます。4点目は「作りません」で通してください。

生成された SKILL.md を自分で読み、description を直します。「いつ使うか」を description に書き切るのが公式の方針です。

いま開いている 予備_チケット管理/ticket_app.py に対して、作った Skill を呼びます。演習2 で踏んだ手順が再現されるかを見ます。

考える: 自分が書いた手順のうち、Skill に残す価値があったのはどれで、その場限りだったのはどれですか。description を直した理由を1行で書いてください。

M6 の会話が残っていると提案が引きずられます。/clear を実行してから claude-automation-recommender を呼びます。

このフォルダを対象に提案を出させます。依頼文には次の3つの条件を入れます。全員同じ依頼文を使います。

• Web 検索を使わない（同梱の references/ とフォルダの中身だけで判断する）
• Hooks・サブエージェント・Skill を各1〜2件に絞る
• この時点ではファイルを作らない

出力を読んだあと、VSCode のエクスプローラでファイルが1つも増えていないことを確認します。この Skill は読み取り専用で、SKILL.md の冒頭に「It does NOT create or modify any files」と書かれています。提案と導入が別の依頼になる2段構えを、ここで体験します。

提案の中身は人によって違います。講師が指定する3本にクラス全体でそろえます。

差分は1行ずつ読んでから承認します。.claude 配下への書き込みは、権限モードに関わらず確認が入ります。

導入前の結果を先に控えてください。戻せるようにする方法は2つあります。対象ファイルをコピーしておくか、メッセージにカーソルを当てて出る Rewind code to here で巻き戻すかです。比べる項目は下の表の3つに固定します。

考える: 提案のうち、この題材では効かないものはどれでしたか。なぜ効かないと判断しましたか。ご自身のプロジェクトなら、最初に入れる1本はどれですか。

VSCode の「ファイル > フォルダーを開く」で 演習3_Lv3_ログ解析 を開き、信頼を選びます。始める前に docs/演習設定.md を開いてください。開くフォルダ、インタプリタ名の差し替え、実行コマンド、必修と余力の線、OK基準の数値がそこにまとまっています。

統合ターミナルで py -V（Mac は python3 -V）を実行します。Windows の方は .claude/settings.json の "command": "python3" を "command": "py" に書き換えてください。書き換えたら Developer: Reload Window を実行します。ここを飛ばすとフックが動きません。

既存の CLAUDE.md と docs/ が揃った状態で何が起きるかを見ます。ここでも既存の行を削る提案は却下します。判断できない場合は却下してから「既存の行は変えずに、不足している項目だけ追記してください」と言い直します。

CLAUDE.md と .claude/rules/ が読み込まれていることを確認します。/context の Memory files で見るか、rules に書いた語を含む応答が返るかで判定します。どちらか片方で構いません。

spec.md の要件を1件ずつのチェックリストにします。読み方が2通りある箇所を洗い出し、どちらで実装するかを自分で決めて書き残してください。

正常な行と、形式が崩れた行の実物を見ます。件数の足し算が合うことを確かめます。

verify-data サブエージェントに、データから件数を数え直させます。ログ本文が本会話に流れ込まず、数えた結果だけが返ることを確認します。返ってきたら Context usage を見て、どれだけ消費したかを覚えておいてください。

権限モードを Plan に切り替えます。入力欄の下のモードインジケータをクリックします。計画は Markdown で開けます。インラインコメントで1箇所直してから出し直させます。

承認は「Yes, manually approve edits」を選びます。自動承認は選びません。差分は1件ずつ読んで承認します。

規約チェックのフックが指摘を返したら、それに従って直します。このフックは Claude がファイルを編集した直後に走ります。ご自身の保存操作では走りません。指摘は1回の実行で最大3点までです。同じ種類の違反は、ファイル全体でまとめて直すと早く終わります。

統合ターミナルで実行します。Windows は py analyze_log.py、Mac は python3 analyze_log.py です。次に、別のフォルダをカレントディレクトリにして同じファイルを実行し、出力が1文字も変わらないことを確認します。そのあと /verify-report を呼び、出力を spec.md の要件と1件ずつ突き合わせます。

code-reviewer サブエージェントにレビューさせ、指摘のうち1件を直します。最後にパネルから Account & Usage を開き、この演習で何が使用量を食ったかを内訳で確かめてください。