.claudeディレクトリの役割 | 仕組み解説

Claude Codeを使い込むと、.claude ディレクトリという設定場所が出てきます。ここには、プロジェクト固有の設定や拡張ルールを置けます。

一言でいうと

.claudeディレクトリは、Claude Codeのプロジェクト固有設定や拡張を整理する場所です。

プロジェクトによって構成は異なりますが、次のようなファイルやディレクトリが関係します。

.claude/
  settings.json
  settings.local.json
  rules/
  skills/
  agents/

settings.local.json は個人の環境に依存する設定に使います。チームで共有しない情報を入れる場所です。

たとえば、ローカルだけの許可設定や個人の作業環境に関する内容は、共有設定に入れない方が安全です。

個人用設定や秘密情報に近いものは、Gitにコミットしない設計にします。

.claude/rules/ は、指示を細かく分けたいときに使います。

.claude/rules/
  frontend.md
  backend.md
  security.md

大きな CLAUDE.md に全部を書くより、領域ごとに分けると保守しやすくなります。

.claude/skills/ は、特定タスクの進め方をまとめる場所です。

たとえば、PRレビュー、リリース作業、障害調査など、毎回は使わないけれど手順が決まっている作業に向いています。

.claude/agents/ は、特定の役割を持つサブエージェントを定義する場所です。

例として、レビュー担当、テスト担当、設計確認担当のように役割を分けられます。

.claude ディレクトリは、Claude Codeの設定や拡張を整理する場所です。常に必要な短い指示は CLAUDE.md、分割ルールは rules、特定タスクの手順は skills、役割分担は agents に置くと整理しやすくなります。