Herramienta de línea de comandos Codex
Codex CLI es la herramienta oficial de línea de comandos, escrita en Rust, ligera y eficiente, ideal para entusiastas de la terminal.
Instalar CLI
Codex CLI es compatible con macOS, Linux y Windows (experimental).
Instalación con npm
Instalación global con npm
npm install -g @openai/codex
# Verificar la instalación
codex --version
Instalación con Homebrew
Instalación con Homebrew
brew install codex
Actualizar CLI
Actualizar versión
npm install -g @openai/codex@latest
# Actualizar con Homebrew
brew upgrade codex
Primer uso
La primera vez que ejecutes Codex te guiará a través de la autenticación:
Iniciar Codex
codex
# O especificar una tarea inicial
codex "Explica la estructura de este proyecto"
Codex abrirá el navegador para la autenticación:
- Inicia sesión con tu cuenta de ChatGPT
- O usa tu clave de API de OpenAI
- Después de autorizar, vuelve a la terminal para continuar
TUI interactivo
El CLI entra por defecto en el modo de interfaz de usuario de terminal (TUI), ofreciendo una experiencia inmersiva.
Áreas de la interfaz TUI
| Área | Función |
|---|---|
| Área de mensajes | Muestra el historial de conversación, las llamadas a herramientas y los resultados de ejecución |
| Área de entrada | Cuadro de entrada inferior, enviar prompt |
| Barra de estado | Muestra el modelo, el uso de contexto y la información del hilo |
Configuración del modo TUI
Configuración de TUI
[tui]
# Modo de pantalla alternativa
alternate_screen = "auto" # auto | always | never
# Conservar el historial de desplazamiento al deshabilitar la pantalla alternativa
# alternate_screen = "never"
El modo de pantalla alternativa hace que Codex use una pantalla independiente y restaure el estado original de la terminal al salir.
Modo de aprobación
El modo de aprobación controla el comportamiento de confirmación antes de que Codex ejecute acciones.
Cuatro modos
| Modo | Descripción | Comportamiento |
|---|---|---|
| suggest | Modo sugerencia | Codex ofrece sugerencias pero no ejecuta |
| auto-edit | Edición automática | Ejecuta automáticamente la edición de archivos, los comandos requieren confirmación |
| full-auto | Totalmente automático | Ejecuta automáticamente todas las acciones (usar con precaución) |
| interactive | Modo interactivo | Pregunta antes de operaciones sensibles (predeterminado) |
Configurar el modo de aprobación
codex --approval-mode full-auto
# O cambiar en la sesión
/approval full-auto
En el modo full-auto, Codex ejecutará automáticamente todas las acciones, incluida la eliminación de archivos. Úsalo con precaución.
Modo sandbox
El modo sandbox restringe el alcance de acceso de Codex a archivos y comandos.
| Modo | Modificación de archivos | Ejecución de comandos | Acceso a red |
|---|---|---|---|
| read-only | Prohibido | Prohibido | Prohibido |
| workspace-write | Solo espacio de trabajo | Permitido | Prohibido |
| danger-full-access | Permitido | Permitido | Permitido |
Configurar el modo sandbox
codex --sandbox read-only
# Modo de escritura en el espacio de trabajo (recomendado)
codex --sandbox workspace-write
# Modo de acceso completo (peligroso)
codex --sandbox danger-full-access
Comandos de barra
El CLI ofrece una amplia variedad de comandos de barra:
| Comando | Función |
|---|---|
/model | Cambiar de modelo (p. ej., /model gpt-5.4-mini) |
/fast | Cambiar al modo Fast |
/plan | Entrar al modo de planificación |
/review | Revisar cambios de código |
/new | Iniciar nueva sesión |
/resume | Restaurar sesión anterior |
/fork | Clonar la sesión actual en un nuevo hilo |
/compact | Comprimir el historial de contexto |
/status | Mostrar estado de la sesión |
/clear | Limpiar pantalla |
/quit | Salir de Codex |
Ejemplos de uso de comandos
Comandos de barra
/model gpt-5.4-mini
# Modo de planificación
/plan implementar un sistema de autenticación de usuarios
# Ver estado
/status
Ejecución de comandos Shell
Ejecuta comandos Shell directamente en el CLI:
Ejecutar comandos
! ls -la
# Ejecutar comandos git
! git status
# Ver procesos
! ps aux
Confirmación de comandos
Los comandos peligrosos requieren confirmación:
- Eliminar archivos (rm)
- Terminar procesos (kill)
- Modificar la configuración del sistema
Entrada de imágenes
El CLI admite adjuntar imágenes como contexto:
Adjuntar imágenes
codex -i screenshot.png
# Adjuntar diseño
codex --image design.png "Implementa la página según este diseño"
# Varias imágenes
codex -i img1.png -i img2.png
Usos de las imágenes
- Analizar mensajes de error con capturas de pantalla
- Convertir diseños de UI en código
- Interpretación de datos de gráficos
Modo no interactivo (exec)
Usa el comando exec para ejecutar tareas únicas, ideal para scripts y CI/CD:
Comando exec
codex exec "Revisa el código y genera un informe"
# Salida a archivo
codex exec "Genera un README" -o README.md
# Usar un modelo específico
codex exec -m gpt-5.4-mini "Analiza la estructura del proyecto"
# Modo totalmente automático
codex exec --full-auto "Ejecuta las pruebas y corrige los fallos"
Parámetros comunes de exec
| Parámetro | Descripción |
|---|---|
-m | Especificar modelo |
-o | Salida a archivo |
--full-auto | Ejecución totalmente automática |
--ephemeral | No guardar archivos de sesión |
--json | Formato de salida JSON |
Atajos de teclado
| Atajo de teclado | Función |
|---|---|
Enter | Enviar mensaje |
Shift+Enter | Nueva línea |
Ctrl+C | Interrumpir operación |
Ctrl+C (两次) | Salir de Codex |
Ctrl+D | Salir (cuando la entrada está vacía) |
Ctrl+R | Buscar en el historial |
Up/Down | Navegar por el historial |
Tab | Autocompletar |
Esc Esc | Editar el mensaje anterior |
Ctrl+O | Copiar la última respuesta |
Preguntas frecuentes
P: ¿Soporte para Windows?
El soporte nativo de Windows es experimental; se recomienda usar WSL2 para obtener la mejor experiencia.
P: ¿Cómo deshabilitar la pantalla alternativa?
Usacodex --no-alt-screeno configuraalternate_screen = "never"。
P: ¿Comando no encontrado?
Asegúrate de que PATH incluya el directorio de instalación global de npm, o instala usando Homebrew.
P: ¿Cómo ver los registros detallados?
Los registros se encuentran en~/.codex/log/el directorio.