← 教材一覧へ戻る

脱・属人プログラム — 学習ノート

Claude Codeの基礎

— 最初に覚える11の言葉

「.mdって何?」「スキルって?」「CLAUDE.mdとメモリは何が違うの?」——使い始めると、聞き慣れない言葉が次々に出てきます。この資料は、そのひとつひとつを数行で説明するだけの1枚です。作り方は書きません。「その言葉が何か」が分かれば、今は十分です。

2026.08.21 作成 / 公式ドキュメントで裏取り済み

この資料の使い方
  1. 通しで読まなくていい / 知らない言葉が出てきたときに、その項目だけ読む
  2. 各項目の最後に「もっと詳しく」がある / 実際に作る段になったら、そちらへ
  3. 覚えるのは名前と役割だけ / 使い方は、必要になった回で扱う

PART 1 / 4

最初に決める3つのつまみ

安全・賢さ・念入りさ。ここだけ先に押さえます。

01

権限モード・モデル・努力度(effort)

AIがどこまで勝手に進めてよいかの設定です。送信ボタンの隣にあります。

モード意味
Manual1つ動くたびに「やっていいですか?」と聞いてくる
Accept editsファイルの書き換えは確認なしで進める
Auto別のAIが裏で危険な操作だけ止める。基本は聞いてこない
Plan何も変更せず、先に計画だけ立てる
最初の設定はここだけ Pro・Max・Teamプランの初期状態は「Auto」です。慣れるまではManualに切り替えてから始めてください。1つずつ許可を出す体験そのものが、「AIが今なにをしているか」を掴む近道です。

モデル — どの頭脳を使うか

入力欄の近くでモデル(AIの種類)を選べます。ざっくり「賢い=じっくり考えるが遅い」「軽い=速いが浅い」の関係です。

選び方向いている場面
賢いモデル設計を考える、複雑な仕組みを作る、長い文章を書く
軽いモデル短い書き換え、単純な整形、大量の繰り返し

迷ったら既定のままで構いません。賢いモデルほど使用量を早く消費するので、「軽い作業が続くときだけ下げる」くらいの使い分けで十分です。

努力度(effort) — どれだけ考えてから答えるか

同じモデルでも、どれくらい念入りに考えてから答えるかを調整できます。上げれば精度は上がりますが、時間と使用量も増えます。

これも最初は触らなくて大丈夫です。「大事な設計を任せる」ときに上げる、「簡単な作業ばかり」のときに下げる——必要になってからで間に合います。

3つの関係 権限モード=どこまで勝手にやらせるか(安全のつまみ)。モデル=どの頭脳を使うか。努力度=その頭脳をどれだけ回すか。最初に決めるのは権限モードだけで、あとの2つは既定のままで問題ありません。

もっと詳しく → Claude Codeを動かすまで

02

作業フォルダ(事業部)と AI専用フォルダ(コーポレート)

パソコンの中に、2つの箱ができます。役割がまったく違うので、最初にここだけ押さえてください。

📁 C:\dev\ ← ① 作業フォルダ(=各事業部)。自分で作る ├─ 📁 営業ダッシュボード\ ← 案件ごとに1フォルダ。Claude Codeはここを開く │ ├─ 📄 CLAUDE.md この案件だけのルール │ └─ 📄 … 作った成果物 └─ 📁 SNS投稿\ ← 別の案件 📁 C:\Users\〈あなたの名前〉\.claude\ ← ② AI専用フォルダ(=コーポレート)。勝手に作られる ├─ 📄 CLAUDE.md どこで開いても効く共通ルール ├─ 📁 memory\ AIの記憶 └─ 📁 skills\ よく使う頼み方の保存先
AI専用フォルダ(.claude)=コーポレート部門と、作業フォルダ(C:\dev)=各事業部を左右に分けた見取り図。作業フォルダを消してもAIの脳は巻き添えにならない、と示している
図|脳(コーポレート)と作業場(事業部)をきっぱり分ける
会社にたとえると ① が各事業部、② がコーポレート(本社)です。現場の仕事は事業部ごとに分かれ、社則や共通の資産は本社にまとまっている——それと同じ形です。

