agent sandbox reset
把沙箱配置重置为默认值。
agent sandbox reset 是“agent sandbox”类别下的一个子命令,会把对 Sandbox 配置所做的个别调整重置为默认值(“Reset sandbox configuration to defaults”)。 相关的兄弟子命令有 agent sandbox enable(启用命令执行的 Sandbox 模式)、agent sandbox disable(关闭 Sandbox,转而使用 Allowlist 模式),以及 agent sandbox run <cmd> [args...]——用于在 Sandbox 中执行一条具有工作区读写权限的单独命令;run 还带有一个 --network 参数,默认值为 false。根据 Cursor 关于 Sandbox 配置的通用参考文档,默认的文件系统访问权限是“workspace_readwrite”,默认的网络规则是“deny”,也就是说,除非明确允许,否则网络访问原则上会被阻止。
✅ 什么时候用?
在多次尝试路径或网络规则后恢复到干净的初始状态
在反复尝试 sandbox enable/disable 及网络设置之后,执行 agent sandbox reset
在开始新项目前确保没有旧的 Sandbox 调整仍处于激活状态
先执行 agent sandbox reset,再执行 agent sandbox enable,确保以完全干净的配置开始
⛔ 什么时候不该用?
只想修改单个设置,而不是全部
agent sandbox reset 会重置整个配置,而不仅仅是单个值。
更好的选择: 有针对性地使用 agent sandbox enable/disable,或使用 agent sandbox run 的 --network 参数
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com