Codex no Linux: a prévia do app desktop, a CLI e o que o Linux ainda não faz

Qual Codex usar no Linux

• O app desktop do ChatGPT, em versão prévia: uma janela com o Codex ao lado de Chat e Work. Essa é a interface gráfica (GUI) do Codex no Linux. O guia da OpenAI cobre o Linux de desktop; em um servidor sem desktop, use a CLI.
• A Codex CLI: roda em um terminal, em um desktop ou em um servidor headless que você acessa por SSH.
• A extensão de IDE, para VS Code, Cursor ou Windsurf, se você prefere ficar no seu editor.
• Codex cloud: as tarefas rodam nos servidores da OpenAI, então nada seu precisa ficar ligado. Veja Codex cloud mais abaixo.

Como instalar o app desktop do Codex no Linux

1. Confira a sua distribuição e a arquitetura

   A versão prévia suporta Ubuntu 24.04 LTS e 26.04 LTS, Debian 13, Fedora 43 e 44, e o Arch Linux atual e totalmente atualizado. Outras distribuições podem funcionar, mas não têm suporte formal. Há pacotes para x64 e ARM64: rode uname -m; x86_64 significa x64, e aarch64 ou arm64 significa ARM64.

   uname -m

2. Baixe e instale o pacote

   Baixe o pacote para a sua distribuição e arquitetura (veja o guia do app para Linux da OpenAI) e instale-o a partir da pasta em que você o salvou. No Arch, o script de instalação da OpenAI também faz uma atualização completa do sistema.

   # Ubuntu or Debian (ARM64: chatgpt_arm64.deb)
   sudo apt install ./chatgpt_amd64.deb
   
   # Fedora (ARM64: chatgpt.aarch64.rpm)
   sudo dnf install ./chatgpt.x86_64.rpm
   
   # Arch Linux: download install-arch.sh from
   # https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
   # then run it (it does a full system upgrade)
   sudo bash install-arch.sh

3. Abra o app e selecione Codex

   Abra o ChatGPT pelo menu de aplicativos, ou rode chatgpt em um terminal, faça login e selecione Codex. No Wayland, o app usa o XWayland quando ele está disponível; o Wayland nativo é experimental, e você pode forçá-lo com chatgpt --ozone-platform=wayland.

4. Mantenha-o atualizado

   As atualizações chegam pelo gerenciador de pacotes.

   # Ubuntu or Debian
   sudo apt update
   sudo apt install --only-upgrade chatgpt
   
   # Fedora
   sudo dnf upgrade --refresh chatgpt
   
   # Arch Linux
   sudo pacman -Syu

5. Mantenha os chats longos rodando

   Ative Settings > General > Prevent sleep while running, que existe no macOS e no Linux, para que os chats locais continuem enquanto você está longe do computador.

Fonte: documentação do Codex da OpenAI, app do ChatGPT para Linux

Como instalar a Codex CLI no Linux

1. Rode o script de instalação

   O mesmo comando instala e atualiza o Codex; codex update também aplica uma atualização quando a versão instalada suporta isso. Com o Node.js instalado, npm install -g @openai/codex também funciona. A OpenAI publica builds para Linux em x86_64 e aarch64.

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Instale o bubblewrap para o sandbox

   O sandbox do Codex no Linux precisa do bubblewrap. Sem um bwrap no PATH, o Codex recorre a um helper embutido que precisa de user namespaces sem privilégios, e mostra um aviso ao iniciar. No Ubuntu 25.04, o bubblewrap empacotado funciona como está; no Ubuntu 24.04, o aviso pode continuar até você carregar o perfil do AppArmor bwrap-userns-restrict (veja a documentação de sandboxing da OpenAI).

   # Ubuntu or Debian
   sudo apt install bubblewrap
   
   # Fedora
   sudo dnf install bubblewrap
   
   # Ubuntu 24.04, if Codex still warns: copy the bwrap-userns-restrict
   # profile to /etc/apparmor.d/, then load it
   sudo apt install apparmor-profiles apparmor-utils
   sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrict

3. Faça login

   Rode codex e escolha Sign in with ChatGPT para usar o seu plano, ou faça login com uma chave de API, cobrada pelas tarifas padrão da API. O Codex cloud exige o login com o ChatGPT. codex login status sai com o código 0 quando o login está feito.

4. Em um servidor headless, faça login com um código de dispositivo

   Sem navegador na máquina, escolha Sign in with Device Code ou rode codex login --device-auth, que está em beta. O login por código de dispositivo precisa ser ativado antes, nas configurações de segurança do ChatGPT ou pelo administrador do workspace. Há duas outras formas: copiar o ~/.codex/auth.json de um computador em que o login pelo navegador funcionou, tratando esse arquivo como uma senha, ou encaminhar o callback do login por SSH e rodar codex login no servidor.

   # On the server, with device code login turned on in ChatGPT
   codex login --device-auth
   
   # Or forward the sign-in callback from your own computer, then sign in on the server
   ssh -L 1455:localhost:1455 user@remote
   codex login

Fonte: documentação do Codex da OpenAI, Codex CLI

Ainda sem Computer Use no Linux

O Computer Use permite que o Codex opere apps desktop movendo o ponteiro e digitando. Ele não está na versão prévia do app desktop para Linux; o guia da OpenAI para Linux diz que uma versão futura vai adicioná-lo. Por enquanto, ele roda no app desktop no macOS e no Windows.

