CAGE · 使用手册

项目、终端与文件

在同一工作台运行 Claude Code、编辑代码、传递附件，并弄清关闭和退出对任务的影响。

本页内容

打开项目与编辑文件

点击左侧“项目”旁的加号，选择已有项目，或点“添加本机项目…”打开主机目录。没有项目时也可使用默认工作区。项目列表会保存，下次启动继续可用。

项目旁的打开图标（↗）在 code-server 中编辑该目录，终端图标（>_）用于选择终端类型。文件会直接写入共享目录，重要项目请先备份；.git 等元数据默认只读，在主机 Git 工具审查和提交代码。

所有项目共用一个环境、工具和账户。切换项目不会改变已有终端的目录，也不会关闭网页或撤销之前的共享。云端的目录与权限见云端部署与 SSH。

也可创建普通终端，自行运行 shell 命令。在“设置 → 通用 → Claude 终端启动命令”添加参数，例如 claude --continue。只对以后新建的 Claude 终端生效，退出 Claude 后 shell 仍可使用。

移动端的结构化会话与普通终端分别管理，详见手机会话范围。

鼠标移入终端行或用键盘聚焦后，可置顶、重命名或删除。网页标签可右键或按 Shift+F10 打开菜单；拖动可在同一列表排序，Esc 取消拖动，刷新保留顺序。页面过多时用向下箭头搜索已打开的网页。

工作台支持网页与终端组合使用；普通网页也支持双页分屏。无痕网页可与终端分屏，双网页分屏仅支持普通标签。浏览器右上角 × 返回之前的工作区，已打开的网页和登录状态保留。

macOS 用 ⌘1–9 切换当前网页或当前目录的终端；Windows/Linux 工作台对应使用 Ctrl。终端中的 Ctrl+C 始终用于中断命令。

网页选择上传文件时，会显示“上传本机文件”，点击“选择本机文件”调用系统窗口。一次最多 100 个文件，单文件最多 2 GB；网站还可能有更小限制。只传递选中的文件，不会因此共享整个文件夹。取消、刷新或关闭原网页后需重新选择。

可以把图片、视频、文档拖到支持附件的目标，或在文件管理器复制后到 Cage 粘贴。终端会把附件存入客机目录并插入带引号的路径，供 Claude Code 读取，不自动执行。截图粘贴最多 20 MB、4000 万像素；文件传输不使用外部存储中转。

下载在 Cage 环境内完成。本机模式的完整文件先保留在默认工作区 Downloads，同名自动换名；工作台观察到完成后弹出“另存为”。取消仍保留默认位置的文件。在左侧“下载”或浏览器下载按钮可查看进度、打开、显示文件位置或另存。

云端文件和已经另存到本机的副本分开记录。要在其他应用打开远端文件，先明确保存到本机。

先点击目标输入位置，再复制或粘贴。macOS 终端用 ⌘C/V，Windows/Linux 终端用 Ctrl+Shift+C/V。普通网页、编辑器和本机输入框按所选键盘习惯操作；“设置 → 通用”可调整。

终端程序接管鼠标时，Mac 按住 Option 拖选，Windows/Linux 按住 Shift 拖选，再复制。普通浏览器因权限限制无法使用剪贴板时，可用“文本传递”面板传纯文本。

网页自身的复制按钮支持把纯文本同步到本机，保持网页和窗口在前台，等待“已复制到本机”。切换标签或输入位置可能取消尚未完成的传递，重新复制即可。

操作	对任务的影响
关闭或隐藏窗口	环境、终端、网页和下载继续运行。不可见时暂停画面显示连接，返回后重连。
锁定 Cage	隐藏工作台并要求验证，已运行的任务继续。手机的受保护操作暂停。
退出应用时选择保留环境	后台任务继续，下次打开重新连接。
停止环境或退出账户	结束运行中的终端，项目、磁盘和登录资料保留。
刷新工作台	可重连后台仍存活的终端。
重启控制服务或环境	旧终端进程不能恢复，需要新建。

停止前保存编辑器内容。磁盘里保存的文件与 Claude 历史，不等于能恢复已结束的进程和终端临时输出。

没有解决你的问题？附上版本、系统与错误原文，帮助我们定位。