1はじめに：読むより「やる」が10倍強い

ここからは、いよいよ手を動かす時間です！自転車の乗り方が本を読むだけでは身につかないのと同じで、Claude Code（＝コードを書いてくれるAIの相棒）も、実際にさわって初めて「あ、こういうことか！」とわかります。このページには 8つの課題 を用意しました。01から順に、初級→中級→上級へとレベルアップしていきます。

🧩
たとえ話：このページは「料理教室」みたいなもの。レシピ（手順のヒント）を見ながら自分で作ってみて、最後に「お手本（＝解答例）」と見くらべます。失敗しても大丈夫。Claude Code には /rewind や EscEsc という「やり直しボタン」があるので、安心して挑戦できます。

🎒準備するもの

⚠️
いきなり大事なプロジェクトで試さないこと。まずは練習用フォルダで。Claude Code は変更前にスナップショット（＝写真のように状態を保存）を取ってくれますが、git（＝変更履歴の記録ツール）の代わりにはなりません。大切なコードは git で守りましょう。
📚
この演習は公式ドキュメントに沿って作っています。元ネタを見たい人は 一般的なワークフロー（公式・ja） と ベストプラクティス（公式・ja） をのぞいてみてください。

2演習の進め方（このループを回そう）

どの課題も、基本は同じ流れです。「ゴールを読む → 自分でやってみる → うまくいかなければ修正 → 解答例と見くらべる」。この4ステップをぐるぐる回すだけ。完璧じゃなくてOK、回数をこなすほどうまくなります！

