Controle remoto do Codex não funciona no Mac? Todos os erros (2026)

Quando o controle remoto do Codex não funciona no Mac, quase sempre é um de três erros. A causa costuma estar nos servidores da OpenAI ou na rede. Por isso a solução é curta: reinicie o app, confira a conta e a rede e tente de novo.

Abaixo estão cada erro, o que se sabe e o que tentar. Quando uma dica vem de usuários no GitHub e não da OpenAI, avisamos.

Primeiro, a lista oficial

Para controlar um Mac pelo app do ChatGPT no celular, a OpenAI pede o seguinte:

• O app de desktop do ChatGPT está aberto no Mac. A configuração começa por ele. Não dá para iniciar pela CLI do Codex nem pela extensão do IDE.
• O Mac e o celular usam a mesma conta e o mesmo espaço de trabalho do ChatGPT.
• Sua conta tem acesso ao Codex nesse espaço de trabalho. Em um espaço de empresa ou equipe, o administrador pode precisar ativar o controle remoto.
• Os dois apps estão atualizados. Pareamentos sem uso desde 8 de junho de 2026 precisam ser refeitos.
• O Mac está acordado, online e com a sessão aberta. Ative Keep this Mac awake em Ajustes > Conexões. Com a tampa fechada, o MacBook também precisa de energia e de uma tela externa.
• Sair da conta desliga o controle remoto. Ligue de novo depois de entrar.

Para qualquer erro depois de tocar em Adicionar, a OpenAI recomenda reiniciar o app de desktop do ChatGPT no Mac e tentar de novo. Feche o app por completo com Cmd+Q antes.

"Pairing code unavailable: Remote control failed to connect"

Você abre Ajustes > Conexões > Controlar este Mac ou PC, escolhe Adicionar e o código QR nunca aparece. No lugar dele surge este erro.

Os logs compartilhados na issue do GitHub #44326 mostram erros HTTP 503 vindos do servidor de controle remoto da OpenAI. O mesmo usuário também viu "Please ensure only one instance of ChatGPT is running" e diz que essa mensagem engana. Reinstalar, sair da conta, reiniciar o Mac e limpar ~/.codex não resolveram.

O que tentar

• Feche com Cmd+Q, abra o app de novo e tente outra vez.
• Espere um pouco e tente de novo. Um 503 vem do servidor, então seu Mac pode estar bem.
• Teste outra rede. Um usuário conseguiu parear pelo roteador do iPhone e não pelo roteador de casa. É um relato de usuário, não uma solução oficial.
• Desligue a VPN ou o proxy por um momento e tente de novo.

Até o momento, a issue continua aberta e sem resposta da OpenAI. Acompanhe #44326 para novidades.

"Unable to enable Remote Control. Please try again."

Este erro aparece quando você tenta ativar Controlar este Mac. A configuração para antes do código QR.

Na issue do GitHub #38095, o log do app dizia ignoring invalid experimental feature enablement keys: apps_mcp_path_override. O autor não achou essa chave nos próprios arquivos de configuração, então ela pode vir de dentro do app. Outro usuário viu "Couldn't enable remote control. Try again." e suspeita de um problema de assinatura no app. A OpenAI não confirmou nenhuma das duas causas.

Uma issue parecida, #36946, mostra o mesmo padrão, às vezes com "Please ensure only one instance of ChatGPT is running". Várias pessoas ali usam proxy.

O que tentar

• Feche com Cmd+Q, instale a versão mais nova do app e tente de novo.
• Confira se só uma cópia do app está aberta.
• Dica da comunidade para quem usa proxy: um usuário da #36946 adicionou as linhas abaixo em ~/.codex/config.toml e abriu o Codex de novo. A OpenAI não confirmou essa solução.

No mesmo tópico, alguém conta que depois funcionou sem mudar nada. Vale tentar de novo após uma atualização.

"Couldn't update remote control availability"

Aqui a opção Controlar este Mac ou PC fica cinza e aparece um erro vermelho. Não dá para adicionar o Mac.

A issue do GitHub #48455 relata o erro no macOS Tahoe 26.6.2. O autor fechou a issue no mesmo dia sem dizer o que resolveu. Em #36946 e #44326 surgiram mensagens parecidas, como "Unable to update remote control status".

O que tentar

• Reinicie o app. Depois saia da conta, entre de novo e ligue o controle remoto outra vez.
• Confira se você está no espaço de trabalho certo. Em uma conta de empresa, pergunte ao administrador se o controle remoto está ativado.
• Atualize o app e pareie de novo.

Se for relatar à OpenAI, a issue mostra onde ficam os logs: ~/Library/Logs/com.openai.codex organizados por data, e os arquivos de sessão em ~/.codex/sessions.

Seu celular trava em "Waiting for desktop"?

Esse é outro erro, do lado do celular. Veja nosso guia Codex travado em Waiting for desktop. Se o pareamento funciona mas as aprovações não chegam, leia Codex travado em Awaiting approval.

Outro jeito de usar o Codex no iPhone

Se o pareamento falha sem parar, dá para pular essa etapa. O Macky é um app separado que conecta seu iPhone ao terminal do Mac. Ele não conserta o app do ChatGPT. Ele segue por outro caminho.

• Modo Codex: use a CLI do Codex que já está no seu Mac.
• Barra de teclas: aprove com y e Enter. Ctrl+C para uma tarefa.
• Sem pareamento da OpenAI: a conexão é criptografada de ponta a ponta e vai direto entre seus aparelhos.
• Tela inteira: mude para a área de trabalho do Mac quando precisar.
• Pro: use o MacBook com a tampa fechada e mantenha as sessões conectadas em segundo plano.

O Macky é grátis com sessões de 5 minutos. O Pro custa US$ 29 em pagamento único. Baixe na App Store.

O passo a passo completo está no nosso guia do Codex no celular.