Codex Manual

配置与登录

大多数 Codex 配置问题，本质上都是改错了 config.toml 或环境变量没有进入当前运行环境。

配置文件在哪里

常见位置：

Windows 原生和 WSL2 是两个环境。你在 Windows 里改 %USERPROFILE%\.codex\config.toml，不会自动影响 WSL 内运行的 codex。

CODEX_HOME

如果设置了 CODEX_HOME，Codex 会使用这个目录作为配置和状态目录。

Linux / macOS：

export CODEX_HOME="$HOME/.codex"

PowerShell：

$env:CODEX_HOME="$HOME\.codex"

普通用户不需要主动设置 CODEX_HOME。只有当你想共享配置、切换多套环境或把 WSL 指向 Windows 配置目录时才需要。

登录方式

Codex 常见登录方式：

1. ChatGPT 账号登录。
2. OpenAI API Key 登录。
3. 自定义 provider，例如 XAI Router。

如果你已经有 ChatGPT Plus / Pro / Business / Edu / Enterprise，通常优先使用 ChatGPT 登录。需要企业统一管理、模型路由或包月额度时，再配置 XAI Router。

常用配置示例

approval_policy = "on-request"
sandbox_mode = "workspace-write"
preferred_auth_method = "apikey"

这表示 Codex 默认在工作区内写文件，需要更高权限时请求确认，并优先使用 API Key 方式。

排查顺序

配置不生效时，按这个顺序检查：

1. 当前 codex 是在 Windows、WSL、macOS 还是 Linux 里运行。
2. 你改的是不是该环境里的 config.toml。
3. 环境变量是否在当前 shell 中生效。
4. 是否用 CLI 参数或 profile 覆盖了配置。
5. 是否需要重启 App 或重新打开终端。