For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Colaboração e compartilhamento

Conexões remotas

Use o Codex no celular para acessar tarefas em um computador conectado ou conecte o aplicativo do ChatGPT para desktop a projetos via SSH

As conexões remotas permitem acessar tarefas em execução em outro dispositivo ou computador. No aplicativo do ChatGPT para iOS, abra Codex para trabalhar com chats do ChatGPT ou do Codex em um Mac ou PC com Windows conectado. Se o aplicativo no celular ainda mostrar Remoto, abra essa opção. Você também pode continuar o trabalho em outro dispositivo compatível que esteja executando o aplicativo do ChatGPT para desktop ou conectar o aplicativo a projetos em um host SSH.

O acesso remoto usa os projetos, chats, arquivos, credenciais, permissões, plug-ins, o recurso Uso do computador, as configurações do navegador e as ferramentas locais do host conectado.

Acesso ao computador local com o Work Cloud e conexões remotas

Para continuar uma conversa do modo Work no desktop, no celular ou na Web, siga as instruções em Continuar uma conversa do modo Work em outro dispositivo. O Work Cloud pode usar recursos locais aprovados por meio de um computador conectado. As instruções abaixo mostram como usar o Codex para se conectar a um computador que funciona como host ou abrir um projeto em um host SSH.

O que você pode fazer remotamente

  • Iniciar chats em projetos no host ou continuar chats existentes.
  • Enviar novas instruções, responder a perguntas e orientar o trabalho em andamento.
  • Aprovar comandos e outras ações.
  • Revisar os resultados gerados, as diferenças no código, os resultados dos testes, a saída do terminal e as capturas de tela.
  • Receber notificações quando o ChatGPT concluir uma tarefa ou precisar da sua atenção.
  • Alternar entre hosts conectados e entre chats.

As próximas seções explicam como usar o aplicativo do ChatGPT no celular para acessar um computador que funciona como host. Para conectar o Codex a um projeto em um host SSH, consulte Conectar a um host SSH.

Antes de configurar o acesso pelo celular

O acesso remoto é compatível com hosts que executam o aplicativo do ChatGPT para desktop no macOS ou no Windows. Você pode controlar um host pelo ChatGPT no iOS ou Android, ou por outro Mac ou PC com Windows quando a opção Controlar outros dispositivos estiver disponível. A disponibilidade pode variar conforme a liberação do recurso.

Confira se você tem:

  • Acesso ao Codex na conta e no espaço de trabalho do ChatGPT que pretende usar.
  • A versão mais recente do aplicativo do ChatGPT em um dispositivo iOS ou Android. Se você não encontrar Codex no iOS ou Remoto em um aplicativo que ainda usa esse nome, atualize o ChatGPT primeiro.
  • A versão mais recente do aplicativo do ChatGPT para macOS ou Windows em execução em um host online e fora do modo de repouso, com sessão iniciada na mesma conta e no mesmo espaço de trabalho. A configuração do acesso pelo celular começa no aplicativo. Não é possível configurá-lo pela CLI do Codex nem pela extensão para IDE.
  • Autenticação multifator, SSO ou chave de acesso configurados conforme as exigências da conta ou do espaço de trabalho.

Se você usa o Codex em um espaço de trabalho do ChatGPT, talvez o administrador precise habilitar o acesso ao Controle remoto para que você possa se conectar pelo celular.

Configurar o acesso pelo celular

Comece no aplicativo do ChatGPT para desktop no host ao qual você quer se conectar. Durante a configuração, o aplicativo habilita o acesso remoto ao host e exibe um código QR para você escanear com o celular. O código QR emparelha esse celular com esse host. Emparelhe cada celular ou dispositivo compatível que use o aplicativo para desktop com cada host que você quer controlar a partir dele.

As conexões existentes usadas desde 8 de junho de 2026 continuam emparelhadas. Se você não usou uma conexão existente desde 8 de junho de 2026, atualize os dois aplicativos e emparelhe os dispositivos novamente.

  1. Inicie a configuração no computador.

    Abra o aplicativo do ChatGPT para desktop no host. Acesse Configurações > Conexões > Controlar este Mac ou PC e selecione Configurar ou Adicionar. Aprove o acesso remoto e conclua as verificações solicitadas.

  2. Escaneie o código QR.

    Use o celular para escanear o código QR exibido pelo aplicativo. O código abre o ChatGPT para que você conclua a conexão do aplicativo no celular com o host.

  3. Conclua a configuração no ChatGPT.

    O ChatGPT abre a tela de configuração da conexão. Confirme que você está usando a mesma conta e o mesmo espaço de trabalho do ChatGPT e conclua as etapas exigidas de autenticação multifator, SSO ou chave de acesso. Após a configuração, o host aparece em Codex no iOS ou em Remoto se o aplicativo no celular ainda usar esse nome.

  4. Confira as configurações do host.

    No aplicativo do host, acesse Configurações > Conexões para gerenciar os dispositivos conectados. Você também pode escolher se quer manter o computador fora do modo de repouso, ativar o Uso do computador ou instalar a Extensão do Chrome.

