作業フォルダを決めることが、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つの指示にします。

  1. ユーザー単位:~/.codex/AGENTS.md(全プロジェクト共通)
  2. プロジェクト:プロジェクトのルートから、作業を始めたフォルダまで、上から順に各フォルダの 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つです。

  1. 業務ごとにプロジェクトを分ける:月次経営会議資料/ をメインのフォルダにしたプロジェクト、予算策定_2027年度/ をメインのフォルダにしたプロジェクト、のように分けます。部署のフォルダ全体を1つのプロジェクトにすると、業務ごとの AGENTS.md が開始時に読まれません
  2. 共通ルールは _共通/ に1つだけ置く:同じ内容を各業務の AGENTS.md にコピーすると、直すときに漏れが出ます。各プロジェクトに _共通/ フォルダも追加し、業務ごとの AGENTS.md から読ませます(追加したフォルダの中の .md は自動では読まれないため、指示が必要です)
  3. 個人の好みは ~/.codex/AGENTS.md に:「報告は箇条書きで」のような自分だけの好みは個人のファイルに書きます。部署のルールを個人のファイルに書くと、ほかのメンバーには届きません
  4. 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エージェント研修 で扱っています。ご相談は 無料相談 からどうぞ。

よくある質問

.codex フォルダはどこにありますか?見当たりません。
ユーザー単位の .codex フォルダは、Mac ではホームフォルダ直下の ~/.codex、Windows では %USERPROFILE%\.codex(通常は C:\Users\ユーザー名\.codex)です。Mac の Finder では名前が「.」で始まるフォルダは表示されないため、Command + Shift + .(ピリオド)で隠しファイルを表示します。環境変数 CODEX_HOME を設定している場合は、その場所が使われます。
AGENTS.md は作業フォルダと .codex フォルダのどちらに置くべきですか?
業務のルールは作業フォルダに、自分だけの好み(文体、報告の仕方など)は ~/.codex/AGENTS.md に置きます。両方とも読み込まれ、作業フォルダに近いほうが後に読まれて優先されます。部署で共有したいルールを個人の ~/.codex/AGENTS.md に書くと、ほかの人には届かないので注意してください。
作業フォルダの中に .codex フォルダを作る必要はありますか?
非エンジニアの業務利用では、通常は不要です。作業フォルダ内の .codex フォルダはプロジェクト単位の設定(config.toml など)を置く場所で、信頼したプロジェクトでだけ読み込まれます。設定を変える必要が出てきたら、情報システム部門や社内のエンジニアと相談して決めます。