Claude Codeは、開いたフォルダの中だけで働きます。だから「どこで開くか」がそのまま「AIに見せる範囲」になります。デスクトップ全体などを選ばないのは、このためです。

もっと詳しく → AIの第二の脳を作る(②の中身の育て方・守り方)/Claude Codeを動かすまで(①の作り方)

PART 2 / 4

ルールと記憶のはなし

「毎回同じことを言わなくて済む」ための道具です。性質が全部違います。

03

.md(マークダウン)

ただのテキストファイルです。中身は文字だけ。特別なソフトは要りません。

普通のテキストと違うのは、# で見出し、- で箇条書き、といったごく簡単な印で構造を表せること。人間も読めて、AIも構造を理解できるので、AIとのやり取りではこの形式が標準になっています。

作った文書も、AIへのルールも、記憶も、ほとんどが .md です。「.mdと出てきたら、ただの文字が入ったファイルだ」と思っておけば大丈夫です。

もっと詳しく → ルールをAIに守らせる3つの道具

04

CLAUDE.md

AIが作業を始める前に、毎回かならず読むルールです。ファイル名は決まっていて、中身はただの .md。「敬語で書いて」「専門用語は補足して」といった、毎回言うのが面倒なことを書いておきます。

置き場所は2か所あり、効く範囲が違います。

置き場所効く範囲たとえ
~/.claude/CLAUDE.mdどのフォルダで開いても効く会社の就業規則
各フォルダの CLAUDE.mdそのフォルダで開いたときだけその現場のルール
CLAUDE.mdの置き場所は2段。全案件で共通のグローバル層と、各プロジェクトごとのローカル層に分かれ、Claude Codeがこの2つを自動で合わせて読み込む
図|CLAUDE.mdは2段で置く。この2つをClaude Codeが自動で合わせて読み込む

2つは足し算です。片方がもう片方を消すことはありません。

Gem・GPTsを使っている方へ GeminiのGemやChatGPTのGPTsで「あなたは〇〇の担当です」「必ず〇〇の形式で答えて」と設定していた部分——それに近いのがCLAUDE.mdです。違いは、AIを選び直すのではなく、フォルダを開くだけで自動的に効くことです。
ここが重要 CLAUDE.mdは「お願い」であって、強制力はありません(公式に明記)。たいていは守りますが、守らないこともあります。絶対に守らせたいことは、この後に出てくるhookやdenyという別の仕組みを使います。

もう1つ、CLAUDE.mdは公式が「200行未満」を目安にしています。これは途中で打ち切られるという意味ではなく、長いほど毎回の読み込み量を食い、指示の守られ方が落ちるという推奨です(公式に明記)。なお「200行 または 25KB で打ち切り」という上限の話を見かけますが、あれはCLAUDE.mdではなく、AIが自分で書くメモリの目次ファイルの話です(混同しやすいので注意)。長くなったら作業手順はスキルへ出してください(スキルの本文は呼ばれたときだけ読まれるので、いくつ作っても重くなりません)。

もっと詳しく → AIの第二の脳を作る

05

メモリ(記憶)

AIが自分で書きためていく記録です。CLAUDE.mdとの違いは、誰が書くかです。

CLAUDE.mdメモリ
書く人あなたAI
中身守ってほしいルールやり取りの中で分かった事実・好み・決定
たとえ就業規則担当者の引き継ぎメモ

どちらもただの .md で、置き場所はコーポレート側(`~/.claude/` の中)です。作業フォルダを消しても、記憶は巻き添えになりません。

※Claudeのアプリ側(チャット・Cowork)にも「メモリ」があり、名前は同じでも別物です。あちらはAnthropic側に保存され、設定 > メモリから覚えている内容を確認・削除できます(2026年8月25日にチャットとCoworkで共有されるようになりました)。Claude Codeの記憶はあなたのPCの中だけで、そちらとは同期しません(公式に明記)。

もっと詳しく → AIの第二の脳を作る

