Instale o Codex do zero, domine o terminal e use a interface gráfica do App para Windows.
Node.js, Git e ambiente
npm install, verificação
Device auth, tokens
Comandos, flags, navegação
Codex App para Windows
Containers, config global
Antes do Codex você precisa de Node.js v18 ou superior (que inclui npm) e Git. Versões antigas do Node causam erros silenciosos durante a instalação do Codex.
O npm é o gerenciador de pacotes que instala o Codex globalmente. Sem Node.js v18+, mesmo o comando de instalação falha com mensagens confusas.
# Instalar Git winget install --id Git.Git -e --source winget # Instalar Node.js (baixe de nodejs.org → LTS) # Verificar depois: node -v # deve ser v18+ npm -v # deve ser 9+
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs git node -v && npm -v
brew install node git node -v && npm -v
O Codex CLI é distribuído como pacote npm: @openai/codex. A flag -g instala globalmente — disponível em qualquer diretório.
Instalação global vs local faz diferença: global permite chamar codex de qualquer pasta. Local só funciona dentro do projeto com npx.
npm install -g @openai/codex # Verificar instalação: codex --version
npm update -g @openai/codex
# Se erro EACCES, configure npm prefix: mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc
O login usa device auth: o terminal exibe um código + link. Você abre o link no browser, digita o código e está autenticado. Sem expor API keys no terminal.
Device auth é seguro mesmo em ambientes compartilhados. O código expira em 15 minutos — abra o link imediatamente.
codex login --device-auth # Saída esperada: # Abra: https://auth.openai.com/codex/device # Código: XXXX-XXXX (expira em 15 min) # ⚠️ NUNCA compartilhe este código # ✓ Successfully logged in
export OPENAI_API_KEY="sk-..." codex auth login
Após instalar e fazer login, o Codex funciona no terminal com dois modos: interativo (codex) e direto (codex "prompt").
Modo interativo é ideal para tarefas longas e iterativas. Modo direto é ótimo para scripts e automações em CI/CD.
codex # modo interativo codex "crie testes" # prompt direto codex chat # modo conversa codex --full-auto "..." # sem confirmação codex --model gpt-5 "..." # modelo específico codex generate --prompt "..."|# gerar código
/plan mode— planejar antes/model— trocar modelo/reasoning— ajustar raciocínio/browser use— ativar browser@arquivo.ts— referenciar arquivo$skill-name— invocar skillO Codex App para Windows é a interface gráfica completa: skills com UI, plugins externos, previews inline, múltiplas threads paralelas, aba de Automations e browser integrado.
A interface gráfica é superior ao CLI para tarefas que envolvem várias threads simultâneas, automações agendadas e uso de browser para computer use.
Interface visual para criar e gerenciar skills, sem editar arquivos manualmente
Conectar APIs externas, bancos de dados e serviços via MCP
Várias conversas/tarefas simultâneas com alternância fácil
Aba dedicada para agendar rotinas recorrentes
Computer use: Codex navega e interage com sites
Ver resultados de código (imagens, HTMLs) sem sair do app
O Codex funciona em Docker via device auth. O arquivo ~/.codex/config.toml persiste configurações globais como approval policy e sandbox mode.
Containers são ideais para usar --dangerously-bypass-approvals com segurança — o sistema host fica protegido. Config.toml evita repetir flags a cada sessão.
# Configuração equilibrada (recomendada) approval_policy = "never" sandbox_mode = "workspace-write" model = "gpt-5"
docker run --rm -it \ -v "$PWD:/app" -w /app \ node:20 bash # dentro do container: npm install -g @openai/codex codex login --device-auth