🔄 演習の進め方ループ
flowchart TD
  A["課題のゴールを読む"] --> B["自分で手を動かす"]
  B --> C{"思った通り?"}
  C -->|"はい"| D["解答例と見くらべる"]
  C -->|"いいえ"| E["Esc Esc で巻き戻す
or プロンプトを直す"]
  E --> B
  D --> F["気づきをメモ
次の課題へ"]
うまくいかなくても落ち込まない！修正してもう一度やるのが一番の上達法です。
💡
公式のベストプラクティスでも「早めに、こまめに方向転換しよう」とすすめています。Claude が変なほうへ進みそうなら、すぐ Esc で止めてやり直すのがコツです。
レベル課題番号身につく力
初級01・02・03会話の基本、確認とやり直し、ルール作り
中級04・05・06計画→実装、バグ修正、コンテキスト整理
上級07・08自分専用ツール作り、自動化

3初級の課題（まずはここから！）

最初の3つは「Claude Code とおしゃべりする」練習です。むずかしいことは一切なし。気軽に話しかけてみましょう！

01

自己紹介させる／このフォルダを説明させる

初級
やること：Claude Code に「あなたは何ができるの？」と聞いて、さらに「今いるフォルダがどんな中身か説明して」と頼んでみる。AIと会話する感覚をつかむのがゴールです。

ヒント

  • 普通の日本語でOK特別な書き方は不要。このコードベースの概要を教えて のように話しかけるだけ。
  • @file でファイルを指す中身を見てほしいファイルがあれば @README.md を説明して のように @ を付けると、Claude がすぐ読み込みます。
  • 広く聞いて、せまく深掘り最初は「全体像」、次に「この部分くわしく」と段階的に。
terminal
# フォルダの中でClaude Codeを起動
$ claude
# 起動したら、こう話しかけてみる
> あなたはClaude Codeですね。何ができるのか簡単に教えて
> このフォルダの概要を教えて。主なファイルや役割も
> @README.md の内容をかみくだいて説明して
解答例（やり方の一例）を見る

進め方の一例：

  1. 起動練習用フォルダで claude を実行。
  2. 自己紹介を頼むClaude Codeでできることを3つ、初心者向けに教えて と打つ。Claude は公式ドキュメントを内蔵しているので、自分の機能を正確に答えてくれます。
  3. フォルダ説明このフォルダの概要を教えて。ファイル構成と、それぞれの役割も と頼む。中身が少なければ「まだファイルがないよ」と教えてくれます。
  4. 深掘り気になった部分を その設定ファイルは何のためにあるの? のように追加で質問。

確認方法：Claude の答えが、実際のフォルダの中身と合っているか自分の目で見くらべましょう。合っていれば成功です！

参考：新しいコードベースを理解する（公式）

02

小さな修正を頼んで /diff で確認、気に入らなければ Esc+Esc

初級
やること：テキストファイルやコードに「ちょっとした変更」を頼み、/diff で何が変わったか確認。気に入らなければ EscEsc で巻き戻す。「変更を見て、いやなら戻す」流れを体験するのがゴール。

ヒント

  • 超小さい修正でOK「あいさつ文を1行追加して」程度で十分です。
  • /diff で差分を見るdiff（＝変わった前後の比較）。何が増えて何が減ったかが色つきで見えます。
  • いやなら戻すEsc を2回、または /rewind で巻き戻しメニューが開きます。さっきの変更を取り消して と頼んでもOK。
terminal
> hello.txt に「こんにちは!」という行を1行追加して
# 変更後、差分を確認
> /diff
# 気に入らなければ Esc を2回押して巻き戻しメニューへ
解答例（やり方の一例）を見る
  1. 修正を依頼hello.txt を作って、中に「やあ!」と1行書いて のように頼む。ファイルがなければ作ってくれます。
  2. 差分チェック/diff を実行。追加された行が緑、消えた行が赤で表示されます。
  3. 巻き戻す「やっぱり違うな」と思ったら EscEsc。メニューで「コードだけ復元」「会話だけ復元」「両方」が選べます。コードを元に戻して再挑戦！
  4. もう一度かわりに「Hello!」と英語で書いて のように指示を変えて再トライ。

確認方法：巻き戻したあと、もう一度 /diff やファイルの中身を見て、ちゃんと元に戻った（または希望どおりになった）か確かめましょう。

参考：早期かつ頻繁に方向転換する（公式）

03

/init で CLAUDE.md を作り、ルールを1つ書く

初級
やること：/init でプロジェクト用の CLAUDE.md（＝Claudeが毎回最初に読む「お願いメモ」）を作り、自分のルールを1つ書き足す。Claude に「クセ」を覚えさせる体験がゴール。
🧩
たとえ話：CLAUDE.md は、新しく来たアルバイトさんに渡す「お店のルールメモ」みたいなもの。「敬語で話してね」「レジは現金のみ」のように書いておけば、毎回説明しなくても守ってくれます。

ヒント

  • /init で土台を自動生成フォルダの中身を調べて、ビルド方法やテスト方法を見つけ、たたき台のCLAUDE.mdを作ってくれます。
  • ルールは「短く・1行」で例：日本語で答えること や コメントは日本語で書くこと。
  • 入れすぎ注意公式いわく「長すぎるCLAUDE.mdは大事なルールが埋もれる」。最初は1つだけ。
terminal
# CLAUDE.mdのたたき台を自動生成
> /init
# できあがったら、ルールを1つ追記してもらう
> CLAUDE.md に「返答は必ず日本語で」というルールを1つ追加して
# 反映されたか確認
> /memory
解答例（やり方の一例）を見る
  1. /init 実行Claude がフォルダを分析し、CLAUDE.md のたたき台を提案。内容を確認して作成。
  2. ルールを1つ追記CLAUDE.md の「Workflow」セクションに『返答は日本語で書く』を追加して と頼む。
  3. 確認/memory を実行すると、いま読み込まれているメモリ（CLAUDE.md）の中身が見られます。ルールが入っていればOK。
  4. 効果テスト新しい質問をして、本当に日本語で答えるか確かめる。公式も「ルールを変えたら動作が変わるか観察しよう」とすすめています。

書くべきこと・書かないこと（公式の表より）：

書く ✅書かない ❌
Claudeが推測できないコマンドコードを読めばわかること
独自のコードスタイル言語の当たり前のルール
テストの実行方法長い説明やチュートリアル

参考：効果的なCLAUDE.mdを書く（公式）

4中級の課題（実戦に近づく）

ここからは「計画してから作る」「バグを直す」「会話を整理する」という、実際の開発で毎日使う動きを練習します。少しずつ本物のエンジニアの作業に近づきますよ！

04

プランモード(/plan)で計画させてから機能を1つ追加

中級
やること：いきなり作らせず、まず /plan（プランモード）で「どう作るか計画」を立てさせる。計画に納得してから実装する流れを体験するのがゴール。
🧩
たとえ話：プランモードは「工事の前に設計図を見せてもらう」こと。いきなり壁をこわされたら困りますよね。先に図面を見て「ここはこうして」と言えば、安全に進められます。

ヒント

  • プランモードに入る/plan または Shift+Tab で切り替え。この間、Claude はファイルを読むだけで勝手に編集しません。
  • まず探索、次に計画「関係ファイルを読んで理解して」→「計画を作って」の順に頼む。
  • 計画OKなら実装へプランモードを抜けて 計画どおり実装して と頼む。
🔄 探索 → 計画 → 実装 → 確認の流れ
flowchart TD
  A["/plan でプランモードに入る"] --> B["関係ファイルを読ませる
（探索）"]
  B --> C["計画を作らせる"]
  C --> D{"計画に納得?"}
  D -->|"いいえ"| E["計画を直すよう頼む"]
  E --> C
  D -->|"はい"| F["プランモードを抜けて実装"]
  F --> G["動きを確認・テスト"]
「設計図に納得してから工事」。これだけで失敗がぐっと減ります。
terminal
> /plan
# 探索フェーズ
> このスクリプトの仕組みを読んで理解して
# 計画フェーズ
> 「あいさつを時間帯で変える」機能を足したい。計画を作って
# 納得したらプランモードを抜けて実装を依頼
解答例（やり方の一例）を見る
  1. プランモードへ/plan を実行（または Shift+Tab）。画面に「plan mode」と出ます。
  2. 探索このファイルがどう動くか読んで説明して。Claude は読むだけで編集しません。
  3. 計画依頼朝/昼/夜であいさつを変える機能を追加したい。どのファイルをどう変える? 計画を作って。
  4. 計画を確認・調整気になる点があれば そこは別のやり方にして と直してもらう。
  5. 実装プランモードを抜けて その計画どおりに実装して。最後に動かして確認。
💡
公式いわく、修正が小さい（タイプミス直しなど）ときは計画は省いてOK。「差分を1文で説明できるなら計画スキップ」が目安です。

参考：最初に探索し、次に計画し、その後コーディングする（公式）

05

バグを再現→原因調査→修正→テストで検証(! でテスト実行)

中級
やること：わざと用意した小さなバグ（＝プログラムの不具合）を、「再現 → 原因さがし → 修正 → テストで確認」の順に直す。プロのデバッグの流れをまるごと体験するのがゴール。

ヒント

  • エラーをそのまま見せるエラーメッセージやスタックトレース（＝どこで失敗したかの記録）をコピペして渡すと精度が上がります。
  • 症状をくわしく「いつ・何をしたら・どうなる」を伝える。公式の良い例は「ログイン失敗の症状＋あやしい場所＋直った状態」をセットで書くこと。
  • ! でコマンドを実行先頭に ! を付けるとシェルコマンドが動きます。!npm test でテストを走らせて確認。
🔄 バグ修正演習の流れ
flowchart TD
  A["バグを再現する"] --> B["エラーをClaudeに見せる"]
  B --> C["原因を調査させる"]
  C --> D["失敗するテストを書く"]
  D --> E["修正を実装させる"]
  E --> F["! でテスト実行"]
  F --> G{"テスト合格?"}
  G -->|"いいえ"| E
  G -->|"はい"| H["完了!"]
「テストが通る」という合格ラインを作ると、Claudeが自分で直るまで直してくれます。
terminal
# まずバグを再現（テストを走らせてみる）
> !npm test
# エラーを見せて原因調査を依頼
> このエラーが出る。原因を調べて、根本原因を直して。エラーを握りつぶさないで
# 直したら、もう一度テストで検証
> 修正後にもう一度テストを実行して、合格するまで直して
解答例（やり方の一例）を見る
  1. 再現バグのあるコードで !npm test（プロジェクトに合ったテストコマンド）を実行し、失敗を確認。
  2. 調査依頼このテストがこのエラーで落ちる：[エラーを貼る]。あやしい場所を調べて原因を説明して。
  3. テストを先にまず問題を再現する失敗するテストを書いて。これで「直ったかどうか」を機械が判定できます。
  4. 修正＆検証根本原因を直して。テストを実行し、合格するまで反復して。Claude がテスト結果を読んで、通るまで直し続けます。
✅
公式の鉄則：「Claudeに検証する手段を与える」。テストという合格・不合格のシグナルがあると、あなたが見張らなくても自分で直してくれます。

参考：バグを効率的に修正する（公式） / Claudeに検証する方法を与える（公式）

06

/compact と /clear を使い分けてコンテキストを整理

中級
やること：会話が長くなったら /compact で要約してスッキリさせ、まったく別の作業に移るときは /clear で完全リセット。2つの使い分けを体で覚えるのがゴール。
🧩
たとえ話：コンテキスト（＝Claudeが覚えている会話の中身）は「作業机の広さ」。机が散らかると作業が遅くなります。/compact は「机の上を整理整頓」、/clear は「机を全部片づけて新品同様に」するイメージです。

ヒント

🧹

/compact

大事な部分を残して要約。同じ作業を続けたいけど会話が長くなったとき。/compact APIの変更に注目して のように注目点も指定できます。

🗑️

/clear

会話をまるごと消して新品状態に。関係ない別タスクに移るとき。公式も「無関係なタスクの間は /clear」とすすめています。

terminal
# いまどれくらい使ってる? を確認
> /context
# 同じ作業を続けるが整理したい
> /compact いま直しているバグの内容を残して要約して
# まったく別の作業へ移る
> /clear
解答例（やり方の一例）を見る
  1. 使用量を見る/context で、いまどれくらいコンテキストを使っているか確認。
  2. 長くなったら要約同じバグ修正を続けるなら /compact 修正中のファイルとテストコマンドを残して。大事な情報を指定して残せます。
  3. 別作業はリセットバグ修正が終わって「次はドキュメント書き」など無関係な作業に移るときは /clear。
  4. 部分的に整理も可EscEsc で特定の地点を選び「ここから要約」「ここまで要約」も選べます。
⚠️
公式の失敗パターン「キッチンシンクセッション」（＝1つの会話に何でもかんでも詰め込む）に注意。関係ない話題が混ざると性能が落ちます。迷ったら /clear！

参考：コンテキストを積極的に管理する（公式）

5上級の課題（自分だけの道具を作る）

最後の2つは「Claude Code を自分好みにカスタマイズ」する上級編。ここまで来たらもう立派な使い手です。自分専用の道具を作って、作業をどんどん速くしましょう！

07

自分用のスキル(SKILL.md)かカスタムコマンドを1つ作る

上級
やること：.claude/skills/ に SKILL.md を作り、よく使う手順を「スキル」（＝呼び出せる必殺技）として登録。/スキル名 で呼び出せるようにするのがゴール。
🧩
たとえ話：スキルは「ゲームの必殺技を登録する」ようなもの。一度コマンドを覚えさせれば、あとは技名（/fix-issue など）を叫ぶだけで発動します。

ヒント

  • 作る場所は .claude/skills/その中にフォルダを作り、SKILL.md を置きます。Claude に作らせてもOK。
  • 先頭に name と descriptionスキルの名前と説明をヘッダー（＝先頭の設定欄）に書きます。
  • 手動だけにしたいならdisable-model-invocation: true を付けると、自動では発動せず /名前 でだけ呼べます。
terminal
# Claudeにスキルを作ってもらう
> .claude/skills/greet/SKILL.md を作って。
> 「あいさつ文を3パターン日本語で出す」スキルにして
# 作ったスキルを呼び出す
> /greet
# 登録済みスキルを確認
> /agents
解答例（やり方の一例）を見る

SKILL.md の中身の一例：

.claude/skills/greet/SKILL.md
# --- 先頭のヘッダー ---
name: greet
description: あいさつ文を3パターン日本語で生成する
# --- ここから本文 ---
# greet スキル
朝・昼・夜それぞれのあいさつ文を、やさしい日本語で1つずつ出してください。
絵文字は使わず、短くまとめてください。
  1. 作成を頼む上の内容で .claude/skills/greet/SKILL.md を作って と依頼。
  2. 呼び出す/greet と打つと、登録した手順が実行されます。
  3. 確認期待どおりの出力が出ればOK。出ない場合は description を具体的にすると安定します。
📝
CLAUDE.md は「毎回読む常識ルール」、スキルは「必要なときだけ読む専門知識」。たまにしか使わない手順はスキルにすると、会話がふくらまずスッキリします。

参考：スキルを作成する（公式）

08

claude -p でワンライン自動化を1つ作る（--max-turns 付き）

上級
やること：ターミナルから claude -p "命令" を1行打つだけで仕事をさせる「非対話モード」を体験。--max-turns（＝Claudeが動ける回数の上限）で暴走を防ぐ安全運転も学ぶのがゴール。
🧩
たとえ話：-p は「会話せず、1回だけお使いを頼む」モード。--max-turns 3 は「3往復まででお願いね」という門限みたいなもの。これがあると、想定外に動き続けて困る…を防げます。

ヒント

  • -p（または --print）セッションを開かず、結果だけ出して終わる。スクリプトやパイプ（|）と相性ばつぐん。
  • --max-turns で上限Claudeが動ける回数を制限。無人で動かすときの安全装置です。
  • パイプで渡すgit log | claude -p "要約して" のように、他のコマンドの出力を流し込めます。
terminal
# 1回だけ質問する（非対話）
$ claude -p "このプロジェクトが何をするものか1行で説明して"
# 回数を3往復までに制限して安全に
$ claude -p "README.mdに見出しを1つ追加して" --max-turns 3
# 他コマンドの出力をパイプで渡す
$ git log --oneline -10 | claude -p "最近のコミットを要約して"
解答例（やり方の一例）を見る
  1. まず質問だけclaude -p "このフォルダの役割を1文で" を実行。答えが1回返ってきて終了します。
  2. 回数制限つきで作業claude -p "README.mdに『使い方』という見出しを足して" --max-turns 3。3往復以内で終わらせます。
  3. パイプ自動化git log --oneline -10 | claude -p "コミットを3行で要約して"。他コマンドの結果をそのまま渡せます。
  4. 出力形式を変える（応用）スクリプトで使うなら --output-format json を付けると、プログラムで結果を読み取りやすくなります。
⚠️
無人で動かすときほど、--max-turns で上限を決めるのが大事。さらに --max-budget-usd で費用の上限も付けられます。安全運転で！

参考：Claudeをスクリプトにパイプする（公式） / 非対話型モードを実行する（公式）

6クリアしたらチェック！＆よくあるつまずき

8つの課題、おつかれさまでした！できたものに心の中でチェックを入れていきましょう。全部できなくても大丈夫、何度でも戻ってきてOKです。

#課題身についたこと
01自己紹介・フォルダ説明@ での参照と会話の基本
02修正→/diff→Esc+Esc確認とやり直しの安心感
03/init でCLAUDE.mdルールを覚えさせる
04/plan で計画→実装設計図を見てから作る
05バグ修正→! でテスト検証で自動的に直す
06/compact と /clear机の整理整頓
07SKILL.md を作る必殺技の登録
08claude -p 自動化1行で安全に自動化

🩹よくあるつまずきと対処

🌀

同じ間違いを何度も直す

2回直してもダメなら /clear して、学んだことを入れた新しいプロンプトでやり直すのが近道。

📦

CLAUDE.mdが効かない

たぶん長すぎ。容赦なく削って、本当に必要な行だけ残しましょう。

🔍

調査で迷子になる

「調べて」だけだと無限に読み続けます。範囲を区切るか、サブエージェントに任せて本体をクリーンに。

✅
一番大事なこと：Claude に「自分の作業を検証する手段（テスト・スクリプト・スクリーンショット）」を渡すこと。検証できないものは出荷しない――これが公式も推す黄金ルールです。

7次の一歩

手を動かして、Claude Code がぐっと身近になったはず！この調子で、力試しや復習に進みましょう。やればやるほどうまくなりますよ。

💡
次にやること：
📚
もっと深めたい人は公式ドキュメントへ。一般的なワークフロー には今回以外のレシピ（リファクタリング、PR作成、ドキュメント整備など）も載っています。ベストプラクティス はくり返し読む価値あり！
🧩
最後にひとこと：うまくいかない日があっても気にしないで。プロのエンジニアでも、Claude を止めて・直して・やり直してを毎日くり返しています。Esc と /rewind はあなたの味方。どんどん挑戦して、たくさん失敗して、上達していきましょう！