Escolher o que conectar

Comece pelo notebook ou computador de mesa em que você já usa o ChatGPT. Adicione um computador que fique sempre ligado ou um host SSH quando precisar de acesso contínuo ou de outro ambiente.

Seu notebook ou computador de mesa

Conecte o Mac ou PC com Windows em que o aplicativo para desktop já está instalado. Assim, você tem acesso remoto aos mesmos projetos, chats, credenciais, plug-ins e configurações locais que já usa.

Se o computador entrar em repouso, perder a conexão com a rede ou se o aplicativo for fechado, o acesso remoto será interrompido até que o computador volte a estar disponível com o aplicativo em execução. Se você usa esse computador como host, mantenha-o ligado à tomada e, se a opção estiver disponível nas configurações de conexão do host, ative-a para impedir que ele entre em repouso.

Em um notebook Mac, o acesso remoto pode continuar disponível com a tampa aberta e o computador ligado à tomada. Para usá-lo com a tampa fechada, conecte também um monitor externo. Selecionar Repouso ainda interrompe o acesso remoto.

Em um host com Windows, mantenha a sessão desbloqueada e disponível para tarefas que dependem do recurso Uso do computador. No Windows, o Uso do computador funciona em primeiro plano. Por isso, o controle remoto é mais indicado para iniciar ou acompanhar o trabalho enquanto você deixa a área de trabalho do host dedicada à tarefa.

Um computador dedicado que fica sempre ligado

Use um Mac ou PC com Windows dedicado que fique sempre ligado quando quiser que o ChatGPT continue acessível durante tarefas mais longas.

Configure nesse computador os projetos, as credenciais, os servidores MCP, as Habilidades e as ferramentas que o ChatGPT ou o Codex deve usar.

Um ambiente de desenvolvimento remoto

Use um host SSH ou um ambiente de desenvolvimento remoto gerenciado quando o projeto já estiver em um ambiente remoto. Primeiro, conecte o host que executa o aplicativo para desktop a esse ambiente. O celular continua se conectando ao mesmo host, e o ChatGPT trabalha no ambiente remoto usando as dependências, as políticas de segurança e os recursos computacionais desse ambiente.

Para saber como configurar o SSH, consulte Conectar a um host SSH.

Para executar tarefas no navegador ou na área de trabalho de um computador que fica sempre ligado ou de um host remoto, ative o Uso do computador e instale a Extensão do Chrome nesse host.

O que o host conectado fornece

O celular envia prompts, aprovações e mensagens de acompanhamento ao ChatGPT. O host conectado fornece o ambiente que o ChatGPT usa.

Na prática:

  • Os arquivos do repositório e os documentos locais vêm do host conectado.
  • Os comandos do shell são executados nesse host ou no ambiente remoto.
  • A configuração do host determina os servidores MCP, as Habilidades, o acesso ao navegador e o Uso do computador disponíveis.
  • Os sites e aplicativos para desktop nos quais você já iniciou sessão só ficam disponíveis se o host tiver acesso a eles.
  • As configurações do ambiente isolado, os controles de segurança e as aprovações de ações continuam valendo para a sessão conectada.

Uma camada segura de retransmissão permite que seus dispositivos autorizados no ChatGPT acessem os computadores confiáveis sem expor esses computadores diretamente à internet pública.

Retomar o trabalho em outro dispositivo

Você pode continuar o trabalho em outro dispositivo compatível com o controle remoto, desde que tenha iniciado sessão no aplicativo do ChatGPT para desktop nesse dispositivo. Por exemplo, se o notebook estiver indisponível, você pode usar o celular para iniciar um chat em um host que fica sempre ligado. Depois, basta abrir o aplicativo no notebook e continuar o mesmo chat.

Em um Mac ou PC com Windows em que o recurso esteja disponível, acesse Configurações > Conexões > Controlar outros dispositivos para adicionar o outro host. Um dispositivo pode permitir o acesso remoto e controlar outro dispositivo ao mesmo tempo.

Conectar a um host SSH

No aplicativo do ChatGPT para desktop, adicione projetos remotos de um host SSH para trabalhar em chats que usam o sistema de arquivos e o shell remotos. Os chats de projetos remotos executam comandos, leem arquivos e gravam alterações no host remoto.

