作業フォルダを決めることが、Codex に任せる第一歩
Codex に仕事を任せるとき、最初に決めるのは「どのフォルダで作業させるか」です。Codex は作業を始めたフォルダの中身を読み、そこにある AGENTS.md(指示書)に従って動きます。フォルダの作り方が曖昧だと、元のファイルを書き換えられたり、成果物が散らばったりします。
ChatGPT デスクトップアプリでは、プロジェクトにパソコン上のフォルダを追加して使います。1つのプロジェクトに複数のフォルダを追加でき、Codex はそのすべてを読み書きできます。ただし、そのうちの1つがメイン(primary)のフォルダで、次のような扱いになります。
- 新しいチャットは、メインのフォルダで始まる
AGENTS.md・スキル・config.tomlを自動で探すのは、メインのフォルダだけ- ほかに追加したフォルダは、検索・読み込み・編集はできるが、その中の
AGENTS.mdは自動では読まれない
関係のない業務は、別のプロジェクトに分けるのが公式ドキュメントの推奨です。なお、コマンドラインの Codex CLI では、起動したフォルダが作業フォルダになります。
この記事では、業務用の作業フォルダの作り方、AGENTS.md の置き場所、ユーザー単位の .codex フォルダの中身を順に説明します。Codex そのものの始め方は 非エンジニアが Codex で業務を任せる方法 を参照してください。
全体像:2つの場所に分かれる
Codex に関わるフォルダとファイルは、大きく2つの場所に分かれます。
【パソコンに1つ】ユーザー単位の設定
~/.codex/ ← Windows では %USERPROFILE%\.codex
├─ config.toml ← 個人の設定
├─ AGENTS.md ← 全プロジェクト共通の個人ルール(任意)
└─ (ログイン情報・履歴・ログなど、Codex が管理するファイル)
【業務ごとに1つ】作業フォルダ(プロジェクトのメインのフォルダ)
月次経営会議資料/
├─ AGENTS.md ← この業務のルール
├─ 00_参照資料/
├─ 01_入力/
├─ 02_作業中/
├─ 03_成果物/
└─ 99_アーカイブ/
人が主に手を入れるのは、作業フォルダの AGENTS.md と中身のファイルです。~/.codex は、必要なときにだけ開く場所と考えてください。
作業フォルダの型:5つの役割に分ける
業務用の作業フォルダは、役割ごとに5つのフォルダに分けます。
月次経営会議資料/
├─ AGENTS.md ← 業務のルール(フォルダの役割もここに書く)
├─ TASKS.md ← (任意)タスクの台帳
├─ 00_参照資料/ ← テンプレート・用語集・過去の完成例
├─ 01_入力/ ← 受け取った元データ。Codex は読むだけ
├─ 02_作業中/ ← Codex が自由に使ってよい場所
├─ 03_成果物/ ← 完成品の出力先。人が確認してから外へ出す
└─ 99_アーカイブ/ ← 終わった月の一式。Codex は読まない
| フォルダ | 置くもの | Codex への指示 | 人がすること |
|---|---|---|---|
| 00_参照資料 | 雛形、用語集、表記ルール、過去の完成例 | 読むだけ。書き換えない | 内容を最新に保つ |
| 01_入力 | 受け取ったデータ、議事録、メモ | 読むだけ。移動・削除・上書きしない | 元データを置く |
| 02_作業中 | 途中のファイル、一時ファイル | 自由に作成・変更してよい | 原則として見ない |
| 03_成果物 | 完成品、変更点の一覧 | 決めた名前で出力する | 確認してから使う |
| 99_アーカイブ | 終わった回の一式 | 読まない・書かない | 月末に移す |
フォルダ名の先頭に番号を付けると、並び順が固定され、依頼文でも「01 のフォルダ」と短く指せます。00_参照資料を分けておくのがポイントで、「過去の完成例と同じ形式で」と頼むときに、どのファイルを見本にすればよいかを Codex が迷わなくなります。99_アーカイブを読まないと決めておくと、前の月のデータが混ざる事故を防げます。
ファイル整理の題材で、この型を使った依頼文の例は Codex に業務ファイルの整理を任せる方法 で紹介しています。
AGENTS.md の置き場所と読み込まれ方
基本:作業フォルダの最上位に置く
AGENTS.md は、プロジェクトのメインのフォルダの最上位に置きます。Codex は作業の開始時にこのファイルを読み込みます。ルールを書き換えたら、新しいチャットを始めてから使うようにしてください。書く内容は AGENTS.md の書き方 を参照してください。
複数の AGENTS.md がある場合の順番
公式ドキュメントによると、Codex は次の順で AGENTS.md を集め、空行でつないで1つの指示にします。
- ユーザー単位:
~/.codex/AGENTS.md(全プロジェクト共通) - プロジェクト:プロジェクトのルートから、作業を始めたフォルダまで、上から順に各フォルダの
AGENTS.md
後に読まれたもの、つまり作業を始めたフォルダに近い AGENTS.md ほど優先されます。1つのフォルダから読まれるファイルは1つだけです。
ここで注意したいのが「プロジェクトのルート」の意味です。Codex は既定では、.git フォルダ(変更履歴を管理する Git の管理フォルダ)があるフォルダをルートとみなします。ルートが見つからない場合は、作業を始めたフォルダの AGENTS.md だけを読みます。 Git を使っていない業務フォルダでは、親フォルダの AGENTS.md は自動では読まれないということです。
~/.codex/AGENTS.md ① 最初に読まれる(個人の共通ルール)
業務/
├─ AGENTS.md ② 業務/ に .git がある場合だけ読まれる
└─ 月次経営会議資料/
└─ AGENTS.md ③ 作業を始めたフォルダ。最後に読まれ、最も優先される
| 作業を始めたフォルダ | 読み込まれる AGENTS.md |
|---|---|
| 月次経営会議資料/(上位に .git なし) | ① と ③ |
| 月次経営会議資料/(業務/ に .git あり) | ① → ② → ③ |
| 業務/ | ① と ②(③ は作業を始めたフォルダより下にあるため、開始時には読まれない) |
非エンジニアの業務利用では、「1つの業務=1つのフォルダ=1つのプロジェクト」にして、そのフォルダの最上位に AGENTS.md を1つ置くのが最も分かりやすい形です。親フォルダから子フォルダへルールを引き継がせる構成は、Git で管理されたフォルダでなければ期待どおりに動きません。
AGENTS.override.md:一時的な上書き用
同じフォルダに AGENTS.override.md があると、AGENTS.md より優先して読まれ、同じフォルダの AGENTS.md は使われません。ユーザー単位の ~/.codex/AGENTS.override.md も同様です。一時的にルールを差し替えるための仕組みなので、普段は作りません。「AGENTS.md を直したのに反映されない」ときは、上書き用のファイルが残っていないかを確認します。
長さの上限
読み込まれる AGENTS.md の合計には上限があり、既定では 32KiB です。日本語は1文字あたりの容量が大きいため、文字数にすると1万字程度が目安になります。上限を超えた分は読み込まれないため、詳しい手順は 00_参照資料/ などの別ファイルに分け、AGENTS.md からは「〇〇の作業では 00_参照資料/手順書.md を読む」と参照させます。
Codex が自動で読む .md ファイル・読まない .md ファイル
作業フォルダには Markdown(.md)のファイルがいくつも並びますが、Codex が自動で読み込むものは限られています。
| ファイル | 自動で読むか | 役割 |
|---|---|---|
AGENTS.md |
読む(作業の開始時) | 業務のルール。指示書の本体 |
AGENTS.override.md |
読む(同じフォルダの AGENTS.md より優先) | 一時的な上書き |
~/.codex/AGENTS.md |
読む(全プロジェクト) | 個人の共通ルール |
SKILL.md(.agents/skills/スキル名/ の中) |
依頼の内容に合うときに使われる | 繰り返し使う手順をまとめた「スキル」 |
README.md・TASKS.md・手順書など |
読み込まない(指示書としては扱われない) | 依頼や AGENTS.md で「読む」と指示すると読まれる |
README.md や手順書を自動で読ませたい場合、設定ファイル(config.toml)で AGENTS.md の代わりに探す名前を追加する方法もあります。ただしこれは AGENTS.md が無いフォルダでだけ使われる代替の名前です。業務で使うなら、ファイル名は AGENTS.md にそろえ、ほかのファイルは AGENTS.md から参照させるほうが混乱しません。タスクの台帳を読ませる設定は Codex の TASKS.md(タスクファイル)の書き方 で紹介しています。
スキルの置き場所は、作業フォルダの .agents/skills/ と、ホームフォルダの .agents/skills/(ユーザー単位)です。スキルの仕組みは更新が続いているため、使う前に最新の公式ドキュメントで確認してください。
ユーザー単位の .codex フォルダの中身
場所
| OS | 場所 |
|---|---|
| Mac・Linux | ~/.codex(ホームフォルダ直下) |
| Windows | %USERPROFILE%\.codex(通常は C:\Users\ユーザー名\.codex) |
環境変数 CODEX_HOME を設定すると、この場所を変えられます。Windows の ChatGPT デスクトップアプリは、Windows 版の Codex と同じ %USERPROFILE%\.codex を使います。一方、WSL(Windows 上で Linux を動かす仕組み)の中で Codex CLI を使う場合は、既定では Linux 側のホームフォルダが使われ、デスクトップアプリとは設定が共有されません。
Mac の Finder では、名前が「.」で始まるフォルダは表示されません。Command + Shift + .(ピリオド)で隠しファイルを表示できます。
主なファイルと、触ってよいかどうか
| ファイル・フォルダ | 中身 | 触ってよいか |
|---|---|---|
AGENTS.md |
全プロジェクト共通の個人ルール | ◎ 自分で編集してよい |
config.toml |
個人の設定(承認の扱い、サンドボックスなど) | △ 必要なときだけ。編集前にコピーを取る |
AGENTS.override.md |
一時的な上書き | △ 使い終わったら消す |
auth.json |
ログイン情報(OS の資格情報の保管庫に保存される場合もある) | × 開かない・コピーしない・人に渡さない |
history.jsonl |
会話の記録 | × 編集しない。中身に業務情報が残る点に注意 |
| ログ・キャッシュ・セッションの記録 | 動作の記録 | × 触らない |
rules/ 内のファイル(例:default.rules) |
サンドボックスの外で実行するコマンドを、許可・確認・禁止に振り分ける規則(実験的な機能) | × Codex が書き込むことがあるため手で編集しない |
| メモリーのフォルダ | メモリー機能を有効にした場合に作られる記録 | × 公式ドキュメントでも「生成された状態」として扱うよう案内されている |
人が編集する価値があるのは AGENTS.md だけ、と考えて差し支えありません。ChatGPT デスクトップアプリでは、設定画面の Personalization(パーソナライズ)の項目から、この個人用の AGENTS.md を編集できます。表示名は言語設定やバージョンによって異なる場合があります。
config.toml は承認の扱いやサンドボックス(Codex が操作できる範囲)を決める設定で、変えると Codex の動き方が変わります。会社で管理者が設定を配布している場合、管理者が定めた要件は利用者側の config.toml では上書きできません。変更が必要なときは、情報システム部門に確認してから行います。
また、~/.codex フォルダには会話の記録やログイン情報が含まれます。フォルダごと共有フォルダや同期フォルダに置いたり、他の人に渡したりしないでください。
作業フォルダ内の .codex フォルダ
作業フォルダの中に .codex/config.toml を置くと、そのプロジェクトだけの設定にできます。ただし Codex は、利用者が信頼したプロジェクトでだけこの設定(プロジェクト単位のルールやフックを含む)を読み込みます。共有フォルダから受け取ったフォルダに .codex が入っていても、信頼しない限り設定は使われません。非エンジニアの業務利用では、作業フォルダに .codex を作る必要は通常ありません。
部署で使うときの推奨構成
部署で Codex を使う場合は、次のように「共通ルールのフォルダ」と「業務ごとのフォルダ」に分けます。
経営企画部/
├─ _共通/ ← 推進担当が管理。Codex は読むだけ
│ ├─ 部署共通ルール.md ← 表記・禁止事項・確認の流れ
│ ├─ 用語集.md
│ └─ テンプレート/
├─ 月次経営会議資料/ ← 1つの業務=1つのプロジェクト
│ ├─ AGENTS.md
│ ├─ TASKS.md
│ ├─ 00_参照資料/
│ ├─ 01_入力/
│ ├─ 02_作業中/
│ ├─ 03_成果物/
│ └─ 99_アーカイブ/
└─ 予算策定_2027年度/
├─ AGENTS.md
└─ (同じ構成)
運用のルールは次の4つです。
- 業務ごとにプロジェクトを分ける:
月次経営会議資料/をメインのフォルダにしたプロジェクト、予算策定_2027年度/をメインのフォルダにしたプロジェクト、のように分けます。部署のフォルダ全体を1つのプロジェクトにすると、業務ごとのAGENTS.mdが開始時に読まれません - 共通ルールは
_共通/に1つだけ置く:同じ内容を各業務のAGENTS.mdにコピーすると、直すときに漏れが出ます。各プロジェクトに_共通/フォルダも追加し、業務ごとのAGENTS.mdから読ませます(追加したフォルダの中の .md は自動では読まれないため、指示が必要です) - 個人の好みは
~/.codex/AGENTS.mdに:「報告は箇条書きで」のような自分だけの好みは個人のファイルに書きます。部署のルールを個人のファイルに書くと、ほかのメンバーには届きません AGENTS.mdの管理者を決める:部署の推進担当が_共通/と各業務のAGENTS.mdの版を管理し、メンバーは気づいた点を推進担当に伝えます
業務ごとの AGENTS.md の冒頭には、次のように書いておきます。
# 月次経営会議資料の作成
## 最初に読むもの
- 作業を始める前に、_共通/部署共通ルール.md と _共通/用語集.md を読む
- _共通/ のファイルは読むだけ。変更・移動・削除しない
## フォルダの役割
- 00_参照資料:雛形と過去の完成例。読むだけ
- 01_入力:受け取ったデータ。読むだけ。移動・削除・上書きしない
- 02_作業中:自由に使ってよい
- 03_成果物:完成品の出力先。ファイル名は YYYY-MM_経営会議資料.xlsx
- 99_アーカイブ:読まない・書かない
## 完了条件
- 03_成果物 に出力したファイルのパスと、元データから変えた点の一覧を示し、確認を待つ
つまずきやすいポイント
- AGENTS.md が効かない:メインのフォルダが別のフォルダになっていないか、ファイル名が
AGENTS.md(大文字)か、中身が空でないか、AGENTS.override.mdが残っていないかを確認します。書き換えた後は新しいチャットで試します - 親フォルダのルールが効かない:Git で管理していないフォルダでは、作業を始めたフォルダの
AGENTS.mdしか読まれません。共通ルールは上の部署の構成のように、ファイルとして読ませます - 追加したフォルダのルールが効かない:プロジェクトに追加した2つ目以降のフォルダの
AGENTS.mdは、自動では読まれません - .codex フォルダが見つからない:Mac では隠しフォルダになっています。
CODEX_HOMEを設定していると別の場所になります - 共有フォルダで直接作業して混乱する:他の人が使っているフォルダで、いきなり Codex に作業させないでください。手元にコピーして試し、成果物だけを戻す運用が安全です
研修で身につけるには
作業フォルダの設計と AGENTS.md の作成から、実際に Codex に作業させて検証するところまでを、Codex 研修 で自社の業務を題材に演習します。日々のタスクを台帳で管理する方法は Codex の TASKS.md(タスクファイル)の書き方 をあわせてお読みください。部署単位で AIエージェントに業務を任せる体制づくりは AIエージェント研修 で扱っています。ご相談は 無料相談 からどうぞ。