06

セッション

会話のひとまとまりのことです。1つの作業に1つ、が基本です。

大事なのは、AIが一度に覚えていられる量には上限があるということ。話が長くなるほど机の上が散らかっていき、だんだん精度が落ちます。話題が変わったら新しいセッションを開く——これだけで調子が戻ります。

たとえるなら 作業机です。1つの案件の資料だけが載っている机は仕事がしやすく、3案件ぶんの書類が積み上がった机では、探すだけで時間が溶けます。

重くなってきたと感じたら

「返事が遅い」「さっき言ったことを忘れている」「同じところをぐるぐるしている」——これらは机が散らかってきたサインです。対処は3つあります。

やり方どうする向いている場面
新しいセッションを開く会話を切り替えるだけ話題が変わるとき。いちばん確実
/compact を打つ要点だけ残して、その場で圧縮する同じ作業を続けたいが、重くなってきたとき
引き継ぎ文を作らせる次の会話に渡す文章を作らせてから移る作業の途中で、経緯を失いたくないとき

おすすめ:引き継ぎ文を作らせてから移る

いちばん確実なのは新しいセッションを開くことですが、そのままでは今までの経緯がゼロに戻ります。そこで、移る前にこう頼みます。

ここまでの経緯を、新しい会話に引き継ぐための文章にまとめて。 ・何をしようとしているか ・どこまで終わったか ・決めたこと、やらないと決めたこと ・次にやること を入れて、そのまま貼れる形で。

出てきた文章を新しいセッションの1通目に貼るだけです。机はきれいなまま、経緯だけを持ち越せます。担当者が代わるときの引き継ぎメモと同じ発想です。

溜め込まないコツ 「重くなってから対処する」より、作業の区切りで新しく開く方がラクです。1つの案件が終わったら閉じる、話題が変わったら開き直す——これを習慣にすると、そもそも重くなりません。

PART 3 / 4

繰り返しを減らす道具

同じ作業を2回以上やるようになってから効いてきます。最初は名前だけで十分。

07

スラッシュコマンド

入力欄で / を打つと出てくる、よく使う操作の呼び出しです。文章で説明する代わりに、一発で呼べます。

最初に覚えるのは、これくらいで足ります。

コマンド何をするか
/compact会話が長くなったとき、要点だけ残して圧縮する
/permissionsいまAIに何を許可しているかを一覧で見る
/usage使用量や契約プランを確認する

もっと詳しく → 非エンジニアのためのコマンド地図

08

スキル

よく使う頼み方を保存して、いつでも呼び出せるようにしたものです。中身は手順を書いた .md にすぎません。

中身は SKILL.md という1枚のファイルです。CLAUDE.md が「ずっと効くルール」なら、SKILL.md は「呼んだときだけ効く手順書」——同じ .md でも役割が違います。

呼び出し方は2つあります

呼び方やること使いどころ
コマンドで呼ぶ/ を打って一覧から選ぶ(例:/記事作成)確実に呼びたいとき
ふつうに頼むいつも通り日本語で書くだけ名前を覚えていないとき。AIが自分で判断して使う

コマンド名は「フォルダ名」で決まります

「/ の後に何て打てばいいの?」の答えは、スキルを入れたフォルダの名前です。

📁 skills\ └─ 📁 記事作成\ ← このフォルダ名が、そのままコマンド名になる └─ 📄 SKILL.md ← 中身(手順)はここに書かれている 打つコマンド = /記事作成

忘れたときは / を打てば一覧が出るので、そこから選べば大丈夫です。