Configure o host remoto seguindo os mesmos critérios de segurança que você usa no acesso SSH habitual: use chaves confiáveis, conceda às contas apenas os privilégios necessários e não deixe serviços públicos aceitando conexões sem autenticação.

  1. Adicione o host à configuração do SSH para que o Codex possa identificá-lo automaticamente.

    Host devbox
      HostName devbox.example.com
      User you
      IdentityFile ~/.ssh/id_ed25519

    O Codex lê os aliases de hosts específicos em ~/.ssh/config, usa o OpenSSH para resolvê-los e ignora as entradas de host definidas apenas por padrões.

  2. Confirme que você consegue se conectar ao host via SSH a partir do computador que executa o aplicativo.

    ssh devbox
  3. Instale e autentique o Codex no host remoto.

    O aplicativo inicia o App Server do Codex no host remoto via SSH, usando o shell de login do usuário remoto. Verifique se, nesse shell, o comando codex está disponível no PATH do host remoto.

  4. No aplicativo, abra Configurações > Conexões, adicione ou habilite o host SSH e selecione uma pasta de projeto remoto.

Transferir um chat entre hosts

A transferência move um chat existente e o estado do Git associado a ele entre o computador local e um host remoto conectado. Use esse recurso para começar o trabalho localmente, continuar em uma árvore de trabalho em um computador remoto e trazer o chat de volta mais tarde.

Antes de transferir um chat, conecte o host de destino e salve nele um projeto do mesmo repositório Git. Se o projeto estiver em um subdiretório do repositório, salve o mesmo subdiretório nos dois hosts. O Codex só exibe destinos que tenham um projeto correspondente salvo.

Para transferir um chat:

  1. Abra o chat no aplicativo para desktop.
  2. No rodapé do chat, selecione o local de execução atual e depois o host de destino. Selecione Este computador para trazer um chat remoto de volta ao computador local.
  3. Confira o destino e a branch e selecione Transferir.

O Codex cria ou reutiliza uma árvore de trabalho no host de destino, transfere o chat e o estado do Git e passa a executar o chat nesse host. Se o chat estiver em execução, o Codex interrompe a resposta atual antes de transferi-lo.

Você também pode pedir ao Codex em outro chat que transfira um chat específico para um host conectado, informando o nome do chat. O Codex não pode transferir o próprio chat em que você faz o pedido. O Codex também não oferece suporte à transferência para um ambiente de nuvem do Codex.

Autenticação e exposição à rede

As conexões remotas usam SSH para iniciar e gerenciar o App Server do Codex no host remoto. Não exponha os transportes do App Server diretamente em uma rede compartilhada ou pública.

Se precisar acessar um computador remoto fora da sua rede atual, use uma VPN ou uma ferramenta de rede em malha em vez de expor o App Server diretamente à internet.

Solução de problemas

O host não aparece no celular

Confirme que o aplicativo para desktop está em execução no host, que você ativou Permitir que outros dispositivos se conectem e que os dois dispositivos usam a mesma conta e o mesmo espaço de trabalho do ChatGPT. Se você não usou a conexão desde 8 de junho de 2026, atualize os dois aplicativos e emparelhe os dispositivos novamente.

O Controle remoto está desativado após um novo login

Sair da conta do ChatGPT desativa o Controle remoto, mas mantém os emparelhamentos existentes entre dispositivos. Depois de entrar novamente, ative o Controle remoto para restaurar o estado anterior da conexão.

Se aparecer um erro depois que você ativar o Controle remoto e selecionar Adicionar, reinicie o aplicativo do ChatGPT para desktop no host e tente novamente.

A solicitação de aprovação não aparece

No aplicativo do ChatGPT para iOS, abra Codex. Se o aplicativo no celular ainda mostrar Remoto, abra essa opção. Confirme que o celular e o host usam a mesma conta e o mesmo espaço de trabalho do ChatGPT. Em seguida, escaneie o código QR novamente ou reinicie a configuração pelo host. Se você usa um espaço de trabalho do ChatGPT, peça ao administrador que confirme se o acesso ao Controle remoto está habilitado.

A sessão remota perde a conexão

Verifique se o host entrou em repouso, se perdeu o acesso à rede ou se o aplicativo foi fechado. Mantenha o host conectado e fora do modo de repouso enquanto o ChatGPT trabalha.

A autenticação impede a configuração

Siga as instruções de autenticação da conta ou do espaço de trabalho exibidas durante a configuração. Se a organização exigir SSO, autenticação multifator ou uma chave de acesso, conclua essas etapas antes de tentar novamente. Se a configuração continuar falhando, peça ao administrador do espaço de trabalho que confirme se o acesso ao Controle remoto está habilitado.

Veja também