【AI】Claude Codeの入力待ちをGhosttyから通知する
Katz
KALEIDOT
【AI】 AGENTS.mdとCLAUDE.mdを共通化(二重管理を解消)する
Katz
複数のAIエージェントを使い始めると、それぞれの設定ファイルを別々に管理する手間がじわじわと増えていきます。シンボリックリンクを使えば、この二重管理の問題を一発で解消できます。
AGENTS.mdとCLAUDE.mdの二重管理を解消する
Claude CodeはプロジェクトルートにCLAUDE.mdを、OpenAIのCodex CLIはAGENTS.mdを参照します。どちらのファイルも「AIエージェントにプロジェクトのコンテキストや作業ルールを伝える」という役割を担っており、記述する内容を同じにしたいことがあります。
このような問題は、どちらか一方のファイルを「本体」として管理し、もう一方をシンボリックリンクにすることで解決できます。こうすれば、1つのファイルを編集するだけで両方のエージェントに同じ内容を読み込ませることができます。
シンボリックリンクとは？
シンボリックリンクとは、別のファイルやディレクトリへの「パス（場所）」を持つ特殊なファイルです。
Windowsのショートカットに似た概念で、シンボリックリンク自身はデータを持たず、指定したパスのファイルを指し示すだけです。
シンボリックリンクを開いたりプログラムから読み込むことで、リンク先の本体ファイルにアクセスできるようになります。
シンボリックリンクで共通化する
AGENTS.mdを本体として、CLAUDE.mdをシンボリックリンクにする例を示します。 逆でも構いません。プロジェクトルートで以下のコマンドを実行します。
# AGENTS.md を本体として作成（既存のファイルはそのまま使用）
# CLAUDE.md を AGENTS.md へのシンボリックリンクとして作成
ln -s AGENTS.md CLAUDE.md
ファイルの状態を確認するには次のコマンドを実行します。 CLAUDE.md -> AGENTS.md と表示されればシンボリックリンクが正しく作成されているので、以後はAGENTS.mdだけを編集すればCLAUDE.mdも同じ内容として機能します。
ls -la CLAUDE.md
# lrwxr-xr-x 1 user group 9 2 22 10:00 CLAUDE.md -> AGENTS.md
Gitはシンボリックリンクをそのままファイルとしてトラッキングします。リポジトリをcloneした際もシンボリックリンクとして復元されるため、チームメンバーや別のマシンでも同じ構成を再現できます。
git add CLAUDE.md
git status
# new file: CLAUDE.md (シンボリックリンクとして認識される)
シンボリックリンクをAIエージェントが正しく読み込めるか
気になるのは、Claude Codeがシンボリックリンク越しにファイルの内容を正しく読み込めるかどうかです。結論として、Claude Codeはシンボリックリンク先のファイル内容を問題なく読み込めます。試しにClaude Codeへ「CLAUDE.mdにどのような内容が記載されているか」と尋ねると、AGENTS.mdと同じ内容が表示されました。
▐▛███▜▌ Claude Code v2.1.63
▝▜█████▛▘ Sonnet 4.6 · Claude Pro
▘▘ ▝▝ ~/Documents/Github/XXXXXXXXXXX
❯ CLAUDE.mdにどのような内容が記載されていますか？
⏺ 現在の CLAUDE.md には以下の内容が記載されています：
… AGENTS.mdに記載されている内容がここに表示される
まとめ
- Claude CodeのCLAUDE.mdとCodex CLIのAGENTS.mdは内容がほぼ同じになるため、二重管理の手間が生じやすい
ln -sコマンドでシンボリックリンクを作成するだけで、1ファイルの管理に一本化できる- Gitはシンボリックリンクをそのままトラッキングするため、チーム開発でも問題なく機能する
- Claude Codeはシンボリックリンク越しにファイルの内容を正しく読み込めることを確認済み
AIエージェントの数が増えるほど設定ファイルの管理コストも上がります。シンボリックリンクによる共通化は、その問題をほぼゼロコストで解決できるシンプルな方法です。
ABOUT ME
エンジニアをやっているKatzです。仕事のことや最近使ってみたものの紹介をしています。
