CLAUDE.md の @ インポート記法:別ファイルを読み込ませる書き方と注意点

CLAUDE.md が長くなってきたとき、すべてを 1 ファイルに書き続けると読みにくく、コンテキストも圧迫します。Claude Code には、@ に続けてパスを書くとそのファイルの内容を取り込むインポート記法があります。

結論として、@docs/coding-style.md のように 1 行書けば、そのファイルが CLAUDE.md の一部として読み込まれます。

基本の書き方

# プロジェクト概要
Next.js の管理画面。

## 規約
@docs/coding-style.md

## アーキテクチャ
@docs/architecture.md

@ の直後にパスを書きます。パスは CLAUDE.md からの相対パス、または絶対パスです。ホームディレクトリは @~/.claude/my-rules.md のように ~ で指定できます。

書き方	意味
@docs/style.md	CLAUDE.md と同じディレクトリを基準にした相対パス
@/absolute/path/rules.md	絶対パス
@~/.claude/personal.md	ホームディレクトリ基準

仕様上の注意

• 再帰: インポート先のファイルの中で @ を使うと、さらに読み込まれます。深さには上限があるため、2〜3 段までにしてください。
• コードブロック内は無視: `@example.com` やコードブェンス内の @ はインポートとして解釈されません。
• 存在しないパス: エラーにはならず、読み込まれないだけです。/memory で確認する習慣をつけてください。
• トークン消費: インポートした内容もセッションごとに送信されます。分割してもトークンは減りません。減らしたいなら、サブディレクトリの CLAUDE.md に移して「必要なときだけ読まれる」ようにします。

構成例:規約を種類ごとに分ける

リポジトリ/
├── CLAUDE.md
└── docs/
    └── ai/
        ├── commands.md      # ビルド・テスト・lint のコマンド
        ├── conventions.md   # コーディング規約
        └── forbidden.md     # 変更禁止の場所

# CLAUDE.md
@docs/ai/commands.md
@docs/ai/conventions.md
@docs/ai/forbidden.md

## 作業の進め方
- 3 ファイル以上の変更は方針を先に提示する

規約の担当者が分かれている場合や、Codex の AGENTS.md と共通化したい場合に、この構成が役立ちます。AGENTS.md を原本にして @AGENTS.md の 1 行だけで CLAUDE.md を構成する方法は CLAUDE.md・AGENTS.md・GEMINI.md の共通化 を参照してください。

個人用ファイルの取り込み

自分だけのルールをプロジェクトの CLAUDE.md に入れたくない場合は、CLAUDE.local.md を使います(CLAUDE.local.md の使い方)。インポートで @~/.claude/personal.md を CLAUDE.md に書く方法もありますが、その行自体が Git にコミットされてしまうため、個人用には CLAUDE.local.md の方が向いています。

関連する記事

CLAUDE.md 全体の書き方と 3 階層の考え方は、親記事の CLAUDE.md の書き方 を参照してください。

まとめ

• @docs/style.md のように書くと、そのファイルが CLAUDE.md に取り込まれる
• 相対パス・絶対パス・~ が使え、コードブロック内の @ は無視される
• 読み込みは /memory で確認する。存在しないパスはエラーにならない
• 分割はトークン節約にならない。節約したいならサブディレクトリの CLAUDE.md に移す