---
title: Conecte-se a uma sessão do Managed Agents a partir do seu terminal
url: https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/sessions-connect
description: Conecte a CLI ant a uma sessão do Claude Managed Agents para acompanhar sua transcrição ao vivo, enviar mensagens, permitir ou negar chamadas de ferramentas ou abrir o visualizador de sessões no seu navegador.
---

`ant beta:sessions connect` conecta seu terminal a uma [sessão](https://platform.claude.com/docs/pt-BR/managed-agents/sessions) existente do Claude Managed Agents. Ele carrega a transcrição da sessão e a acompanha ao vivo enquanto o agente trabalha. Você também pode intervir: enviar uma mensagem, interromper o agente ou permitir ou negar uma chamada de ferramenta que está aguardando aprovação. Com `--web`, ele abre a sessão no visualizador de sessões do Claude Console no seu navegador.

O comando requer a versão 1.32.0 ou posterior da CLI. Para instalar ou atualizar a CLI e se autenticar, consulte o [início rápido da CLI](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/quickstart).

## Conectar-se a uma sessão

Passe o ID de uma sessão no seu workspace. Você pode copiá-lo da resposta de criação, de `ant beta:sessions list` ou do Console.

```bash CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7
```

Sem `--web`, o comando precisa de um terminal interativo. Em scripts, use `ant beta:sessions:events stream` e `ant beta:sessions:events send` em vez disso. Consulte [Scripts e automação com a CLI](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/scripting).

Pressione Ctrl+C para desconectar. A sessão continua em execução, e conectar-se novamente carrega todo o seu histórico.

## Acompanhar e direcionar a sessão

A visualização do terminal mostra a conversa ao vivo: mensagens e chamadas de ferramentas, com a duração e o resultado de cada chamada. Uma barra de status mostra se a sessão está em execução, ociosa ou aguardando sua aprovação. Em sessões [multiagente](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration), a visualização acompanha a thread principal da sessão, que inclui as mensagens trocadas entre o agente que a sessão executa e os agentes aos quais ele delega tarefas.

| Tecla              | Ação                                                                                                                                                    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enter              | Envia sua entrada como um evento `user.message`. Alt+Enter ou Ctrl+J inicia uma nova linha.                                                             |
| Esc                | Interrompe o agente enquanto ele está em execução (`user.interrupt`).                                                                                   |
| Ctrl+O             | Mostra ou oculta detalhes: entradas e resultados de ferramentas, uso de tokens e eventos de status. `--verbose` (`-v`) inicia com os detalhes exibidos. |
| Page Up, Page Down | Rola pela transcrição. Rolar para cima pausa o acompanhamento; End o retoma.                                                                            |
| Ctrl+C             | Desconecta. Ctrl+D em uma linha de entrada vazia também desconecta.                                                                                     |

Quando uma chamada de ferramenta está aguardando sua aprovação, a linha de entrada muda para **Allow tool call?** Isso acontece sob uma política `always_ask`, ou sob `auto` quando o servidor não chega a uma determinação. Escolha **Yes**, **No** ou **No, and tell the agent why**. A CLI envia sua escolha como um evento [`user.tool_confirmation`](https://platform.claude.com/docs/pt-BR/managed-agents/permission-policies#respond-to-confirmation-requests), com qualquer motivo que você digitar como seu `deny_message`.

Se a sessão estiver `terminated` ou tiver sido excluída, a visualização é somente leitura.

## Abrir o visualizador de sessões no seu navegador

```bash CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web
```

`--web` serve o visualizador de sessões do Console a partir de um servidor local em `127.0.0.1`, imprime sua URL e a abre no seu navegador. Adicione `--no-browser` para não abrir o navegador. Você também pode enviar mensagens, interromper o agente e permitir ou negar uma chamada de ferramenta a partir do navegador. Diferentemente da visualização do terminal, o visualizador do navegador acompanha todas as threads de uma sessão multiagente.

A URL pode ser aberta uma única vez, em até dois minutos após ser impressa. Recarregar essa aba funciona, mas para abrir o visualizador em qualquer outro lugar, execute o comando novamente. Suas credenciais nunca saem da CLI: a página envia requisições apenas para o processo `ant` local, que faz as requisições à API. O servidor é executado até você pressionar Ctrl+C.