工作区
工作区是服务器上 Claude Code 会话运行的项目目录。每个服务器会自动创建一个默认工作区,你可以为不同项目创建额外的工作区。
创建工作区
在服务器详情页面,点击工作区部分的 + 按钮。
基本信息
- 名称 — 工作区名称(必填)
- 描述 — 工作区用途的可选描述
- 图标 — 从 12 个图标中选择以直观识别工作区
自定义路径
默认情况下,ServerCC 会在你的 home 目录下创建工作区。要放在其他位置,请在文本框中输入路径(例如 /home/user/projects/myapp),或点击右侧的文件夹按钮打开目录选择器。
选择器会从你的 home 目录开始,通过 SFTP 列出服务器上的文件夹。点击某一行进入子目录;点击顶部的路径面包屑可以返回上一级。点击右上角的选择此文件夹使用当前路径 — 路径会回填到文本框中。
选择(或输入)路径后,ServerCC 会检查该目录是否已存在。如果不存在,会出现自动创建目录开关,开启后保存时会自动 mkdir 创建。
Git 仓库(可选)
如果服务器上安装了 Git,你可以在创建工作区时提供要克隆的仓库 URL。支持 SSH 和 HTTPS URL:
git@github.com:user/repo.git
https://github.com/user/repo.git
如果克隆失败,你可以选择重试或跳过并不克隆直接创建工作区。
工作区设置
每个工作区都有影响 Claude Code 或 Codex 会话启动方式的设置。这些开关位于会话选择器的设置部分。
No Flicker 模式
通过设置 CLAUDE_CODE_NO_FLICKER=1 启用 Claude Code 的全屏 TUI 模式。在此模式下,Claude Code 以全屏终端应用形式渲染,支持触摸/鼠标操作,并显著减少慢速连接上的画面闪烁。
推荐在较慢或高延迟连接中使用,这些场景下默认终端输出会产生可见的闪烁。如果你偏好带有触摸交互的全屏 TUI 体验,也可以启用。此设置仅适用于 Claude Code 会话。
权限模式(Claude Code)
对于 Claude Code,会话选择器提供四档选择器,直接对应 Claude 的 --permission-mode 参数:
- Default — Claude 在执行工具、编辑文件或运行 Shell 命令前会询问(推荐默认值)。
- AcceptEdits — 自动批准文件编辑;其他工具调用仍会询问。
- Auto — 由 Claude 判断哪些操作需要确认;大多数安全操作直接执行。
- Bypass — 添加
--dangerously-skip-permissions。Claude 执行任何工具都不再询问 — 仅在可信环境中使用。
标签 Default、AcceptEdits、Auto、Bypass 在所有语言下都保留英文,以与 Claude Code 官方术语保持一致。
Full Auto 模式(Codex)
对于 Codex,有一个单独的 Full Auto Mode 开关用于添加 --full-auto。开启后 Codex 执行任何工具调用时都不再询问。
仅在可信环境中使用 Bypass(Claude Code)或 Full Auto Mode(Codex)。跳过权限后,代理会在不询问的情况下执行文件编辑、Shell 命令及其他操作。
解锁钥匙串用于 OAuth(macOS)
通过 SSH 连接 macOS 服务器时,Claude Code 将 OAuth 凭据存储在 macOS 钥匙串中。但 SSH 会话默认无法访问钥匙串。启用此开关可在 Claude Code 会话启动时自动解锁钥匙串。
启用后,ServerCC 会:
- 提示你保存 macOS 用户登录密码(存储在 iOS 钥匙串中)
- 在 Claude Code 启动前自动运行
security unlock-keychain - 在解锁提示出现时输入密码,使 Claude Code 可以访问存储的 OAuth 凭据
此选项仅在 macOS 服务器(自动检测)且工作区代理模式为 Claude Code 时显示。Codex 使用 API 密钥而非 OAuth,因此不需要此选项。
会话、Worktree 与后台运行
每个工作区包含 Claude Code 会话,并可选择使用 Git worktree。详见专门指南:
删除工作区
在服务器详情页面,向左滑动工作区可删除它。这会从 ServerCC 中移除工作区,但不会删除服务器上的目录。