Claude Code¶
公式サイト: Claude Code、ドキュメント
Anthropic のコーディングエージェント。ここでは、リポジトリに置いて使う機能(指示、ルール、スキル)の置き方をまとめる。
指示ファイル(CLAUDE.md)¶
- Claude Code は、
CLAUDE.mdを読む。v2.1.277(9月18日のリリース)で、AGENTS.mdのサポートが追加された1。 - リリースノートの記述:
CLAUDE.mdがないプロジェクトでは、代わりにAGENTS.mdを読む。/configの「Project instructions」で変更できる。Bedrock、Vertex、Foundry では、v2.1.277 の時点では使えない。 CLAUDE.mdがある場合は、CLAUDE.mdが使われると考えられる。「Project instructions」の選択肢の内容は、リリースノートには書かれていない。AGENTS.mdを使いつつ、Claude Code だけの指示を足したいときは、CLAUDE.mdからAGENTS.mdを取り込む。
Note
2026-11-21 に確認した、公式ドキュメントのメモリのページには、「AGENTS.md は読まない」とあった。リリースノートとの食い違いは、ドキュメントの更新が追いついていないためと考えられる(推測)。CLAUDE.md と AGENTS.md が両方あるときの扱い、CLAUDE.local.md の扱いは、リリースノートに記述がなく、未確認。
@パスで、ほかのファイルを取り込める。相対パスは、取り込む側のファイルからの位置で解決される。取り込みの入れ子は、最大4段まで。- ユーザー単位の指示は、
~/.claude/CLAUDE.mdに置く。
ルール(.claude/rules/)¶
指示をテーマごとのファイルに分けて置ける。
- フロントマターの
pathsに glob を書くと、該当するファイルを扱うときだけ、そのルールが読み込まれる。 pathsがないルールは、セッションの開始時に読み込まれる。
- ユーザー単位のルールは、
~/.claude/rules/に置く。
スキル¶
- プロジェクトのスキルは
.claude/skills/<name>/SKILL.md、個人のスキルは~/.claude/skills/に置く。プラグインに含めることもできる。 SKILL.mdは、フロントマターと、手順の本文でできている。フロントマターのnameは省略でき、省略するとディレクトリ名になる。descriptionに、どんなときに使うかを書く。これを元に、Claude がスキルを選ぶ。- 同梱のスキルと同じ名前のスキルを、プロジェクトや個人で作ると、そちらが優先される。プラグインのスキルは、
プラグイン名:スキル名の名前空間で区別される。
参考¶
- How Claude remembers your project - Claude Code Docs: CLAUDE.md、
@による取り込み、.claude/rules/ - Skills - Claude Code Docs: スキルの置き場所とフロントマター
- Feature Request: Support AGENTS.md · Issue #6235 · anthropics/claude-code:
AGENTS.md対応の要望
-
Release v2.1.277 · anthropics/claude-code(公式のリリースノート。「Added AGENTS.md support」の項目) ↩