🎓 Claude Code大学

🔭まず全体像：Claude Codeとは何なのか

この違いが、Claude Codeの本質です。技術的にはこう動いています。

この「指示 → 道具を使う → 結果を見る → また使う」のぐるぐるをエージェントループと呼びます。Claude Codeが「賢い」と感じるのは、頭が良いからというよりこの輪を何度も回して自分で確かめているからです。

⌨️ターミナルへの恐怖を捨てる

ターミナル（Windowsでは PowerShell）は、マウスの代わりにキーボードでPCに命令する画面です。黒い画面に白い文字が並ぶアレです。

怖がられる最大の理由は「間違えたら壊れそう」だからですが、今週使うコマンドはすべて「見るだけ」で、何も壊しません。覚えるのは3つだけです。

Windowsの人への注意：PowerShellとコマンドプロンプトは別物です。画面の左に PS C:\ と出ていればPowerShell、C:\ だけならコマンドプロンプトです。インストールコマンドが違うので、ここは見分けてください。

💿インストール（現在の推奨手順）

macOS / Linux / WSL：

Windows（PowerShell）：

インストールできたか確認：

そして起動。必ず「作業したいフォルダの中で」起動してください。起動した場所がそのままClaudeの作業場になります。

初回はブラウザが開いてログインを求められます。ログイン後は認証情報が保存されるので、次回以降は claude だけでOKです。

🧪今週の演習

• ターミナル（またはPowerShell）を開き、pwd と ls を打って結果を眺める何も壊れないことを体感するのが目的です
• デスクトップに my-first-project という空フォルダを作る（マウスでOK）ターミナルから作りたい人は mkdir my-first-project
• Claude Codeをインストールし、claude --version でバージョンが出ることを確認する
• cd でそのフォルダに移動し、claude で起動してログインする
• 起動したら /help と打って、使えるコマンドの一覧を眺める全部覚えなくていい。「こんなにあるんだ」と知るだけ
• 日本語で「このフォルダには何がありますか？」と聞いてみる空フォルダなので「何もありません」と返ってくるはず。それが正解
• 「hello.txt というファイルを作って、中に自己紹介を書いてください」と頼み、承認を求められる画面を実際に見るここが一番大事な体験です
• /exit で終了する

💬Claude Codeにそのまま聞ける質問例

コピーして、Claude Codeの入力欄にそのまま貼り付けてください。

📕Week 1 用語集

ターミナル terminal

キーボードで文字を打ってPCに命令する画面。Windowsでは PowerShell が同じ役割。マウス操作の代わりだと思えばよい。

CLI Command Line Interface

「文字で命令する操作方法」の総称。対義語は GUI（マウスとアイコンで操作する画面）。Claude CodeはCLIツール。

ディレクトリ directory

フォルダのこと。同じ意味。技術文書では「ディレクトリ」と書かれることが多い。

パス path

ファイルやフォルダの住所。~/Desktop/my-project/index.html のような文字列。~ は自分のホームフォルダを指す略記。

カレントディレクトリ

「今いるフォルダ」。Claude Codeは起動したカレントディレクトリを作業場にするので、起動場所を間違えると別のフォルダをいじられる。

コマンド command

ターミナルに打ち込む命令文。ls や cd など。

スラッシュコマンド slash command

Claude Codeの中で使う特殊コマンド。/help、/clear、/exit など、頭に / がつく。ターミナルのコマンドとは別物なので混同しないこと。

エージェント agent

指示を受けて、自分で道具を選んで、自分で作業を進めるAIのこと。答えを返すだけのチャットAIとの決定的な違い。

エージェントループ

「指示 → 道具を使う → 結果を見る → 足りなければまた使う」の繰り返し。Claude Codeの心臓部。

ツール tool

Claudeが使える道具。ファイルを読む、ファイルを書く、コマンドを実行する、Webを検索する、など。

権限 / 承認 permission

Claudeがファイルを変更したりコマンドを実行したりする前に、あなたに「やっていい？」と確認する仕組み。安全装置。

