会话与工作流

Tactic Remote 使用 tmux 会话 保持 Claude Code 进程在断连后存活。本页说明会话的工作原理和日常工作流。

会话如何工作

每个会话对应：

• 一个 工作目录（你的项目文件夹）。
• Mac 上的一个 tmux 会话，运行 Claude Code。
• 显示在 iPhone 上的 终端输出流。

会话在以下情况下保持存活：

• iPhone App 关闭或进入后台。
• 网络临时断开。
• Mac 休眠后唤醒。

重连后，应用恢复会话及其终端输出。

创建会话

1. 点击会话选择器（App 左上角）。
2. 点击 New Session。
3. 浏览 Mac 文件系统并选择项目目录。
4. 为会话命名（如 my-api、frontend-work）。
5. 点击 Create。

可以为不同项目创建多个会话，随时切换。

启动 Claude Code

点击 Start 按钮在当前会话中启动 Claude Code。

应用有 防重复启动保护：如果 Claude Code 已在会话中运行，点击 Start 不会产生任何效果，防止意外双重启动。

启动前检查： 查看状态指示灯。绿色 "Running" 表示 Claude 已在运行——无需点击 Start。

发送提示

在聊天输入框中输入并发送。提示通过 WebSocket 传输到 Mac，Mac 将其传递给 Claude Code 进程。输出实时流式回传。

快捷操作

应用提供常用终端输入的快捷按钮：

• Enter —— 提交输入
• Escape —— 取消当前操作
• Tab —— 自动补全
• 方向键 —— 导航
• Ctrl+C —— 中断

重连

当应用失去连接（网络切换、进入后台等）：

1. 自动尝试以指数退避重连。
2. 重连后重新附加到已有的 tmux 会话。
3. 断连期间积累的终端输出被恢复。

你无需做任何操作——重新打开应用即可。

如果视图看起来过时： 打开会话选择器重新选择会话，强制刷新。

通知

对于长时间运行的任务，你不需要一直开着应用：

1. Claude Code 支持 hooks，在任务完成时触发。
2. 服务器将这些事件作为推送通知转发到 iPhone。
3. 收到通知后，打开应用查看结果。

请保持 iOS 对 Tactic Remote 的通知权限开启。

结束会话

• 停止 Claude： 点击 Stop 按钮终止 Claude Code 进程。会话保留，可稍后重新启动。
• 删除会话： 在会话选择器中滑动删除。这会移除 Mac 上的 tmux 会话。