配置工作目录与权限：从可控的小范围开始

01 · 先读现有配置

Codex 的个人配置通常位于 ~/.codex/config.toml，也可能受自定义 CODEX_HOME 或组织策略影响。先在客户端确认当前配置位置。已有配置时保留副本并只改需要的项，不覆盖认证文件。

codex --help
# 查看帮助后，从需要工作的项目目录启动
codex

02 · 理解两个不同的开关

下面是个人配置中的两个示例字段，不是要求覆盖你的整份文件。sandbox_mode 控制可访问范围；approval_policy 控制何时请求审批。即使两项写入成功，组织策略、系统限制或宿主应用设置仍可能收紧权限。

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

03 · 用状态与只读请求交叉检查

在交互会话里用 /status 查看当前配置，用 /permissions 查看可选权限。再请求列出当前目录和适用规则；预期结果应与实际打开的项目一致。不要通过关闭全部限制来解决一个路径错误，也不要让初次任务修改项目外文件。

/status
/permissions

04 · 遇到失败先定位约束

文件写入失败，先核对路径、目录权限和沙箱边界；网络失败则检查连接、代理及允许的网络范围。不要因为一个下载失败就把所有执行权限放开。调整之后新开会话再检查状态，确认本次任务实际采用的设置。

请先只读检查：当前目录是什么？适用哪些项目规则？
本次任务需要写入哪些文件、访问哪些网络地址？
先说明需求与当前限制，再提出最小调整。

常见问题