先打开当前沙箱的“总览”,看看网络线路、浏览器和沙箱各自是什么状态。如果有报错,保留提示,再找下面对应的情况。
安装还没完成
下载慢、安装失败、权限检查不通过或一直正在连接本机服务,先看安装问题排查。
网页打不开
先看网络排查与修复。0.4.14 用户可以复制一行命令运行检查;修复后再试原来失败的操作。
- 确认你从 Code Sandbox 打开了当前沙箱的隔离浏览器。
- 如果问题出现在开启本机网络工具之后,暂时关闭该工具,再试同一个操作;恢复后再检查规则、DNS 或 TUN 是否冲突。查看对照排查步骤
- 查看“总览”里的网络线路和浏览器状态,按失败提示处理。
- 如果其他网站能打开,只有 Claude 不能打开,记录具体页面提示,发给支持人员。
先别急着重置浏览器,也不要让 AI 直接改网络设置。这些操作可能清掉登录状态,或改掉我们需要检查的配置。
Windows 旧版的兼容问题
如果使用 0.4.14 等 Windows 旧版,长时间卡在防火墙步骤,或者需要启用无感模式,请看 Windows 旧版兼容处理。里面有管理员 PowerShell 命令和开发者模式的操作说明;0.5.4 不适用这些旧版步骤。
桌面版或终端打不开
先确认选择的是完整沙箱,且已经显示“运行中”。还在下载或安装时,等待当前步骤结束;显示失败时,查看具体原因后重试。
已经显示“运行中”,桌面版或终端还是打不开的话,把完整提示发给我们。先保留现场,反复重装不方便判断原因。
收不到邮件或验证码过期
先检查邮箱地址和垃圾邮件,等几分钟后重新发送。使用最新一次登录生成的验证码,填回最初发起登录的窗口。
桌面版的邮箱登录请按验证码流程操作。弹出打开应用的提示时,选择 Cancel。
看不到项目文件
先确认本机的项目文件夹还在,再检查它有没有共享给当前沙箱。终端里要进入的是沙箱内路径,可以从共享设置里核对。只能看、不能改时,再看看权限是不是设成了只读。
macOS 文件访问权限的具体步骤见首次准备中的完全磁盘访问。
把问题发给我们
告诉我们你用的系统和 Code Sandbox 版本,再说一下是在哪个页面、做了什么操作后出的问题。最好附上报错截图;应用里有诊断导出入口的话,也可以把记录一起发来。
发送前检查并遮住账号密码、验证码和授权链接。不要发送私钥或整个浏览器资料文件夹。
在群里 @我们,或者发邮件到 hi@zaneliu.me 都可以。需要一起查看电脑状态时,我们会让你开启临时远程协助。