codex无法读取项目是因为未设置项目根目录。需在app中手动选择本地文件夹作为根目录,mac用户应避免系统高危路径并手动输入路径,windows用户需检查环境变量path,最后完成三步权限校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex无法读取项目,是因为它根本不知道该从哪开始读——工作区未划定,AI就像站在一整栋楼前却没拿到任何一把门钥匙,连首层目录都进不去。这个问题在新安装用户中占比超70%,多数人反复重装却始终卡在第一步。
确认项目根目录是否已设置
打开Codex App → 点击左侧导航栏的「项目」入口 → 在弹出的访达/文件资源管理器窗口中,必须手动选择一个明确的本地文件夹作为根目录(例如你的Git仓库所在路径,如 D:\my-app 或 ~/Projects/react-demo)→ 点击“选择”或“确定”。
这一步不可跳过。Codex默认对所有本地路径无访问权,只有被显式选中的文件夹及其子目录才纳入沙箱范围。未执行此操作就直接提问“读取package.json”,AI会静默返回“文件不可访问”,不会报错,极难定位。
Mac用户:避开系统高危路径
Mac版Codex在访达弹窗中若停留在桌面、下载或文稿目录,极易触发解析卡死。因为这些位置混有.DS_Store、iCloud冲突文件或符号链接,Codex尝试读取时会无限等待。
正确做法:访达窗口弹出瞬间,立刻按 Command+Shift+H 回到当前用户主目录 → 在地址栏直接粘贴路径,例如:~/Desktop/codex-test → 回车确认。
不要点击左侧边栏的“桌面”图标——它实际指向的是 /Users/xxx/Desktop,但底层可能被iCloud同步层拦截;而手动输入路径可绕过Finder的元数据劫持,确保真实路径透传给Codex。
Windows用户:检查安装路径与环境变量
方法一:验证Codex是否真正在PATH中
按下 Win + R → 输入 cmd → 回车 → 执行:codex --version。
若提示“不是内部或外部命令”,说明系统找不到可执行文件。此时需确认Codex是否安装在非系统盘(如D:\Codex\),并手动将该路径添加至系统环境变量PATH中。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:临时注入路径快速验证
关闭所有终端 → 以管理员身份启动PowerShell → 执行:$env:Path += ";D:\Codex"(把D:\Codex换成你的真实安装路径)→ 再运行 codex --version。
若此时能返回版本号,证明路径本身正确,只是系统级PATH未被新进程加载——必须重启电脑才能让Explorer、IDE等全部进程识别更新后的环境变量。
权限校验三步走
第一步:确认Codex是否获得对应系统权限
macOS:系统设置 → 隐私与安全性 → 文件和文件夹 → 找到「Codex Computer Use」→ 勾选它;若列表中无此条目,先在Codex内执行一次 ls 命令触发授权注册。
第二步:检查目标文件夹用户权限
在访达中右键点击你选定的项目文件夹 → “显示简介” → 展开「共享与权限」→ 确保你的用户名对应权限为「读与写」;若为灰色或仅「只读」,点锁图标解锁 → 修改权限 → 点齿轮图标 → 选择「应用到所有项目」。
第三步:确认项目目录未被标记为受限位置
【关键前提】Codex只能访问你明确添加进项目根目录的路径及其子目录。把文件拖进一个未被授权的桌面文件夹,再试图拖进Codex,系统压根不会转发路径信息——这不是Codex bug,是macOS强制隔离策略。










