键盘优先
在真实 TTY 中推进任务，不需要切换到图形界面。
正在确认登录状态
02直接答案
先说清楚它是什么。
Cocode TUI 是面向真实 TTY、SSH 和无图形环境的 terminal AI coding agent。它连接 Cocode Host 与 Session，让开发者在远程机器上读取仓库、运行命令、修改代码并继续桌面端任务。
- 运行环境
- 支持交互输入的真实 TTY
- 远程使用
- SSH 分配伪终端后使用
- 任务连续性
- 与 GUI 共享同一 Host、Profile 和 Session
- 启动检查
- `cocode doctor` 后运行 `cocode`
SSH 友好
适合远程机器、服务器和没有桌面环境的工作区。
共享 Session
与 GUI 连接同一个 Host、profile 和 Session 数据。
02为什么重要
适合远程和键盘流开发
安装 TUI 后运行 `cocode doctor` 检查 Host，再运行 `cocode` 开始任务。真实终端会保留滚动、快捷键和交互状态。
不是另一套孤立的客户端
GUI 与 TUI 都连接同一个 Host。你可以在桌面查看 diff，在 SSH 中继续执行测试，再回到 GUI 检查结果。
↗
清晰的边界，才适合真实开发任务。
权限、模型和 Session 都有上下文
终端界面展示当前模型、工作目录、活动状态和权限边界，让远程任务不再是黑盒命令流。
↗
清晰的边界，才适合真实开发任务。
05实际工作流
从开始到验证，每一步都有明确结果。
下面不是理想化功能清单，而是一条可以在真实代码库中执行和检查的路径。
- 01
确认终端能力
在支持 TTY、颜色和交互输入的 shell 中运行，SSH 时确认会分配伪终端。
- 02
执行环境诊断
用 `cocode doctor` 检查 Host、配置和模型连接，先处理明确错误。
- 03
启动 TUI
运行 `cocode`，选择工作区和 Session 后开始任务。
- 04
在 GUI 与 TUI 间继续
需要可视化检查 diff 时回到桌面端，远程执行时继续使用同一个 Host 与 Session。
06适用场景
按真实任务判断是否适合。
SSH 远程开发
在云主机或开发机上读取日志、修改服务并运行测试。
无图形服务器
在 headless 环境中保持完整的 agent 任务流。
容器内排障
进入开发容器或临时环境，检查依赖、构建和运行时问题。
CI 修复
复现失败命令、修改配置或测试，再验证相同门禁。
07开始前确认
运行要求与兼容边界
- 支持交互输入的真实 TTY；非交互管道不等同于 TUI
- SSH 使用 `-t` 或等效设置分配终端
- 工作区和命令需要当前用户具备相应权限
- 长任务建议使用稳定会话管理，并避免终端断连造成未确认状态
08可直接尝试
终端快速开始
先进入目标仓库，再检查环境并启动 TUI。
cocode://workspaceREADY
cd /path/to/repository
cocode doctor
cocode09事实与边界
终端工作流的能力和限制。
TUI 接近真实命令环境，适合远程开发，也需要更清楚的权限和连接边界。
| 能力 | 结论 | 条件与证据范围 |
|---|---|---|
| SSH / headless | 支持 | SSH 需要分配伪终端；无图形环境不影响 TUI。 |
| 交互式 TTY | 必须 | 非交互管道或不完整终端不能替代真实 TUI 环境。 |
| Session 续接 | 同范围支持 | 需要相同 Host、Profile、DSH Home 与 Session 数据。 |
| 断线恢复 | 取决于状态 | 长任务应使用稳定会话工具，并在重连后检查未确认动作。 |
10Cocode 的判断
终端的价值是保持上下文，不是隐藏影响。
Cocode TUI 让 SSH 和键盘流继续同一任务，但命令、数据库、凭据和部署仍然是真实外部影响。终端效率必须和退出码、输出与权限确认一起使用。
- 维护者
- Cocode Agency
- 最近复核
- 2026-08-25
- 内容范围
- Cocode TUI、TTY、SSH 与跨客户端 Session 连续性
- 验证方式
- 依据当前终端启动路径、Host 连接和权限边界维护
06FAQ
在开始之前，先把边界说清楚。
Cocode TUI 需要真实终端吗？
需要。TUI 是终端客户端，应在支持 TTY 的 shell 中运行。
可以在 SSH 服务器上使用吗？
可以。TUI 面向键盘和远程工作，不要求图形环境。
TUI 与 GUI 的会话互通吗？
在相同 DSH Home、profile 和 Host 配置范围内，GUI 与 TUI 可以连接同一个 Session。
非交互 shell 可以运行 Cocode TUI 吗？
TUI 需要真实交互终端。自动化任务应使用适合非交互执行的接口，而不是把 TUI 当作管道命令。
SSH 断开后任务一定能无损恢复吗？
不能作无条件保证。恢复结果取决于 Host、Session 和动作当时的状态，重连后应先检查运行中或待确认操作。