名前を覚えなくても呼べる仕組み SKILL.md の冒頭には description(どんなときに使うスキルか)が1〜2行書いてあります。AIはここを読んで、「今の頼みごとはこのスキルだな」と自分で判断します。だからコマンド名を覚えていなくても、ふつうに頼むだけで使われます。
逆に言うと、この説明文が雑だと呼ばれません。作るときにいちばん大事なのは、手順そのものより「どんなときに使うか」の1行です。
Gem・GPTsを使っている方へ GeminiのGemやChatGPTのGPTsは、「設定を保存して、用途ごとに選んで使う」ものでした。Claude Codeでは、その役割が2つに分かれています。
ずっと効かせたいこと(口調・守ってほしいこと・前提)は CLAUDE.md に。その作業のときだけ呼びたい手順はスキルに。
Gem・GPTsを1つ作るときに書いていた内容が、「常に効く部分」と「呼んだときだけ効く部分」に分かれた——そう考えると掴みやすいはずです。
いつ効くか中身
CLAUDE.mdそのフォルダで作業している間ずっと口調・前提・守ってほしいこと
SKILL.md呼び出したときだけ決まった作業の手順(レシピ)
作るタイミング 同じ作業を2回以上やってからで十分です。先に作っても、何を保存すべきかが分かりません。「またこれか」と思った瞬間が作りどきです。

そして、これが脱・属人の核心でもあります。作れる人が型を作れば、ほかの人が同じ品質で呼び出せるようになります。全員が作り方を覚える必要はありません。

どこに保存されるか — スキルも段で分かれています

CLAUDE.mdと同じで、置き場所によって効く範囲が変わります。

置き場場所効く範囲
会社管理者が配る設定組織の全員
パーソナル~\.claude\skills\自分の全フォルダ
プロジェクトそのフォルダの .claude\skills\そのフォルダの中だけ
CLAUDE.mdとは逆なので注意 CLAUDE.mdは足し算でした(上のルールも下のルールも両方効く)。スキルは上書きです。同じ名前が2か所にあると、範囲の広いほうだけが動きます。
たとえば同じ名前のスキルをパーソナルとプロジェクトの両方に置くと、そのフォルダで作業していてもパーソナル側が使われ、プロジェクト側は黙って無視されます。「その場に合ったほうが選ばれる」ではありません。フォルダに近いほうが勝ちそうに見えますが、逆です。

だから、こう使い分けます。

やりたいことやり方
この案件だけで使うプロジェクト側に置く
どの案件でも使うプロジェクト側を削除してから、パーソナルへ移す
両方持ちたい名前を変える(例:汎用版を 記事作成-汎用 に)
チームに配りたいプロジェクト側のまま。フォルダごと渡すか、GitHubに入れる

※例外:同じ名前でも、さらに下のフォルダに置いた場合だけは両方残ります。名前の前にフォルダ名が付いて区別され(例:/ai-content:記事作成)、作業中のファイルに応じて使い分けられます。上書きされるのは「パーソナル対プロジェクト」のように段をまたぐときだけです。

ひとことで 同じ名前を上の段に置くと、下の段は黙って無視される。使い分けたいなら、名前を変えるか、片方を消す。

置き場所の落とし穴 — 3つ

① 作業場の親フォルダ(中間の段)に置かない C:\dev\.claude\skills\ のように、案件フォルダを並べている親フォルダにスキルを置くと、今は使えます。下の案件フォルダで起動しても、Claude Codeは親フォルダまでさかのぼってスキルを探すからです。
ただし、案件フォルダをGitHubの保管箱(リポジトリ)にした瞬間に、読まれなくなります(理由は②)。しかも親フォルダはどの保管箱にも入らないので、バックアップからも漏れます。
置くのはパーソナル(~\.claude\skills\)か、その案件フォルダの中のどちらかにしてください。
② さかのぼりは「保管箱のいちばん上」で止まる スキルを親フォルダへさかのぼって探すのは、保管箱(リポジトリ)のいちばん上のフォルダまでです(公式に明記)。保管箱の外にある親フォルダのスキルは、そこから先は読まれません。
CLAUDE.mdとはここも違います。CLAUDE.mdは保管箱の外の親フォルダまでさかのぼって読まれます。
実際に試すと、親フォルダに置いたスキルは、案件フォルダを保管箱にする前は一覧に出て、した直後に消えました。同じ親フォルダのCLAUDE.mdは、保管箱にした後も読まれたままでした(2026-10-01 確認)。
③ パソコンの外で動くものは、パーソナルを読まない クラウドで動くセッション・routine(クラウドの定期実行)・Coworkは、あなたのパソコンの ~\.claude\skills\ を読みません(公式に明記)。パーソナルにしか無いスキルをroutineから呼ぶと、「見つからない」と言われます。
これらでも使いたいスキルは、保管箱の .claude\skills\ に入れてGitHubに上げる(クラウドのセッション・routine向け)か、claude.aiのアカウントでそのスキルを有効にする(Cowork・クラウドのセッション向け)必要があります。
※デスクトップアプリの定期タスクは、パソコンの中で動くのでパーソナルも読みます。

