# Code Sandbox 使用说明 # 安装与登录 第一次使用,从下面第一步开始。已经装好 Code Sandbox,可以直接去[账号登录](https://code-sandbox.cc/guide/login/);已经登录过,就看[日常使用](https://code-sandbox.cc/guide/restart/)。 ## 第一步,安装 Code Sandbox 按你的电脑系统打开对应教程。 - [Windows 安装](https://code-sandbox.cc/guide/install-windows/)包含下载安装包、保留下载、允许运行和完成安装。 - [macOS 安装](https://code-sandbox.cc/guide/install-macos/)包含下载 DMG、拖入“应用程序”和允许首次打开。 安装完成后,从电脑的应用列表打开 Code Sandbox,再继续下一步。 ## 第二步,激活并准备功能 按[激活、权限与功能选择](https://code-sandbox.cc/guide/first-start/)填写软件授权码,完成系统权限,再选择你要用的功能。 只在网页聊天,使用安装包默认自带的隔离浏览器。要用 Claude Code 或隔离桌面版,还需要准备完整沙箱和对应功能。走完这一步,你会进入自己的沙箱页面。 下载慢、安装失败或一直正在连接本机服务,先看[安装问题排查](https://code-sandbox.cc/guide/install-troubleshooting/),处理当前卡住的步骤。 ## 第三步,登录账号 先[准备账号与邮箱](https://code-sandbox.cc/guide/login/),再从账号对应的沙箱打开隔离浏览器。 1. [登录邮箱和 Claude 网页版](https://code-sandbox.cc/guide/login-web/),确认可以收到邮件、进入聊天页面。 2. 要用命令行,继续做 [Claude Code 订阅登录](https://code-sandbox.cc/guide/login-cli/)。 3. 要用桌面版,继续做[隔离桌面版验证码登录](https://code-sandbox.cc/guide/login-desktop/)。 网页、终端和桌面版可能分别要求登录,按你需要的入口完成即可。 ## 登录后开始使用 先读一遍[注意事项](https://code-sandbox.cc/guide/precautions/),了解账号入口、文件访问和新账号用量建议。 接下来去[日常使用](https://code-sandbox.cc/guide/restart/),查看每天怎样启动,以及网页、Claude Code、桌面版各自的操作。遇到报错时,进入[遇到问题](https://code-sandbox.cc/support/)查找对应处理办法。 # Windows 安装 ## 下载适合你的版本 1. 打开[下载页面](https://code-sandbox.cc/download/),下载当前提供的 Beta 版。 2. 点击“下载 Windows 版”,等待 `.exe` 文件下载完成。目前提供 Windows 64 位安装包。 3. 安装包应来自 `cdn.s3.loki.zaneliu.me/code-sandbox/`。不要使用陌生人转发、改名或重新打包的文件。 ## Edge 提示不常见下载 当前安装包尚未签名,Edge 或 Windows 可能显示“不常见下载”“未知发布者”或无法验证来源等提示。从我们的下载页取得安装包后,按下面的步骤继续。 1. 点击 Edge 右上角的下载图标,找到 Code Sandbox 安装包。 2. 点击文件旁的“…”菜单,选择“保留”。 3. 如果还有一层提示,展开“显示更多”或类似选项,再选择“仍然保留”。不同 Edge 版本的文字可能略有不同。 4. 等下载完成,再打开文件。没有这个提示就直接继续安装。 [![Edge 下载保留步骤示意](https://code-sandbox.cc/guide/images/windows-edge.svg)](https://code-sandbox.cc/guide/images/windows-edge.svg) *这是操作示意图,可点击放大。它只说明已核对来源时的不常见下载提醒。* 如果提示与示意图不一致,或找不到“保留”选项,把安装包文件名和完整截图[发给我们](https://code-sandbox.cc/contact/#contact),我们会协助确认下一步。 ## 运行安装程序 1. 双击下载完成的 `.exe`。 2. 如果 Windows 显示“Windows 已保护你的电脑”这类未识别应用提示,确认是刚才下载的 Code Sandbox 安装包后,点击“更多信息”,再选择“仍要运行”。如果系统没有提供该选项,联系我们协助处理。 3. 按安装向导确认安装位置。看到权限请求时,核对程序名称和刚才的安装操作,再决定是否允许。 4. 等待安装完成,从开始菜单打开 **Code Sandbox**。 [![Windows 安装步骤示意](https://code-sandbox.cc/guide/images/windows-install.svg)](https://code-sandbox.cc/guide/images/windows-install.svg) ## 360、火绒或防火墙出现提示 360、火绒或防火墙提示 Code Sandbox 的安装、组件运行或联网权限时,核对程序名称、路径和当前操作,允许这次对应的请求,再继续安装。 如果软件给出其他拦截结果,或你不确定它提示的是哪个文件,把完整提示发给我们,我们会协助核查和处理。公司电脑的策略限制,请由管理员处理。 ## 激活、授权和选择功能 安装完成后,从电脑应用列表打开 Code Sandbox。接着按[首次激活、权限与功能选择](https://code-sandbox.cc/guide/first-start/)操作,从填写授权码一直走到自己的沙箱页面。 隔离浏览器默认包含在安装包中。沙箱供 Claude Code、终端和桌面版共用;选择桌面版或本机命令入口时,会同时选中沙箱。进入确认页后自动下载缺少的组件,桌面版单独显示额外下载量。 下载源可选“加速线路”“备用线路”或“Cloudflare”。“代理设置”里的“直连”跟随系统网络设置,“家庭宽带线路”使用家宽流量。代理设置下方会显示系统代理开关和下载使用的地址、端口;更改网络工具设置后可点击“重新检测”。仅使用 TUN 模式时,系统代理可能仍显示关闭,请在网络工具中确认连接状态。切换后点击继续下载。下载慢、安装失败时,先看[安装问题排查](https://code-sandbox.cc/guide/install-troubleshooting/)。 ## 旧版 Windows 的两项设置 已经在使用 0.4.14 等旧版时,无感模式需要先[开启开发者模式](https://code-sandbox.cc/guide/seamless/#windows-旧版先打开开发者模式)。若长时间卡在防火墙步骤,可按[旧版防火墙处理说明](https://code-sandbox.cc/support/windows-legacy/#长时间卡在防火墙步骤)操作。这些旧版步骤仅用于对应版本。新版遇到相似提示时,先让客服核对当前问题。 ## 选一种用法,走到登录完成 - [使用网页版](https://code-sandbox.cc/guide/browser/)包含浏览器准备、邮箱登录和开始聊天。 - [使用 Claude Code](https://code-sandbox.cc/guide/cli/)包含沙箱准备、项目共享、登录和终端使用。 - [使用桌面版](https://code-sandbox.cc/guide/desktop/)包含 Beta 桌面组件准备、验证码登录和打开项目。 - [使用 VS Code](https://code-sandbox.cc/guide/vscode/)介绍 Remote - SSH 和远程窗口里的 Claude Code 扩展。 装好后请先阅读[使用须知](https://code-sandbox.cc/guide/precautions/)。关机或重启后的步骤见[下次怎么继续用](https://code-sandbox.cc/guide/restart/)。 下载拦截的官方说明见 [Microsoft Edge 下载问题说明](https://learn.microsoft.com/en-us/troubleshoot/microsoft-edge/development/download-failures)。 # macOS 安装 ## 先确认电脑型号 当前 macOS 安装包支持 **Apple Silicon 芯片**。点击屏幕左上角苹果菜单,打开“关于本机”,查看芯片信息。Intel Mac 不适用这个安装包。 ## 下载并安装 1. 打开[下载页面](https://code-sandbox.cc/download/),下载当前提供的 Beta 版。 2. 点击“下载 macOS 版”,等待 `.dmg` 下载完成。下载地址应来自 `cdn.s3.loki.zaneliu.me/code-sandbox/`。 3. 双击 `.dmg`,打开安装窗口。 4. 把 **Code Sandbox** 图标拖到 **Applications(应用程序)** 文件夹,等待拷贝完成。 5. 在访达中打开“应用程序”,双击 Code Sandbox。以后都从这里启动,也可以保留到程序坞。 [![macOS 将应用拖入 Applications 的步骤示意](https://code-sandbox.cc/guide/images/macos-install.svg)](https://code-sandbox.cc/guide/images/macos-install.svg) *操作示意图,可点击放大。安装窗口外观可能随版本变化。* 请先完成拷贝,再运行应用;不要一直从 DMG 的安装窗口里打开。安装完成后可以推出磁盘映像。 ## 系统提示无法验证开发者 未签名或未完成公证的安装包,可能触发 macOS 的开发者验证提示。从我们的下载页取得安装包后,可以按下面的步骤允许本次打开。 1. 先从“应用程序”尝试打开 Code Sandbox 一次。 2. 如果 macOS 提示无法验证开发者或未完成公证,关闭提示,打开“系统设置”。 3. 进入 **隐私与安全性**,向下找到安全性区域里对应 Code Sandbox 的提示,点击 **仍要打开**。旧版系统的位置可能在“系统偏好设置 → 安全性与隐私”。 4. 按系统要求验证身份,再确认“打开”。如果这个按钮没有出现,先核对刚才拦截的是否就是 Code Sandbox。 [![macOS 隐私与安全性中允许本次打开的步骤示意](https://code-sandbox.cc/guide/images/macos-open.svg)](https://code-sandbox.cc/guide/images/macos-open.svg) 如果提示与上面的开发者验证示例不同,或找不到“仍要打开”,把完整提示[发给我们](https://code-sandbox.cc/contact/#contact),我们会协助确认文件和后续操作。系统提示的说明可参考 [Apple 官方文档](https://support.apple.com/zh-cn/102445)。 ## 激活、授权和选择功能 安装完成后,从“应用程序”打开 Code Sandbox。已有权限会自动检查;缺少权限时,点击去授权,并按系统设置上方的浮层拖入对应项目、开启开关。检查通过后,在欢迎页点击“立即进入”。接着按[首次激活、权限与功能选择](https://code-sandbox.cc/guide/first-start/)操作,从填写授权码一直走到自己的沙箱页面。 隔离浏览器默认包含在安装包中。沙箱供 Claude Code、终端和桌面版共用;选择桌面版或本机命令入口时,会同时选中沙箱。进入确认页后自动下载缺少的组件,桌面版单独显示额外下载量。 下载源可选“加速线路”“备用线路”或“Cloudflare”。“代理设置”里的“直连”跟随系统网络设置,“家庭宽带线路”使用家宽流量。代理设置下方会显示系统代理开关和下载使用的地址、端口;更改网络工具设置后可点击“重新检测”。仅使用 TUN 模式时,系统代理可能仍显示关闭,请在网络工具中确认连接状态。切换后点击继续下载。下载慢、安装失败时,先看[安装问题排查](https://code-sandbox.cc/guide/install-troubleshooting/)。 ## 接下来做什么 - [网页版安装与登录](https://code-sandbox.cc/guide/browser/) - [Claude Code 准备与使用](https://code-sandbox.cc/guide/cli/) - [隔离 Claude Desktop 安装与登录](https://code-sandbox.cc/guide/desktop/) - [VS Code Remote - SSH](https://code-sandbox.cc/guide/vscode/) 开始使用前看[使用须知](https://code-sandbox.cc/guide/precautions/),关机或重启后看[下次怎么继续用](https://code-sandbox.cc/guide/restart/)。 # 首次激活、权限与功能选择 先按 [Windows](https://code-sandbox.cc/guide/install-windows/)或 [macOS](https://code-sandbox.cc/guide/install-macos/)教程装好应用。这一页从你第一次打开 Code Sandbox 开始。旧版页面可能不同,按当前页面的提示操作。 ## 输入软件授权码 1. 从电脑的应用列表打开 **Code Sandbox**。 2. 在授权页面粘贴收到的软件授权码,检查前后有没有多复制空格,再点击激活。 3. 等待验证结果,继续完成系统准备。 这里填写的是 Code Sandbox 的软件授权码。邮箱密码和 Claude 发来的登录验证码,要在后面的账号登录步骤使用。 提示授权无效、到期或设备绑定异常时,把错误提示和授权码尾号发给客服核对。不要在群里贴完整授权码,也不要为了重试反复解绑设备。 ## macOS 完成系统权限 “完成系统授权”页会自动检查已有权限。更新后原有授权仍有效时,会直接通过检查。 ### 安装辅助组件 点击页面提供的安装或更新按钮。系统要求管理员确认时,核对是刚才 Code Sandbox 发起的操作,再输入本机账号密码。这个密码只填在 macOS 的系统窗口里。 ### 开启完全磁盘访问 这项权限允许对应程序访问本机受保护的文件。确认接受这个范围后再开启。 1. 点击“去授权”,打开“系统设置 → 隐私与安全性 → 完全磁盘访问权限”。 2. 引导浮层会贴在系统设置窗口旁,窗口移动或缩放时跟随。把浮层中的 **Code Sandbox**、**Code Sandbox 辅助组件**和 **nfsd** 逐项拖入权限列表,再开启开关。辅助组件在系统中也可能显示为 `com.codesandbox.privilegedhelper`。 3. 已在列表中的项目直接开启。浮层的拖入标记用于记录操作,应用还会检查实际文件访问;全部检查通过后显示欢迎页。 4. 欢迎页播放撒花效果,点击 **立即进入**,开始选择功能。 ![完全磁盘访问权限示意图:Code Sandbox、com.codesandbox.privilegedhelper 和 nfsd 三个开关均开启](https://code-sandbox.cc/guide/images/walkthrough/mac-disk-clean.png) 图中的 `com.codesandbox.privilegedhelper` 是 Code Sandbox 的特权辅助组件,`nfsd` 是系统文件共享进程。示意图只展示需要核对的三个条目,实际列表可能还有其他应用。 更新后开关已经开启但检查仍未通过时,按应用显示的提示移除旧的 Code Sandbox 条目,重新拖入当前应用并开启。系统要求退出并重新打开时,先保存工作,再按提示操作。仍未通过时,见[权限排查](https://code-sandbox.cc/guide/install-troubleshooting/#权限已经打开还是不能继续)。 进入应用后,可以在“系统设置”点 **重新检查** 核对现有文件访问,检查通过会显示“已授权”。点击 **打开授权引导** 仍会打开系统设置和拖入浮层;从这里主动打开的浮层会保留,完成后点“返回应用”或关闭浮层。 终端图片粘贴需要辅助功能权限,使用该功能时可到系统设置按提示开启。辅助功能允许应用控制本机。 ## Windows 完成系统准备 如果出现“准备系统访问”,按页面按钮安装系统辅助组件。出现 Windows 权限确认时,核对程序名称和当前操作,再允许这次安装。 应用提示“需要重启电脑”时,先保存其他工作再重启。回来后打开同一个 Code Sandbox,继续原来的准备流程。 使用 0.4.14 等旧版,并且准备开启无感模式的用户,还需要看[旧版开发者模式设置](https://code-sandbox.cc/guide/seamless/#windows-旧版先打开开发者模式)。 ## 选择你要用的功能 先看看左侧是否已经有为你配好的沙箱。有的话选中它;没有的话,点击新增入口,部分版本按钮叫“新建环境”。 | 功能 | 用途与下载内容 | | --- | --- | | 隔离浏览器 | 默认自带,用于 Claude 网页版和其他网站 | | 沙箱 | Claude Code、终端、SSH 和 Claude 桌面版共用的基础,下载一次 | | Claude 桌面版 | 在沙箱中使用 Chat、Code 和 Cowork,显示的下载量仅为额外桌面组件 | | 本机命令入口 | 在本机终端使用 `sandbox` 和 `claude-sandbox` 命令连接沙箱 | 勾选 Claude 桌面版或本机命令入口,会同时勾选沙箱;取消沙箱会同时取消这两项。只取消桌面版或本机命令入口,可以继续保留沙箱。 沙箱本身已经包含终端和 Claude Code。是否勾选“本机命令入口”,只决定是否把命令安装到本机终端。 首次安装与新建沙箱使用同一创建流程,已安装的组件会复用,只准备当前缺少的部分。共享文件夹在创建后按需到“目录与密钥”添加。 按向导选择为你提供的网络线路,再确认环境配置。已经配好的设置先保留,拿不准选哪个就把这一页发给客服。 ## 自动下载与安装 进入“确认”页后,所需组件会自动开始下载。隔离浏览器优先使用安装包里的文件;缺少内置文件时会下载修复。若文件校验或安装失败,按这一项的提示重试或联系支持。 下载页有两个独立设置。 | 设置 | 选项 | | --- | --- | | 下载源 | **加速线路**使用 CDN;**备用线路**使用 S3 源站;**Cloudflare**使用另一份资源镜像 | | 代理设置 | **直连**跟随本机系统网络设置,包括已配置的 HTTP/SOCKS 系统代理;**家庭宽带线路**使用家宽流量 | 家庭宽带线路需有可用的分配线路。系统自动代理脚本(PAC)暂不支持组件下载,出现提示时改用 HTTP/SOCKS 设置或家庭宽带线路。 默认优先使用加速线路,连接失败时会尝试备用源。手动选择下载源后,后续下载使用所选源。切换下载源或代理设置会暂停下载,点击“继续下载”后生效;已经进入安装的项目继续完成。 “下载中”时看文件进度,“安装中”时等当前步骤完成。安装期间保持应用打开。已暂停的任务点“继续”;出现失败提示,先读原因,再按[排查步骤](https://code-sandbox.cc/guide/install-troubleshooting/)处理。 下载完成后可能还要校验和解压,下载条到头不等于安装完成。所有必需项目完成后,点击“创建环境”。 ## 到这里就装好了 能进入自己的沙箱页面、选中沙箱,并看到所选功能的打开入口,就完成了应用的首次准备。要用 Claude Code 或桌面版,先启动沙箱,等它显示“运行中”。 勾选“本机命令入口”后,安装成功会弹出 CLI 使用引导,说明启动顺序并提供对应沙箱的可复制命令。关闭后,可从“环境设置 → 命令行入口 → 查看使用引导”重新打开。使用步骤见[Claude Code 命令行教程](https://code-sandbox.cc/guide/cli/#用本机命令入口开始)。 下一步按[账号登录教程](https://code-sandbox.cc/guide/login/)准备邮箱和 Claude 账号。 # 下载慢或安装失败怎么办 先看应用当前写的是“下载中”“已暂停”“安装中”还是“失败”。处理办法不同,别一遇到等待就卸载重装。 ## 下载很慢 1. 看下载进度和速度有没有变化。有变化就先保持应用和电脑联网,避免电脑进入睡眠。 2. 暂停其他大文件下载,确认本机网络可以正常打开网站。 3. 先在“下载源”里尝试“备用线路”或“Cloudflare”,再按实际网络情况选择“代理设置”里的“直连”或“家庭宽带线路”。直连跟随系统网络设置。查看下方系统代理状态与端口,修改网络工具设置后点击“重新检测”。系统代理关闭不代表 TUN 模式未连接。切换后点击继续或重试。 4. 仍然没有进展,记录组件名称、下载进度和页面提示,发给客服。不要把“下载慢”简单归因到账号或家宽到期。 安装包本身下载不了,可以返回[下载页](https://code-sandbox.cc/download/)重新取得同一版本。不要从陌生链接下载同名文件。 ## 已暂停或下载失败 “已暂停”时点击继续。显示失败时,先看是不是网络断开、磁盘空间不足或文件被安全软件拦截。只处理明确提示的问题,完成后重试当前项。 有些组件比较大,要给下载文件和解压后的文件都留出空间。删除不需要的个人下载文件可以腾出空间,别直接删 Code Sandbox 的沙箱、浏览器资料或更新目录。 ## 下载到头后一直在安装 校验、解压和导入沙箱系统会继续占用时间。看页面的安装步骤是否变化,暂时不要结束进程或重复点安装。 如果同一步长时间没有变化,保留组件名称、等待时长和当前提示,联系支持一起检查。我们没有给所有电脑规定统一的安装耗时,不能单凭等了几分钟就判断失败。 ## 权限已经打开还是不能继续 macOS 用户点“去授权”后,核对应用要求的每一个开关。应用会自动检查访问结果。更新后仍未通过时,先把系统列表中的旧 Code Sandbox 用“−”删除,再用“+”添加当前应用并开启。有些权限需要系统确认后重新打开应用,按屏幕提示执行,先保存工作。 详细路径见[首次权限设置](https://code-sandbox.cc/guide/first-start/#macos-完成系统权限)。辅助组件还没安装成功时,先处理安装错误;重复开关权限不会补上缺失的组件。 Windows 提示权限不足时,核对是否出现过系统确认窗口。公司电脑限制安装或系统设置时,请由电脑管理员处理,不要尝试绕过组织策略。 ## 提示需要重启电脑 保存正在编辑的文件,重启电脑后重新打开 Code Sandbox,选中原来的沙箱继续。重启不会要求你为重试重新购买授权或再建一份沙箱。 ## 一直正在连接本机服务 先保留正在工作的沙箱。没有任务运行时,可以正常退出并重新打开 Code Sandbox,看看连接是否恢复;正在运行任务就先联系支持,别强行结束进程。 仍然停在连接页面,把操作系统、Code Sandbox 版本和完整提示发给我们。不要删除应用数据、重装沙箱或清理浏览器资料来尝试恢复。 ## Windows 旧版卡在防火墙步骤 确认使用的是 0.4.14 等旧版后,再看[旧版防火墙处理](https://code-sandbox.cc/support/windows-legacy/#长时间卡在防火墙步骤)。新版遇到类似提示,先交给客服核对,不直接套用旧版命令。 ## 给客服发哪些信息 说明电脑系统、软件版本、正在安装的组件,以及点击哪个按钮后停住。附上完整错误提示和大约等待了多久;有诊断导出入口时,按客服指引提供。 截图先遮住授权码、邮箱密码和登录链接。[联系支持](https://code-sandbox.cc/contact/#contact)后,需要一起操作电脑时再开启[远程协助](https://code-sandbox.cc/support/remote/)。 ## 隔离浏览器准备失败 新版安装包内置隔离浏览器。进入确认页后会自动检查和解压;缺少内置文件时自动下载修复。真正的校验或安装错误会显示在下载列表的“隔离浏览器”这一行,按提示重试。反复失败时,把这一行的错误、应用版本和系统版本发给客服。 # 准备账号与邮箱 装好 Code Sandbox 后,下一步是登录你要使用的 Claude 账号。还没进入沙箱页面,先完成[首次准备](https://code-sandbox.cc/guide/first-start/)。 ## 还没有账号怎么办 你需要一个自己有权使用的 Claude 账号,以及能收到登录邮件的邮箱。还没有账号或不清楚套餐包含什么,可以先[联系交付人员](https://code-sandbox.cc/contact/#contact)确认账号、订阅权益和邮箱入口,再决定是否购买。 已经有自己的账号,就确认邮箱能登录、套餐支持你要用的功能。软件授权和 Claude 订阅分别管理,激活 Code Sandbox 不会自动开通 Claude 订阅。 ## 哪个信息填在哪里 | 收到的信息 | 填在哪里 | | --- | --- | | Code Sandbox 授权码 | Code Sandbox 首次激活页面 | | 邮箱地址和邮箱密码 | 对应邮箱网站 | | Claude 登录邮件或验证码 | 刚才发起 Claude 登录的页面或窗口 | | Claude Code 授权完成后给出的 code | 最初发起登录的 Claude Code 终端 | 如果拿到的是礼品兑换凭证,先按交付说明取得软件授权码,再激活软件。 ## 先打开同一个沙箱的隔离浏览器 在 Code Sandbox 里选中账号对应的沙箱,点击“打开浏览器”,启动这个沙箱的隔离浏览器。后面的邮箱、Claude 网页和授权链接,都在这个隔离浏览器窗口里打开。 教程网站可以在本机默认浏览器阅读。真正登录账号时,要回到 Code Sandbox 打开的隔离浏览器。 ## 按顺序登录 1. 先做[邮箱和网页版登录](https://code-sandbox.cc/guide/login-web/),确认能收到邮件。 2. 需要命令行,再做 [Claude Code 订阅登录](https://code-sandbox.cc/guide/login-cli/)。 3. 需要桌面版,再做[隔离桌面版登录](https://code-sandbox.cc/guide/login-desktop/)。 三个入口可能各自要求登录。网页版已经登录,并不代表终端和桌面版都完成了授权。 # 登录邮箱和 Claude 网页版 做完这页,你会在隔离浏览器里看到 Claude 的聊天页面。先准备账号邮箱和邮箱密码,拿不准它们的区别就看[账号准备](https://code-sandbox.cc/guide/login/)。 ## 打开邮箱 1. 在 Code Sandbox 左侧选中给这个账号使用的沙箱,点击“打开浏览器”,启动该沙箱的隔离浏览器。 2. 在刚打开的隔离浏览器里点击地址栏,输入邮箱网址,按回车。 3. SpaceMail 用户打开 [spacemail.com/login](https://spacemail.com/login)。Gmail 用户打开 [mail.google.com](https://mail.google.com/),其他邮箱使用交付给你的登录地址。 4. 输入完整邮箱地址和邮箱密码,完成邮箱自己的验证。看到收件箱后,先保留这个标签页。 这里不要填写 Code Sandbox 授权码。邮箱密码不对时,先核对邮箱地址、大小写和复制时的空格;仍然无法登录,联系邮箱提供方或交付人员。 ## 让 Claude 发送登录邮件 1. 在同一个隔离浏览器中新开标签页,打开 [claude.ai](https://claude.ai)。 2. 输入这个账号的邮箱地址,选择 **Continue with email**。页面中文含义是使用邮箱继续。 3. 留着这个 Claude 标签页,回到刚才的邮箱标签页,刷新收件箱。 ## 打开邮件完成登录 1. 找到本次收到的 Claude 登录邮件,核对是刚才申请的那一封。 2. 点击邮件中的 **Sign in** 或 **Sign in with Claude.ai**。链接仍然要在这个隔离浏览器里打开。 3. 如果页面要求填写验证码,就把最新邮件里的验证码填回刚才的 Claude 登录页面。 4. 按页面要求完成账号信息。看到可以输入消息的聊天页面,就完成网页版登录。 有多个同名邮件时,使用最新一次登录对应的邮件。不要把链接发到手机或复制到本机普通浏览器里继续。 ## 没收到邮件或链接过期 先核对邮箱地址,再看垃圾邮件和收件箱。等待一会儿仍没收到,回 Claude 页面重新发送一次。 过期后使用重新发送的新邮件。反复同时发起多次登录容易分不清哪封有效,先保留一个登录页面完成它。 已经进了聊天页面,可以看[网页版日常使用](https://code-sandbox.cc/guide/browser/)。需要用 CLI,继续 [Claude Code 登录](https://code-sandbox.cc/guide/login-cli/)。 # Claude Code 订阅登录 先完成[邮箱和网页版登录](https://code-sandbox.cc/guide/login-web/),并确认你使用的 Claude 订阅支持 Claude Code。整个过程需要保留两个窗口,一个沙箱终端,一个同沙箱的隔离浏览器。 ## 在沙箱中启动 Claude Code 1. 打开 Code Sandbox,选中完整沙箱,启动后等待“运行中”。 2. 在 Claude Code 页面确认已安装,再打开“隔离终端”。也可以使用应用为当前沙箱提供的 SSH 命令进入。 3. 在终端输入下面的命令,按回车。 ```bash claude ``` 首次使用按提示选择显示主题等设置。已经进入 Claude Code 对话但需要重新登录时,在对话输入框输入 `/login`,按回车。 ## 选择订阅登录 看到登录方式时,用上下方向键选包含 **Claude account with subscription** 或 Pro、Max、Team、Enterprise 的选项,按回车。具体文字会随 Claude Code 版本变化,认准 Claude 账号订阅这一项。 只有明确使用 API 计费账号的人才选择 Console/API 方式。我们这里讲的是订阅账号登录;选错了先返回重新选,不要往里填软件授权码或邮箱密码。 ## 复制链接到隔离浏览器 1. 终端会给出登录网址。按屏幕提示复制,提供 `c` 复制快捷键时可以按 `c`;也可以完整选中网址复制。 2. 回到这个沙箱的隔离浏览器,新开标签页。 3. 点击地址栏,粘贴完整网址,按回车。不要漏掉网址后面的一长串字符。 4. 核对网页显示的是你要用的 Claude 账号,按页面按钮允许这次授权。要求登录时,用前一篇的邮箱流程完成。 如果系统自动打开了普通浏览器,先不要在那里登录。把终端给的链接带到隔离浏览器继续。 ## 把 code 粘贴回终端 网页可能直接完成回传,也可能显示一段授权 code。显示 code 时,复制整段,回到**最初发起登录的那个 Claude Code 终端**,在等待 code 的位置粘贴并按回车。 macOS 终端通常用 **Command + V** 粘贴,Windows Terminal 通常用 **Ctrl + V**。Code Sandbox 的内置终端可使用它提供的粘贴操作。 看到 **Login successful** 后,按提示再按回车继续。能回到 Claude Code 的对话界面,才算终端登录完成。这段 code 不需要再粘回浏览器,也不是软件授权码。 ## 页面成功了,终端还在等 先看网页是否给了可复制的 code,给了就按上一节手动粘贴。已经过期或终端被关闭时,重新发起一次登录,使用新链接和对应的 code。 不要公开发送完整授权链接或 code。仍然失败,提供脱敏后的报错和当前停在哪一步即可。 接下来按[Claude Code 日常使用](https://code-sandbox.cc/guide/cli/)打开项目。登录方式和手动回填的说明可对照 [Claude Code 官方登录文档](https://code.claude.com/docs/en/authentication)。 # 隔离桌面版验证码登录 先准备支持桌面版的交付版本,启动完整沙箱,再从 Code Sandbox 打开“Claude 桌面版”。本机单独安装的 Claude 不用于这套登录流程。 ## 在桌面窗口发起登录 1. 保留 Code Sandbox 启动的隔离 Claude 桌面窗口。 2. 输入账号邮箱,点击 **Continue with email**。 3. 即使使用 Gmail,也按邮箱方式继续。当前隔离桌面版不提供 Google 一键登录。 ## 在隔离浏览器里收邮件 1. 从 Code Sandbox 打开同一个沙箱的隔离浏览器。 2. 登录账号对应的邮箱。SpaceMail 或其他邮箱的步骤见[邮箱登录](https://code-sandbox.cc/guide/login-web/#打开邮箱)。 3. 找到刚才桌面版发来的最新登录邮件,点击 **Sign in**。 ## 出现 Open Claude 时选择 Cancel 浏览器可能询问 **Open Claude?**。选择 **Cancel**,不要勾选始终允许,也不要点击 **Open App**。 直接唤起应用可能打开本机另装的 Claude。我们要把验证码交回刚才的隔离桌面窗口。 没有出现这个弹窗,就直接看下一步。 ## 复制并填写验证码 1. 在后续网页选择 **Log In With Code**。 2. 点击 **Copy Code**,复制页面给出的验证码。 3. 回到最初发起登录的隔离 Claude 桌面窗口,把验证码粘贴到验证码输入框。 4. 点击 **Verify email address**。验证通过、进入聊天页面后,就完成了桌面版登录。 macOS 用 **Command + V**,Windows 用 **Ctrl + V**。这个验证码只交给桌面登录窗口,不发给客服,也不填进 Code Sandbox 的授权页。 ## 没有收到邮件或找不到按钮 先检查收件箱和垃圾邮件。验证码过期就从桌面窗口重新发送,使用新邮件。 页面布局和上面不同,先保留当前窗口,把遮住邮箱、验证码和完整链接的截图发给客服。不要为了继续登录去打开普通 Claude 或改浏览器配置。 登录后,按[桌面版日常使用](https://code-sandbox.cc/guide/desktop/)选择 Chat、Cowork 或 Code。 # 每天开机后怎么打开 重启电脑后,使用原来的沙箱继续。看到“已停止”很正常,先启动它即可。 ## Code Sandbox 会不会自己打开 这取决于你是否开启了应用的开机启动设置,以及系统是否允许它启动。桌面没有出现 Code Sandbox 时,从开始菜单或“应用程序”手动打开。 “应用启动时自动启动沙箱”是另一项设置。启用后,应用会尝试启动已停止的完整沙箱;它不等于自动打开所有浏览器、终端和桌面窗口。是否启动成功以沙箱状态为准。 ## 每天的操作顺序 1. 打开 Code Sandbox。本机网络工具可以保持原来的设置,出现连接问题时再做对照排查。 2. 在左侧选中这个账号一直使用的沙箱。 3. 只用网页时,从 Code Sandbox 打开当前沙箱的隔离浏览器。使用 CLI 或桌面版时,先让完整沙箱进入“运行中”。 4. 按下面对应的入口打开工作窗口。如果打开网络工具后连接失败,按[排查步骤](https://code-sandbox.cc/guide/account/#本机网络工具怎么开)检查是否存在冲突。 | 今天要用什么 | 接下来怎么打开 | | --- | --- | | 网页版 | 从 Code Sandbox 点击当前沙箱的“打开浏览器”,在启动的隔离浏览器中访问 Claude | | Claude Code | 打开“隔离终端”,或用当前沙箱的 SSH 命令连接,进入项目后运行 `claude` | | Claude 桌面版 | 点击 Code Sandbox 中的“Claude 桌面版”,选择需要的 Chat、Cowork 或 Code | | VS Code | 用 Remote - SSH 连接同一个本机沙箱,再打开项目 | ## 还保留着登录吗 通常会保留原来的登录资料。平台要求重新登录时,按[账号登录教程](https://code-sandbox.cc/guide/login/)完成验证,仍然使用同一沙箱。 授权到期或设备绑定提示与 Claude 重新登录是不同的问题,先看清提示来自哪个应用,再联系对应支持人员。 ## 睡眠或断网后连不上 先确认本机恢复联网,再看 Code Sandbox 中沙箱的状态。显示“已停止”就启动原来的沙箱;正在启动就等它结束,不重复创建。 SSH 窗口断开后,重新连接同一个目标,再查看原任务是否还在运行。不要立刻重复提交原任务,以免执行两次。 ## 关机前做什么 保存文件,正常结束 Claude 任务。下载、安装或更新正在进行时,等当前步骤完成后再退出。 Claude Code 对可读写共享文件夹的修改已经影响本机原文件,按项目需要提交或备份。遇到启动失败,看[问题排查](https://code-sandbox.cc/support/),保留报错再处理。 # 使用网页版 安装 Code Sandbox 后默认自带我们自研的**隔离指纹浏览器**,在本机运行,随沙箱管理独立资料、设备特征和网络线路。 第一次还没登录,先看[邮箱和网页版登录](https://code-sandbox.cc/guide/login-web/)。这一页讲登录完成后,每天怎样打开和使用。 ## 从 Code Sandbox 打开隔离浏览器 1. 打开 Code Sandbox,选中给这个账号使用的沙箱。 2. 在 Code Sandbox 中点击“打开浏览器”,或进入该沙箱的“浏览器”页面。通过这里启动的是当前沙箱的隔离浏览器。 3. 在这个隔离浏览器里访问 [claude.ai](https://claude.ai)。已经登录就会进入账号页面。 4. 如果要求重新登录,在同一个隔离浏览器里打开邮箱、收取邮件,按[登录步骤](https://code-sandbox.cc/guide/login-web/)继续。 **网页登录和日常使用都从 Code Sandbox 的隔离浏览器入口开始。** 不要打开本机平时使用的 Chrome、Edge 或 Safari 来继续这套操作。 ## 发起一次对话 在隔离浏览器的 Claude 页面选择新对话,输入想做的事,再发送。需要它处理文档时,使用页面的附件入口,核对选中的文件后上传。 上传的文件会交给 Claude 服务处理。公司资料、账号文件或其他敏感内容,先确认你有权提供。 ## 暂时关闭和下次继续 结束当前任务后,可以正常关闭隔离浏览器窗口。下次打开 Code Sandbox,选中同一个沙箱,再点击“打开浏览器”。这样打开的仍是该沙箱的隔离浏览器,通常会保留其中的登录资料;平台要求重新验证时按提示登录。 不要为恢复登录去删除沙箱或清空浏览器资料。网页打不开时按[问题排查](https://code-sandbox.cc/support/#网页打不开)检查网络和当前状态。 ## 在隔离浏览器里访问其他网站 可以按实际需要使用网页,但通过配套线路产生的视频、文件下载等流量也会计入网络额度。网络流量和 Claude 对话额度分别管理,详细说明见[用量](https://code-sandbox.cc/guide/account/)。 # 使用 Claude Code CLI 本页讲终端中的 Claude Code CLI。Claude Desktop 里的 Code Local 见[桌面版指南](https://code-sandbox.cc/guide/desktop/#local)。 需要首次登录时,先按 [Claude Code 订阅登录](https://code-sandbox.cc/guide/login-cli/)完成授权。已经登录的用户从下面开始。 ## 用本机命令入口开始 首次创建时勾选“本机命令入口”,安装成功后会弹出使用引导。关闭后,可在沙箱的“环境设置 → 命令行入口”中点击“查看使用引导”;没有安装时,先点击“安装命令”。 1. 在 Code Sandbox 中启动要使用的沙箱,等状态显示“运行中”。 2. 重新打开本机终端。macOS 可以使用终端或 iTerm;Windows 可以使用 PowerShell 或 Windows Terminal。 3. 在终端中进入自己的项目文件夹,再运行: ```bash claude-sandbox ``` `claude-sandbox` 会把当前项目文件夹共享给沙箱,并在沙箱中启动 Claude Code。项目中的修改会同步到本机原文件。首次登录按终端提示继续,并使用同一个沙箱的隔离浏览器打开授权页面,详见[Claude Code 订阅登录](https://code-sandbox.cc/guide/login-cli/)。 想进入沙箱终端时,运行: ```bash sandbox ``` 只有一个完整沙箱时会直接选择;多个时按终端提示选择。应用引导中可复制带 `--id` 的命令,直接连接对应沙箱。需要按名称选择时,可以运行: ```bash claude-sandbox --env "开发沙箱" sandbox --env "开发沙箱" ``` 同名沙箱请使用应用显示的 ID 区分。脚本和 CI 必须使用 `--env` 或 `--id` 明确指定目标。 如果提示找不到命令,先重新打开终端;仍然失败时,在“命令行入口”中重新安装。沙箱尚未运行时,先回到应用启动对应沙箱,再执行命令。 ## 使用应用中的隔离终端 1. 打开 Code Sandbox,选中对应的完整沙箱,点击“启动沙箱”。 2. 等状态显示“运行中”,再点击“隔离终端”。 3. 使用自己的终端时,复制应用为当前沙箱显示的 SSH 命令并执行。只有应用显示的别名确实是 `claude` 时,才使用下面的示例。 ```bash ssh claude ``` SSH 在这里连接的是这台电脑上由 Code Sandbox 管理的沙箱。有多个沙箱时,每次核对要连接的那一个。 ## 打开项目再运行 如果只是让 CLI 按任务使用本机文件和工具,可以在[无感模式](https://code-sandbox.cc/guide/seamless/)下提供本机路径;共享文件夹不是每次使用的前置步骤。 1. 使用沙箱中的已有项目时,直接进入项目目录。需要在终端里打开本机项目目录时,可以[共享项目文件夹](https://code-sandbox.cc/guide/files/),记下页面显示的沙箱内路径。 2. 在已经连接沙箱的终端里输入 `cd`,后面加一个空格,再填项目的沙箱内路径。路径包含空格时用英文双引号包住。 3. 按回车进入文件夹,再输入下面的命令。 ```bash claude ``` 第一次打开项目时,Claude Code 可能询问是否信任这个文件夹。确认是你自己的项目后,再按提示继续。 进入对话后,可以先请它阅读项目的 README,暂时不要修改。核对它找到的确实是当前项目,再安排后续工作。 ## 让它编辑文件或执行命令 把要改的内容、涉及的文件和预期结果说清楚。修改共享文件夹里的内容会同步影响本机原文件,重要改动先做好备份。 需要本机的编译工具或服务时,查看[无感模式](https://code-sandbox.cc/guide/seamless/)。需要调整操作确认方式,查看 [Bypass 设置](https://code-sandbox.cc/guide/permissions/)。这两个设置分别控制访问范围和确认方式。 ![Claude Code 设置页面,使用示例数据](https://code-sandbox.cc/previews/sandbox-claude.jpg) ## 结束后如何再打开 先让当前任务结束,再输入 `/exit` 退出 Claude Code。下次进入同一个沙箱和项目,再运行 `claude`。 要继续已有对话,使用当前 Claude Code 版本提供的恢复会话入口,先核对项目和会话内容。电脑重启后的启动顺序见[每天开机后怎么打开](https://code-sandbox.cc/guide/restart/)。 ## 提示未安装或命令不存在 先回 Code Sandbox 的 Claude Code 页面检查安装状态,并核对终端确实连到了当前沙箱。缺少组件时使用应用提供的安装操作。 不要为解决这个提示,直接在本机另装一份 Claude Code 登录同一个账号。仍然失败时,把报错和安装状态发给客服。 习惯 VS Code 的用户可以接着看 [Remote - SSH 教程](https://code-sandbox.cc/guide/vscode/)。 # 使用隔离桌面版 Claude Desktop 保留 Chat、Code、Cowork 的工作方式,并增加沙箱与环境防护。Code Local 和 Cowork 默认可访问本机文件与工具,不需要开启 Claude Code CLI 的无感模式,也不需要先添加共享文件夹。 **隔离 Claude 桌面版依赖沙箱。** 先准备所需组件并启动沙箱,再打开桌面版。 这篇适用于支持隔离 Claude 桌面版的交付版本。先完成[安装与功能准备](https://code-sandbox.cc/guide/first-start/),第一次打开后按[验证码教程](https://code-sandbox.cc/guide/login-desktop/)登录。 ## 每次怎样打开 1. 打开 Code Sandbox,选中对应的完整沙箱,启动后等待“运行中”。 2. 点击应用中的“Claude 桌面版”。缺少桌面组件时,先按应用提供的安装操作完成准备。 3. 在 Code Sandbox 打开的隔离桌面窗口里继续工作。不要从本机另装的普通 Claude 入口登录这个账号。 ## Chat 用来聊天 选择 **Chat**,新建对话,输入问题后发送。需要提供文件时,通过附件入口选择并核对文件。 网页、终端和桌面版的登录状态可能分别保存。桌面版要求重新验证时,使用[邮箱验证码登录](https://code-sandbox.cc/guide/login-desktop/)。 ## Cowork 用来处理任务和文件 选择 **Cowork**,按界面要求选择要处理的文件夹,再说明任务。例如整理你选中的资料,或处理其中的文档。 先看清它将访问哪个文件夹。任务涉及写入时,会改变实际文件,重要资料先备份。页面提示准备组件或没有可用权限时,按具体提示处理,再开始任务。 不同交付版本和账号开放的入口可能不同。没有 Cowork 或启动失败时,把版本与提示发给我们核对,不要改选不明远端环境来继续。 ## Code 用来写代码 Code 提供图形界面来使用 Claude Code 的编程能力。真正执行任务的位置由会话选中的运行方式决定,下面分别说明。 ### Local 1. 在隔离桌面窗口切换到 **Code**,选择 **Local**。 2. 选择要处理的本机项目文件夹。桌面版通过本机访问功能读写项目,按页面提示打开即可。 3. 新建会话,核对项目位置,先让 Claude 读取项目说明。 4. 确认文件正确后再安排修改。 这里说的 Local 是 Code Sandbox 启动的隔离桌面版提供的入口。不要把它和本机普通 Claude 中的 Local 混用。隔离桌面版还具备本机访问能力,任务可能影响本机,范围见[桌面版的本机访问范围](https://code-sandbox.cc/guide/seamless/#桌面版的访问范围)。 ### SSH 1. 保持 Code Sandbox 和目标沙箱运行。 2. 在桌面版 Code 的运行方式选择处,选择已配置好的 SSH 目标。 3. 对照 Code Sandbox 中当前沙箱的 SSH 名称,确认是同一个目标。 4. 连接后打开项目的沙箱内路径,再开始会话。 **这里只使用我们为本机沙箱配置好的 SSH 目标。** 不添加其他云服务器、其他电脑或陌生 SSH 地址。目标机器负责实际运行,连到其他机器后,本产品给本机沙箱配置的网络和隔离不会自动跟过去。 找不到对应目标时,回 Code Sandbox 查看当前沙箱的连接信息,或联系我们核对。不要猜测地址、端口或用户名。 ## 操作确认与文件访问 Code 会话的权限模式按[权限设置教程](https://code-sandbox.cc/guide/permissions/)检查。Bypass 会跳过通常的修改和命令确认,先限定任务范围。 隔离桌面版可调用本机文件和程序。Claude Code 页面中的隔离模式开关只管理 CLI,不能据此判断桌面版已经失去本机访问能力。 ## 退出和下次继续 先等任务完成、保存修改,再关闭桌面窗口。下次从 Code Sandbox 打开原来的沙箱和桌面入口,按需要恢复会话。 登录的逐步操作已集中到[桌面版验证码登录](https://code-sandbox.cc/guide/login-desktop/)。 # Claude Code CLI 共享文件夹 共享文件夹用于让沙箱中的 **Claude Code CLI** 读取本机项目。两边用的是同一份文件,允许写入后,改动会直接反映到本机项目里。 **Claude Desktop 的 Code Local 和 Cowork 默认可直接选择本机文件和项目,无需先配置共享文件夹或开启 CLI 无感模式。** 具体操作见[桌面版教程](https://code-sandbox.cc/guide/desktop/)。 共享文件夹在沙箱创建后设置;首次安装和新建向导不需要填写文件夹。 ## 添加一个项目 1. 在 Code Sandbox 中选中对应的完整沙箱。 2. 打开“目录与密钥”,找到“共享文件夹”,点击“添加共享文件夹”。 3. 选择本机项目文件夹,确认沙箱内路径。 4. 需要修改代码就选择“可读写”,只检查文件可以选择“只读”。 5. 保存设置。应用要求重启沙箱时,先保存正在进行的工作,再点击“保存并重启”。 6. 重启完成后,在沙箱终端中进入这个项目的沙箱内路径,再启动 Claude Code。 > **可读写共享会直接修改本机文件。** 在沙箱里删掉一个共享文件,本机那份也就删掉了。重要文件请提前备份。 只共享当前项目需要的文件夹。不要把整个个人主目录、浏览器资料或存有登录信息的配置文件夹一起共享进去。 ## macOS 文件访问授权 如果提示缺少文件访问权限,按[首次准备中的完全磁盘访问步骤](https://code-sandbox.cc/guide/first-start/#开启完全磁盘访问)开启应用要求的条目,再回 Code Sandbox 验证。 这项系统权限允许程序访问受保护的文件;共享文件夹的“只读”和“可读写”仍需按当前项目单独选择。 ## 文件夹打不开时 先看看沙箱是否正在运行、本机文件夹还在不在,再核对你打开的是不是沙箱内路径。能看不能改的话,检查权限是不是设成了只读。 Windows 提示某个文件夹被系统安全设置拦截时,按具体提示处理这个文件夹。仍然无法访问,把错误提示发给支持人员。 # Claude Code CLI 无感模式 **这一页的无感模式开关只管理 Claude Code CLI。** 终端任务需要本机文件、编译工具或服务时,可以通过无感模式直接调用。 Claude Desktop 的 **Code Local 与 Cowork 默认就能访问本机**,不需要开启这个开关,也不需要先添加共享文件夹。桌面版操作见[使用指南](https://code-sandbox.cc/guide/desktop/)。 ## 选择适合当前任务的模式 | 模式 | 可以做什么 | | --- | --- | | 隔离模式 | 使用沙箱和已共享的文件夹 | | 无感模式 | 在此基础上访问本机文件、运行本机命令、连接本机服务 | ## 怎样开启 1. 在 Code Sandbox 里选中要使用的完整沙箱,打开“Claude Code”页面。 2. 找到运行模式,选择“无感模式”,阅读本机访问说明后保存。 3. 保存前先结束需要保留结果的任务。页面要求重启沙箱时,保存文件后再重启;否则重新打开 Claude Code 会话。 4. 新会话中先说清要使用的本机文件夹和工具,核对路径后再让它执行。 新建沙箱默认使用无感模式,已有沙箱会保留之前的选择。已经开启的用户不需要反复切换。 ## Windows 旧版先打开开发者模式 **Windows 旧版(例如 0.4.14)使用无感模式前,需要开启本机的开发者模式。0.5.4 不适用这项旧版设置。** 1. 按 `Win + I` 打开 Windows 设置,在设置的搜索框输入“开发者模式”。 2. 打开对应结果,将 **开发者模式** 开关打开,按系统提示确认;需要管理员身份时由电脑管理员处理。 3. 返回 Code Sandbox,在当前沙箱的 Claude Code 页面选择“无感模式”,再新开一个 Claude 会话。 不同 Windows 版本的入口不同。Windows 10 常见位置是“更新和安全 → 开发者选项”;Windows 11 可在设置中搜索找到“开发者选项”或“高级”页面。只需按本步骤打开开发者模式,不要同时开启设备门户或设备发现。 ### 找不到设置入口 按 **Win + R** 打开“运行”,输入下面这一行,按回车。这条命令只打开开发者设置页面。 ```text ms-settings:developers ``` 如果页面仍然打不开,且这台电脑由你自己管理,可以按下面的方法开启开发者模式。公司电脑或提示“由组织管理”的电脑,交给管理员处理。 1. 在开始菜单搜索 **Windows PowerShell**,选择“以管理员身份运行”。 2. 核对是本机 PowerShell 窗口,粘贴下面整行命令,按回车。它会更改本机的开发者模式设置。 ```powershell reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1" ``` 3. 命令成功后重新打开设置,确认开发者模式开关已启用,再回 Code Sandbox 重开 Claude Code 会话。 4. 如果提示拒绝访问、组织策略限制或组件安装失败,保留错误交给管理员或客服,不继续修改其他注册表项。 这些步骤适用于前面说明的旧版需求。日后要关闭开发者模式,回 Windows 设置关闭对应开关。 这是本机 Windows 的设置,不能让 AI 顺带修改沙箱内的时区、语言或网络配置。公司电脑若由组织策略管理,请联系管理员。系统入口可参考 [Microsoft 开发者设置说明](https://learn.microsoft.com/en-us/windows/advanced-settings/developer-mode)。 旧版如果长时间卡在防火墙步骤,请看[Windows 旧版兼容处理](https://code-sandbox.cc/support/windows-legacy/)。 ## 本机访问权限 Claude 会用你当前电脑账号的权限运行本机命令,可以调用 Shell,也能修改这个账号有权访问的文件。**执行本机命令时,没有额外的逐条批准弹窗。** 请先确认你信任当前项目和 Claude 会话。只想让它使用沙箱和共享文件夹时,选隔离模式,再按任务需要设置文件夹的读写权限。 ## 桌面版的访问范围 Claude Desktop 的 Code Local 与 Cowork 启动后默认具备本机访问能力,可以按任务访问文件、调用工具和运行命令。这套能力与 Claude Code CLI 的模式分别管理。 把 Claude Code 切成隔离模式,只会关闭命令行的这套本机访问功能。桌面版仍然能操作本机,所以使用桌面版时,也要单独确认哪些任务可以交给它。 ## 日常项目怎么用更顺手 Claude Code CLI 在无感模式下可以按你提供的本机路径处理文件与工具。需要在沙箱终端中直接打开本机项目目录,或按项目设置只读、可读写权限时,再[添加共享文件夹](https://code-sandbox.cc/guide/files/)。 # 调整 Auto 和 Bypass 权限模式 保留 Code Sandbox 交付时的权限模式,不要自行切换 Auto 或 Bypass。需要调整时先联系交付人员确认,下面的步骤只用于已经确认的调整。 **Bypass 会跳过通常的操作确认,Claude 可以直接修改文件和执行命令。** 开启无感模式或使用隔离桌面版时,这些操作也可能影响本机。只在信任项目、明确任务范围并已备份重要文件时使用。 ## 从 Code Sandbox 设置 1. 选中当前沙箱,打开“Claude Code”页面。 2. 找到权限设置中的默认模式,选择“跳过权限确认”,对应 `bypassPermissions`。 3. 保存设置,结束旧的 Claude Code 会话,再打开新会话。 4. 看新会话显示的权限模式是否符合刚才的选择。未变化时先检查是不是选错了沙箱。 经确认需要在操作前再询问时,选择“手动确认”。按我们的实际使用经验,不推荐新用户自行开启 Auto。它会根据任务上下文审查工具操作,可能拦截后续动作。具体建议见[使用须知](https://code-sandbox.cc/guide/precautions/#auto-和-bypass-的使用建议)。 ## 在 Claude Code 里调整 先确认当前终端已经进入沙箱,再进入 Claude Code。输入 `/permissions`,按当前版本提供的选项查看权限规则和模式;界面没有所需选项时,返回 Code Sandbox 设置。 如果输入 `/` 后能找到 **update-config**,也可以在 Claude Code 的对话输入框使用下面的请求。 ```text /update-config 将当前沙箱内 Claude Code 的用户级 permissions.defaultMode 设置为 bypassPermissions。只改这个字段,保留其他配置,不修改网络、语言、时区、设备标识或服务设置。完成后告诉我是否需要重开会话。 ``` `/update-config` 的可用性取决于所安装版本和功能。提示未知命令时,用上面的应用设置方式。不要把这句话粘贴到 PowerShell、系统终端的普通命令提示符或浏览器地址栏。 如果组织策略禁止 Bypass,遵循组织设置,不能通过改其他文件解除限制。 ## 桌面版怎么选 在隔离 Claude 桌面版的 Code 会话中查看权限模式。已有 Bypass 就按原配置使用;经交付人员确认需要修改时,在该会话提供的模式菜单中选择 **Bypass permissions**。选项不存在或被组织禁用时,先向管理员或客服核对。 ## 权限模式和无感模式分开看 权限模式决定操作前怎么确认。无感模式开关决定 Claude Code CLI 能否调用本机文件、命令和服务。Claude Desktop 的 Code Local 与 Cowork 默认具备本机访问能力,不受这个 CLI 开关控制。两类入口都需要确认实际任务范围,写入本机文件会影响原文件。 权限模式的具体边界见 [Claude Code 官方权限说明](https://code.claude.com/docs/en/permissions)。 # VS Code 与 Remote - SSH ## 先准备好 1. 按 [macOS](https://code-sandbox.cc/guide/install-macos/) 或 [Windows](https://code-sandbox.cc/guide/install-windows/) 教程装好 Code Sandbox,准备并启动完整沙箱。 2. 在本机安装 VS Code,打开扩展市场,安装 Microsoft 发布的 [**Remote - SSH**](https://code.visualstudio.com/docs/remote/ssh)。 3. 在 Code Sandbox 中查看当前沙箱的 SSH 连接命令。先在本机终端执行它,确认可以连接。 ## 连接沙箱与项目 1. 在 VS Code 打开命令面板。macOS 按 `Shift + Command + P`,Windows 按 `Ctrl + Shift + P`。 2. 选择 `Remote-SSH: Connect to Host…`,选择交付时配置的 `claude` 目标,或应用给出的对应 SSH 目标。多个沙箱不要混用。 3. 如果询问远程系统类型,沙箱选择 **Linux**。首次连接等待 VS Code 在沙箱中准备服务。 4. 确认窗口左下角显示 `SSH: claude` 或你的实际目标名,再打开项目在沙箱中的文件夹。 5. 打开该远程窗口的终端,运行 `claude`,按 [CLI 教程](https://code-sandbox.cc/guide/cli/)继续。 ## Claude Code 扩展装在哪里 需要图形扩展时,在**已经连接沙箱的 VS Code 窗口**中找到 Anthropic 发布的 Claude Code 扩展,选择安装到当前 SSH 目标。扩展是否支持当前沙箱架构、版本和账号,以扩展的实际提示为准。 使用前确认窗口和扩展运行在 SSH 目标中,别在本机普通窗口里登录这个账号。授权网页仍然放到对应沙箱的隔离浏览器中完成。 这里使用 Microsoft 的 Remote - SSH 扩展连接本机沙箱。具体连接说明见 [VS Code 官方文档](https://code.visualstudio.com/docs/remote/ssh)。 ## 重启后继续 先启动 Code Sandbox 和原来的沙箱,再打开 VS Code 连接同一个 SSH 目标。进入项目后继续工作。不要把断开连接误认为项目丢失,也不要为此重新建沙箱。 # 线路与环境配置 ## 大陆优化与美国真实家宽 我们提供 **CN2 GIA + 9929 + CMIN2 优化三网精品线路**,搭配 **美国自有公寓光纤入户**,使用真实家庭宽带出口。 连接路径为:沙箱与隔离指纹浏览器 → 大陆优化线路 → 美国家庭宽带出口。 首页“真家宽”标签可展开查看住宅属性检测,显示美国加利福尼亚州 Irvine、原生 IP、住宅 IP。数据来源:[ippure.com](https://ippure.com)。[测一下你的家宽?](https://ippure.com) 交付时会把对应网络线路配到沙箱里。日常从同一个沙箱打开隔离浏览器、CLI 或桌面版,使用交付的线路。网络状态以当次连接和检测结果为准;遇到连接问题,把应用提示发给我们,先不要自行重置网络。 ## 45 项环境风险因子 交付方案围绕 **45 项环境风险因子** 做统一配置,包含网络探测、本机应用特征、DNS、WebRTC、字体、时间、时区和语言等方面,让沙箱的环境信号与美国本地使用场景保持一致。 这些设置重点用于防止真实设备、网络与地区信息泄露,减少由环境泄露带来的账号风险。这里列出的是主要配置类别,并非逐项检测报告。环境配置不能保证平台一定把账号认定为美国本地用户,也不能承诺账号永不受限。 ## 怎样保持交付配置 - 账号登录、邮箱登录和授权链接都在指定沙箱中完成。 - 所有交付沙箱、隔离浏览器和隔离应用的设置都保留原样,不要改成中文。未经交付人员确认,自己和 AI 工具都不能改动;语言、地区、时区、设备标识、DNS、网络和服务启动顺序都在这个范围内。 - 正常写代码、安装项目依赖和中文对话都可以。本机的语言与时区按自己的习惯设置即可。 - 本机网络工具能一起正常使用时,保留原设置。开启后沙箱断网,再按[对照排查步骤](https://code-sandbox.cc/guide/account/#本机网络工具怎么开)检查规则、DNS 或 TUN 是否冲突。 完整的新账号、模型和权限建议见[使用须知](https://code-sandbox.cc/guide/precautions/)。流量与续费说明见[账号与日常使用](https://code-sandbox.cc/guide/account/),账号及售后风险见[下载页风险提示](https://code-sandbox.cc/download/#risk-notice)。 # 使用须知

