跳到主要内容

配置只读沙箱

提示词中的“不要修改文件”是一条任务要求,还需要配置执行权限。本页以 Codex 的只读沙箱为上手路径;Claude Code 中同名的文件范围选项对应 Plan 模式,两者的隔离方式不同。

设置位置​

  1. 展开左侧边栏,从底部打开 设置。
  2. 进入 AI 助手。
  3. 在页面上方的 AI 助手配置卡片中找到 Codex。
  4. 找到该 Runtime 下的 文件访问范围下拉框,选择只能读取文件。
  5. 等待设置应用,结束当前任务后重新连接或重启 SciForge;不要沿用尚未确认权限的运行中任务。
  6. 回到工作台,新建会话,并在输入框右下角确认执行者为 codex。

页面顶部的“权限范围”快捷按钮定位到 Computer Use 配置;文件访问范围在各 Runtime 自己的配置栏中。

SciForge AI 助手设置中的文件访问范围 图示值允许修改工作区;只读任务应选择“只能读取文件”。

执行者“只能读取文件”的实际含义使用边界
Codex请求 Codex 的 readOnly 沙箱,并关闭该沙箱中的命令网络访问适合本教程的本地文件检查;遇到扩大权限的请求应停止并核对
Claude Code使用 Claude Code 的 plan 权限模式用于分析与规划;不能据此声称具有与 Codex 相同的文件系统沙箱隔离
DSH没有同名的文件访问范围选项;原生 shell 默认关闭,仅对用户安装的 DSH 开启后逐条批准本教程使用 Codex;不能把 DSH 的 shell 开关当作文件系统只读沙箱

MCP、远程命令和 Computer Use 的权限需要分别核对;第一次任务只使用读取本地项目所需的工具。

添加工作区外文件、拖入文件或粘贴图片可能先将文件导入工作区。只读检查请引用已有文件,并在导入完成后重新记录基线。输入框上方移除附件只会取消本次发送,不会删除已经导入的文件。

只读模式允许什么​

通常可以:

  • 列出目录和读取文本文件
  • 搜索源码与配置
  • 查看 Git 状态和差异
  • 执行不会写入工作区的检查
  • 给出分析、计划和建议

不应允许:

  • 创建、覆盖、重命名或删除文件
  • 安装会写入项目的依赖
  • 运行会生成缓存、日志或构建产物的命令
  • 修改 Git 索引、提交或分支

命令是否真正只读取决于其行为,而不是命令名称。某些测试和解释器会自动生成缓存;在只读沙箱中遇到写入失败时,应更换检查方式,不能为了完成教程直接扩大权限。

双重验证​

在 Git 项目中分别于任务前后运行:

git status --short

Git 状态比较用于发现变更,不能代替执行隔离;它也不会列出被 .gitignore 忽略的文件。需要严格核对全部文件时,使用项目副本并额外比较任务前后的文件清单与内容哈希。

如果输出发生变化:

  1. 立即停止后续任务。
  2. 让 Agent 列出改动,并用 git diff 核对文件差异。
  3. 不要自动删除或还原已有修改。
  4. 判断改动来自任务、工具缓存还是任务前已存在的状态。

什么时候切换到工作区写入​

只有当任务明确需要生成脚本、表格、图表或文档,并且你已检查计划与输出路径时,才切换到“可修改工作目录”。写入型任务应使用项目副本或干净分支,并在结束后审查变更。

下一步:与 Agent 协作。