终端与 Claude Code/Codex

ServerCC 提供功能完整的终端用于与 Claude Code 和 Codex 交互。终端支持 VT100/Xterm 仿真和实时双向 I/O。

终端界面

输入框

终端在屏幕底部使用专用的输入框(不直接使用系统键盘)。这为编写多行提示和与 Claude 交互提供了更好的体验。

多行编辑模式

编写较长的 prompt 时,可切换到多行编辑模式 — 这是一个全高度编辑器,允许你在发送前起草、审阅和修改。它与语音转写键盘配合尤其出色:口述整段内容、就地订正错字,再一次性发送给 Claude 或 Codex。

编辑过程中,底层终端输入会实时同步 — 编辑器中所见即发送给代理的内容,发送时不会出现意外。

可定制快捷命令

输入框上方的快捷命令条分为两屏。第一屏是内置的 chip,如 /clear、Esc、思考模式快捷键等。第二屏完全可定制 — 将你最常用的 slash command、按键或片段固定在这里。

已保存的快捷命令在 App 范围内生效(非按工作区),因此你搭建的布局会在每台服务器和每个工作区中一致出现。点击 chip 可将其文本插入当前光标位置;点击按键 chip(如 Esc)会直接把该按键发送给代理。

添加图片

点击输入框旁的照片按钮,从相册添加图片 — 截图、设计稿、示意图、白板照片都可以。支持多选;每张图片会转换为 JPEG,通过 SFTP 上传到服务器,并在输入框上方显示缩略图 chip,不影响你继续输入。

发送消息时,附件会以原生图片引用的形式交给代理 — Claude CodeCodex 都能识别并看到图片内容。发送前点击 chip 上的 ✕ 可移除附件。

全屏模式

切换全屏模式可最大化终端区域。在全屏模式下,系统键盘直接用于终端输入,底部工具栏隐藏。

No Flicker 模式

No Flicker 模式将 Claude Code 切换为全屏 TUI,支持触摸/鼠标操作,在较慢或高延迟连接上显著减少画面闪烁。在工作区的会话选择器设置中启用。详见 工作区设置

底部工具栏

底部工具栏显示你选择的三个标签,可在设置 → 偏好设置 → 终端 → 底部工具栏标签中从四个可用标签里挑选:

  • 文件 — 打开此工作区的文件浏览器
  • Git Diff — 以 GitHub 风格审阅工作区更改 — 见 Git 差异
  • 技能 — 管理此工作区的 Claude Code 技能
  • MCP — 配置 MCP 服务器

会话、端口、VNC 及其他工作区操作位于右上角菜单(⋯)中。如果你想要完全干净的界面,终端设置里的隐藏底部工具栏开关可以彻底移除工具栏。

终端外观

设置 → 偏好设置 → 终端中,可以通过滑块调整终端字体大小(并可一键恢复默认值)。字体小一些能在屏幕上容纳更多 Claude 的输出;大一些则更方便阅读。

登录流程

首次启动 Claude Code(或会话过期后),你需要进行认证:

1

Claude Code 在终端中输出一个登录 URL。

2

ServerCC 检测到该 URL 后弹出原生 Authentication Required 提示框,提供 Open Login PageCancel 两个按钮。

3

点击 Open Login Page,在内嵌 Safari 中完成 OAuth。登录后复制页面上的配对码,粘贴到终端输入框里即可。

会话生命周期

离开终端时,你有几个选项:

  • 后台运行 — 让 Claude 在后台继续运行。会话出现在运行中标签页,稍后可恢复。
  • 退出 — 结束 Claude 会话并关闭终端连接。

重新连接

如果 SSH 连接断开(网络切换、服务器重启等),ServerCC 会显示重连横幅并自动以指数退避方式尝试重新连接(最多 3 次重试)。你也可以点击横幅手动重试。

纯终端

ServerCC 还提供纯终端模式 — 不带 Claude Code/Codex 的直接 SSH Shell。在服务器详情页面的终端部分访问。适用于:

  • 直接运行系统命令
  • 检查服务器日志
  • 常规服务器管理
  • 调试连接问题