Codexのカスタム指示は「書かない」｜あの欄はグローバルAGENTS.mdの編集画面だった【コーデックス設定の落とし穴】

公開日: 2026年7月30日

ChatGPTデスクトップアプリの「カスタム指示」欄（設定＞パーソナライズ）は、Codex（コーデックス）のグローバル ~/.codex/AGENTS.md を編集する画面そのものです。別々のファイルが裏で同期されているのではなく、同じ1つの設定に入口が2つあるだけです。

前提として、独立した「Codexアプリ」はもう存在しません。 2026年7月9日にCodexアプリとChatGPTアプリが1つに統合され、Chat・Work・Codexの3モードを持つ新しいChatGPTデスクトップアプリになりました（従来のチャット中心のアプリはChatGPT Classicへ改名。この経緯はGPT-5.6一般公開の続報に書いています）。だからCodexへの常時指示を設定画面から触るときの入口は、ChatGPTアプリの設定です。

これは、みやっち🧑‍💻が2026年7月30日の月次ライブ（Codex基礎編）で受講生に説明を間違えたところです。「カスタム指示に書くと、裏で個人用のAGENTS.mdに反映されてしまう」——そう話しました。誤りでした。ライブ中にCodex本人へ問い合わせると「グローバルのAGENTS.mdがセッションに読み込まれたものです」と返ってきました。その場では「すごい学びがありました」と受け止めただけで、誤りの中身を整理できたのはライブのあとです。教材と書き起こしには同日、訂正を入れました。

Codexのカスタム指示とは ChatGPTデスクトップアプリの設定（Settings）＞パーソナライズ（Personalization）＞カスタム指示は、Codexに毎回読ませる常時指示を書く欄です。日本語表示では「設定」の中の「パーソナライズ」に並びます。公式の設定リファレンスには「カスタム指示を編集すると、AGENTS.md にあるあなたの個人向け指示が更新される」と明記されています。対象はグローバル（既定で ~/.codex/AGENTS.md）だけで、リポジトリごとのAGENTS.mdは含みません。

勘違いしたままでも普段の作業は動きます。ただし、AGENTS.mdをファイルとして管理している人は、アプリ画面から保存した瞬間にそのファイルを上書きし得るという別の問題を抱えることになります。ここを整理しておきます。AGENTS.mdそのものの置き場所はAGENTS.mdとは｜CLAUDE.mdとの違いにまとめてあるので、この記事はその設定画面側の話です。

自分が書いていない文章がびっしり入っているのはなぜか

みやっち🧑‍💻のカスタム指示欄には、自分でこの画面から書いた覚えのない文章が大量に入っていました。ライブでは「これは（Codexが）勝手に書いていた」と説明しました。これも誤りです。

正体はこうです。みやっち🧑‍💻の環境では、~/.codex/AGENTS.md が Claude Code側のグローバルCLAUDE.md（共有リポジトリに置いた1つの正本）へのシンボリックリンクになっています。シンボリックリンクは、ファイルの実体を持たない参照用のショートカットです。つまりカスタム指示欄に表示されていたのは、自分がCLAUDE.mdに書き溜めた恒常ルールそのものでした（画面がファイルの中身を読み戻して表示する挙動自体は、公式ドキュメントには書かれていません。みやっち🧑‍💻の環境で確認した結果です）。

Codexが自発的に設定を書き足したわけではなく、自分が書いたファイルを、別の入口から見ていただけです。ライブでは続けて「AGENTS.mdはCLAUDE.mdを読み込む形にしていて触れないから、Codexがカスタム指示側に書いたのだろう」とも推測しましたが、これも成り立ちません。カスタム指示欄とグローバルAGENTS.mdは同じ設定なので、「触れないから別の場所に書いた」という逃げ道自体が存在しないからです。

心当たりがある人は、この2つのどちらかです。

以前に自分でカスタム指示欄へ書いた内容が残っている
~/.codex/AGENTS.md に書いた内容（またはリンク先のファイルの内容）が、そのまま画面に映っている