もっと詳しく → Claudeスキルの作り方と使い分け

09

hook(フック)

AIが何かをする「前」や「後」に、決まったプログラムが必ず走る仕掛けです。

CLAUDE.mdとの違いは強制力です。

性質守られるか
CLAUDE.mdAIへのお願い守らないことがある
hook仕組みとして割り込む必ず走る(※下記)

使いどころは2つだけです。

「CLAUDE.mdに書いたのに守ってくれない」という場面が出てきたら、hookに格上げする——これが本来の使い方です。最初から作る必要はありません。

※ ただし「必ず走る」には但し書きがあります 必ず走るのはhookの仕組みのほうで、中身のプログラムが壊れていたら話は別です。ファイルを置き場所から動かした、名前を書き間違えた——それだけで、何も言わずにそのまま通ります。公式にも「パスを間違えた見張りは、全部素通りさせる」と書かれています。
つまり「止める」ために入れたhookほど、壊れたときが危ないのです(止めてくれていると思い込むため)。壊れたときに止まるよう設定する方法と、ちゃんと動いているか確かめる方法は、下のリンク先にあります。

もっと詳しく → ルールをAIに守らせる3つの道具(.md・lint・hook)

10

サブエージェント

別室で働いてもらう助手です。調べ物や下読みのような、量は多いが結果だけ欲しい作業を任せます。

いちばんの利点は、本体の会話が散らからないことです。助手は自分の机(別の作業領域)で作業し、結果だけを持ち帰ります。途中の大量のやり取りは、こちらの机に載りません。

もっと詳しく → サブエージェント入門(別室の助手)

PART 4 / 4

つなぐ・守るのはなし

外のサービスとつなぐとき、必ずセットで出てくる言葉です。

11

MCP・コネクタ/APIキー・.env・deny

MCP・コネクタ

どちらもAIと外部サービス(Google ドライブ、Notion、GitHubなど)をつなぐ仕組みです。つなぐと、AIがそのサービスを直接読み書きできるようになります。

言葉としては、コネクタ=設定画面からクリックでつなぐもの、MCP=その裏側にある共通の規格、と押さえておけば十分です。

APIキー・.env・deny

言葉ひとことで
APIキー・トークンサービスに入るためのカギ。パスワードと同じ扱い
.env(ドットエンブ)そのカギをまとめて置いておく専用ファイル
deny(デナイ)「読ませない・触らせない」と封印する設定

この3つは必ずセットで出てきます。「.envにカギを置き、Claude Codeにはその.envを読ませない(deny)」と設定すると、作る本人であるAIはカギを見ないのに、出来上がったツールはカギを使ってちゃんと動く——という状態になります。

denyは"お願い"ではありません CLAUDE.mdと違い、denyは読む行為そのものをブロックします。しかもどのレベルで設定されていても、他のどこからも解除できません(公式に明記)。だから安心して厳しめに設定できます。

もっと詳しく → API・APIキー入門/AIの第二の脳を作る/Google DriveとClaude Codeの連携ガイド

まとめ

一覧 — どの言葉が、いつ必要になるか

ここまでの11項目を1枚にまとめました。右の列が、その言葉が必要になる場面です。全部を今すぐ覚える必要はありません。「この場面が来たら、この言葉を思い出す」——この表はそのために使ってください。

