⌨️ Terminal e interfaz gráfica

🟢 Qué es

Antes de Codex necesitas Node.js v18 o superior (que incluye npm) y Git. Las versiones antiguas de Node causan errores silenciosos durante la instalación de Codex.

💡 Por qué aprender

npm es el gestor de paquetes que instala Codex globalmente. Sin Node.js v18+, incluso el comando de instalación falla con mensajes confusos.

🔑 Instalación por sistema

# 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

🟢 Qué es

Codex CLI se distribuye como paquete npm: @openai/codex. La bandera -g se instala globalmente — disponible en cualquier directorio.

💡 Por qué aprender

La instalación global o local marca la diferencia: la global permite llamar codex desde cualquier carpeta. Local solo funciona dentro del proyecto con npx.

🔑 Comandos de instalación

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

⚠️ Errores comunes en la primera ejecución y su solución

codex : O arquivo codex.ps1 não pode ser carregado porque a
execução de scripts foi desabilitada neste sistema.
    + FullyQualifiedErrorId : UnauthorizedAccess

# En PowerShell, ejecútalo una vez y confirma con "S":
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

# Vuelve a probar:
codex --version

# Rode o Codex pelo Prompt de Comando (cmd), que
# não passa pela política de execução do PowerShell:
codex --version

# Conferir a política atual, se quiser:
Get-ExecutionPolicy -List

git add skills/minha-skill
git commit -m "Add skill"
git push -u origin main   # ...e nada aparece no GitHub

git status     # 1. os arquivos estão "staged" (verdes)?
git remote -v  # 2. existe 'origin' e a URL está certa?
git branch     # 3. seu branch é 'main' ou 'master'?

# Se ainda não houver remote:
git remote add origin https://github.com/usuario/repo.git

git add .
git commit -m "Add automatic climate dashboard update skill"

# Se o push for rejeitado (remoto à frente):
git pull --rebase origin main
git push -u origin main

# ~/.codex/config.toml — fixa o padrão e evita repetir flags:
approval_policy = "on-request"      # untrusted | on-failure | on-request | never
sandbox_mode    = "workspace-write" # read-only | workspace-write | danger-full-access

🟢 Qué es

El inicio de sesión usa autenticación de dispositivo: la terminal muestra un código + un enlace. Abres el enlace en el navegador, escribes el código y ya tienes la sesión iniciada. Sin exponer API keys en la terminal.

💡 Por qué aprender

La autenticación del dispositivo es segura incluso en entornos compartidos. El código vence en 15 minutos: abre el enlace de inmediato.

🔑 Paso a paso

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

🟢 Qué es

Después de instalar e iniciar sesión, Codex funciona en la terminal con dos modos: interactivo (codex) y directo (codex "prompt").

💡 Por qué aprender

El modo interactivo es ideal para tareas largas e iterativas. El modo directo es excelente para scripts y automatizaciones en CI/CD.

🔑 Referencia rápida

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

🟢 Qué es

La aplicación de Codex para Windows es la interfaz gráfica completa: skills con UI, plugins externos, vistas previas en línea, múltiples hilos paralelos, pestaña de Automations y browser integrado.

💡 Por qué aprender

La interfaz gráfica es superior al CLI para tareas que implican varios hilos simultáneos, automatizaciones programadas y uso del navegador para computer use.

🔑 Recursos principales

🟢 Qué es

Codex funciona en Docker mediante la autenticación del dispositivo. El archivo ~/.codex/config.toml persiste configuraciones globales como la política de aprobación y el modo sandbox.

💡 Por qué aprender

Los contenedores son ideales para usar --dangerously-bypass-approvals de forma segura; el sistema host queda protegido. Config.toml evita repetir flags en cada sesión.

🔑 Config.toml y Docker

# 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