この記事ではAIエージェントに特化して解説します。AIエージェント全般は AIエージェントフレームワーク比較2026年版 をご覧ください。
何が起きたか
Claude Codeの動作を制御する「.claude/」フォルダの内部構造がDaily Dose of Data Scienceで詳細に解説された。指示内容、カスタムコマンド、権限ルール、セッション間メモリを一元管理する中枢である。
2つのディレクトリ構造
.claude/フォルダはプロジェクトレベルとグローバルレベルの2階層で構成される。
| レベル | パス | 管理方法 | 用途 |
|---|---|---|---|
| プロジェクト | プロジェクトルート/.claude/ |
Git管理（チーム共有） | プロジェクト固有の設定・ルール |
| グローバル | ~/.claude/ |
ローカル管理（個人用） | 個人の設定・セッション履歴・自動メモリ |
プロジェクトレベルのフォルダをGitリポジトリに含めることで、チーム全員が同一のルールと設定で運用できる。グローバルレベルには個人のCLAUDE.md、セッションの記録、プロジェクトごとの自動メモリ、個人用コマンドやスキルが保存される。
コアコンポーネント
CLAUDE.md: ビルド・テスト・リントのコマンド、アーキテクチャ概要、コーディング規約を記述する主要指示ファイル。200行以内が推奨。
CLAUDE.local.md: 個人用オーバーライドファイル。自動的に.gitignoreされる。
rules/ディレクトリ: 関心事ごとに分割したモジュール型指示ファイル群。YAMLフロントマターでパススコーピングが可能。
commands/ディレクトリ: /project:reviewのようなスラッシュコマンドを定義。バッククォート構文でシェルコマンドの埋め込みが可能。
skills/ディレクトリ: YAMLフロントマターで自動起動条件を定義する自動実行型ワークフロー。関連ファイルをバンドルして格納可能。
agents/ディレクトリ: 隔離されたコンテキストウィンドウを持つ特化型サブエージェント。モデル選択とツールアクセスの制限を設定可能。
settings.jsonによる権限制御
settings.jsonでClaude Codeの実行権限をallow/denyリストで制御する。npm run *等の安全なコマンドをAllowに、rm -rfや.envアクセスをDenyに設定。未登録コマンドは実行前に確認プロンプトが表示される。
導入アプローチ
推奨される順序は、CLAUDE.md → settings.json → カスタムコマンド1〜2個 → rules/skills/agentsの段階的な追加である。
参考リンク
この記事はAI業界の最新動向を速報でお届けする「AI Heartland ニュース」です。