• O trabalho que acontece em um terminal continua rodando no Linux: o Codex roda comandos e edita arquivos ali, dentro do sandbox do bubblewrap.
• Para tarefas que precisam de apps desktop, use um Mac ou um PC com Windows. No Windows, o Computer Use assume a tela enquanto trabalha: veja Codex no Windows. Para um Mac sempre ligado, veja Codex em um Mac mini.

Use uma máquina Linux pelo app desktop em um Mac ou PC

A documentação de conexões remotas da OpenAI lista só computadores Mac e Windows como hosts que o app do ChatGPT no celular consegue controlar, então controlar o app desktop no Linux pelo celular não está documentado. Uma máquina Linux ainda pode ser um host SSH: o app desktop em um Mac ou PC com Windows abre projetos nela, e o Codex roda comandos, lê arquivos e grava alterações ali. Você então a conduz pelo celular por meio desse Mac ou PC.

1. Adicione a máquina Linux à sua configuração SSH

   No Mac ou PC que roda o app desktop, adicione um host ao ~/.ssh/config. O Codex lê desse arquivo os aliases de host concretos e ignora as entradas que são só padrões. Confira se ssh devbox funciona a partir desse computador. Trate isso como qualquer acesso SSH: chaves confiáveis, uma conta com o mínimo de privilégios e nada sem autenticação escutando em uma rede pública; para acessar uma máquina fora da sua rede, use uma VPN ou uma ferramenta de rede mesh.

   # ~/.ssh/config on the Mac or PC running the ChatGPT desktop app
   Host devbox
     HostName devbox.example.com
     User you
     IdentityFile ~/.ssh/id_ed25519

2. Instale o Codex na máquina Linux e faça login

   O app inicia o Codex na máquina remota via SSH, no login shell do usuário remoto, então codex precisa estar no PATH ali. Instale-o com o script acima e faça login, com codex login --device-auth em um servidor headless.

3. Adicione o host no app desktop

   Vá em Settings > Connections, adicione ou ative o host SSH e escolha uma pasta de projeto nele. Quando o mesmo repositório Git está salvo como projeto dos dois lados, você pode passar um chat entre o seu computador e o host Linux pelo rodapé do chat.

4. Controle-a pelo celular

   Pareie o celular com o Mac ou PC como descrito em remote control do Codex. O celular conversa com esse computador, que precisa ficar ligado, e o Codex faz o trabalho na máquina Linux. Para um servidor alugado, veja Codex em uma VPS.

Fonte: documentação do Codex da OpenAI, conexões remotas

Ou deixe o Codex cloud rodar a tarefa

Se você não quer manter nenhuma máquina ligada, o Codex cloud roda tarefas nos servidores da OpenAI. Cada tarefa ganha o próprio workspace e continua enquanto o computador está em repouso.

• Inicie uma tarefa pela web ou pelo app desktop com Work in > Cloud, ou pelo Codex no app do ChatGPT no celular. Em um terminal Linux, codex cloud abre um seletor de chats na nuvem, codex cloud exec envia uma tarefa e codex cloud list lista as recentes.
• Ele exige login no ChatGPT e não está disponível com uma chave de API. A tabela de planos da OpenAI o lista nos planos Plus, Pro, Business e Enterprise.
• Uma tarefa na nuvem só enxerga o ambiente na nuvem dela. Os arquivos locais da sua máquina, processos em execução, logins do navegador e acesso à VPN não são levados junto, e não dá para passar para ela um chat do seu computador.
• Para uma configuração reutilizável, crie um ambiente em Work in > Cloud > Select environment > Create environment, com acesso total à internet pública ou uma lista de permissões.

Dê ao Codex da sua máquina Linux um trabalho fixo

O app desktop, a CLI e o SSH esperam você iniciar a próxima tarefa. O Crewmark transforma um chat do Codex na sua máquina Linux em um funcionário de IA com cargo, metas, horário de trabalho e um heartbeat: durante o horário dele, a CLI crewmark, que roda no Linux e também no macOS e no Windows, o acorda para pegar a próxima issue de um quadro compartilhado. A máquina precisa ficar ligada, o que um servidor Linux já faz de qualquer forma.

1. Contrate um funcionário

   Escolha um cargo entre os cargos de funcionários de IA, como engenheiro de software, e escreva as metas e os KPIs dele.

2. Conecte um chat do Codex na máquina

   Vincule um chat do Codex no desktop ou servidor Linux ao funcionário pela CLI crewmark. Essa conversa vira o funcionário. O Claude Code também funciona.

3. Defina o horário de trabalho e um heartbeat

   Só em dias úteis ou todos os dias, no seu fuso horário, com um horário que pode passar da meia-noite. Durante esse horário, a CLI acorda o funcionário a cada 15, 30, 60, 120 ou 240 minutos. Veja como deixar o Codex proativo.

4. Atribua issues de qualquer navegador

   Crie e atribua issues no quadro em crewmark.ai; atribuir uma acorda o funcionário. Quando precisa de uma revisão ou de uma decisão, ele marca a issue como Needs action e pergunta a você ali mesmo. Trabalhos para dar a ele estão em casos de uso do Codex.

Perguntas frequentes