# AI 编码工具

Termbridge 非常适合监控 AI 编码助手。在终端中启动代理，然后离开办公桌时也能通过手机查看它的工作进度。

## 为什么将 Termbridge 与 AI 工具搭配使用？

- **远程监控**：在沙发上也能查看 Claude Code 或 Codex 的工作进度
- **随时掌握情况**：查看代理何时需要输入或遇到错误
- **快速干预**：通过手机发送命令或取消进程
- **无需 VPN**：随时随地安全访问

## 支持的工具

Termbridge 会流式传输 tmux 会话中的所有内容，因此无需了解具体工具。本页示例使用：

- **Claude Code** (`claude`)
- **Codex** (`codex`)
- **OpenCode** (`opencode`)

这三种代理也是沙盒模式可以安装并自动登录的代理。其他基于终端的代理也以相同方式运行，但未经测试。

## 本地工作流程

### 通过手机查看 Claude Code

```bash
# Start Termbridge with a named session
termbridge --session claude

# In the terminal (via UI or locally), start Claude
claude
```

扫描 QR 代码，即可随时随地查看 Claude 的工作进度。

### 先启动代理

如果你想先启动代理，再启动 Termbridge：

```bash
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"

# Then attach Termbridge to it
termbridge --session claude
```

### Codex 工作流程

```bash
tmux new-session -d -s codex
tmux send-keys -t codex "codex" Enter
termbridge --session codex
```

## 沙盒工作流程

若要使用隔离环境，请在 Daytona 沙盒中运行代理。Termbridge 可以自动安装代理 CLI 并同步你的身份验证信息。

### 快速设置

```bash
export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_SANDBOX_AGENTS=claude-code,codex

termbridge
```

此操作将：

1. 创建 Daytona 沙盒
2. 安装代理 CLI
3. 同步你的本地身份验证文件，让代理可以立即使用

完整详情请参阅 [编码代理指南](https://termbridge.inline0.dev/zh/docs/sandboxes/coding-agents)。

## 提示

### 命名会话

使用有意义的会话名称，方便了解正在运行的任务：

```bash
termbridge --session claude-refactor
termbridge --session codex-tests
```

### 多个代理

在不同终端中运行不同的代理：

```bash
TERMBRIDGE_SESSIONS=2 termbridge
```

在一个终端中启动 Claude，在另一个终端中启动 Codex，然后在它们之间切换。

### 长时间运行的任务

AI 代理可能会运行很长时间。Termbridge 能很好地处理这种情况：

- 即使关闭浏览器，你的会话也会继续运行
- 随时刷新页面即可重新连接
- 即使 Termbridge 重启，tmux 也会让代理继续运行

### 干预

需要停止或引导代理改变方向？

1. 使用 `Ctrl+C` 按钮中断任务
2. 在输入框中输入新指令
3. 代理会像在本地终端中一样接收你的输入

## 沙盒与本地模式对比

| 功能 | 本地（tmux）| 沙盒（Daytona）|
|---------|--------------|-------------------|
| 设置 | 只需 tmux | Daytona 账户 + API 密钥 |
| 环境 | 你的计算机 | 隔离容器 |
| 持续运行 | 重启后继续运行 | 直接模式下，笔记本电脑休眠时仍会继续运行 |
| 身份验证 | 已配置 | 由 Termbridge 自动同步 |
| 适用场景 | 快速监控 | 隔离实验 |

对大多数用户来说，本地模式更简单。需要以下功能时，请使用沙盒模式：

- 干净、可随时丢弃的环境
- 代理工作时不占用你的笔记本电脑
- 运行实验而不影响本地设置