Node.js

JavaScriptをPC上で動かすための土台ソフト。現在のClaude Code（ネイティブインストーラー版）には不要です。古い記事では必須と書かれているので注意。

🎯まず全体像：良い指示の3原則

Claude Codeへの指示は、優秀だが、あなたのプロジェクトを今日初めて見る新人に頼むつもりで書きます。優秀なので細かい手順は要りません。でも「今日初めて」なので、前提は知りません。

原則1：具体的に書く

原則2：段階に分ける

大きなお願いを1回で投げると、AIは勝手に前提を埋めて、あなたの想定と違うものを作ります。番号で区切ってください。

原則3：作らせる前に「読ませる」

これが一番効きます。いきなり「直して」と言うと、AIは全体を把握しないまま書き換えます。先に理解させてください。

🛑暴走を止める3つの装置

① プランモード（Shift + Tab）

入力欄で Shift + Tab を押すと、権限モードが切り替わります。「プランモード」にすると、Claudeは調査と計画立案だけを行い、ファイルには一切手を出しません。計画を読んで納得してから実行に移せます。

② Esc キー

Claudeが作業中に「あ、違う」と思ったら、Esc を押せば即座に止まります。走り出してから止めても構いません。遠慮なく止めてください。

③ 承認を緩めない

「毎回確認されるのが面倒だから全部許可」は、慣れるまで絶対にやらないでください。Claude Codeはファイルを削除することもできます。取り返しがつくのはWeek 3でGitを覚えてからです。

🧠コンテキストという概念（重要）

コンテキストとは、Claudeが今この瞬間に頭の中に載せている情報のことです。会話の履歴、読んだファイル、あなたの指示。すべてがここに積まれます。

そして、ここには上限があります。長く会話を続けると机の上が書類で埋まり、返答が鈍くなったり、序盤の指示を忘れたりします。

🧪今週の演習

• Shift+Tab を押して、権限モードが切り替わる表示を実際に見る
• プランモードで「このフォルダに簡単なメモアプリを作る計画を立てて」と頼み、ファイルが作られないことを確認する
• 通常モードに戻し、実際に1ファイルのHTMLツールを作らせるお題は自由。「入力した文字数をカウントするツール」など単純なもので十分
• 作られたHTMLをブラウザで開いて、実際に動くことを確認する「開いて」と頼めばClaudeが開いてくれます
• わざと曖昧な指示（「いい感じにして」）を出して、想定と違うものが返ってくる体験をするこれは失敗ではなく、実験です
• 同じことを具体的な指示で言い直し、結果がどう変わるか比べる
• Claudeが作業中に Esc を押して、途中で止められることを体験する
• /context で残量を見てから、/clear を打って机をリセットする

💬Claude Codeにそのまま聞ける質問例

📕Week 2 用語集

コンテキスト context

Claudeが今この瞬間に把握している情報の総量。会話履歴＋読んだファイル＋指示。上限があり、超えると精度が落ちる。

コンテキストウィンドウ

コンテキストの上限サイズ。「机の広さ」。

トークン token

AIが文章を数える単位。おおよそ日本語1文字が1〜2トークン。コンテキストの残量はトークン数で測られる。

プランモード plan mode

調査と計画だけを行い、ファイルを一切変更しないモード。Shift+Tab で切り替え。

モデル model

AIの頭脳の種類。賢いモデルほど高品質だが遅く高い。/model で切り替える。

プロンプト prompt

AIへの指示文のこと。「プロンプトを工夫する」＝「指示の書き方を工夫する」。

ハルシネーション hallucination

AIが、もっともらしい嘘を自信満々に出力すること。「存在しないファイル名を挙げる」「使えないコマンドを教える」など。必ず自分で動作確認すること。

イテレーション iteration

作る→動かす→直す、の繰り返し。1回で完成させようとしないこと。

デバッグ debug

不具合の原因を探して直す作業。Claude Codeにはエラー文をそのまま貼るのが最速。

