工作区

工作区是服务器上 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 执行任何工具都不再询问 — 仅在可信环境中使用。

标签 DefaultAcceptEditsAutoBypass 在所有语言下都保留英文,以与 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。详见专门指南:

  • 会话 — 创建、恢复和管理 Claude Code 对话
  • Worktree — 同时处理多个 Git 分支
  • 后台与并行运行 — 后台运行会话并同时并行运行多个实例

删除工作区

在服务器详情页面,向左滑动工作区可删除它。这会从 ServerCC 中移除工作区,但不会删除服务器上的目录。