Codex Profiles 配置：独立文件、切换方式与旧写法迁移

先看版本：新旧教程不能混用

先运行 codex --version。官方文档说明：从 Codex 0.134.0 开始，--profile 不再读取 config.toml 里的 [profiles.<名称>]，顶层 profile = "名称" 也不再受支持。本文针对新写法；旧版本用户应先确认本机帮助与对应版本行为。

基础文件放共用项

保留已验证可用的模型、供应商和登录设置。示例只展示与场景有关的差异，不要求你覆盖整个现有文件。

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

新建一个只读审查 Profile

sandbox_mode = "read-only"
approval_policy = "on-request"

codex --profile review

review.config.toml 里直接写顶层键，不要再包 [profiles.review]。名称可使用字母、数字、连字符与下划线。需要改变模型或推理强度时再加对应键，并确认所选模型支持这些值。

为什么 Profile 的设置也会被覆盖

当前顺序中，命令行覆盖和受信任项目配置都高于 Profile，Profile 高于用户基础配置。因此这个 review 示例只设置只读默认值，不是不可更改的安全边界。启动后用 /status 验证实际权限；如果项目配置把它改回可写，不要仅凭文件名判断安全。

codex --profile review --sandbox read-only --ask-for-approval on-request

迁移时一次只改一个 Profile

1. 备份 config.toml，记录现有启动脚本。
2. 把旧 [profiles.review] 中的键移到 ~/.codex/review.config.toml 顶层。
3. 移除已迁移的旧表和顶层 profile 选择器，避免留着两套定义误导后续维护。
4. 用 --profile review 启动新会话，核对模型、权限和供应商日志。
5. 修改桌面端时单独核对其配置入口；CLI 的 --profile 不代表图形客户端会自动选择同一文件。

回退只需不再传 --profile，并恢复必要的基础配置；如果连基础配置也改过，使用备份恢复。下一步阅读 配置优先级 或 权限与审批。