# 编程代理

Termbridge 可以在 Daytona 沙盒中准备编程代理，方法是安装其 CLI 并同步你现有的身份验证信息。这样无需重新登录，沙盒即可随时使用。

## 支持的代理

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

## 自动设置（推荐）

选择代理以启用自动设置：

```bash
export TERMBRIDGE_SANDBOX_AGENTS=claude-code,codex,opencode
```

也可以启用所有已知代理：

```bash
export TERMBRIDGE_SANDBOX_AGENT_AUTO=true
```

启用自动设置后，Termbridge 将会：

- 在沙盒中安装代理 CLI（通过 `npm install -g`）。
- 将本地身份验证文件同步到沙盒中。
- 将受支持的 API 密钥转发到 tmux 会话中。

本地身份验证文件的默认发现位置如下：

- `~/.claude/.credentials.json`
- `~/.codex/auth.json`
- `~/.config/opencode/opencode.json`

## 手动同步身份验证信息

如果你希望手动控制，可以直接指定身份验证路径：

```bash
export TERMBRIDGE_SANDBOX_AGENT_AUTH_PATHS=~/.claude/.credentials.json,~/.codex/auth.json,~/.config/opencode/opencode.json
```

需要自定义沙盒内的目标路径？请使用显式映射：

```bash
export TERMBRIDGE_SANDBOX_AGENT_AUTH_MAPS=~/.claude/.credentials.json=/home/daytona/.claude/.credentials.json
```

## API 密钥和额外环境变量

Termbridge 会自动转发常见代理的 API 密钥。你可以通过以下方式添加其他环境变量名称：

```bash
export TERMBRIDGE_SANDBOX_AGENT_ENV=CUSTOM_TOKEN,ANOTHER_SECRET
```

## 控制安装

如果要跳过在沙盒中安装 CLI，请设置：

```bash
export TERMBRIDGE_SANDBOX_AGENT_INSTALL=false
```

要完全覆盖安装包列表：

```bash
export TERMBRIDGE_SANDBOX_AGENT_PACKAGES=claude-code,codex,opencode
```

> **注意**
> 身份验证同步会将本地凭据复制到沙盒中。请仅对可信任的沙盒使用此功能，并优先选择使用 `TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true` 的临时沙盒。


## 相关文档

- [沙盒](https://termbridge.inline0.dev/zh/docs/sandboxes)
- [CLI](https://termbridge.inline0.dev/zh/docs/cli)