CLAUDE.md の設定

Claude Code がプロジェクト単位で参照する設定ファイル。プロジェクトのルール・コンテキスト・制約を記述しておくことで、AI の振る舞いをカスタマイズできる。

役割

• コーディング規約・命名規則の指定
• プロジェクト固有の知識（アーキテクチャ、注意事項など）の提供
• AI に「やってはいけないこと」を明示する

配置場所と優先順位

場所	対象	優先度
~/.claude/CLAUDE.md	全プロジェクト共通（ユーザー設定）	低
<project>/CLAUDE.md	プロジェクトルート	中
<subdir>/CLAUDE.md	サブディレクトリ固有	高

プロジェクト設定と個人設定を両立させることで、チーム共有ルール（リポジトリに含む）と個人設定（.gitignore）を分離できる。

@記法による外部ファイル参照

@docs/architecture.md
@.cursor/rules/style-guide.md

仕様書・スタイルガイド・APIドキュメントなど既存ファイルをインラインで取り込める。CLAUDE.md 自体を肥大化させずに済む。

.claude/rules/ によるモジュール化

CLAUDE.md が大きくなった場合、.claude/rules/ ディレクトリにルールファイルを分割できる。

.claude/
  rules/
    coding-style.md
    testing.md
    git-conventions.md

CLAUDE.md から @.claude/rules/coding-style.md のように参照する。

/init による自動生成

/init を実行するとコードベース（パッケージファイル・ドキュメント・ディレクトリ構造）を分析し、CLAUDE.md のひな形を自動生成する。生成後は作業しながら育てていくのが理想的。

settings.json による権限制御

CLAUDE.md と並んで重要な設定ファイル。permissions セクションで操作の allow / deny を定義。

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./secrets/**)"
    ]
  }
}

• allow: 毎回の承認確認をスキップ
• deny: 操作を完全禁止（セキュリティ上重要）

書き方のポイント

• 宣言的・具体的に書く（「〜すること」より「〜しない」が効きやすい）
• プロジェクト固有の用語や略語を定義する
• 頻繁に変わる情報は書かない（セッション中に古くなる）
• 短く書く・多くのセッションで効くルールを優先する — 長文ルールはコンテキストを圧迫し読み飛ばされやすい。全セッションで効くルールほど投資対効果が高い（Claude Codeを使いこなすための個人ルール設定 より）

実践的なルール例（個人用 CLAUDE.md）

カテゴリ	例
回答スタイル	「挨拶・前置き・段階報告・絵文字禁止。結論ファースト」
ブランチ管理	「develop最新化→ブランチ切り・プッシュは明示指示のみ」
プロジェクト固有手順	サブモジュール反映コマンドなど毎回使う操作のルール化
コード説明	変更前後の意図・問題点を毎回説明させる

→ 詳細な設定例: Claude Codeを使いこなすための個人ルール設定

非エンジニア業務への応用：業務マニュアルとして

KAJI 梶谷健人 の実践モデルでは、CLAUDE.md を「最重要業務マニュアル」として位置づける。記述内容の例：

項目	記述例
役割定義	「私の経営パートナーとして、事業戦略の壁打ち、サービス設計、リサーチをサポートして」
ディレクトリ説明	各フォルダが何を意味し、どういう情報が入っているか
外部ツール連携	Notion / Google Calendar / Google Sheets との MCP 接続方法
ワークフロー定義	「おはよう」→ /daily-schedule 自動発動 など
コンテンツパイプライン	情報収集→分析→発信→効果測定→次の企画 の流れ
GitHub Issue ワークフロー	カンバンボード、WIP 上限、ラベル体系の定義

セッション開始時に自動読み込みされるため、AI は「経営パートナー」として適切にオンボードした状態で仕事を始める。

→ 詳細: Claude Code 非エンジニア活用

プロンプト設計ルールの永続化

AIの回答形式をプロジェクト全体で統一したい場合も CLAUDE.md が活用できる。

例: 推奨度付き選択肢（AIプロンプト設計） を常時有効化する場合:

選択肢にはそれぞれ、推奨度と理由を提示する

これにより毎回指示しなくても、不明点の質問が常に「選択肢+推奨度+理由」形式で返ってくる。

階層設計（フォルダごとに CLAUDE.md を配置する）

チャエン（茶圓将裕） の実践モデルでは、フォルダ単位に CLAUDE.md を配置し 4〜5 階層で管理することを推奨している。

~/work/CLAUDE.md              # ワーク全体のルール
~/work/client/CLAUDE.md       # クライアント固有のルール
~/work/client/project/CLAUDE.md  # プロジェクト固有のルール

これにより「上位ルール + 下位ルール」の多層構造で精度が上がる。詳細 → Claude Code 初期設定9選（チャエン解説動画）

関連

• Claude Code
• Claude Code Memory — Claude が自動書き込みする記憶ファイル
• Claude Code カスタムコマンド
• Claude Code 非エンジニア活用
• 推奨度付き選択肢（AIプロンプト設計）
• Claude Code 完全ガイド Ch.19-22
• Claude Code 初期設定9選（チャエン解説動画）
• Claude Codeを使いこなすための個人ルール設定 — 実践的なルール例と設定効果の実録