Codex连接超时往往不是网络问题,而是沙箱限制导致:需确认项目目录是否正确打开、config.toml未引用外部路径、实际加载配置是否为项目级文件,必要时临时启用workspace-write模式调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex连接超时后,不能直接重装或改API Key,必须先确认当前任务是否被限制在项目目录沙箱内——很多超时实际是因Codex尝试访问工作区外文件触发审批阻塞,而非网络问题。
确认当前项目目录是否被正确识别
打开终端,进入你正在使用的项目根目录(不是用户主目录,不是桌面,不是任意空文件夹),执行:pwd。确保输出路径是你真正想让Codex操作的代码所在位置,比如 /Users/xxx/project/my-app 或 C:\dev\my-api。
这一步非常关键。如果当前路径是 /Users/xxx 或 C:\ 这类宽泛路径,Codex会默认把整个用户目录当作工作区,但沙箱机制可能拒绝跨盘符/跨分区读写,导致请求卡在“准备中”或直接超时。
检查 .codex/config.toml 中是否引用了外部路径
用文本编辑器打开 项目根目录下的 .codex/config.toml(注意:不是用户目录下的 ~/.codex/config.toml)。
逐行检查是否有类似 workspace_path = "/home/shared"、include_dirs = ["/etc", "/var/log"] 这类指向项目目录之外的配置项。
【Codex 默认只信任项目根目录及其子目录】。一旦配置里写了绝对路径或上级路径(如 ../config),它就会触发沙箱审批流程;若审批策略设为 never 或未手动批准,请求将挂起直至超时。
删掉所有超出当前项目范围的路径配置,只保留相对路径引用,例如 include_dirs = ["src", "tests"]。
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
验证 Codex 实际加载的是哪个 config.toml
第一步:运行 codex --debug info(或 codex info,取决于版本),观察输出中 config loaded from: 后面的路径。
第二步:对比该路径是否为你刚刚编辑的那个文件。常见陷阱包括:
• 项目根目录下有 .codex/config.toml,但终端不在该项目目录下启动,Codex 就会 fallback 到用户级 ~/.codex/config.toml;
• 文件名写成了 config.toml.txt,系统无法识别;
• VSCode 插件单独指定了 settings.json 中的 config 路径,和 CLI 完全不共享。
第三步:如果发现加载路径不对,立刻 cd 进正确项目目录再试;若插件场景,则去 VSCode 设置里搜 codex.configPath,手动填入项目内绝对路径。
临时关闭沙箱验证(仅调试用)
方法一:启动时加参数绕过限制
在项目根目录下运行:codex --sandbox=workspace-write --approval-policy=on-request your-command。
方法二:修改项目级 config.toml
在 [sandbox] 区块下添加或修改两行:sandbox_mode = "workspace-write"approval_policy = "on-request"。
【不要在生产环境长期启用 workspace-write】。该模式允许 Codex 修改项目目录外的文件,但会降低安全性。调试确认是沙箱问题后,应立即恢复为 read-only 并把所需文件移进项目目录。

















