你希望有人检查现有项目,但不希望对代码进行修改或更改设置。这种情况下,请以只读模式启动 Codex,以 Plan 模式启动 Claude Code,并请求它“仅调查并给出建议”。两者名字相似,但运作机制并不相同。
结论:先用这一行命令启动
Codex
只读 + 不额外请求批准codex --sandbox read-only --ask-for-approval never在应用和 IDE 中,请在 Sandbox settings 里选择相当于只读的限制。
Claude Code
以 Plan 模式开始claude --permission-mode plan在 Desktop、VS Code 和 Web 中,请在输入框附近的模式选择器里选择 Plan。
确认设置界面与共享设置。不要只看审批菜单就下结论,请确认文件写入限制。
在界面中选择 Plan。在界面中选择的 Plan 只对该次会话生效。
请前往 Codex CLI、Claude Code CLI,或 Claude 的 Web 版与手机版。也要确认执行环境。
1. “不要修改”与权限限制的区别
例如,如果请求“检查登录处理中的问题”,就很难判断你是希望调查后继续修复,还是只需要报告问题就停止。写“不要修复”虽然能传达目的,但仅凭这句话,并不能消除编辑工具或 shell 的写入能力。
把传达目的与停止执行分开看待
提示词
希望它做什么写明“仅调查与给出建议,不要实现”。同时确定报告格式和结束条件。
产品的权限控制
允许使用哪些工具通过 Plan 或工具限定,限制用于实现的操作。确认审批或模式切换会在什么条件下改变范围。
执行环境的限制
如何保护写入位置通过沙箱或操作系统权限,限制实际的写入。确认适用的进程及例外情况。
Claude Code 的官方文档也说明,提示词和 CLAUDE.md 会影响模型打算做什么,而允许执行哪些操作由权限系统决定。如果在 Codex 的 AGENTS.md 中写入禁止事项,也请将其与实际权限的作用区分开。来源:Claude Code 权限。
2. Codex:应用、IDE 与 CLI 设置
桌面端:在设置界面确认写入限制
在桌面应用中,从应用菜单打开Settings(设置)→ Configuration(配置)。打开设置的快捷键在 Windows 上是 Ctrl+,,在 macOS 上是 Cmd+,。官方的 Configuration 界面分别显示了Approval policy和Sandbox settings。
审批与写入分开查看
如果 Sandbox settings 为 Workspace write,则可以写入工作区。仅用于调查时,请确认相当于 read-only 的限制。
Approval policy 用于设置如何处理超出限制的执行。仅靠要求审批的设置,无法禁止编辑工作区。
发送请求前,请确认输入框下方的权限控制项以及当前生效的设置。如果已有工作在运行,请先停止。
来源:官方 Configuration 界面、设置的打开方式、输入框中的权限控制项。
界面中找不到时:通过 config.toml 确认
可从 Settings → Configuration → Open config.toml 打开设置文件。用户设置通常位于 ~/.codex/config.toml。在传统的沙箱设置中,以下取值分别对应只读,以及不额外请求审批的策略。
sandbox_mode = "read-only"
approval_policy = "never"
用户设置也会影响读取同一设置的应用、IDE 扩展和 CLI。受信任项目中的 .codex/config.toml、启动时的指定以及托管策略同样有关,因此仅凭文件中有这两行,不能判定其已生效。在 CLI 中,可以用 /status 或 /debug-config 查看执行条件和设置的来源。如果只想在本次运行中调查,而不改变永久设置,可以使用下面的 CLI 示例。
新的 Permission profiles 是测试版功能,是另一种设置方式,用于选择内置的 :read-only 等配置。与传统的 sandbox_mode 或 --sandbox 同时使用时,有时会优先采用传统设置,托管策略也可能形成例外。请先确认现有方式,不要同时添加两种设置。来源:打开设置文件的路径、设置的优先级、Permission profiles。
Ask for approval 并不等于“禁止编辑”
输入框中的 Ask for approval(请求批准)会在允许的工作区内,按策略自动处理操作。Approve for me 会把符合条件的审批转交给自动审查。两者都不是仅凭选择就能让工作区变为只读的设置。Full access 也无法替代仅调查的设置。
Codex 的 /plan 是在实现前请求制定计划的功能,不是限制文件写入的设置。它也与 Claude Code 的 Plan 不同。来源:Codex 的 /plan。
IDE 扩展:从齿轮图标打开 Codex Settings
在 Codex 侧边栏顶部点击齿轮图标 → Codex Settings可查看共同设置,详细内容可通过Open config.toml确认。也请确认输入框中的权限控制项。编辑器中的扩展设置与代理读取的 config.toml 是两回事。即使关闭了传递已打开文件的 IDE context,也不等于禁止代理读取文件。来源:各客户端的 Developer settings。
CLI:在本次启动选项中指定
如果环境中已经可以使用 Codex CLI,请在打开了调查目标文件夹的终端中,按如下方式启动。无需永久改写设置文件。如果有组织的管理策略,则以管理策略为准。
codex --sandbox read-only --ask-for-approval never
--sandbox read-only
选择写入限制在只读沙箱内读取可访问的文件并执行命令。
--ask-for-approval never
不请求审批,在限制范围内继续不额外请求审批。无法执行的操作不会通过扩大限制来继续,而是作为无法执行的事项报告。
never并不代表全部权限。沙箱类型与审批策略是不同的设置,官方的组合表中也包含同时使用 read-only 与 never 的示例。来源:Agent approvals & security。
使用 --ask-for-approval on-request 时,对于超出沙箱的操作可能会请求审批,如果在此批准,只读的边界就会被打破。“需要时先问我再修改”与“这次不做修改”要分开使用。
调查过程中应避免的操作
不要为了消除错误而当场切换到 Full access,或批准超出限制的执行。如果只是调查,记录“该检查未执行”就足够了。
Web、Cloud 与 Remote:区分显示端与执行端
Web 版的 Work 使用受管理的执行环境,不会读取你本地的 Codex 设置文件。仅在电脑端写入上面两行,并不能让 Cloud 中的执行变为只读。对于 Cloud,请确认使用界面和工作区中提供的控制项。
通过 Remote 在其他屏幕上查看电脑端的工作时,需要保护的设置是命令实际运行一侧的条件。不要以为把查看端设为只读就足够了。关于各环境的区别,请参见Codex 本地、Remote 与 Cloud 的使用区分。来源:Web 与本地设置的区别。
3. 仅将 Claude Code 用于调查与规划
Claude Desktop:在 Code 标签页的发送按钮旁选择 Plan
对象是 Claude Desktop 的Code 标签页。Chat 和 Cowork 的设置与 Claude Code 的权限模式是两回事。模式名称采用官方英文名称。关于各模式的区别,请参见Claude Code 权限模式解析。
发送前确认执行位置与 Plan
确认 Environment 是 Local、Cloud、SSH、WSL 中的哪一个,以及 Project folder 是否为要调查的对象。
Manual 是编辑需要批准的模式,Accept edits 是自动批准编辑的模式。仅用于调查时,选择 Plan。
发送下面的提示词,阅读计划后结束。调查的后续步骤也保持在 Plan 中进行。
在选择器中选择的 Plan 只适用于该会话。其他模式的选择会按文件夹记忆,并且优先于设置文件中的 permissions.defaultMode。如果希望即使在新会话中也只做调查,请每次都确认 Plan 的显示。来源:Desktop 的权限模式与保存范围。
VS Code:从输入框下方的模式显示中选择 Plan
打开 Claude Code 聊天面板,选择输入框下方的模式显示 → Plan。
VS Code 的详细设置(新会话也设为 Plan、自动保存)
根据版本不同,也可以在面板中发送 /plan 进行切换。即使计划以 Markdown 文档形式打开,也应将其作为调查结果阅读,而不要批准实现。
希望新会话也使用 Plan 时
- 打开 VS Code 设置(Windows/Linux 为 Ctrl+,,macOS 为 Cmd+,)
- 在 Extensions → Claude Code 中,确认
claudeCode.initialPermissionMode的用户设置 - 如果要将启动模式固定为 Plan,请在该用户设置中指定
plan - 打开新会话,确认实际显示的是否为 Plan
根据当前官方规范,claudeCode.initialPermissionMode的工作区设置会被忽略。另外,在聊天中仅选择 Plan,也只对该会话有效。不要认为只要在项目的 .claude/settings.json 中设置 permissions.defaultMode,VS Code 的启动模式就一定会改变。请确认扩展的启动设置、上次选择的普通模式,以及管理与用户设置的优先顺序。
未保存的文件也需要注意。扩展的 claudeCode.autosave 是在 Claude 读取或写入之前,先保存编辑器中修改的设置。请分别确认 AI 对源代码的编辑,以及编辑器的保存。自动附加已打开文件的设置,也与禁止文件访问是两回事。来源:VS Code 的模式操作、扩展设置与优先级。
Web、手机与 JetBrains 中的操作
在 Web 和手机上也是从模式选择中选择 Plan。JetBrains 的操作与 CLI 相同。
各界面的操作与 Cloud 注意事项
从输入框附近的模式菜单中选择 Plan。Cloud 支持 Accept edits 和 Plan。Auto 需要组织允许以及支持的模型,且无法使用 Bypass permissions。
在 Claude Code 会话中,点击输入框中的“+”→ Permission 来选择模式。使用 Remote Control 时,还需注意手边正在运行的会话的权限会发生变化。
插件是在 IDE 内的终端中使用 CLI 的方式。请使用下面的 CLI 启动示例或 Shift+Tab,不要套用 VS Code 独有的设置名称。
Cloud 中普通的文件编辑会被预先批准,因此调查时应明确选择 Plan,并给出报告后不再进入实现的提示词。来源:各界面的切换方式、Cloud 的模式。
CLI:以 Plan 启动,不批准实现
使用 Claude Code CLI 时,可以用下面的参数从 Plan 模式开始。普通的 Plan 会读取文件,调查结构和问题,并规划修改方案。通常会阻止源代码编辑工具进行修改,但会创建计划文件。
claude --permission-mode plan
在收到调查结果时停下来
在交互式终端中可以用 Shift+Tab 切换。也请确认当前启动状态是否可以使用绕过权限。
完成条件应是包含目标文件和行号的报告,而不是编辑或构建。
计划出现后,请阅读内容,或选择 No, keep planning 继续调查。选择 Yes 后会退出 Plan 并进入实现。
Plan 中 shell 命令的处理
Plan 中的 shell 命令也并非只限读取命令。在 auto 模式可用且 useAutoModeDuringPlan 为开启时,存在由分类器审查并允许的路径。auto 不可用等情况下,对于内置只读命令范围之外的命令,会请求批准。来源:Permission modes 中的 Plan 说明。
在 Plan 中,编辑限制也可能被解除
根据官方文档,在可使用绕过权限的交互式终端会话中,不会强制执行 Plan 的编辑与命令限制。即使显示为 Plan,尝试的编辑或命令也可能被执行,因此也要确认启用绕过权限的启动参数和设置(-p、SDK 与 VS Code 聊天面板的处理方式不同)。来源:bypassPermissions 的说明。
不希望使用 shell 或编辑工具时
如果只需要调查结构或读取代码,可以用 --tools 限定内置工具。下面的示例将文件调查工具限定为 Read、Glob、Grep,并拒绝 MCP 工具。用于结束会话的 EndConversation 会保留。调查能力会比普通 Plan 更窄,需要运行命令的检查将无法进行。
claude --permission-mode plan --tools "Read,Glob,Grep" --disallowedTools "mcp__*"
这里不要替换为 --allowedTools。后者是指定“无需确认即可使用的工具”,而不是把可用工具限定为这些工具。另外,仅使用 --tools 并不能限制 MCP,因此需要另外指定。来源:CLI reference。
Desktop 中的处理,以及更严格的 --restricted
Desktop 没有与 CLI 的 --allowedTools 或 --disallowedTools 相同的会话级 UI 指定。设置文件中的权限规则会生效,但仅靠 Plan 按钮,并不能达到与本工具限定示例相同的状态。来源:Desktop 与 CLI 的对应范围。
这个示例也不能让包括应用自身保存处理、所读取的设置和钩子在内的整台电脑都变为只读。如果要打开不熟悉的项目,还需另外确认已有钩子、插件和外部连接的处理方式。更严格的运行所使用的 --restricted 是 v2.1.248 之后的功能,它不仅改变工具,还会改变设置的读取范围等。它并不是让你保持平时环境不变的 Plan 别名。
需要持续管理工具权限时,请参见Claude Code 的 allow、ask 与 deny 设置;需要隔离 Bash 时,请参见沙箱设置与限制。默认允许写入工作文件夹的隔离,与仅调查的目的不同。
4. 可直接使用的调查专用提示词
准备好权限后,请让会话以报告结束。与其说“修复它”或“改进它”,明确要调查什么、以什么形式返回才算完成,能减少导致进入实现的误解。
本次只请对现状进行调查并给出建议。不要实现。
对象:本项目的登录处理与授权边界。
允许:读取可访问的源代码,并说明结构与问题。
禁止:创建、编辑或删除文件;修改设置;添加依赖项;
构建、测试、数据库操作、commit 或 push、部署,以及修改外部服务。
不得为了运行钩子或脚本而扩大权限。
提交物:
1. 处理流程,以及调查过的文件和行号
2. 每个候选问题的依据、影响和优先级
3. 未执行的改进方案,以及若要实现需要确认的事项
4. 仅凭读取无法判断的内容,以及未执行的检查
如果需要修改,请不要执行,只以建议的形式停止。
提交调查结果后,就在该时点结束。
“从保存与读取处理及异常处理中,调查导致保存内容丢失的原因候选。”如果日志中包含机密信息,请先确定可以共享的范围。
“说明模块之间的依赖关系,并指出职责重叠的地方。”实际的重构不包含在提交物中。
“阅读所有者确认、认证、授权和输入验证。”执行攻击代码或向生产环境发送请求,应作为另外的工作来处理。
即使同意改进方案,也请在调查会话中回复“作为采用候选保留,不实现”。实现应拆分到重新界定范围的开发会话中进行。
5. 开始前与结束后要确认的事项
不要仅以“模型说它没有修改”就结束,要通过显示、设置和差异来确认。
开始前:统一目标与执行条件
- 确认调查对象文件夹,以及允许其读取的信息
- Codex 请确认文件权限与审批策略;Claude Code 请确认 Plan 与绕过权限的启动条件
- 确认新会话中是否仍保持同一模式,以及共享设置是否会影响其他客户端
- 确定调查中使用的操作范围:shell、MCP、浏览器、外部应用等
- 掌握自己未提交的修改和未跟踪的文件,并保留调查后用于比较的基准
- 以提交报告作为结束条件,因权限不足而无法进行的检查,要求其作为未执行的项目返回
如果在 Git 管理下,比较差异
例如,用下面的命令可以确认已更改的文件,以及已暂存和未暂存的差异。在调查前后都进行确认,避免把之前就存在的自己的修改误认为是 AI 的修改。这是目标仓库已在使用 Git 的情况下的示例。
git status --short
git diff --stat
git diff --cached --stat
git diff 不会反映未跟踪文件、被忽略的文件、工作文件夹之外的内容、数据库或外部服务的变化。即使修改后又还原的操作,也不会留在最终差异中,因此请分别记录已确认的对象与未确认的对象。Git 官方:git status、git diff。
结束后:不要把报告当作实现的结果来读
- 问题候选是否带有文件、行号和处理依据?
- 是否将静态阅读的判断与实际复现、测试的结果区分开?
- 调查前后的差异中,是否有无法说明的修改?
- 因权限不足或禁止执行而无法确认的项目,是否已明确标注?
- 后续需要的工作是否作为“建议”保留,而没有被擅自开始?
6. 无法调查的范围与残留风险
测试和构建也会涉及写入
即使不编辑代码,测试也可能写入临时文件或快照,构建可能写入产物,包管理可能写入缓存。在只读状态下测试失败,有时是限制带来的结果,而不是缺陷。
对于只有运行才能知道的事情,不要在生产数据库或涉及机密的设备上允许写入,而应计划在单独的验证环境中复现。
仅限制源代码的写入,无法保护到这种程度
有读取权限的信息可能被用于调查。只读与禁止读取机密文件是不同的措施。
MCP 或已连接的应用可能能够修改工单、代码仓库等。请与本地的写入限制分开确认。
会话和计划的保存,与修改目标源代码是两回事。这不是一个能把电脑上所有写入都降为零的启动示例。
Codex 的网络限制也区分了沙箱内命令的通信,与模型、认证等服务通信。只读是对写入的限制,因此所读取的内容仍会像以前一样传给模型。用于训练的使用是另外的设置。来源:Permissions 的适用范围。关于阻止读取机密的措施,请参见Codex 的机密文件与权限;关于训练使用与存储设置,请参见ChatGPT 与 Codex 的训练使用和隐私。
无法按预期限制时
- 没有该项:确认你使用的产品、版本、执行位置,以及组织的管理限制。不要切换到绕过限制的设置。
- 测试失败:区分是需要写入,还是代码本身的问题。将未执行的检查记入报告。
- 中途才限制:已经执行的修改无法恢复。请停止正在进行的处理,确认差异后,再开始新的调查会话。
在 monorepo 中按文件夹分工时,也请一并确认子目录中的 CLAUDE.md、AGENTS.md 何时被加载,以及如何用自动检查让 AI 遵守规则。
总结
Codex 指定只读与审批策略;Claude Code 确认 Plan 的启动条件,如有需要还可以限定可用工具。在此基础上,传递一段在提交报告后即结束的提示词。两种方式都能将“调查”与“执行修改”区分开来运作。
即使有无法调查的项目,也不要切换为全部权限。请接受未执行的项目以及下一步的验证建议。
本文的前提:于 2026年10月9日,依据 OpenAI 与 Anthropic 的官方文档撰写。启动示例未在实际设备上运行,因此使用前请确认界面显示以及设置是否真正生效。
相关文章:如果要在允许编辑的开发中减少等待审批的时间,请参见Codex 的 Goal mode 与自动审批审查的区分使用。
FAQ
如果请求“只做调查”,就会变为只读吗?
目的能够传达,但实际的编辑能力和命令权限并不会改变。请在提示词之外,结合使用 Codex 的沙箱或 Claude Code 的 Plan 与工具限制,并确认哪些内容受到限制。
使用 Claude Code 的 Plan,文件就绝对不会被修改吗?
不是。通常会阻止源代码编辑,但会创建计划文件。官方还有一个例外:在可使用绕过权限的交互式终端会话中,不会强制执行 Plan 的限制。它并不是禁止整台电脑写入的模式。
Codex 的 never 是指无需确认就执行任何操作的设置吗?
它是一个不请求审批的设置,并不意味着解除沙箱。与 read-only 组合使用时,会在该限制范围内进行调查。请将它与授予全部权限的启动方式区分开。
如果只是只读,能否说安全检查已经完成?
不能。通过阅读源代码发现的问题候选与实际运行后复现的结果是两回事。如果无法确认设置、执行环境和依赖的服务,结论就会有局限。请报告依据和未确认的事项,并将必要的验证计划在单独的验证环境中进行。
在 Codex 应用中选择“要求批准”,就不会修改文件了吗?
仅凭这一点无法禁止。审批策略与文件写入限制是两回事。请确认 Configuration 与当前生效的权限,若仅用于调查,请使用相当于 read-only 的限制。
在 Claude Desktop 或 VS Code 中选过一次 Plan,下次也会是 Plan 吗?
在选择器中选择的 Plan 只适用于该聊天或会话。请每次确认显示。若要在 VS Code 中固定启动模式,可以使用用户设置 claudeCode.initialPermissionMode 的方式。