場所と中身の早見
Codexの.codexフォルダはどこ?Windowsは%USERPROFILE%\.codex
Codexの設定・ログイン情報・会話の記録は、ホームフォルダの下の「.codex」にまとまっています。Windows、Mac、WSLでの場所、中に入っているファイル、開き方、触る前に知っておきたい点を、OpenAI公式の文書(2026年11月12日確認)に沿って整理します。
最初に答え
Codexが手元のPCに残す設定や記録は、CODEX_HOMEというフォルダに置かれます。公式の説明では、何も設定していなければ既定は ~/.codex です。
| 環境 | .codexフォルダの場所 |
|---|---|
| Windows(アプリ・CLI) | %USERPROFILE%\.codex(たとえば C:\Users\ユーザー名\.codex) |
| Mac・Linux | ~/.codex(ホームフォルダの下) |
| WSL(Windows上のLinux) | Linux側のホームの ~/.codex。Windowsアプリとは別の場所です |
環境変数 CODEX_HOME を設定すると、置き場所を変えられます。公式には、指定するフォルダは先に作ってあることが条件と書かれています。
エクスプローラーで開く方法
Windowsでは、エクスプローラーのアドレス欄に %USERPROFILE%\.codex と入力してEnterを押すと、そのユーザーの.codexフォルダが開きます。
設定ファイルだけを開きたい時は、ChatGPTデスクトップアプリの Settings > Configuration > Open config.toml から開けます(公式の案内)。ターミナルで中身を一覧するなら次のとおりです。
dir %USERPROFILE%\.codexフォルダの中身と役割
公式の文書に出てくる主なファイルとフォルダです。実際に見えるものは、使っている機能やログイン方法で変わります。
| 名前 | 何が入っているか |
|---|---|
config.toml | 自分用の設定ファイル。モデル、承認の求め方などの既定を書きます |
auth.json | ログイン情報。ファイルで保存する設定の時に作られます。OSのキーチェーンに保存する設定なら、ここには置かれません |
history.jsonl | 入力の履歴。履歴の保存が有効な時に作られます |
sessions\ | 会話(セッション)の記録 |
archived_sessions\ | アーカイブした会話の記録 |
log\ | ログファイルの既定の置き場所(log_dir で変更できます) |
AGENTS.md | 全体に効かせる自分用の指示。プロジェクトごとの指示とは別です |
rules\・prompts\・skills\ | コマンドの規則、再利用する指示文、スキルの置き場所 |
プロファイル名.config.toml | 用途別の設定を分けて置くファイル(例:deep-review.config.toml) |
.env | デスクトップアプリやIDE拡張がシェルの環境変数を引き継がない時に、必要な値を書く場所 |
プロジェクト内の.codexとは別物
リポジトリの中にも .codex/config.toml を置けます。これはそのプロジェクトだけに効く設定で、公式によると信頼したプロジェクトでだけ読み込まれます。信頼していないプロジェクトでは、プロジェクト内の設定・フック・ルールは読まれません。
ホームの .codex が「自分用の既定」、プロジェクトの .codex が「そのリポジトリ用の上書き」と分けて覚えると迷いません。設定の効く順番はCodexの設定と作業フォルダにまとめています。
WindowsアプリとWSLで共有するには
Windowsアプリは、Windows上でCodexを使う時と同じ %USERPROFILE%\.codex を使います。WSLの中でCLIを動かすと、既定ではLinux側のホームを使うため、設定・ログイン・会話の履歴は自動では共有されません。
公式が挙げる共有の方法は2つです。
- WSL側の
~/.codexと%USERPROFILE%\.codexを、ファイルの同期で揃える - WSLで
CODEX_HOMEをWindows側のフォルダに向ける
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex触る前に確認すること
- auth.json は共有しない。ログイン情報に当たるファイルです。画面の写真や相談文に貼らないでください。
- sessions のログは中身を見てから。公式も、ログを共有する時は機密が入っていないか先に確認するよう案内しています。
- config.toml を書き換える前にコピーを取る。戻せる状態にしてから編集すると、設定ミスで動かなくなっても元に戻せます(当サイトの勧めです)。
- フォルダごと消す前に。消すと設定や会話の記録も一緒に消える可能性があります。不調の切り分けはconfig・local stateの確認を先に見てください。
よくある質問
.codexフォルダが見つかりません。
Codexを一度も起動していない、または CODEX_HOME で別の場所に変えている可能性があります。環境変数の設定と、ログインして1回操作した後のフォルダを確認してください。
PCを替える時は.codexフォルダをコピーすればいいですか。
設定ファイルを移す方法は、あわせて新しいPCへの移行で整理しています。auth.json などログインに関わるファイルは、安易にコピーせず、新しいPCでログインし直す方が安全です(当サイトの勧めです)。
config.toml はどこで編集しますか。
ChatGPTデスクトップアプリでは Settings > Configuration > Open config.toml から開けます。CLIの場合は、上の場所のファイルをエディタで開きます。
関連ページ
出典と確認日
- OpenAI Learn: Codex ドキュメント(Config and state locations/環境変数 CODEX_HOME/Windows app の WSL との共有)
- OpenAI Learn: 設定ファイルの場所とプロジェクトの .codex/config.toml(同じドキュメント内)
- 確認日: 2026年11月12日
出典は公式の文書です。画面の表示や手順は更新されることがあるため、迷ったら出典を優先してください。
