先检查这几项

网页打不开、登录卡住或项目看不到时,可以先这样检查。

先打开当前沙箱的“总览”,看看网络线路、浏览器和沙箱各自是什么状态。如果有报错,保留提示,再找下面对应的情况。

安装还没完成

下载慢、安装失败、权限检查不通过或一直正在连接本机服务,先看安装问题排查。

网页打不开

先看网络排查与修复。0.4.14 用户可以复制一行命令运行检查;修复后再试原来失败的操作。

  1. 确认你从 Code Sandbox 打开了当前沙箱的隔离浏览器。
  2. 如果问题出现在开启本机网络工具之后,暂时关闭该工具,再试同一个操作;恢复后再检查规则、DNS 或 TUN 是否冲突。查看对照排查步骤
  3. 查看“总览”里的网络线路和浏览器状态,按失败提示处理。
  4. 如果其他网站能打开,只有 Claude 不能打开,记录具体页面提示,发给支持人员。

先别急着重置浏览器,也不要让 AI 直接改网络设置。这些操作可能清掉登录状态,或改掉我们需要检查的配置。

Windows 旧版的兼容问题

如果使用 0.4.14 等 Windows 旧版,长时间卡在防火墙步骤,或者需要启用无感模式,请看 Windows 旧版兼容处理。里面有管理员 PowerShell 命令和开发者模式的操作说明;0.5.4 不适用这些旧版步骤。

桌面版或终端打不开

先确认选择的是完整沙箱,且已经显示“运行中”。还在下载或安装时,等待当前步骤结束;显示失败时,查看具体原因后重试。

已经显示“运行中”,桌面版或终端还是打不开的话,把完整提示发给我们。先保留现场,反复重装不方便判断原因。

收不到邮件或验证码过期

先检查邮箱地址和垃圾邮件,等几分钟后重新发送。使用最新一次登录生成的验证码,填回最初发起登录的窗口。

桌面版的邮箱登录请按验证码流程操作。弹出打开应用的提示时,选择 Cancel。

看不到项目文件

先确认本机的项目文件夹还在,再检查它有没有共享给当前沙箱。终端里要进入的是沙箱内路径,可以从共享设置里核对。只能看、不能改时,再看看权限是不是设成了只读。

macOS 文件访问权限的具体步骤见首次准备中的完全磁盘访问。

把问题发给我们

告诉我们你用的系统和 Code Sandbox 版本,再说一下是在哪个页面、做了什么操作后出的问题。最好附上报错截图;应用里有诊断导出入口的话,也可以把记录一起发来。

发送前检查并遮住账号密码、验证码和授权链接。不要发送私钥或整个浏览器资料文件夹。

在群里 @我们,或者发邮件到 hi@zaneliu.me 都可以。需要一起查看电脑状态时,我们会让你开启临时远程协助。

Code Sandbox 教程文档这一步卡住了?联系我们