Apresentação de OpenAI Codex
Codex CLI é o agente de programação da OpenAI que roda em um terminal. Ele lê o repositório em que você o inicia, propõe alterações, executa comandos e testes, e pede sua confirmação conforme o modo de aprovação escolhido. O projeto é open source e está publicado no GitHub.
Instalá-lo em um VPS, em vez de no seu computador, tem uma vantagem concreta: o agente roda em uma máquina sempre ligada, com conexão de rede estável, e você o controla de qualquer computador via SSH. Tarefas longas (refatoração, migração, correção de testes) deixam de ocupar o seu notebook.
Na entrega, o servidor contém um usuário de sistema codex com shell bash e direitos de sudo sem senha, além de git, curl e ca-certificates. O Codex CLI é instalado para esse usuário com o script de instalação oficial, sem Node.js. As chaves SSH autorizadas para root são copiadas para codex, então você pode se conectar diretamente com ele. A autenticação não é feita por você: ela é interativa e começa depois que você se conecta.
O que pode fazer com OpenAI Codex
Agente de código no terminal
O Codex lê o seu repositório, propõe alterações em arquivos e executa comandos no diretório atual. Você mantém o controle graças às confirmações pedidas antes das ações sensíveis.
Instalação oficial sem Node.js
O script de instalação publicado nas releases do GitHub da OpenAI é executado para o usuário codex. Não há runtime Node.js para instalar nem manter.
Usuário dedicado e acesso SSH direto
Uma conta codex é criada, com a senha bloqueada. Suas chaves SSH de root são copiadas para ela, para uma conexão por chave imediata.
Autenticação por código de dispositivo
O comando codex login --device-auth exibe um código para digitar no seu navegador. Prático em um servidor sem interface gráfica.
Git e ferramentas básicas incluídos
git, curl e ca-certificates estão instalados. Você pode clonar seus repositórios e pôr o agente para trabalhar neles desde a primeira conexão.
Começar com OpenAI Codex
Da encomenda à produção em poucos minutos.
- 1
Encomende o VPS com o Codex marcado
Escolha um VPS Linux em Paris ou Frankfurt (Debian 12, Debian 13, Ubuntu 20.04, 22.04 ou 24.04). Na aba "Applications" do formulário de pedido, marque OpenAI Codex e adicione sua chave SSH, se o formulário oferecer essa opção.
- 2
Conecte-se por SSH com o usuário codex
Com o servidor entregue, abra uma sessão SSH com a conta codex. Ela herda as chaves autorizadas de root: se você não informou uma chave no pedido, conecte-se primeiro com o acesso fornecido e adicione a chave em /home/codex/.ssh/authorized_keys.
Bashssh codex@SERVER_IP - 3
Autentique o Codex e inicie-o em um repositório
Inicie o login por código de dispositivo, abra no navegador o endereço exibido e digite o código. Depois, entre em um repositório git e inicie o agente.
Bashcodex login --device-auth git clone https://github.com/YOUR_ORG/YOUR_REPO.git && cd YOUR_REPO codex - 4
Proteja o servidor antes do uso regular
Deixe o acesso SSH somente por chave e limite o firewall à porta 22. Considere também substituir o sudo sem senha da conta codex se mais de uma pessoa tiver acesso ao servidor.
Bashsudo apt install -y ufw sudo ufw allow 22/tcp sudo ufw enable sudo sed -i 's/^#\?PasswordAuthentication.*/PasswordAuthentication no/' /etc/ssh/sshd_config sudo systemctl reload ssh
Casos de uso de OpenAI Codex
Agente de código sempre disponível
Inicie uma refatoração longa ou uma atualização de dependências, desconecte-se e retome a sessão mais tarde a partir de outro computador.
Ambiente isolado para repositórios sensíveis
Mantenha o código e as chaves de deploy em um servidor dedicado ao agente, e não na sua máquina pessoal, com uma conta de sistema separada.
Automação de tarefas de manutenção
Peça correções, testes ou scripts de migração em um clone do repositório e revise o diff antes de fazer o push.
Estação de trabalho remota para a equipe
Uma equipe pequena se conecta ao mesmo servidor para delegar tarefas repetitivas ao Codex, cada pessoa com a sua própria chave SSH.
Perguntas frequentes sobre OpenAI Codex
Não. A receita usa o script de instalação oficial do projeto, que não exige Node.js. Você já recebe o comando codex para o usuário de mesmo nome.
Mais sobre OpenAI Codex
Autenticação
O Codex aceita login com uma conta ChatGPT ou com uma chave de API da OpenAI. A receita não faz nenhum login: cabe a você executar codex login --device-auth como usuário codex. O fluxo por código de dispositivo evita abrir um navegador no servidor, pois você valida a partir do seu computador.
Manter a sessão ativa
Uma sessão SSH interrompida corta o agente no meio da tarefa. Instale um multiplexador de terminal, por exemplo sudo apt install -y tmux, execute tmux e, dentro dele, codex. Você poderá se desconectar da sessão e retomá-la com tmux attach.
Permissões e segurança
A conta codex tem sudo sem senha, o que é prático para instalar dependências, mas dá acesso total à máquina a quem tiver a chave SSH dela. Proteja essa chave e reserve o servidor para repositórios cujos comandos você aceita que o agente execute. Mantenha um modo de aprovação prudente enquanto não confiar no fluxo de trabalho.
Atualizações
O Codex CLI evolui rápido. Para obter a versão mais recente, execute novamente, como usuário codex, o script de instalação oficial usado na entrega: curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | sh. Leia as notas de versão do projeto antes de atualizar um servidor usado em produção.
Ir mais longe
Para uma máquina mais potente ou vários agentes em paralelo, compare as ofertas de VPS Linux. Há guias passo a passo na seção de tutoriais.
