# 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. 等下载完成,再打开文件。没有这个提示就直接继续安装。 [](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**。 [](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。以后都从这里启动,也可以保留到程序坞。 [](https://code-sandbox.cc/guide/images/macos-install.svg) *操作示意图,可点击放大。安装窗口外观可能随版本变化。* 请先完成拷贝,再运行应用;不要一直从 DMG 的安装窗口里打开。安装完成后可以推出磁盘映像。 ## 系统提示无法验证开发者 未签名或未完成公证的安装包,可能触发 macOS 的开发者验证提示。从我们的下载页取得安装包后,可以按下面的步骤允许本次打开。 1. 先从“应用程序”尝试打开 Code Sandbox 一次。 2. 如果 macOS 提示无法验证开发者或未完成公证,关闭提示,打开“系统设置”。 3. 进入 **隐私与安全性**,向下找到安全性区域里对应 Code Sandbox 的提示,点击 **仍要打开**。旧版系统的位置可能在“系统偏好设置 → 安全性与隐私”。 4. 按系统要求验证身份,再确认“打开”。如果这个按钮没有出现,先核对刚才拦截的是否就是 Code Sandbox。 [](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. 欢迎页播放撒花效果,点击 **立即进入**,开始选择功能。  图中的 `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/)。这两个设置分别控制访问范围和确认方式。  ## 结束后如何再打开 先让当前任务结束,再输入 `/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 代改。
中文对话、写中文文档可以正常使用。这里禁止更改的是这些环境的语言设置。