📝CLAUDE.md ── プロジェクトのルールブック

Claude Codeは、セッションを終了すると会話をすべて忘れます。毎回ゼロから説明するのは苦痛です。そこで CLAUDE.md の出番です。

これはプロジェクトのフォルダに置く、ただのテキストファイル（マークダウン形式）です。Claude Codeはセッション開始時に、これを毎回自動で読みます。

作り方は簡単です。プロジェクトのフォルダでClaude Codeを起動し、こう打つだけ。

Claudeがプロジェクトを調べて、CLAUDE.md の下書きを作ってくれます。あとは自分で育てていきます。

何を書くか（書きすぎ注意）

• プロジェクトの一言説明（何のためのものか）
• よく使うコマンド（起動、テスト、ビルド）
• 守ってほしいルール（命名規則、使わないライブラリ、禁止事項）
• 触ってはいけないファイル

書き方のコツ：曖昧語を禁止する

CLAUDE.md のサンプル：

💾Git ── 壊しても戻れるセーブポイント

Gitは「バージョン管理システム」ですが、初心者にとっての価値はただ一つ、いつでも過去に戻れることです。

そして最高の知らせ。Gitコマンドを覚える必要はありません。Claude Codeに日本語で頼めます。

コミットのタイミング：「ここまでは動いている」と確認できたら、その瞬間にコミット。これだけです。1日1回ではなく、動作確認できるたびにやってください。

🧪今週の演習

• Week 2 で作ったプロジェクトのフォルダで /init を実行し、CLAUDE.md が作られるのを見る
• 作られた CLAUDE.md を自分の目で読む（Claudeに「読み上げて説明して」と頼んでOK）
• CLAUDE.md に「私はプログラミング未経験です。専門用語には必ず補足をつけてください」という1行を自分で追加するこれが一番効きます
• 一度 /exit して再起動し、CLAUDE.md のルールが効いているか確認する「あなたが今読んでいるルールを教えて」と聞くとわかる
• Claudeに頼んでGitを初期化し、最初のコミットを作る
• わざとファイルを大きく壊してもらい、コミットした状態に戻してもらう戻せることを体で確認するのが目的。これが安心の土台になります
• 「これまでのコミット履歴を見せて」と頼み、自分の作業の足跡を眺める
• /memory を実行し、Claudeが勝手に覚えたメモがあるか見てみる

💬Claude Codeにそのまま聞ける質問例

📕Week 3 用語集

CLAUDE.md

プロジェクトのルールを書いたテキストファイル。Claude Codeがセッション開始時に毎回自動で読む。あなたが書く。200行以内推奨。

マークダウン Markdown

記号だけで見出しや箇条書きを表現する、簡単な書式ルール。# が見出し、- が箇条書き。.md という拡張子のファイル。

自動メモリ / MEMORY.md

Claudeが作業中に気づいたことを自分で記録するメモ。Claudeが書く。CLAUDE.md とは方向が逆。/memory で確認できる。

Git ギット

ファイルの変更履歴を記録し、いつでも過去に戻せるようにする仕組み。ゲームのセーブ機能だと思えばよい。

コミット commit

「ここまでの状態をセーブする」操作。メッセージを添えて記録する。

リポジトリ repository

Gitで管理されているプロジェクトのフォルダ全体のこと。略して「リポジトリ」「レポ」。

ブランチ branch

作業の枝分かれ。「本番用」とは別に「実験用」を作り、うまくいったら合流させる。最初は使わなくてよい。

.gitignore

「これはGitで記録しないで」という除外リスト。パスワードを含むファイルなどを入れる。

GitHub

Gitのデータをネット上に保存・公開できるサービス。無料枠あり。Gitとは別物（GitHubを使わなくてもGitは使える）。

/init

プロジェクトを調べて CLAUDE.md の下書きを自動生成するスラッシュコマンド。

🧭まず全体像：あなたの本当の仕事

この4週間で見えてきたはずです。Claude Codeを使う人の仕事は、コードを書くことではありません。