言葉ひとことで必要になる場面
権限モードどこまで勝手にやらせるかいちばん最初。1回だけ設定
作業フォルダAIに見せる範囲いちばん最初。開く場所を決めるとき
.mdAIが読み書きしやすい文書作ったものを見るとき
CLAUDE.mdAIへのルール同じ指示を2回言ったとき
メモリAIが覚えたこと「前に言ったよね?」となったとき
セッション会話のひとまとまり話が長くなってきたとき
スラッシュコマンドよく使う操作の呼び出し慣れてきたとき
スキル頼み方の保存同じ作業を2回以上やったとき
hook必ず走る仕掛けルールを守ってくれないとき
サブエージェント別室で働く助手調べ物や大きい作業を任せたいとき
MCP・コネクタ外部サービスとの接続Drive・Notion等とつなぎたいとき

番外

ツールをまたいだ全体図 — AIエージェント活用の基礎

ここまでの言葉は、Claude Codeだけのものではありません。OpenAI(Codex)やCursorでも、ほぼ同じ部品が、同じ役割で出てきます。X(旧Twitter)で公開されていた1枚の図が、部品どうしの関係を「会社の仕事」にたとえてよくまとめていたので、出典つきでそのまま載せます。

AIエージェント活用の基礎(OpenAI・Claude・Cursorのロゴつき)。左列に、人の指示=今回頼む仕事、Automation=自動で始める入口、Agent=仕事を進める実行役、Sub-agent=別室の担当者。Agentから右列へ、毎回読むAGENTS.md=新入社員マニュアル、条件付きのRules=部門別・テーマ別マニュアル、テーマごとのSkill=再現したい仕事の手順(SKILL.md・references/assets・examples・scripts)、必要時に開くWiki=必要なときに開く図書館。下段に、Hooks=自動チェックを差し込む仕組み、Connector/MCP=外部ツールとの接続口、Plugin=手順や設定をまとめて配る箱
図|AIエージェント活用の基礎 — 11の部品と、そのつながり(画像をタップすると原寸で開きます)
図の文字おこし(画像の文字が小さいとき用)

AIエージェント活用の基礎(右上にOpenAI・Claude・Cursorのロゴ)

