先看应用当前写的是“下载中”“已暂停”“安装中”还是“失败”。处理办法不同，别一遇到等待就卸载重装。
下载很慢
- 看下载进度和速度有没有变化。有变化就先保持应用和电脑联网，避免电脑进入睡眠。
- 暂停其他大文件下载，确认本机网络可以正常打开网站。
- 先在“下载源”里尝试“备用线路”或“Cloudflare”，再按实际网络情况选择“代理设置”里的“直连”或“家庭宽带线路”。直连跟随系统网络设置。查看下方系统代理状态与端口，修改网络工具设置后点击“重新检测”。系统代理关闭不代表 TUN 模式未连接。切换后点击继续或重试。
- 仍然没有进展，记录组件名称、下载进度和页面提示，发给客服。不要把“下载慢”简单归因到账号或家宽到期。
安装包本身下载不了，可以返回下载页重新取得同一版本。不要从陌生链接下载同名文件。
已暂停或下载失败
“已暂停”时点击继续。显示失败时，先看是不是网络断开、磁盘空间不足或文件被安全软件拦截。只处理明确提示的问题，完成后重试当前项。
有些组件比较大，要给下载文件和解压后的文件都留出空间。删除不需要的个人下载文件可以腾出空间，别直接删 Code Sandbox 的沙箱、浏览器资料或更新目录。
下载到头后一直在安装
校验、解压和导入沙箱系统会继续占用时间。看页面的安装步骤是否变化，暂时不要结束进程或重复点安装。
如果同一步长时间没有变化，保留组件名称、等待时长和当前提示，联系支持一起检查。我们没有给所有电脑规定统一的安装耗时，不能单凭等了几分钟就判断失败。
权限已经打开还是不能继续
macOS 用户点“去授权”后，核对应用要求的每一个开关。应用会自动检查访问结果。更新后仍未通过时，先把系统列表中的旧 Code Sandbox 用“−”删除，再用“＋”添加当前应用并开启。有些权限需要系统确认后重新打开应用，按屏幕提示执行，先保存工作。
详细路径见首次权限设置。辅助组件还没安装成功时，先处理安装错误；重复开关权限不会补上缺失的组件。
Windows 提示权限不足时，核对是否出现过系统确认窗口。公司电脑限制安装或系统设置时，请由电脑管理员处理，不要尝试绕过组织策略。
提示需要重启电脑
保存正在编辑的文件，重启电脑后重新打开 Code Sandbox，选中原来的沙箱继续。重启不会要求你为重试重新购买授权或再建一份沙箱。
一直正在连接本机服务
先保留正在工作的沙箱。没有任务运行时，可以正常退出并重新打开 Code Sandbox，看看连接是否恢复；正在运行任务就先联系支持，别强行结束进程。
仍然停在连接页面，把操作系统、Code Sandbox 版本和完整提示发给我们。不要删除应用数据、重装沙箱或清理浏览器资料来尝试恢复。
Windows 旧版卡在防火墙步骤
确认使用的是 0.4.14 等旧版后，再看旧版防火墙处理。新版遇到类似提示，先交给客服核对，不直接套用旧版命令。
给客服发哪些信息
说明电脑系统、软件版本、正在安装的组件，以及点击哪个按钮后停住。附上完整错误提示和大约等待了多久；有诊断导出入口时，按客服指引提供。
截图先遮住授权码、邮箱密码和登录链接。联系支持后，需要一起操作电脑时再开启远程协助。
隔离浏览器准备失败
新版安装包内置隔离浏览器。进入确认页后会自动检查和解压；缺少内置文件时自动下载修复。真正的校验或安装错误会显示在下载列表的“隔离浏览器”这一行，按提示重试。反复失败时，把这一行的错误、应用版本和系统版本发给客服。