【Anthropic公式】Claude Codeへの指示の出し方|CLAUDE.md・スキル・サブエージェントの使い分け完全ガイド

※本記事にはプロモーション(アフィリエイト広告)が含まれます。

「Claude Codeに毎回同じ説明を繰り返している」「タスクが大きくなると精度が落ちる」——そんな悩みはありませんか。開発元のAnthropicは、Claude Codeへの指示の出し方としてCLAUDE.md・スキル・サブエージェントなどの仕組みを公式に解説しており、国内メディアでも大きく取り上げられています。本記事ではこの3つの仕組みの違いと使い分けを、初心者にもわかりやすく整理します。

結論:役割は「憲法・手順書・専門家チーム」

3つの仕組みは役割がまったく異なります。ざっくり言えば、CLAUDE.mdは常に守らせる「憲法」、スキルは特定作業の「手順書」、サブエージェントは仕事を任せる「専門家チーム」です。この整理さえ頭に入れば、どこに何を書くべきか迷わなくなります。

CLAUDE.md:全セッション共通のルール

CLAUDE.mdはプロジェクト直下に置くテキストファイルで、Claude Codeは会話の開始時に毎回自動で読み込みます。「日本語で丁寧に書く」「変更後は必ずテストを実行する」といった、どんなタスクでも守るべきポリシーを書く場所です。逆に、個別タスクの手順まで詰め込むとファイルが肥大化し、毎回のコンテキストを圧迫してしまう点には注意が必要です。

スキル(SKILL.md):繰り返し作業の手順書

スキルは「.claude/skills/スキル名/SKILL.md」というファイルを置くだけで作れる仕組みです。冒頭のYAML部分にname(スキル名)とdescription(いつ使うか)を書き、本文に手順をまとめます。スラッシュコマンド(/スキル名)で手動起動できるほか、descriptionにトリガー条件を具体的に書いておけば、タスク内容に応じてClaudeが自動で呼び出してくれます。Anthropicは「1日に複数回行う作業はスキルに変換する」ことを推奨しています。

サブエージェント:コンテキストを汚さない分業

サブエージェントは「.claude/agents/」にMarkdownファイルを置いて定義する、独立したコンテキストで動く作業者です。コードベースの調査やレビューといったタスクを切り出して任せることで、メインの会話をクリーンに保ち、トークン消費も抑えられます。Anthropicは「10以上のファイル探索が必要な場合」「3つ以上の独立した作業を含む場合」がサブエージェント活用を検討すべきシグナルだとしています。

3つの仕組みの比較表

仕組み 置き場所 読み込みタイミング 向いている用途
CLAUDE.md プロジェクト直下 毎会話の開始時(常時) 全タスク共通のルール
スキル .claude/skills/ コマンド実行時・自動呼び出し時 繰り返す定型ワークフロー
サブエージェント .claude/agents/ タスク委任時 大規模調査・並列作業・レビュー

正直なデメリット・注意点

  • 最初から作り込むと挫折しやすい:Anthropic自身も「まず会話で指示し、繰り返しパターンが見えてから自動化する」段階的な進め方を勧めています。
  • サブエージェントの乱用は逆効果:小さなタスクまで分割するとかえってトークンを浪費し、コストと待ち時間が増えます。
  • スキルの自動発動は調整が必要:descriptionの書き方に発動精度が左右されるため、期待どおり動くまで試行錯誤が要ります。

よくある質問(FAQ)

Q. プログラミング未経験でも使えますか?

A. CLAUDE.mdもSKILL.mdもただのテキストファイルなので、書くこと自体に専門知識は不要です。ただしClaude Codeはターミナル操作が基本のため、最低限のコマンドライン知識があるとスムーズです。

Q. 3つとも使う必要はありますか?

A. ありません。まずCLAUDE.mdに共通ルールを書くだけでも体感は大きく変わります。慣れてきたら頻出作業をスキル化する、という順番がおすすめです。

Q. 追加料金はかかりますか?

A. これらの仕組み自体は無料ですが、Claude Codeの利用にはClaudeの有料プランまたはAPI利用料が必要です。

あわせて読みたい

体系的にプログラミングを学びたい方へ

Claude Codeのようなコーディングエージェントは、基礎のプログラミング知識があるほど使いこなせる幅が広がります。AIの出力を正しく評価できる土台を作りたい方は、買い切り型で質問し放題のオンライン教材「スキルハックス」もチェックしてみてください。

【広告】スキルハックスの詳細はこちら

おすすめの記事