部品書いてあること
【左列】頼む・始める・進める・任せる
人の指示 = 今回頼む仕事対象・目的・完成条件を渡す。何を作り、どんな状態なら完成かを具体的に伝える。
形式・確認項目・保存先まで伝えると、AIが終わりを判断しやすい。現状と理想の差を言葉にする。
Automation = 自動で始める入口決まった時刻や、Slack・GitHubなどの出来事をきっかけに、依頼した仕事を起動する。
クラウドで動くものはPCを閉じても進む。端末内で動かす定期実行は、PCが止まると止まる。
まず手動・ローカルで成功させ、対象・実行タイミング・結果の保存先を固めてから自動化する。
↓ 指示・きっかけで起動
Agent = 仕事を進める実行役指示を受けて資料を読み、作り、結果を確かめる本人。共通の前提と、今回の仕事に合う手順を参照して動く。
複雑な仕事はPlanで進め方を壁打ちし、Agentで実行する。手順はSkillへ寄せ、必要な情報をその都度読む。
〔例〕同じ実行役が、議事録を作るときは議事録Skillを、文章を確認するときはレビューSkillを使う。
初めての仕事はSkillがなくても始められる。良い出力になったやり方を、あとから手順として残す。
任せる ↓ / ↑ 結果・根拠を返す
Sub-agent = 別室の担当者Agentから切り出された調査・作成・レビューなどを担当する補助AI。別の会話で集中し、結果を本体へ戻す。
渡すのは、役割・対象・使ってよい資料や道具・返してほしい結果。別の目で見られ、本体の会話を散らかしにくい。
〔例〕レビュー担当は1体にして、内容・書式・抜け漏れなど、観点別のレビューSkillを持たせる。
Skillは「知識・レシピ」、Sub-agentは「担当者」。まず1つで試し、足りなければ作成とレビューを分ける。分業すると使用量と時間も増える。
【右列】Agentが参照するもの(読むタイミング:毎回読む/条件付き/テーマ/必要時)
AGENTS.md = 新入社員マニュアル
(毎回読む)
毎回説明している仕事の前提を、短い文章で残すもの。目的・やらないこと・用語・読む資料・保存場所を伝える。
長い説明をすべて詰め込まず、200行未満を目安に必要な前提へ絞る。末尾には「いつ、どれを読むか」の目次を置く。
〔例〕「元の会議メモは変更しない」「決まっていないことを決定にしない」「完成した議事録は指定先へ保存する」
CursorはAGENTS.mdを読む。Claude CodeではCLAUDE.mdから「@AGENTS.md」で共通指示を参照する運用にできる。矛盾・追記案は人が判断して整理する。
Rules = 部門別・テーマ別マニュアル
(条件付き)
特定のファイル・フォルダ・場面に合う、詳しい守りごと。共通前提を長くする代わりに、必要なルールを分ける。
対象を指定したルール:Cursorでは、対象ファイルを読むときに適用する。例:資料を読むときは「原文と解釈を混ぜない」。
対象指定なしのルール:Cursorでは開始時から常に読む。共通前提と重複させず、条件付きとの違いを意識する。
1ルール1ファイルを基本にする。どこへ追記するか、同じ内容が二重になっていないかは人が決める。
Skill = 再現したい仕事の手順
(テーマ)
いつ使うか・何を入力するか・どう進めるか・何を完成とするか・どの資料を参照するかを、ひとまとまりにする。
名前と説明文(name・description)で仕事に合うSkillが選ばれる。「/名前」で明示的に呼ぶこともできる。呼ばれないときは、まず名前と説明文を見直す。
SKILL.md|本体:役割・使う場面・入力・手順・完成条件を書く。まずはこれだけで始める。
references / assets|参考資料・素材:判断の根拠や用語集、書式・テンプレートを必要なときだけ読む。
examples|良い出力の模範例:「この入力なら、この出力」を見せ、文体や仕上がりの粒度を伝える。
scripts|成功した処理のコード:集計・変換・命名など、決まった処理を繰り返し使う。
〔例〕思考のSkill:戦略・アイデア。実行のSkill:作成とレビュー。記憶のSkill:Wiki追記・ログ・成果物保存。
最初はSkillなしで仕事を任せ、うまくいった会話の続きで「このやり方をSkillにして」と頼む。新しい会話で再現を確かめ、修正案を人が確認して育てる。
Wiki = 必要なときに開く図書館
(必要時)
案件・商品・顧客・過去の判断・資料の所在など、調べるための情報置き場。AIの行動を決める指示とは役割が違う。
毎回すべて読むのではなく、AGENTS.mdやSkillの案内から、必要なページをたどる。
〔例〕議事録を作るときに、関連する用語や過去の決定を参照する。長い知識を共通指示へ丸ごと貼り付けない。
【下段】仕組みとして足す・つなぐ・配る
Hooks = 自動チェックを差し込む仕組み
(↑ 設定した場面で自動検査)
「もし、このタイミングになったら、この処理をする」を仕組みとして組み込む。AIの判断に任せず、設定したタイミングで必ず呼び出す。
動く場面と処理の例:編集後:書式・形式・動作を確認する。/外部送信や危険操作の前:機密情報や操作範囲を検査する。/作業を終える前:保存結果を確かめ、ログを残す。/完了時:通知を出す。
ルール・レビューとの関係:AGENTS.mdやSkillはAIが読んで守る指示。Hooksは決めた処理を動かす仕組み。
内容の良し悪しは別担当のレビューとも組み合わせる。まず通知など小さい処理から始め、必要なものだけ足す。
Connector / MCP = 外部ツールとの接続口
(↑ 許可された外部情報を読み書き)
Agentが外部サービスの情報を直接読み、必要な操作を行うための仕組み。MCPは、AIと外部ツールをつなぐ共通規格。
つなぐと扱える情報の例:Slack:やり取りを読み、返信の下書きを作る。/Googleドライブ:成果物を保存・参照する。/Notion:社内ドキュメントや案件の進み具合を参照・更新する。
手順と接続は別の役割:何をどうするかはSkill。どのサービスを読み書きするかをつなぐのが接続口。
会社が認めた接続先・アカウント・操作範囲で使う。読み取りと書き込みを分け、鍵や認証情報は共有する設定へ書かない。
Plugin = 手順や設定をまとめて配る箱
(↑ 複数の仕事場へ同じ環境を配布)
Skill・Sub-agent・Hooks・MCPなどを1つにまとめ、複数のチームや仕事場へ同じ環境を配るための単位。
いつ使う?:同じ作業フォルダを共有する仲間には、その共有で手順が届く。別のチームや複数のフォルダへ展開する段階で、配布用にまとめる。
入る中身はツールで違う:CursorのプラグインはRulesも同梱できる。Claude CodeはCLAUDE.md・Rulesを同梱しない。AGENTS.mdはどちらも入れない。
〔例〕手順はSkillに、担当の役割はSub-agentに、自動処理はHooksに、接続先はMCPに分け、その組み合わせを配る。
まず1つの仕事場で試し、うまく動く中身をまとめる。外部配布のSkillやプラグインは、出典と内容を確認してから導入する。

