
# Agentes de programação

Termbridge pode preparar agentes de programação em sandboxes Daytona, instalando suas CLIs e sincronizando a autenticação que você já usa. Assim, o sandbox fica pronto para uso, sem precisar fazer login novamente.

## Agentes compatíveis

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

## Configuração automática (recomendada)

Ative a configuração automática selecionando os agentes explicitamente:

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

Ou ative todos os agentes conhecidos:

```bash
export TERMBRIDGE_SANDBOX_AGENT_AUTO=true
```

Quando a configuração automática estiver ativada, Termbridge:

- Instalará as CLIs dos agentes no sandbox (via `npm install -g`).
- Sincronizará arquivos de autenticação locais com o sandbox.
- Encaminhará as chaves API compatíveis para a sessão tmux.

Os arquivos locais de autenticação são encontrados nestes locais padrão:

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

## Sincronização manual de autenticação

Se preferir controlar o processo manualmente, especifique diretamente os caminhos de autenticação:

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

Precisa definir destinos personalizados no sandbox? Use mapeamentos explícitos:

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

## Chaves API e variáveis de ambiente extras

Termbridge encaminha automaticamente chaves API comuns dos agentes. Adicione outros nomes de variáveis de ambiente com:

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

## Controlar a instalação

Para ignorar a instalação das CLIs no sandbox, defina:

```bash
export TERMBRIDGE_SANDBOX_AGENT_INSTALL=false
```

Para substituir completamente os pacotes de instalação:

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

> **Observação**
> A sincronização de autenticação copia as credenciais locais para o sandbox. Use-a somente com sandboxes confiáveis e prefira sandboxes efêmeros com `TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true`.


## Documentação relacionada

- [Sandboxes](https://termbridge.inline0.dev/pt/docs/sandboxes)
- [CLI](https://termbridge.inline0.dev/pt/docs/cli)
