用途:在向维护者报告沙箱阻塞或申请配置变更前,先自行完成验证,避免提交无效报告。
主要能力:提供八项按顺序执行的检查,包括不轻信系统提示中的沙箱描述、确认命令确实在沙箱内运行(echo $TMPDIR)、将 cd 与命令放在同一次调用中、先确认二进制存在、读取真实退出码而非管道退出码、检查命令重写器是否介入、确认条目按原样匹配命令、配置变更后重启会话。另含网络阻塞诊断(域名允许列表拒绝约挂起 5-7 秒,不存在的主机 30 毫秒内失败)与报告模板。
使用方式:按顺序运行检查,命令示例包括 echo $TMPDIR、command -v <binary>、cmd > "$TMPDIR/out.log" 2>&1 等。全部通过后填写报告模板,交给能编辑设置文件的人,不要从 Bash 自行编辑。
适用场景:Claude Code 沙箱会话出现阻塞、命令被拒或网络不通时。
限制:部分限制无解,如 setuid 二进制、AF_UNIX socket bind、直接 DNS、.idea/ 与 .vscode/ 写入;credentials.envVars 在 deny 模式下不会移除变量;allowUnsandboxedCommands: false 不会抵消 excludedCommands。资料未提供收费、价格与平台信息。