両端があなたの担当です。そして、両端の質が成果物の質を決めます。真ん中をどれだけAIが上手にやっても、「何を作るか」が曖昧なら、上手に作られた「よく分からないもの」ができるだけです。

📋アイデアを仕様に変える4つの問い

作りたいものを思いついたら、コードの前に、この4つに文章で答えてください。答えられない項目があれば、それがまだ考えていない部分です。

特に④が効きます。「作らないもの」を先に宣言しないと、AIは親切心で機能を盛ります。盛られた分だけ複雑になり、複雑になった分だけ壊れます。

🚀作ったものを公開する（無料でできます）

手元で動くだけでは、誰にも見せられません。公開まで行って、初めて「作った」と言えます。個人利用なら無料枠で足ります。

どちらもClaude Codeに手順を聞けば、日本語で伴走してくれます。

🧪今週の演習（卒業制作）

• 上の「設計シート」を最後まで埋める埋まらない欄があれば、それがあなたの考えていない部分です。埋まるまで考える
• 生成されたプロンプトを、プランモードでClaude Codeに渡すいきなり作らせない。まず計画を見る
• 返ってきた計画を読み、自分の意図と違う部分を1つ以上見つけて指摘するここができれば、あなたはもう「指示を出せる人」です
• Gitで最初のコミットを作ってから、実装を開始する
• 動くところまで作り、設計シート④「完成の定義」を満たしているか自分で確認する
• 使ってみて気づいた不満を1つ挙げ、修正を依頼するこれがイテレーション。ここからが本当の開発です
• 秘密情報チェックのプロンプトを実行する
• 公開する（またはしないと決める）
• CLAUDE.md を、この1ヶ月で学んだことを反映して書き直すあなた専用のマニュアルに育てる

📕Week 4 用語集

仕様 specification / spec

「何を作るか」を言葉で定義したもの。コードの前に必要。設計図。

スコープ scope

作る範囲。「ここまでは作る、ここからは作らない」の線引き。曖昧だと際限なく膨らむ（＝スコープクリープ）。

完成の定義 Definition of Done

「どうなったら完成と言えるか」を、動作確認できる形で書いたもの。「いい感じになったら」は定義ではない。

MVP Minimum Viable Product

「最小限だが価値がある版」。最初から全部盛りにせず、一番大事な機能だけで一度動かすこと。

デプロイ deploy

作ったものをサーバーに置いて、誰でも使える状態にすること。「公開する」とほぼ同義。

ホスティング hosting

ファイルを置いてWebに公開してくれるサービス。GitHub Pages、Cloudflare Pages など。

APIキー

外部サービスを使うための「あなた専用の鍵」。絶対に公開してはいけない。漏れると勝手に使われ、課金される。

リファクタリング refactoring

動きを変えずに、中身を整理して読みやすくすること。「動くけど汚い」を「動くしきれい」にする。

MCP Model Context Protocol

Claudeを外部サービス（GitHub、Googleドライブ等）に接続する仕組み。4週間終えて余力があれば、次に学ぶ領域。

Skills / スキル

よく使う作業手順をファイルにまとめ、/名前 で呼び出せるようにする機能。同じ指示を何度も打っていると気づいたら、これの出番。

🎓卒業後にどこへ行くか

この4週間で扱わなかったこと（＝次の学習範囲）を、正直に挙げておきます。

• Skills：繰り返す作業を /コマンド にまとめる。同じ指示を3回打ったら、その時が学びどきです。
• MCP：Claude Codeを外部サービスにつなぐ。GitHubやGoogleドライブを直接操作させたくなったら。
• Hooks：「コミット前に必ずテストを走らせる」など、自動処理を仕込む。運用が固まってから。
• サブエージェント：複数のClaudeに分担させる。大きなプロジェクトを扱うようになってから。

ただし、慌てて手を出さないでください。これらは全部「同じ作業を繰り返して面倒になった」ときに初めて意味を持つ機能です。面倒になる前に導入すると、使いこなせない設定が増えるだけです。