CLAUDE.md・サブエージェント・スキル・コマンドの使い分けガイド

記事内に広告を含みます

この記事には広告を含む場合があります。
記事内で紹介する商品を購入することで、当サイトに売り上げの一部が還元されることがあります。

CLAUDE.md・サブエージェント・スキル・コマンド——使うほど、なぜか準備で疲れていませんか。

Claude Codeを使い始めた頃、すべてがメインチャットで完結していた。

シンプルで分かりやすかった。

ところが使い込むうちに、CLAUDE.mdを知り、コマンドを覚え、スキルやサブエージェントという概念に出会いました。

便利になるはずが、「これはどこに書くべき？」「この処理はコマンド？スキル？」と、なぜか迷う時間が増えていきました。

気づけば、Claudeに指示を出す前の「準備」で疲れてしまっている。

もしあなたが同じような状況にいるなら、この記事が役に立つかもしれません。

今回は、私自身が混乱から抜け出すために整理した「使い分けの考え方」を共有したいと思います。

この記事でわかること

CLAUDE.md・コマンド・スキル・サブエージェントを一言で整理した早見表
4機能を「前提・判断・作業」の3軸で分ける考え方
最小構成で始める3ステップ（まずCLAUDE.mdだけ→コマンド→必要なら追加）
「どこに書く？」で迷ったときの3つの質問による判断フロー

記事を書いている人

R（アール）

Web制作の現場で17年（現役進行中）。精密栄養カウンセラー。

個人開発をアプリ6本並行しながら、AIと「作る・届ける」を実験しています。

うまくいったことも、月収2,000円みたいな冴えない数字も、隠さず公開中。

教える人ではなく、少し先で転んで戻ってきた人として、あなたと同じ目線で現在地を観測していけたらと思います。

AIと「作る・届ける」の実験は、週1でメルマガにも書いています。→ のぞいてみる（限定特典つき無料）

CLAUDE.md・サブエージェント・スキル・コマンドを一言で整理
CLAUDE.mdとサブエージェントのよくある間違った使い分け
CLAUDE.md・サブエージェント・スキル・コマンドを「前提・判断・作業」で分ける
CLAUDE.md活用の最小構成おすすめ例
CLAUDE.md・サブエージェントで迷ったときの判断基準
今日からできる1アクション
参考文献
- AI・自動化の関連記事
- Claude Codeの関連記事
Git/Claude Code 使い込んでる人ほど、止まりがちです。

CLAUDE.md・サブエージェント・スキル・コマンドを一言で整理

まず、各機能の役割を一言で把握しておきましょう。

機能	一言で言うと	具体例
CLAUDE.md	前提・思想・ルール	「このプロジェクトは TypeScript で書く」「テストは必ず書く」
コマンド	呼び出しの入口	`/blog:new` で記事作成フローを開始
スキル	再利用可能な処理	「SEO最適化」「校正」などの定型処理
サブエージェント	役割を持った相談相手	「インタビュアー」「エディター」など

いかがでしょうか？

実際に使い始めると「で、この場合はどっち？」という場面が必ず出てきます。

CLAUDE.mdとサブエージェントのよくある間違った使い分け

私自身がやってしまった失敗パターンを紹介します。

失敗1：CLAUDE.mdに「すべて」を書く

「Claudeへの指示はCLAUDE.mdに書けばいい」と思い、プロジェクトのルール、よく使うコマンド、作業手順まで全部詰め込んでしまいました。

結果、CLAUDE.mdが肥大化。

Claudeの応答が遅くなり、しかも指示が多すぎて肝心なルールが埋もれてしまいました。

失敗2：コマンドとスキルを同じものだと思っていた

「どっちも処理を呼び出すものでしょ？」と混同していました。

確かに似ていますが、役割が違います。

コマンドは「入口」で、スキルは「中身」。

玄関と部屋の違いのようなものです。

失敗3：サブエージェントを作りすぎる

「役割分担すれば効率的」と考え、細かい作業ごとにサブエージェントを定義しました。

管理が大変になり、どのエージェントを呼べばいいか分からなくなりました。本末転倒でした。

Claude Codeでよくある失敗パターンでも触れていますが、「便利にしようとして複雑にする」のは典型的な落とし穴でした。

とりさん

4つもあると、どれをいつ使えばいいのか分からなくて…。全部ちゃんと覚えないとダメですか？

