Codex CLI无法读取文件的原因与解决方法

先说一个让很多用户头疼的问题：Codex CLI 明明已经安装成功，也能正常启动，但一旦让它读取本地文件，就反复报错“文件不可访问”。不少人会来回检查路径、文件名拼写，甚至卸载重装，结果问题依旧没有解决。其实，这类 Codex CLI 无法访问本地文件的问题，根源通常只有两个——要么项目工作区范围没有设置正确，要么系统权限没有完整授权。更麻烦的是，程序往往不会直接提示“权限不足”，而是只返回一个模糊的“文件不可访问”，导致排查过程非常费时。

简单理解就是，AI 对项目目录外的文件“够不着”，而对项目目录内的文件又可能“没权限动手”。例如你没有先配置项目根目录，就直接让它执行“帮我修改 src/utils.js”，它通常只会机械地回复“文件不可访问”，而你很难第一时间判断到底是路径问题、工作区问题，还是系统授权问题。

第一步：确认项目根目录已正确设置

打开 Codex 桌面 App → 点击左侧导航栏中的「项目」入口 → 在弹出的窗口中选择你希望 Codex 操作的本地项目根文件夹（例如 Git 仓库所在目录）→ 确认后，左下角会显示当前已绑定的路径。

【必须执行】这一步绝不是可有可无。Codex 默认不具备对任意本地路径的读写权限，只有你手动指定的文件夹及其子目录范围内，AI 才能正常执行 read、write、run 等操作指令。

第二步：按系统补全必要系统权限

macOS 用户需要同时开启 Screen Recording 和 Accessibility 权限；Windows 用户则应通过 Microsoft Store 安装，并以管理员身份运行 Codex。

方法一：通过 Codex 设置页触发授权
进入 Codex Settings → 左侧选择「Computer Use」→ 点击 Install 完成组件安装 → 系统会自动弹出两个授权窗口，这两个权限必须都允许：Screen Recording 和 Accessibility。

方法二：手动补充权限（适用于系统未弹窗时）
前往「系统设置 → 隐私与安全性 → 录屏与系统录音」→ 点击右下角锁形图标解锁 → 在列表中勾选「Codex Computer Use」；然后进入「辅助功能」→ 同样解锁后勾选「Codex Computer Use」。

【关键提醒】很多用户只开启了录屏权限，结果 AI 虽然能看到文件列表，却无法双击打开文件——原因正是 Accessibility 权限缺失，导致文件管理器相关操作被系统拦截。

第三步：检查 Windows 下的隐藏目录权限问题

1. 打开文件资源管理器，进入 C:Users你的用户名.codex 目录。
2. 右键 → 属性 → “常规”选项卡 → 取消勾选“隐藏”属性（如果当前已勾选）→ 应用。
3. 切换到“安全”选项卡 → 点击“编辑”→ 选中当前用户 → 勾选“完全控制”→ 确定。
4. 重启 PowerShell 或终端后，再次运行 codex 命令。

在 Windows 环境中，以 . 开头的目录（例如 .codex）虽然不像 Unix 那样具有特殊语义，但某些工具在创建时可能会附带隐藏属性或系统属性。这会导致 PowerShell 底层调用 Get-Item 时出现“拒绝访问”错误，看起来像是 Codex CLI 权限异常，实际上未必是真正的文件权限缺失。

第四步：验证 CLI 是否能正常访问目标文件

在终端中执行：
codex --debug read "src/utils.js"

如果返回 Error: file not found，通常说明路径拼写有误，或目标文件不在已设置的项目根目录范围内；
如果返回 Error: permission denied，则说明系统级权限尚未正确生效；
如果能够直接返回文件内容，就表示 Codex CLI 读取本地文件的访问链路已经打通。

注意：这里填写的路径必须是相对于你设置的项目根目录的相对路径，不能使用绝对路径，也不能访问上级目录文件（例如 ../outside.js）。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Codex CLI无法读取文件的原因与解决方法要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题