Claude Code v2.1.277で、プロジェクトの指示書としてAGENTS.mdを読めるようになりました。これまでClaude CodeではCLAUDE.mdが入口という説明を見かけることが多かったので、既存プロジェクトに別のエージェント向けルールを置いている人には少し気になる変更です。
v2.1.277で何が変わったのか
公式リリースノートによると、CLAUDE.mdが存在しないプロジェクトで、Claude CodeがAGENTS.mdをプロジェクト指示として読むようになりました。ポイントは「どちらも常に読む」ではなく、まず既存のCLAUDE.mdを確認し、そこが無い場合の入口としてAGENTS.mdが使われることです。
つまり、すでにCLAUDE.mdを運用しているリポジトリへ、何も考えずに同じ内容をAGENTS.mdへコピーする必要はありません。二重管理にすると、片方だけ更新されてルールが食い違う危険があります。
AGENTS.mdを使うと何がうれしいか
AGENTS.mdは、複数のAIコーディングエージェントで共有しやすい名前です。Claude Code専用の設定はCLAUDE.mdに残し、エージェントをまたいで守るべき作業ルールをAGENTS.mdに置く、という整理ができます。
ただし、今回のリリースノートが示しているのはClaude Code側の読み込み対応です。別のツールも同じ探索順序で読むとは限りません。対応状況を確認せずに「AGENTS.mdなら全エージェントで共通」と断定するのは避けた方が安全です。
読み込みを確認する安全な手順
新しい指示書を試すときは、まず変更の少ない作業用ブランチや検証用ディレクトリで確認します。プロジェクト直下に短いテスト用のAGENTS.mdを置き、Claude Codeを起動して、指示書に書いた確認用の質問をします。
mkdir agent-instructions-check
cd agent-instructions-check
@'
# Project instructions
When asked for a status check, reply with: AGENTS-MD-LOADED
'@ | Set-Content AGENTS.md
claude -p "確認用の返答だけをしてください" --output-format textこの確認では、ファイルを書き換えたり外部サービスへ接続したりする指示を入れないことが重要です。読み込み確認のために危険なコマンドを実行させる必要はありません。
CLAUDE.mdと二重管理しない
既存のCLAUDE.mdがある場合は、まず役割を分けます。たとえば、リポジトリ全体のテスト・秘密情報・公開禁止事項は共通文書にまとめ、Claude Codeだけのスラッシュコマンドやモデル固有の注意はCLAUDE.mdに残します。
一方、両方を自動で読み込む環境もあり得るため、同じ指示を重複して書くより、片方からもう片方へ参照関係を明示する方が保守しやすい場合があります。実際の探索順序と優先順位は、使っているClaude Codeのバージョンと公式ドキュメントで確認してください。
無人実行では「読んだ前提」を検証する
定期タスクやCIからClaude Codeを起動している場合、指示書の名前が変わっただけでも動作の前提が変わります。最初の一度だけでも、ログに指示書の検出結果を残し、テストコマンドが実行されたかを確認すると安心です。
特に、公開・削除・認証情報へのアクセス・外部送信のような不可逆操作は、AGENTS.mdを置いたから自動的に安全になるわけではありません。許可境界と検証手順は別に残し、実行前後の証跡を確認する必要があります。
まとめ
- Claude Code v2.1.277で、
CLAUDE.mdがないプロジェクトのAGENTS.mdが指示書として読まれるようになった。 - 既存の
CLAUDE.mdと内容をコピーして二重管理しない。 - 他のエージェントも同じように読むとは限らないので、ツールごとに確認する。
- 無人実行では、読み込み確認と危険操作の検証を分けて考える。
この変更は、AIエージェント向けのプロジェクトルールを共有する入口を増やすものです。便利さに乗る前に、どのファイルがいつ読まれ、どの指示が優先されるのかを小さな検証で確かめるのがよさそうです。
コメント