不要改成中文!

沙箱、隔离浏览器和隔离 Claude 应用的界面语言都要保持交付时的设置。不要自行更改,也不要让 AI 代改。

中文对话、写中文文档可以正常使用。这里禁止更改的是这些环境的语言设置。

## 1 最严重的风险,在沙箱外登录账号 **账号的所有登录和授权操作,都必须在为它配置好的沙箱内完成。** 包括 Claude 登录、邮箱登录、收取登录邮件和打开授权链接。 不要在本机普通浏览器、手机、其他电脑或另装的 Claude 应用里登录这个账号,也不要把登录链接复制过去打开。那次访问会使用对应设备的网络与设备信息,指定沙箱的隔离设置无法保护它,可能暴露真实访问环境并增加账号受限风险。 ### 桌面版 SSH 只连接配置好的沙箱 Code 模式选择 SSH 时,对照 Code Sandbox 中当前沙箱的连接名称。不要把其他服务器或电脑加进来使用这个账号。程序会在 SSH 目标机器上运行,当前沙箱的设置无法覆盖另一台机器。具体步骤见[桌面版的 Local 和 SSH 用法](https://code-sandbox.cc/guide/desktop/#code-用来写代码)。 已经在其他入口登录过,先停止继续使用那个入口,把设备、入口和当时的操作告诉客服。不要靠重置沙箱或更换标识尝试清除平台已经收到的信息。 ## 2 不要修改交付配置,避免本机信息泄露 **所有交付沙箱及其隔离浏览器、隔离应用的设置都要保留原样。未经交付人员确认,任何设置都不要自行修改,也不要授权 Claude Code、Codex 或其他 AI 工具修改。** 尤其要保留语言、地区、时区、设备标识、DNS、网络线路、浏览器配置和服务启动顺序。修改这些设置可能破坏原有隔离或网络配置,让真实本机的网络、设备或地区信息暴露给外部服务。 AI 提出“改成中文”“自动调整时区”“修复网络”或“重置浏览器”时,先停下,把它准备修改的内容发给客服。已经改过的,记录改了什么,暂停账号使用,交给客服核对恢复。 日常写代码和处理文档照常进行。不要为了完成任务,顺带更改沙箱的系统、网络或浏览器设置。 ## 3 第一周控制用量,不要使用 Fable **新账号第一周,每个 5 小时周期的已用额度和每周已用额度,都建议不要超过 80%。** 两项分别看,不能只看其中一项。 以 Claude 用量页面显示的比例和重置时间为准。这是使用额度的百分比,5 小时也指额度周期。任一项接近 80%,先停下或推迟后续任务,等对应额度重置。不要一开始就同时跑大量任务,或长时间连续重复请求。 80% 是我们的交付使用建议,不代表 Claude 官方的风控阈值,也不能保证低于它账号就不会受限。 **按我们的交付建议,不要使用 Fable 系列模型,包括 Max 用户。** Fable 内置内容安全审查,可能拒绝请求。日常任务先按交付建议选择 Opus 5.5;其他模型也有安全限制,换模型不代表可以绕过平台规则。审查机制可参考 [Claude 官方说明](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback)。 遇到内容限制、账号警告或暂停,保留完整提示,停止重复尝试,联系客服处理。需要申诉时按平台流程提交。 ## 4 Auto 和 Bypass 的使用建议 **保留交付时的权限模式,不要自行切换 Auto 或 Bypass。** 如需调整,先让交付人员确认。 我们不建议新用户自行开启 **Auto**。它会在执行部分工具操作前自动检查动作是否符合你的请求,可能拦截后续操作。这是工具操作检查,与模型的内容安全审查分别生效。 交付时已经配置 **Bypass permissions** 的,在明确任务范围、信任项目并备份重要文件的前提下使用。Bypass 会跳过通常的文件修改和命令执行确认;无感模式和隔离桌面版还可能直接修改本机文件、运行本机程序。Bypass 不会取消平台的内容审查或账号限制。 需要逐次确认操作时,联系交付人员调整。组织禁止的模式,遵循组织限制。经确认后的设置步骤见[权限模式说明](https://code-sandbox.cc/guide/permissions/)。 ## 网络与流量 本机网络工具能正常配合使用时,保留当前设置。开启后出现断网,按[网络工具排查](https://code-sandbox.cc/guide/account/#本机网络工具怎么开)核对,别自行重置沙箱网络。 配套线路的网络流量和 Claude 使用额度分别计量,具体见[用量说明](https://code-sandbox.cc/guide/account/)。需要技术支持时[通过页脚微信联系](https://code-sandbox.cc/contact/#contact),账号风险和售后范围见[下载页风险提示](https://code-sandbox.cc/download/#risk-notice)。 # 用量与账号维护 ## 继续使用同一个沙箱 这个账号一直在给它配好的沙箱里用。登录邮箱、打开登录邮件和授权链接,也都在它的隔离浏览器里完成。 不要把登录授权链接复制到本机普通浏览器、手机或本机另装的 Claude 中打开。这些入口使用各自的网络和设备配置。 ## 本机网络工具怎么开 **是否会影响,要看你使用的工具和当前设置。** 开着时,隔离浏览器、CLI 和桌面版都能正常连接,就可以保持现状。 如果一开启网络工具,沙箱就上不了网,先这样对照检查。 1. 记下工具名称、当前模式和应用报错,暂时关闭这个网络工具,再试同一个沙箱里的同一个操作。 2. 关闭后恢复正常,说明这个工具或它的设置可能影响连接。检查是否开启了 TUN(有些工具叫“虚拟网卡模式”),以及它的网络规则是否影响了沙箱流量。 3. 想继续同时使用时,一次只改一项工具设置,再测试。具体排除规则让客服根据工具和报错核对,不照抄其他人的地址或端口。 4. 关闭后仍然不通,就继续按[问题排查](https://code-sandbox.cc/support/)检查网络线路和沙箱状态。 网络规则、DNS 或 TUN 接管都可能产生冲突,具体原因要看实际表现。别为排查本机工具去重置沙箱网络、清空浏览器资料或修改隔离配置。 ## 网络流量怎么算 交付的常见套餐每月包含 **100 GB 网络流量**,加购说明为 **20 元增加 50 GB**。你的额度、期限和价格以购买时确认的套餐为准,购买了其他套餐就按对应额度使用。 同一份网络套餐下,隔离浏览器里的网页、视频和文件下载共同消耗线路流量。CLI 和桌面版通过这份线路上网,也会消耗这份额度。持有多个授权码时,先向客服核对每份码对应的套餐,不把不同套餐的余额混在一起。 可以正常看视频、刷网页,只是视频和大文件下载用得比较快。加购流量请[联系淘宝店铺](https://code-sandbox.cc/contact/#shop);家庭宽带线路续费请通过[页脚微信](https://code-sandbox.cc/contact/#renew)联系。 ## Claude 对话额度和网络流量有什么区别 Claude 页面里的消息、模型使用量和重置时间由 Claude 套餐决定。Code Sandbox 配套的 GB 流量用于网络传输,两边分别计量。 Claude 提示达到使用上限时,按 Claude 页面显示的重置时间或套餐说明处理。家宽流量不足时联系淘宝店铺加购,线路到期时通过页脚微信续费。 查看线路用量时,留意数据来源和更新时间。旧版应用的本机累计只能作为参考,和后台核对不一致时,让客服查服务器记录,不凭本机数字判断扣费。 ## 本机语言和时区可以改回去吗 可以。本机的语言和时区按你自己的习惯设置就好,不用为了 Claude 一直保留英文或美国时区。Code Sandbox 使用自己管理的设置。 本机网络工具是否影响连接,按前面的对照步骤检查。沙箱和隔离浏览器里的配置,则按下一节保留原样。 ## 保留已配置的设置 正常写代码、安装项目需要的开发工具、用中文对话,都可以。 **所有交付沙箱、隔离浏览器和隔离应用的设置都要保留原样,不要改成中文。** 未经交付人员确认,任何设置都不要自行修改,也不要让 Claude Code、Codex 或其他工具代改。语言、地区、时区、设备标识、DNS、网络线路、浏览器配置和服务启动顺序都在这个范围内。 如果 AI 建议“重置浏览器”或“修复网络”,先把它准备改的内容发给我们。改动可能破坏隔离或网络配置,使真实本机信息泄露。完整警告见[使用须知](https://code-sandbox.cc/guide/precautions/)。 ## 新账号与操作确认 第一周用量、模型选择和保留配置的交付建议,集中在[使用须知](https://code-sandbox.cc/guide/precautions/)。调整 Auto 或 Bypass 的具体操作见[权限模式](https://code-sandbox.cc/guide/permissions/)。 ## 出现内容限制时 先停下这次请求,看看页面具体说了什么,再检查任务内容和授权范围。不要反复改写同一个被拒绝的请求,试图继续执行。 如果需要我们协助,说明你用的是网页、桌面版还是命令行,附上操作步骤和错误提示。截图前遮住密码、验证码和登录授权链接。 # 从安装到开始使用 ## 先把应用装好 按电脑系统打开 [Windows 安装](https://code-sandbox.cc/guide/install-windows/)或 [macOS 安装](https://code-sandbox.cc/guide/install-macos/),再完成[授权、权限和功能选择](https://code-sandbox.cc/guide/first-start/)。看到自己的沙箱页面后,再登录账号。 安装慢、出现失败或一直正在连接本机服务,按[安装问题排查](https://code-sandbox.cc/guide/install-troubleshooting/)处理当前这一步。 ## 登录 先[准备账号和邮箱](https://code-sandbox.cc/guide/login/),再从同一个沙箱打开隔离浏览器,完成[邮箱和网页版登录](https://code-sandbox.cc/guide/login-web/)。 要用 Claude Code,再做[订阅登录](https://code-sandbox.cc/guide/login-cli/);要用桌面版,再做[验证码登录](https://code-sandbox.cc/guide/login-desktop/)。两个入口的 code 要填回各自发起登录的窗口。 ## 使用 [网页版](https://code-sandbox.cc/guide/browser/)、[Claude Code](https://code-sandbox.cc/guide/cli/)和[桌面版](https://code-sandbox.cc/guide/desktop/)都有各自的打开步骤。下一次开机,按[日常启动顺序](https://code-sandbox.cc/guide/restart/)继续使用原来的沙箱。 Claude Code 的项目路径和终端操作见[命令行教程](https://code-sandbox.cc/guide/cli/)。 Claude Code 需要接入本机项目时,可以[添加共享文件夹](https://code-sandbox.cc/guide/files/)。允许写入后,修改会直接影响本机原文件。Claude 桌面版直接通过自己的文件入口访问本机,见[桌面版教程](https://code-sandbox.cc/guide/desktop/)。 ## Auto 和 Bypass 怎么选 操作确认方式统一放在[权限模式教程](https://code-sandbox.cc/guide/permissions/)。Claude Code CLI 需要本机文件和工具时,了解[无感模式](https://code-sandbox.cc/guide/seamless/)的访问范围;Claude Desktop 的 Code Local、Cowork 默认具备本机访问能力。 ## 和本机网络工具一起使用 能正常使用就保留现有设置,出现断网时看[网络工具排查](https://code-sandbox.cc/guide/account/#本机网络工具怎么开)。 ## 新账号与模型使用建议 用量、模型和配置保护的交付建议见[使用须知](https://code-sandbox.cc/guide/precautions/)。账号操作继续在指定沙箱内完成。 完整安装顺序见[安装与登录](https://code-sandbox.cc/guide/),卡住时可以[联系支持](https://code-sandbox.cc/contact/#contact)。 # Windows 旧版兼容处理 **这页适用于 Windows 旧版,例如已安装的 0.4.14。0.5.4 已处理这里的两项兼容问题,不需要按本页手动设置。** 新版如果仍然卡住,请把版本和完整提示发给我们,不要套用旧版命令。 ## 长时间卡在防火墙步骤 如果旧版在防火墙相关步骤等待很久,没有继续,可以按下面的方法为当前运行的 Code Sandbox 添加一条入站允许规则。 ### 执行前 1. **保持 Code Sandbox 运行**,不要先退出或重开 App。下面的命令需要找到当前正在运行的程序。 2. 在开始菜单搜索 **Windows PowerShell**,右键选择 **以管理员身份运行**。如果用 Windows Terminal,请选择管理员窗口里的 PowerShell,不要粘贴到命令提示符或沙箱终端。 3. 这条规则只指定找到的那个 Code Sandbox 程序,但会允许本地子网向它建立入站 TCP 连接,涵盖所有网络配置文件,未限定本地端口。规则重启后仍然保留,请在你信任的网络中使用。 ### 复制整段命令执行 ```powershell $appExe = Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -like "$env:LOCALAPPDATA\CodeSandbox\App\*\Code Sandbox.exe" } | Sort-Object CreationDate -Descending | Select-Object -First 1 -ExpandProperty ExecutablePath if ([string]::IsNullOrWhiteSpace($appExe) -or !(Test-Path -LiteralPath $appExe)) { throw "未找到当前运行的 Code Sandbox.exe,请确认 App 仍在运行" } $appExe $ruleName = "CodeSandbox-Emergency-GuestRuntime-$(Get-Date -Format 'yyyyMMdd-HHmmss')" New-NetFirewallRule ` -Name $ruleName ` -DisplayName $ruleName ` -Group "Code Sandbox emergency recovery" ` -PolicyStore PersistentStore ` -Enabled True ` -Direction Inbound ` -Action Allow ` -Protocol TCP ` -Program $appExe ` -RemoteAddress LocalSubnet ` -Profile Any ``` 命令会先显示当前程序路径,再创建一条带时间戳的规则。看到规则信息后,回到 Code Sandbox 检查原步骤是否继续;如果应用已显示失败,再使用页面上的重试入口。不要反复执行整段命令,以免添加多条规则。 - 提示“未找到当前运行的 Code Sandbox.exe”,先确认 App 仍在运行。自定义安装路径不匹配时,请联系我们确认,不要把程序路径改成通配放行。 - 提示“拒绝访问”,检查是不是管理员 PowerShell。 - 规则已创建但仍卡住,把应用提示和命令报错发给我们。不要关闭整个防火墙或删除其他规则。 ### 查看或撤回这条规则 在刚才的同一个 PowerShell 窗口里,可以查看它的状态。 ```powershell Get-NetFirewallRule -Name $ruleName -PolicyStore PersistentStore | Select-Object Name, Enabled, Direction, Action, Profile ``` 如果已经换了窗口,先把执行时输出的**完整规则名**赋给 `$ruleName`。确认不再需要这条临时处理规则后,用下面的命令只删除这一条。 ```powershell Remove-NetFirewallRule -Name $ruleName -PolicyStore PersistentStore ``` 不要把规则名换成 `*`。升级后程序路径可能变化,旧规则也不会自动对应到新的程序;可以联系我们确认是否清理。 ## 旧版无感模式需要开发者模式 Windows 旧版使用无感模式前,先在本机 Windows 设置中打开“开发者模式”,具体步骤见[无感模式的旧版 Windows 设置](https://code-sandbox.cc/guide/seamless/#windows-旧版先打开开发者模式)。只使用隔离浏览器时,不用为此开启它。 参数说明可参考 [Microsoft 防火墙命令文档](https://learn.microsoft.com/en-us/powershell/module/netsecurity/new-netfirewallrule)。这段命令是旧版问题的处理方法,不能代替对其他网络或系统问题的排查。