全部いっぺんに覚えなくて大丈夫です。僕は「前提・判断・作業」という3つの置き場所で考えるようにしたら、一気に整理できました。次から、その分け方を説明します。

CLAUDE.md・サブエージェント・スキル・コマンドを「前提・判断・作業」で分ける

混乱を抜け出すために、私は3つの軸で整理することにしました。

前提：CLAUDE.md

「Claudeが常に知っておくべきこと」を書く場所。

プロジェクトの技術スタック
コーディング規約
絶対に守るべきルール

大事なのは「毎回伝える必要があること」だけを書くことです。

一度きりの指示や、特定の作業手順は書かないことにしました。

CLAUDE.mdの育て方で詳しく記載しましたが、最初は3〜5行で十分。

使いながら育てていくのがコツだと感じています。

判断：コマンド

「何をするか決める入口」がコマンド。

ユーザーが「この作業をやりたい」と意思表示する手段です。

コマンドを実行すると、必要なスキルやサブエージェントが呼び出されます。

例えば `/blog:new tech` と打てば、「techカテゴリの新規記事を作る」という判断が伝わり、適切な処理フローが始まります。

作業：スキルとサブエージェント

「実際に手を動かす部分」がスキルとサブエージェント。

では、この2つはどう違うのか？

スキル：定型的で、毎回同じように実行される処理
サブエージェント：状況に応じて判断しながら進める処理

SEO最適化のように「決まったチェック項目を確認する」のはスキル向き。

インタビューのように「相手の回答に応じて質問を変える」のはサブエージェント向き。

CLAUDE.md活用の最小構成おすすめ例

「結局どこから始めればいいの？」という人のために。

Step 1：CLAUDE.mdだけ作る

まずはこれだけ。

markdown

# プロジェクト概要

このプロジェクトは〇〇です。

# 技術スタック

- TypeScript

- React

# ルール

- 関数には必ずJSDocを書く

これだけで、Claudeの出力がプロジェクトに合ったものになります。

Step 2：よく使う作業をコマンド化

同じ指示を3回以上繰り返したら、コマンドにする。

.claude/commands/review.md

中身は、いつも打っている指示をそのまま書けば大丈夫です。

Step 3：必要になったらスキル・サブエージェントを追加

「コマンドの中身が複雑になってきた」「役割を分けた方が管理しやすい」と感じたら、初めてスキルやサブエージェントを検討します。

最初から全部揃える必要はありません。

CLAUDE.md・サブエージェントで迷ったときの判断基準

それでも「これはどこに書く？」と迷うことがあります。

そんなときの判断基準です。

Q: 毎回Claudeに伝える必要がある？

Yes → CLAUDE.md
No → 次へ

Q: ユーザーが明示的に呼び出す？

Yes → コマンド
No → 次へ

Q: 処理は定型的？

Yes → スキル
No → サブエージェント

この順番で考えれば、大体の場合は整理できると思います。

/compactと/clearの使い分けのように、具体的なコマンドの使い方を知ると、この判断基準がより腑に落ちるようになるでしょう。

慣れないうちは複雑に感じてしまうと思いますが、ひとつづつ理解していく感じで大丈夫です。

今日からできる1アクション

最後に、今日からできることを1つ。

「次にClaudeを使うとき、CLAUDE.mdに1行だけ追加してみる」

大げさな設計はいりません。

「このプロジェクトではsnake_caseを使う」でも「日本語で返答する」でもいいです。

その1行が、Claudeとの会話を少しだけ楽にしてくれます。

そこから少しずつ育てていけばいいのです。

機能が増えて複雑に見えても、結局は「Claudeとの会話をどう設計するか」だけ。

前提・判断・作業という3つの置き場所を意識するだけで、混乱はかなり減ると思います。

Claudeを使うことが負担ではなく、本当の意味で「楽」になることでしょう。

4つの機能をどう使い分けるかは、突き詰めると「自分がどんな作業を繰り返しているか」を知っているかどうかで決まります。

道具が増えるほど、置き場所のルールを覚えることに気を取られがちです。でも本当に効くのは、自分の作業のどれが「毎回の前提」で、どれが「その場の判断」で、どれが「定型の作業」なのかを観測すること。そこが見えていれば、機能が増えても迷いません。新しい道具と付き合う前に、まず自分の手元を観測する——そこから整理は始まります。