場所と中身の早見

Codexの.codexフォルダはどこ?Windowsは%USERPROFILE%\.codex

Codexの設定・ログイン情報・会話の記録は、ホームフォルダの下の「.codex」にまとまっています。Windows、Mac、WSLでの場所、中に入っているファイル、開き方、触る前に知っておきたい点を、OpenAI公式の文書(2026年11月12日確認)に沿って整理します。

このサイトはCodexの公式サイトではありません。公式の文書を元に日本語で整理した解説です。フォルダの中身は版やログイン方法で変わるため、実際に見えるものと出典を照らして確認してください。

最初に答え

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つです。

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

触る前に確認すること

よくある質問

.codexフォルダが見つかりません。

Codexを一度も起動していない、または CODEX_HOME で別の場所に変えている可能性があります。環境変数の設定と、ログインして1回操作した後のフォルダを確認してください。

PCを替える時は.codexフォルダをコピーすればいいですか。

設定ファイルを移す方法は、あわせて新しいPCへの移行で整理しています。auth.json などログインに関わるファイルは、安易にコピーせず、新しいPCでログインし直す方が安全です(当サイトの勧めです)。

config.toml はどこで編集しますか。

ChatGPTデスクトップアプリでは Settings > Configuration > Open config.toml から開けます。CLIの場合は、上の場所のファイルをエディタで開きます。

関連ページ

出典と確認日

出典は公式の文書です。画面の表示や手順は更新されることがあるため、迷ったら出典を優先してください。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(公式の情報と照らした日)
更新履歴
(公開)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。