公式ドキュメントで確認できること

2026年7月30日時点で、OpenAIの公式ドキュメント（Codexの設定リファレンスとAGENTS.mdガイド）から確認できるのは次の3点です。

編集は同じ場所に効く: 設定リファレンスに “Editing custom instructions updates your personal instructions in AGENTS.md.” と書かれています。UIとファイルは同じ設定への2つの入口です
グローバルの置き場所はCodexのホームディレクトリ: 既定は ~/.codex で、CODEX_HOME を設定すれば変更できます。同じ場所に AGENTS.override.md があると、Codexは AGENTS.md ではなくそちらを読みます（一時的に上書きしたいとき用。この「overrideを先に探す」仕組みはグローバルだけでなく各階層で働きます）
読み込みは実行の開始時に1回: 指示ファイルは実行（run）が始まるときに読み込まれます（公式の表現は “once per run”）。新しい実行が始まれば読み直されるので、アプリなら新しいタスクを立てれば反映されます。一方ターミナル版（TUI）は基本的に起動したセッション単位で1回なので、書き換えを効かせるにはセッションを開き直す必要があります

そして、指示は「グローバル → リポジトリのルート → 作業中のフォルダ」の順に重ねて読まれ、後から読まれる（現在地に近い）側が優先されます。途中のサブフォルダにAGENTS.mdがあれば、それも順番に読まれます。だからグローバルには全プロジェクト共通の話し方や進め方を書き、プロジェクト側にはそのリポジトリ固有のルールを書く、という住み分けになります。

気をつけるべきなのは「二重管理」ではなく「上書き」

ライブで話した心配は「憲法が2か所にできて、両方見に行かないといけなくなる」でした。仕組みが分かった今、この心配は消えます。同じ場所なので、憲法は最初から1つです。

代わりに出てくるのが上書きです。危ない順序はこれです。

ChatGPTアプリのカスタム指示画面を開く
別のエディタ（またはClaude Code）で ~/.codex/AGENTS.md を書き換える
古い内容が表示されたままの設定画面で「保存」を押す
2で書いた内容が消える

公式ドキュメントには、外部エディタとの内容の統合・編集中のロック・競合の検知についての記載が見当たりません（2026年7月30日時点）。つまり「あとから保存した方が残る」という前提で自分の運用を組む必要があります。Gitで管理しているファイルなら差分を見て戻せますが、管理していなければ気づかないまま消えます。

編集する経路を1つに決める

対策はシンプルで、編集の入口を片方に決めて、もう片方からは触らないことです。使い方で2通りに分かれます。

Codexだけを普通に使う人: アプリのカスタム指示画面だけで編集する。ファイルの場所を覚える必要はありません
Git管理・複数台のパソコン・Claude Codeとの共有をしている人: ファイル側を正本にして、アプリのカスタム指示画面からは編集も保存もしない

みやっち🧑‍💻は後者です。指示の正本を1つのリポジトリに置き、各パソコンからはシンボリックリンクで参照しています。カスタム指示欄はその中身を映す窓として見るだけにして、書き換えはファイル側でしか行いません。正本を1つに保つ考え方そのものはCLAUDE.mdを社内憲法にするで書いたSSOTの運用と同じです。

メモリはOffにしておく

同じ設定パネルにある「メモリ（Memories）」も、ここで決めておくと後が楽です。みやっち🧑‍💻はOffを勧めています。公式ドキュメントによれば、デスクトップアプリやCLIなど手元で動くCodexのメモリは既定でオフなので、多くの人は触らずそのままで済みます。

理由は、過去のやり取りを覚えていること自体がノイズになるからです。事業の方針は月単位で変わります。先月の自分の発言をもとに判断されるより、毎回まっさらな状態から、いま有効なルールだけを読ませたほうが結果が安定します。守らせたいルールはメモリではなくAGENTS.mdとスキル（手順書）の側に書く、という切り分けです。なお公式ドキュメントは、Web版のChatGPTが使うメモリと、手元で動くCodexのメモリを別のストア・別の設定として説明しています。Workモードのメモリはアカウントとワークスペース側の設定に従うため、この手元のオン・オフとは別枠です。

