@kawai_design: Claude Codeは、名前だけ見るとむずかしく見えます。...
Claude Codeは、名前だけ見るとむずかしく見えます。
ターミナル、MCP、hooks、Skills、APIが一気に出てくるため、最初の1時間で迷子になります。
この記事では、Claude Codeを「先生が中学生2人に教える授業」として整理します。
読み終わると、基本操作、外部連携、Skills、メモリー、hooks、MCP、APIを、どの順番で覚えればよいか分かります。
見出し画像はAIで生成しました。
プロンプトはこの記事に掲載中。
Claude Codeは「答えるAI」ではなく「動くAI」
Claude Codeは、質問に答えるだけではなく、パソコンの中で作業を進めるAIです。
公式docsでは、ファイル編集、コマンド実行、git操作、MCP連携などができるエージェント型の開発ツールとして説明されています。
まずここを押さえると、全部の機能がつながります。
先生は、黒板にこう書きました。
「チャットAIは、相談に乗る先生です。Claude Codeは、教室で一緒に手を動かす班長です」
ミナが聞きます。
「じゃあ、Claude Codeはプログラミングできる人だけのものですか？」
先生は首を振ります。
「最初はコードを書く道具として有名になりました。でも本質は、フォルダを読み、ファイルを直し、手順を実行するAIです。文章、資料、Webページ、調査メモ、教材作りにも使えます」
レンが言います。
「つまり、ChatGPTに『作文して』と言うのではなく、Claude Codeに『このフォルダを見て、直して、確認して』と言える感じですね」
その通りです。
Claude Codeを教える時は、最初にこの3分類だけで十分です。
たとえば、先生が文化祭のWebページを作る授業なら、Claude Codeにはこう頼みます。
```
このフォルダを読んで、文化祭ページの構成を説明してください。
そのあと、見出しを中学生向けに分かりやすく直してください。
最後に、リンク切れや誤字がないか確認してください。
```ここで大事なのは、AIに「答え」だけを求めないことです。
Claude Codeには、作業の順番を渡します。
目次
基本操作は「お願い、確認、修正」の3つ
Claude Codeの基本は、お願いして、確認して、修正する流れです。
難しいコマンドを暗記するより、この会話の型を覚える方が早く上達します。
最初は「一発で完成」ではなく「一緒に直す」前提で使います。
先生は、2人に最初の型を渡しました。
```
1. まず全体を読んでください
2. 何を直すべきか提案してください
3. 私がOKした範囲だけ直してください
4. 直した内容を確認してください
```ミナが安心した顔で言います。
「いきなり全部変えられるのが怖かったです。先に提案してもらえばいいんですね」
先生は答えます。
「はい。Claude Codeは勝手に作業させるより、確認ポイントを作る方が安全です」
基本の使い方は、次の5つです。
ただし、中学生に最初から全部教える必要はありません。
最初の授業では、`claude` を開いて次の一文だけで十分です。
```
このフォルダで何ができるか、初心者にも分かるように説明してください。
```レンが言います。
「最初の一言、これでいいなら怖くないですね」
先生は続けます。
「そうです。Claude Codeは、使い方を聞きながら使えます。分からない時は、使い方そのものを聞いてください」
基本操作のゴールは、コマンド暗記ではありません。
AIに任せる範囲を、人間が決められることです。
メモリーは先生の申し送りノート
メモリーは、Claude Codeに毎回読んでほしい前提を書いておく場所です。
公式docsでは、ユーザー単位、プロジェクト単位などの指示ファイルを使い分ける仕組みとして説明されています。
授業で言えば、先生同士の申し送りノートです。
先生は、黒板に `CLAUDE.md` と書きました。
ミナが聞きます。
「これは何ですか？」
先生は答えます。
「Claude Codeが作業前に読む、教室のルールブックです」
たとえば、文化祭プロジェクトならこう書きます。
```
# このプロジェクトのルール
- 対象は中学生と保護者
- 文章は短く、やさしい日本語
- 画像ファイルは assets/ に置く
- 変更前に必ず作業方針を説明する
- 個人情報は書かない
```レンが言います。
「毎回これを言わなくていいんですね」
先生はうなずきます。
「そうです。毎回同じ説明をするなら、メモリーに入れます」
メモリーに向いている情報は、次の4つです。
逆に、メモリーに向いていない情報もあります。
中学生に教えるなら、こう言えば伝わります。
「メモリーは、AIの頭を良くする魔法ではありません。毎回忘れてほしくないルールを置くノートです」
この説明で十分です。
Skillsは必殺技カード
Skillsは、よく使う仕事の手順を呼び出せる形にしたものです。
公式docsでは、`SKILL.md` を中心に、テンプレート、例、スクリプト、参照資料をまとめられる仕組みとして説明されています。
授業で言えば、必要な時だけ出す必殺技カードです。
先生は、カードを3枚描きました。
ミナが聞きます。
「プロンプト集と何が違うんですか？」
先生は答えます。
「プロンプト集は、毎回貼る紙です。Skillsは、Claude Codeの道具箱に入れておくカードです」
Skillの基本構造は、こうです。
```
my-skill/
├── SKILL.md
├── examples/
├── references/
└── scripts/
````SKILL.md` には、いつ使うか、何をするか、何を読めばよいかを書きます。
Claude Codeは、会話に合うSkillを自動で使うことも、ユーザーが `/skill-name` の形で呼び出すこともできます。
レンが言います。
「じゃあ、先生が毎回やっている添削ルールをSkillにすればいいんですね」
その通りです。
たとえば、読書感想文Skillなら、こう設計します。
```
---
name: book-report-review
description: 読書感想文の構成、具体例、感想の深さを確認する時に使う
---
あなたは中学生向け読書感想文の添削係です。
確認する順番:
1. あらすじを書きすぎていないか
2. 自分の変化が書かれているか
3. 印象に残った場面が具体的か
4. 最後のまとめが本文とつながっているか
出力:
- よい点
- 直す点
- 書き直し例
```ここで大切なのは、何でもSkillにしないことです。
1回しか使わない依頼は、その場で頼めば十分です。
Skill化するべき仕事は、次の条件に当てはまるものです。
先生は最後に言いました。
「Skillは、AIに才能を足すものではありません。人間の手順を、再利用できる形にするものです」
Claude Code 辞書サイトもご活用ください。
https://x.com/i/status/2053158055211139292
hooksはチャイムと見回り係
hooksは、Claude Codeの作業前後に自動で動く仕組みです。
公式docsでは、`PreToolUse` や `PostToolUse` など、特定のイベントに合わせてコマンドや処理を走らせる設定として説明されています。
授業で言えば、チャイムと見回り係です。
ミナが聞きます。
「チャイムですか？」
先生は答えます。
「はい。授業が始まる前に鳴る。提出前に鳴る。危ない場所に行こうとしたら止める。これがhooksです」
たとえば、Claude Codeがファイルを書き換える前に、次のような見回りができます。
レンが目を輝かせます。
「じゃあ、AIがミスしそうな時に止められるんですね」
先生は少しだけ厳しく言います。
「ただし、hooksは強い道具です。シェルコマンドを自動実行できるため、よく分からないまま入れると危険です」
hooksを中学生に説明するなら、最初は設定を書かせなくてよいです。
先に役割だけ教えます。
作業前: 危ない操作を止める
作業後: テストや確認をする
終了時: やり残しをチェックする
実務では、次の順番で導入します。
いきなり自動化しないことです。
人間が理解していない確認を自動化すると、失敗も自動化されます。
先生は、黒板にこう書きました。
「hooksは便利なロボットではなく、決めたルールを守る見回り係です」
MCPは校外学習のバス
MCP（Model Context Protocol）は、Claude Codeを外部サービスやデータにつなぐ仕組みです。
公式docsでは、Model Context Protocolを、AIツールと外部データソースをつなぐオープン標準として説明しています。
授業で言えば、教室の外へ行くための校外学習バスです。
先生は、教室の絵を描きました。
その外に、図書館、職員室、町役場、博物館を描きます。
レンが言います。
「Claude Codeが教室の外へ行けるんですか？」
先生は答えます。
「そのイメージです。MCPをつなぐと、Claude CodeはGitHub、Sentry、PostgreSQL、Slack、Google Drive、Figmaのような外部情報へアクセスできるようになります」
もちろん、何でも自由に見せるわけではありません。
接続するサーバー、認証、権限を決めます。
Claude CodeのMCP設定では、HTTPサーバーやローカルで動くstdioサーバーなどを追加できます。
たとえば、公式docsには次のような追加方法が載っています。
```
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
```ミナが心配そうに言います。
「外につなぐのは、少し怖いです」
先生は答えます。
「その感覚は正しいです。MCPは便利ですが、つなぐほど触れる情報が増えます。だから、読み取り専用から始めます」
MCPを教える時の順番は、次の通りです。
MCPの価値は、AIが賢くなることではありません。
AIが仕事に必要な資料を、自分で取りに行けることです。
先生はまとめます。
「MCPは、AIに外の世界を見せるバスです。ただし、どこへ行ってよいかは先生が決めます」
APIとSDKはClaude Codeを部品にする方法
API（Application Programming Interface）とSDK（Software Development Kit）は、Claude Codeをアプリや自動処理の中に組み込む方法です。
公式docsでは、Claude Code SDKを、CLI、TypeScript、Pythonから使える仕組みとして説明しています。
授業で言えば、班長を教室の外の仕事にも参加させる方法です。
レンが聞きます。
「APIって、結局何ですか？」
先生は答えます。
「人間が画面で話す代わりに、プログラムからClaude Codeへ仕事を頼む入口です」
たとえば、普通の使い方はこうです。
```
claude -p "この文章を読みやすく直してください"
```これは、人間がターミナルから1回頼む形です。
SDKを使うと、アプリやバッチ処理の中でClaude Codeを呼べます。
Python SDKは `claude-code-sdk` として提供され、TypeScript SDKも用意されています。
ミナが聞きます。
「それは初心者も最初にやるべきですか？」
先生は答えます。
「いいえ。最初にやるべきではありません」
APIやSDKは、次の段階で使います。
中学生向けに言うなら、こうです。
「手で班長にお願いするのがClaude Codeの基本。放送室から自動で依頼を流すのがAPIとSDKです」
便利ですが、最初から使うと混乱します。
順番は、基本、メモリー、Skills、MCP、hooks、その後にAPIです。
まず30分で作る練習メニュー
Claude Codeは、全部を一気に覚える必要はありません。
最初の30分でやることを絞ると、怖さが消えます。
中学生に教えるなら、小さな成功体験を先に作ります。
先生は、最後に30分の授業メニューを出しました。
```
0〜5分: Claude Codeを開く
5〜10分: このフォルダで何ができるか聞く
10〜15分: CLAUDE.mdに教室のルールを書く
15〜20分: 文章ファイルを1つ直してもらう
20〜25分: 変更内容を説明してもらう
25〜30分: 次にSkill化できる作業を3つ出してもらう
```ミナが言います。
「これなら授業でできそうです！」
レンが言います。
「MCPとかhooksは、あとでいいんですね」
先生は答えます。
「はい。順番が大事です。いきなり外部連携や自動実行へ行くと、何が起きているか分からなくなります」
最初のゴールは、次の3つです。
ここまでできれば、Claude Codeの本質はつかめます。
その後に、用途別に進めます。
Claude Codeは、機能を暗記する道具ではありません。
仕事の渡し方を育てる道具です。
先生は、最後にこう言いました。
「AIを使える人は、AIに詳しい人ではありません。仕事を分けて、ルールを渡して、確認できる人です」
これが、Claude Codeを中学生に教える時のいちばん大事な結論です。
関連記事
https://x.com/i/status/2032673056347533607
【超初心者OK】Claude Code 個別サポート
※早割先着10名様分は完売しました。
https://x.com/i/status/2045844913598988764
Claude Codeデザインパターン
〜フォルダ構造・Skills・database・コンテンツ生成フロー全公開〜
https://x.com/i/status/2050047571457110275
お問い合わせ・個別相談・法人研修のご依頼
https://kawai-official.pages.dev/
Claude Code版が大変好評なため、
Codex版も投稿しました。
x.com/kawai_design/s…