← 教材一覧へ戻る

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

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は「お願い」であって、強制力はありません(公式に明記)。たいていは守りますが、守らないこともあります。絶対に守らせたいことは、この後に出てくるhookdenyという別の仕組みを使います。

もう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:記事作成)、作業中のファイルに応じて使い分けられます。上書きされるのは「パーソナル対プロジェクト」のように段をまたぐときだけです。

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

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

09

hook(フック)

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

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

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

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

「CLAUDE.mdに書いたのに守ってくれない」という場面が出てきたら、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等とつなぎたいとき

次へ

この先の順番

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

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