Vercel Sandbox CLI 现在对智能体更友好
内容提要
Sandbox CLI 4.0.1 改进了输出和错误提示：新沙箱创建后显示连接指引；未找到沙箱时提示查看现有列表；误用命令时给出正确替代；过时安装会提醒更新。每条消息都附带下一步操作，提升用户体验。
延伸解读
错误提示的改进方向
这次更新体现了CLI工具在错误处理上的一个趋势：从“报错”转向“引导”。每个错误信息都附带下一步操作，比如提示运行`sandbox ls --all`查看现有沙箱，或者用`sandbox run -i claude`替代误用的`sh claude`。这种设计减少了用户因错误而中断工作流的情况，尤其对自动化脚本和智能体友好，因为它们可以依据提示自动修正命令。
版本检查的权衡
版本检查功能在创建沙箱时提醒更新，但默认情况下不会自动更新，因为创建参数（如基础镜像）由客户端决定，旧版本可能默默使用旧默认值。检查结果缓存一小时，且与创建请求并发执行，避免延迟。不过，预发布版本会跳过检查，用户也可通过环境变量禁用，这为需要稳定环境的用户提供了灵活性。
对智能体开发者的意义
对于构建智能体的开发者，这些改进降低了CLI在自动化流程中的出错率。清晰的连接指引和错误提示让智能体能够更可靠地解析输出并采取下一步行动。例如，创建沙箱后直接给出`ssh`命令，智能体无需猜测如何连接。这种设计思路值得其他CLI工具借鉴，尤其是在AI辅助编程日益普及的背景下。
Q&A
Sandbox CLI 4.0.1 在创建新沙箱后增加了什么提示？
创建新沙箱后，输出会附带连接提示，例如 `sandbox ssh my-sandbox`，让用户知道如何连接。
当引用的沙箱不存在时，Sandbox CLI 4.0.1 会给出什么错误提示？
错误提示会显示沙箱未找到，并提示运行 `sandbox ls --all` 查看项目中的沙箱列表，而不是直接输出原始 API 错误。
如果用户误用了 `sandbox sh` 命令，CLI 会如何提示？
CLI 会指出 `sh` 启动的是普通 shell，不接受命令，并给出正确的替代命令，例如 `sandbox run -i claude` 来交互式运行 claude。
Sandbox CLI 4.0.1 如何提醒用户更新过时的安装？
在创建沙箱、执行 `sh` 或 `run` 时，CLI 会检查是否有新版本，如果过时则显示更新提示，并建议使用 `npm i -g sandbox@latest` 更新。
Sandbox CLI 的版本检查是否会拖慢创建沙箱的速度？
不会。版本检查结果会缓存到文件，每小时最多刷新一次，且检查与创建请求并发进行，不会增加延迟。
如何禁用 Sandbox CLI 的版本检查？
可以通过设置环境变量 `SANDBOX_SKIP_VERSION_CHECK=1` 来禁用版本检查，预发布版本也会自动跳过检查。
