你希望有人检查现有项目,但不希望对代码进行修改或更改设置。这种情况下,请以只读模式启动 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。

两者都需要在此基础上,在请求中写明“仅调查并给出建议,不要实现”。这里能保护的是目标项目的源代码,并不意味着会话记录、日志和计划文件的保存也会一并消失。
Codex 应用、IDE

确认设置界面与共享设置。不要只看审批菜单就下结论,请确认文件写入限制。

Claude Desktop、VS Code

在界面中选择 Plan。在界面中选择的 Plan 只对该次会话生效。

CLI、Web、手机

请前往 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。

审批与写入分开查看

1
在 Configuration 中确认文件权限

如果 Sandbox settings 为 Workspace write,则可以写入工作区。仅用于调查时,请确认相当于 read-only 的限制。

2
确认审批策略

Approval policy 用于设置如何处理超出限制的执行。仅靠要求审批的设置,无法禁止编辑工作区。

3
在用于调查的新会话中确认生效状态

发送请求前,请确认输入框下方的权限控制项以及当前生效的设置。如果已有工作在运行,请先停止。

如果找不到设置项,请使用下面的 config.toml 进行确认。

来源:官方 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

1
在 Code 标签页中选择环境和文件夹

确认 Environment 是 Local、Cloud、SSH、WSL 中的哪一个,以及 Project folder 是否为要调查的对象。

2
从发送按钮旁的模式中选择 Plan

Manual 是编辑需要批准的模式,Accept edits 是自动批准编辑的模式。仅用于调查时,选择 Plan。

3
只请求报告,不切换到实现

发送下面的提示词,阅读计划后结束。调查的后续步骤也保持在 Plan 中进行。

在 Desktop 中,与终端不同,不用 Shift+Tab 切换模式,而使用发送按钮旁边的选择器。

在选择器中选择的 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 注意事项
claude.ai/code

从输入框附近的模式菜单中选择 Plan。Cloud 支持 Accept edits 和 Plan。Auto 需要组织允许以及支持的模型,且无法使用 Bypass permissions。

手机

在 Claude Code 会话中,点击输入框中的“+”→ Permission 来选择模式。使用 Remote Control 时,还需注意手边正在运行的会话的权限会发生变化。

JetBrains

插件是在 IDE 内的终端中使用 CLI 的方式。请使用下面的 CLI 启动示例或 Shift+Tab,不要套用 VS Code 独有的设置名称。

Cloud 中普通的文件编辑会被预先批准,因此调查时应明确选择 Plan,并给出报告后不再进入实现的提示词。来源:各界面的切换方式、Cloud 的模式。

CLI:以 Plan 启动,不批准实现

使用 Claude Code CLI 时,可以用下面的参数从 Plan 模式开始。普通的 Plan 会读取文件,调查结构和问题,并规划修改方案。通常会阻止源代码编辑工具进行修改,但会创建计划文件。

claude --permission-mode plan

在收到调查结果时停下来

1
确认 Plan 状态和启动条件

在交互式终端中可以用 Shift+Tab 切换。也请确认当前启动状态是否可以使用绕过权限。

2
只请求问题、依据和建议

完成条件应是包含目标文件和行号的报告,而不是编辑或构建。

3
不批准计划的实现

计划出现后,请阅读内容,或选择 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 的 Permission profiles 针对本地命令;MCP、已连接的应用、浏览器、Cloud 等则使用另外的控制方式。

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 的方式。