設定を1回決めると、毎回の説明がなくなる

ここまでは設定画面の話ですが、実際に変わるのは日々の指示の出し方です。

設定が曖昧なままだと、依頼のたびに前提を書き直すことになります。「敬語で」「結論から」「金額は税込で」「勝手にファイルを消さない」——毎回書けば毎回効きますが、書き忘れた回だけ品質が落ちます。正本を1つ決めて、そこにルールを溜めていくと、依頼は「請求書のチェックをして」の一行で済むようになります。前提を毎回説明する仕事が、まるごと消えます。

これは汎用の業務ソフトを買っても、単発でチャットに聞いても手に入りません。自分の事業のルールを覚えた状態が積み上がっていくからこそ、指示が短くなっていきます。自分専用の分身を育てる作業であって、便利なツールを使う話とは別物です。だから最初の設定を、雰囲気ではなく仕組みを理解した上で決めておく価値があります。

よくある質問

Codexアプリをダウンロードすればいいのですか

いいえ。デスクトップアプリとしてのCodexは存在しません。 2026年7月9日の統合以降、Codexは新しいChatGPTデスクトップアプリの中のモードになりました。インストールするのはChatGPTのデスクトップアプリで、カスタム指示もそのアプリの設定＞パーソナライズにあります。なお、ターミナルで動かすCodex CLIとエディタ用のCodex IDE拡張は、公式の入口として別途インストールできます（この記事でTUIと呼んでいるのはCLI版のことです）。

カスタム指示に書いた内容は、プロジェクトのAGENTS.mdより優先されますか

いいえ。指示は「グローバル → リポジトリのルート → 作業中のフォルダ」の順に重ねて読まれ、後から読まれる側が優先されます。カスタム指示（＝グローバル）は最初に読まれるので、プロジェクト側のAGENTS.mdに違うことが書かれていればそちらが勝ちます。

カスタム指示を書き換えたのに、Codexの動きが変わりません

指示ファイルは実行の開始時に読み込まれます。いま動いているタスクには反映されないので、アプリなら新しいタスクを立てて、ターミナル版（TUI）ならセッションを開き直して確かめてください。それでも変わらない場合は、~/.codex に AGENTS.override.md が置かれていないかを確認します。あるとCodexは AGENTS.md ではなくそちらを読みます。

Claude Codeを使っている場合、CLAUDE.mdと内容を二重に書く必要がありますか

必要ありません。1つのファイルを正本にして、もう片方からはシンボリックリンクや取り込みで参照する形にできます。置き場所と参照方法はAGENTS.mdとは｜CLAUDE.mdとの違いにまとめています。

設定はどこから触るのが最短ですか

ChatGPTデスクトップアプリの設定パネルです（Codex専用のデスクトップアプリはありません）。アプリメニューから開けるほか、macOSなら Cmd + ,、Windowsなら Ctrl + , で直接開きます。アプリの操作全体の型（作業中に指示を足すときのステアとキューの使い分けなど）はCodexデスクトップアプリの使い方、そもそもの入口はCodexの始め方にあります。

間違いは訂正して、設定は1回で決める

みやっち🧑‍💻はライブで説明を間違えました。ただ、間違いが分かったことで、注意すべき点が「管理が二重になる面倒さ」から「正本を上書きしてしまう事故」へ入れ替わりました。仕組みを一段確かめると、対策の中身まで変わります。

こういう設定は、記事を読んで分かった気になるのと、自分の画面で決め切るのとで差が出ます。AI CrewはClaude Code・Codexの両方を扱う講座で、この手の初期設定は月次ライブやオフ会で実際の画面を見ながら一緒に決めています。自分の環境で腰を据えて決めてしまいたい方は、まず無料セミナーでお会いしましょう。