コンテンツにスキップ

Claude Skills・Prompts・Projects・Subagents・MCPの違いと使い分け入門ガイド

Claude Code を使いこなすには、5つの仕組み（Skills、Prompts、Projects、Subagents、MCP）の違いを理解することが重要です。この記事では、企業内でClaude導入を任されたエンジニア向けに、それぞれの役割と導入ステップを解説します。

この記事の対象者

  • Claude Codeを触り始めた個人開発者・テックリード
  • 企業内でClaude導入を任されたエンジニア・SRE
  • Promptsだけ使っているが
  • Projects/Skills/MCPにまだ手を出せていない方

5つを一言でまとめると

仕組み一言説明
Promptsその場で投げる「口頭指示」
Skills何度も使う「標準手順書」
Projects資料と履歴がまとまった「案件フォルダ」
Subagents役割と権限を持つ「専門家メンバー」
MCP社内システムやSaaSとつなぐ「配線」

迷ったときの判断基準

  • 一回きりの相談 → Prompts
  • 毎回同じ手順を説明している → Skills
  • 特定プロダクト／案件の話が続く → Projects
  • 役割ごとに権限分けしたい → Subagents
  • GitHubやDBに直接アクセスさせたい → MCP

Skillsとは：手順書と専門知識のフォルダ

繰り返し実行する作業手順や専門知識を再利用可能な形でまとめる仕組みです。指示・メタデータ・スクリプト等のリソースをパッケージ化し、必要なときだけ段階的にロードされるため、コンテキスト節約（プログレッシブディスクロージャ）が可能です。

活用例: セキュリティチェック手順、デプロイ手順、コーディング規約の確認

最初の一歩

  1. Claude Codeのリポジトリ直下に .claude/skills ディレクトリを作成
  2. SECURITY_REVIEW.skill.md のようなファイルを1つ作り、「いつ・どんなコードに・どうチェックするか」をテンプレ化
  3. そのSkillが実際に呼び出されるまでのログをClaude Code側で確認

よくある失敗

Skillsを増やしすぎて管理不能になる。最初は3〜5個に絞り、実際に繰り返し使うものだけを昇格させる

Promptsとは：その場限りの指示

会話の中で直接与える一回限りの指示です。即座に実行でき柔軟な指示が可能ですが、保存されません。

活用例: 「このコードをPython 3.12対応に書き換えて」「この関数のテストケースを3つ作成して」

最初の一歩

  • まずはPromptsだけで運用し、毎回同じ説明を繰り返していることに気づいたらSkillsに昇格させる

ポイント

同じ作業を3回以上繰り返す場合はSkillsまたはProjectsへの昇格を検討しましょう

Projectsとは：知識ベース付きワークスペース

プロジェクト固有の知識や文脈を持つワークスペースです。会話履歴と文脈を保持し、長期間続く開発で過去の意思決定を参照できます。200Kコンテキスト＋RAG連携でプロジェクト知識を拡張できる点が特徴です。

活用例: API仕様書の管理、設計ドキュメントの保存、実装方針の議論履歴

最初の一歩

  1. Claudeの左メニューから Projects を作成
  2. そのプロジェクトで使う仕様書／README／設計ドキュメントを3〜5個だけアップロード
  3. 「このプロジェクトでは◯◯の観点を重視する」といった instructions を1つだけ追加して挙動を試す

よくある失敗

Projectsに何でもかんでも突っ込んで検索性が落ちる。関連性の高い資料だけに絞る

Subagentsとは：専門家チームとしてタスクを分割する仕組み

特定の専門領域に特化した複数のAIエージェントを組み合わせる仕組みです。それぞれが独立したコンテキストとツール権限を持つため、単なる「役割ラベル」ではなく、権限設計の単位として機能します。

活用例: フロントエンド・バックエンド・テストの分業、複雑な機能の並列開発

最初の一歩

  1. Claude Code利用時に、テスト実行や静的解析だけを任せるSubagentを1つ作ってみる
  2. 権限を限定的に設定し、予想外の動作を防ぐ
  3. 動作ログを確認し、権限設計を調整

よくある失敗

Subagentsを細かく作りすぎて挙動が読めなくなる。シンプルな作業では単一のPromptの方が効率的

MCPとは：外部システムへの接続レイヤー

外部のデータベースやAPIと連携するための接続レイヤーです。Claude単体ではアクセスできない外部データやシステムと連携できます。オープン標準であり、Claude以外のクライアントからも利用でき、複数ツールとの連携を単一プロトコルにまとめられます。

活用例: GitHub API連携、データベースアクセス、クラウドサービス統合

最初の一歩

  1. 公式MCPサーバー（例: @modelcontextprotocol/server-filesystem）を1つだけインストール
  2. Claude Codeの設定ファイルにサーバー情報を追加
  3. 簡単なファイル操作から試してみる

よくある失敗

MCPに何でもつなぎすぎてガバナンスが破綻する。最初は読み取り専用から始める

5つの仕組みの違いを比較する

何を保持するか／どこまで持続するか

仕組み何を保持するかどこまで持続するか
Prompts会話1ターン分の文脈1チャット内のみ
Skills手順・ノウハウ・スクリプト全プロジェクト横断で再利用
Projects資料・履歴・設定プロジェクト単位で継続
Subagents役割プロンプト＋権限エージェント単位で継続
MCP接続先の定義サーバー・クライアント間で継続

シナリオ別の使い分け

シナリオ推奨する仕組み
単発の質問Prompts
繰り返す作業Skills
長期プロジェクトProjects
複雑なタスク分業Subagents
外部システム連携MCP

これらの仕組みは組み合わせて使えます。ProjectsにSkillsを組み込み、MCPで外部データを取得しながら、Subagentsで並列作業を実行することも可能です

どこから始めるか：導入ステップ

  1. Step 1: Promptsだけで運用してみる まずはチャット＋Projectsで会話しながら、繰り返す作業を洗い出す

  2. Step 2: 繰り返す作業をSkillsに昇格させる 毎回打っている長文プロンプトを洗い出し、Skillsに昇格させる

  3. Step 3: 長期案件・チーム案件をProjectsで分離 仕様書・README・設計書を集約し、プロジェクト固有の文脈を保持

  4. Step 4: Subagentsで権限分離／並列化を入れる テスト実行や静的解析だけを任せるSubagentを1つ作り、権限設計を学ぶ

  5. Step 5: MCPで社内システム・外部SaaSと接続 既存のGitHub / DB / SaaSをMCPで接続し、「本番ワークフロー」に組み込む

まとめ

5つの仕組みを状況に応じて使い分けることで、Claude Code を効率的に活用できます。まずは単純なPromptsから始め、繰り返す作業をSkillsに昇格させ、プロジェクトが大きくなったらProjectsとMCPを活用しましょう。

参考リンク

公式ドキュメント

関連記事