この資料の項目との対応

図の言葉と、この資料(Claude Code)での呼び名を並べました。名前が違っても、役割は同じです。

図の部品Claude Codeではこの資料・関連教材
人の指示あなたが打つ依頼文(プロンプト)プロンプトの作り方/AIに仕組みを作らせるコツ
Automation定期実行(Desktopの定期タスク・/schedule など)定期実行の選び方
AgentClaude Code本体(Planで壁打ち=権限モードのPlan)01 権限モード
Sub-agentサブエージェント10 サブエージェント
AGENTS.mdCLAUDE.md(中で @AGENTS.md と書けば読み込める)04 CLAUDE.md
Rules.claude/rules/ に分けたルール04 CLAUDE.md の仲間(下の注記を参照)
Skillスキル08 スキル
Wiki第二の脳(調べるための知識置き場)AIの記憶と第二の脳のつくり方
Hookshook09 hook
Connector / MCPMCP・コネクタ11 MCP・コネクタ
Pluginプラグイン(この資料では扱っていません)
図の中の「ツールごとの違い」— どこまで確かめたか Claude Codeについての記述は、公式ドキュメントで確認しました(2026-11-06)。
・CLAUDE.mdから @AGENTS.md と書いて共通指示を読み込める → 公式に記載あり(memory)
・「200行未満を目安に」→ 公式の推奨は「CLAUDE.md 1ファイルあたり200行未満」。打ち切りではなく目安です(04参照)
・Rules にあたるものは .claude/rules/。対象ファイルを指定したルール(paths)はそのファイルを読み書きしたときに読み込まれ、指定なしのルールは開始時からCLAUDE.mdと同じ扱いで読まれる → 公式に記載あり(memory)。図の「対象指定あり/なし」の2種類は、Claude Codeにもそのまま当てはまります
・プラグインにCLAUDE.mdは入らない → 公式に「プラグインの直下にCLAUDE.mdを置いても読み込まれない。指示を入れたいならスキルにする」と記載(plugins-reference)。Rules については明記が無く、プラグインに入れられる部品の一覧にもありません
Cursorについての記述(AGENTS.mdを読む・ルールの種類・プラグインにRulesを同梱できる)は、まだ公式で裏取りしていません。Cursorを使う場合は、Cursorの公式ドキュメントで確かめてから使ってください。

出典:X投稿(2026-11-05)https://x.com/yoshio_nocode/status/2118311427832500601
※図は上記投稿の画像を転載(文字おこし・対応表・確認メモは本教材で追加)。同じ投稿の事業管理の図3枚は → 会社OSとFDE(CHAPTER 8)

次へ

この先の順番

言葉が分かったら、あとは順番に手を動かすだけです。全部を今やる必要はありません。

教材の並び順は → Claude Code 導入ロードマップの「教材の地図」/全体の現在地は → 順路