Claude CodeとCodexを自由に切り替えられる置き方。原本は「1つ」、仕事もルールもスキルも引き継ぐ

私たちは1台のPCで、Anthropic の Claude Code と OpenAI の Codex という2つのAIコーディングツールを併用し、27個のスキル（AIに手順を教えるファイル）を両方に読ませています。どちらを開いても同じ会社の記録を読み、同じ手順で仕事をします。この記事は、その置き方を公式文書と実運用の失敗から書いたものです。

2つ入れると、なぜズレるのか

2つのツールは、読むファイルが違います。指示書は Claude Code が CLAUDE.md、Codex が AGENTS.md。スキルの置き場も、フックと呼ばれる安全装置の設定も、それぞれ別の場所にあります。私たちも最初は、片方の設定をコピーしてもう片方に置きました。ズレはそこから始まります。

私たちの環境で実際に起きたことを2つ書きます。1つは、CLAUDE.md の「Claude」を「Codex」に機械置換して AGENTS.md を作ったところ、「Codex API」という存在しないサービス名が文中に生まれていたことです。もう1つは、フックの設定ファイルを8月11日から9月2日までの間に22回作り直していたことです（残っていたバックアップの数）。版が上がって壊れた分と、自分で変えた分の区別は、もうつきません。コピーは必ず古くなり、ツール固有の仕掛けに預けた規則は、いつ消えたか分からなくなります。

原本を1つにする、3つの置き方

ズレの原因が「2か所に同じものがある」ことなら、答えは1か所にすることです。生成も置換もしません。

指示書の本文にはツール名を書きません。「あなた」「このAI」と書き、あるツールだけに要る注意は末尾に節を作って両方から見える場所に置きます。片方だけが知っている規則を作らないためです。Windows でファイルのシンボリックリンクを作るには管理者権限が要りますが、ディレクトリのジャンクションは要りません。Claude Code の公式文書も、Windows では import を使うよう案内しています。

受け渡しは、ファイルで残す

使い分ける最大の利点は、片方に書かせたものをもう片方に見せられることです。ここでプロセスの起動や API を挟むと、認証切れや実行時間の制限で止まります。私たちは依頼を1ファイル、応答を1ファイルにして、人が相手のツールを開いて「依頼を処理して」と1行言う型にしました。状態は依頼ファイルの中に持ち、未着手、着手、完了、失敗の4つだけです。

同じ文書を両方に読ませると、片方が書いたものをもう片方が別の目で読みます。同じ会社が2社の検収を受けるのに近い形になります。

壊れる場所を、先に書いておく

この置き方にも壊れる場所があります。先に知っておけば、壊れたときに原因を探す時間が消えます。

• git はジャンクションを普通のフォルダとして記録する。そのままコミットすると、clone した先ではスキルが複製になり、原本が2つに戻ります。リンクは git に入れず、clone した人が1手順で作り直す形にします（実測 2026年9月4日）。
• Codex は AGENTS.md を合計 32 KiB で打ち切る。長い規則は後ろが読まれません。200行以内に収め、手順の詳細はスキルへ移します。
• ツールは月単位で変わる。今日の公式文書の記述が来月も同じとは限りません。

3つ目への答えとして、仕様書の冒頭に「鮮度確認」の節を置きました。AIが仕様書を読んだら、まず自分の版を控え、壊れると導入が失敗する前提を5つに絞って公式文書を開き、該当箇所を引用できたものだけ「成立」と判定します。崩れていたら手元の設定だけ直し、仕様書本体は書き換えず、人に渡す報告文を作る決まりです。導入後は指示書に「最後に検収した版」が書かれ、AIは毎回自分の版と比べて、ズレたら人に言われる前に再検収する仕組みにしました。

導入直後の検収は9項目です。抜き出すと次のようになります。

明日やること

やることは3つです。プロジェクトのフォルダで、いま使っているツールを開く。原本にする指示書を AGENTS.md の名前で置き、CLAUDE.md には @AGENTS.md の1行を書く。スキルの置き場を .agents/skills に決め、Claude Code 側をリンクにする。ここまでで、後からもう片方を入れても設定は変わりません。

この置き方を、AIが読んでそのまま導入し、検収まで自分で行う仕様書の形にまとめました。雛形、受け渡しのスキル、検収の見本をすべて1本の文書に入れてあり、貼れば入ります。note で配布しています（有料・1,980円）。

会社の記録を複数のAIに同じように読ませる設計は、無料相談で一緒に考えられます →

よくある質問

まとめ

2つのAIコーディングツールを入れると、指示書とスキルが2か所に分かれてズレます。答えは、原本を1つにすること。指示書は AGENTS.md を原本に CLAUDE.md は1行、スキルは1か所にしてリンクで束ね、安全装置はフックに預けず文書と git で持ちます。受け渡しはファイルで残し、壊れる場所は先に書き、ツールの更新はAI自身に前提を確かめさせました。会社の記録をAIの外に置き、どのAIにも同じものを読みに来させる形です。私たちが顧客の現場で作っているものと、同じ形をしています。