Claude Codeにおける.claude/フォルダは、プロジェクト単位のエージェント設定を格納するディレクトリである。このフォルダをリポジトリに配置することで、Claude Codeの動作をプロジェクトごとにカスタマイズできる。従来は断片的な情報しかなかったが、設定ファイル体系の全容が整理されつつある。
.claude/フォルダの中核を担うのがCLAUDE.mdファイルである。プロジェクトルートまたは.claude/配下に配置し、コーディング規約・ファイル構造・禁止事項などをMarkdownで記述する。Claude Codeは会話開始時にこのファイルを自動で読み込み、指示に従って動作する。複数階層での配置も可能で、ディレクトリごとに異なるルールを適用できる。
.claude/commands/ディレクトリには、スラッシュコマンドとして呼び出せるスキルを定義する。各.mdファイルが1つのコマンドに対応し、プロンプトテンプレートとして機能する。変数展開やファイル参照にも対応しており、繰り返し実行するタスクの自動化に適している。詳細な仕組みについてはClaude Skills解説を参照されたい。
.claude/agents/には、特定の役割を持つエージェント定義を配置する。SEO分析・コードレビューなど専門的なタスクをエージェントとして分離できる。また、.claude/settings.jsonではツールの許可リストやモデル設定など、プロジェクト全体に適用される設定を管理する。これらはチームメンバー間で共有可能であり、Git管理の対象となる。
.claude/フォルダ内にはメモリ関連のファイルも格納される。会話中に得たフィードバックや学習内容が自動的に記録され、次回以降の会話で参照される。プロジェクト固有のメモリとユーザー固有のメモリが分離されており、チーム開発における情報共有と個人設定の両立が図られている。
.claude/フォルダの構造を正しく理解することで、Claude Codeを単なる対話ツールではなくプロジェクト専用のAIエージェント基盤として活用できる。設定のバージョン管理・チーム共有・タスク自動化の3点が、この仕組みの主要な利点である。
この記事はAI業界の最新動向を速報でお届けする「AI Heartland ニュース」です。