ほとんどの開発者は、セットアップを飛ばしていきなり使い始めます。
それが最初の失敗です。
Claude Code を本当に使いこなすには、`.claude/` フォルダを「プロジェクトのインフラ」として設計する必要があります。
この記事では、開発者 @akshay_pachaar が図解でまとめた `.claude/` フォルダの構造を元に、各パーツの役割と使い方を整理します。
まず、この投稿を見てください
`.claude/` フォルダの全体像
構造はこうなっています。
それぞれの役割を順に説明します。
CLAUDE.md：チームへの指示書
リポジトリにコミットするので、チーム全員が同じ指示を共有できます。
内容が増えてきたら、`rules/` フォルダに分割して管理するのが推奨です。
settings.json：権限の柵
たとえば、機密情報が入ったフォルダを読ませない、本番反映コマンドを自動実行させない、といった制御をここで行います。
ルールより先に物理的な柵がある方が事故は減ります。`CLAUDE.md` で「触らないで」と書くより、`settings.json` で塞ぐ方が確実です。
commands/：くり返し作業をコマンド化する
毎回同じ手順を踏む作業（コードレビュー・デプロイ確認など）を、コマンド一発で呼び出せます。
rules/：ルールをモジュールで管理する
コーディングスタイル、テスト方針、API規約など、テーマごとに分けて管理できます。
skills/ と agents/：自律化を進める
どこから始めるか
すべてを一度に作る必要はありません。
まず `CLAUDE.md` と `settings.json` だけ作る。それだけで、Claude が何をしてよくて何をしてはいけないかが決まります。
まとめ
| パーツ | 役割 | コミット |
|---|---|---|
| CLAUDE.md | チームへの指示書 | する |
| CLAUDE.local.md | 個人用の上書き | しない |
| settings.json | 権限設定 | する |
| settings.local.json | 個人用の権限設定 | しない |
| commands/ | スラッシュコマンド | する |
| rules/ | モジュール化されたルール | する |
| skills/ | 自動起動ワークフロー | する |
| agents/ | サブエージェント定義 | する |
セットアップを飛ばすと、Claude は毎回ゼロから始めます。`.claude/` フォルダを整えると、Claude はプロジェクトを知った状態でスタートします。
