概要
https://qiita.com/fujisho1216/items/90b34ef9abd910deb6ac
詳細内容
## Claude Codeの各機能（CLAUDE.md/サブエージェント/スラッシュコマンド/エージェントスキル）の役割と使い分けガイド
https://qiita.com/fujisho1216/items/90b34ef9abd910deb6ac
整理 Claude Codeにおける4つの主要機能の役割を定義し、プロジェクトの文脈管理と作業効率を最大化するための具体的な使い分け基準を提示する。
**Content Type**: ⚙️ Tools
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:3/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 81/100 | **Annex Potential**: 77/100 | **Overall**: 80/100
**Topics**: [[Claude Code, AIエージェント, CLAUDE.md, 開発ワークフロー, コンテキスト管理]]
著者は、急速に進化し機能が拡張され続ける「Claude Code」において、各機能の境界が曖昧になりつつある現状を整理し、エンジニアが迷わずにツールを使いこなすための判断基準を示している。本記事の核心は、単なる機能紹介ではなく、AIエージェントに「いつ、何を、どのように」教えるべきかという戦略的な使い分けの提示にある。
まず、**CLAUDE.md**はプロジェクトの「前提知識・憲法」として位置づけられる。コーディング規約やテスト手順など、開発中に常に遵守すべきプロジェクト固有のコンテキストを記述する。著者は、このファイルが肥大化して可読性が下がるのを防ぐため、`.claude/rules/`を用いてルールをモジュール化する手法を推奨しており、これは大規模なプロジェクトを扱うエンジニアにとって極めて実用的なアドバイスとなっている。
次に、**サブエージェント**は「専門特化型の分身」として定義される。最大の特徴は、メインの会話履歴（コンテキスト）から切り離された独立した環境で動作する点にある。著者は、サブエージェントの利用意義として、メインのトークン消費を節約できること、ノイズを排除できること、そして並列処理が可能であることを挙げている。これは、複雑な調査タスクをメインの思考プロセスを汚さずに外出ししたい場合に不可欠な戦略となる。
一方、**スラッシュコマンド**と**エージェントスキル**は、共に「タスク実行の手順」を定義するものだが、著者はその「起動トリガー」と「複雑性」で明確に区別している。スラッシュコマンドは、エンジニアが手動で明示的に呼び出す「定型作業のショートカット」であり、単純なレビューやコミットメッセージ生成などに適している。対してエージェントスキルは、Claudeが文脈に応じて自動的に呼び出す「包括的な機能」である。複数のステップや外部スクリプトを必要とする複雑なワークフロー（例：特定の分析手順やドキュメント生成フロー）をスキルとして定義することで、エージェントの自律的な問題解決能力を底上げできると主張している。
最後に、著者は「Claude Codeの設定に正解はない」と前置きしつつも、これらの機能を適切に配置することで、AIとの協業効率が劇的に向上することを強調している。開発ワークフローの中にこれらの機能をどう組み込むかという「設計思想」を持つことの重要性が、本記事を通じて説かれている。これはAI coding assistantを単なるチャットツールとしてではなく、高度な自動化プラットフォームとして運用したいWebアプリケーションエンジニアにとって、非常に有益な知見である。