Codex Hoja de referencia
Este apéndice incluye la hoja de referencia de comandos, preguntas frecuentes e información de actualizaciones de versión.
Hoja de referencia de comandos
Comandos básicos de CLI
| Comando | Descripción |
|---|---|
codex | Iniciar TUI interactivo |
codex "任务" | Iniciar y ejecutar la tarea especificada |
codex exec "任务" | Ejecutar tareas en modo no interactivo |
codex --version | Mostrar información de versión |
codex --help | Mostrar información de ayuda |
Comandos de barra diagonal
| Comando | Descripción |
|---|---|
/model <name> | Cambiar de modelo |
/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 sesión actual |
/compact | Comprimir contexto |
/status | Mostrar estado de la sesión |
/clear | Limpiar pantalla |
/quit | Salir de Codex |
/approval <mode> | Cambiar modo de aprobación |
Parámetros de CLI
| Parámetro | Descripción |
|---|---|
-m <model> | Especificar modelo |
--sandbox <mode> | Configurar modo sandbox |
--approval-mode <mode> | Configurar modo de aprobación |
-i <file> | Adjuntar imagen |
-o <file> | Salida a archivo (exec) |
--full-auto | Ejecución totalmente automática |
--ephemeral | No guardar archivos de sesión |
--reasoning-effort <level> | Intensidad de razonamiento |
Ejecución de comandos Shell
| Formato | Descripción |
|---|---|
! <command> | Ejecutar comandos Shell en Codex |
! git status | Ver estado de Git |
! npm test | Ejecutar pruebas |
Rutas de archivos de configuración
Ubicación de archivos de configuración
| Archivo | Ruta | Función |
|---|---|---|
| Configuración de usuario | ~/.codex/config.toml | Configuración global predeterminada |
| Configuración del proyecto | .codex/config.toml | Configuración específica del proyecto |
| Instrucciones del proyecto | AGENTS.md | Normas de comportamiento del proyecto |
| Directorio de registros | ~/.codex/log/ | Registros de ejecución |
| Directorio de sesiones | ~/.codex/sessions/ | Registros de sesión |
Directorio de habilidades
| Ubicación | Ruta |
|---|---|
| Nivel de proyecto | .agents/skills/ |
| Nivel de usuario | ~/.agents/skills/ |
| Nivel de sistema | /etc/codex/skills/ |
Atajos de teclado
Atajos de teclado de CLI
| 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 historial |
Up/Down | Navegar por el historial |
Tab | Autocompletar |
Esc Esc | Editar el mensaje anterior |
Ctrl+O | Copiar la última respuesta |
Atajos de teclado de la App
| Atajo de teclado | Función |
|---|---|
Cmd/Ctrl+N | Nueva sesión |
Cmd/Ctrl+Shift+N | Nueva ventana |
Cmd/Ctrl+W | Cerrar ventana/pestaña |
Cmd/Ctrl+[ | Pestaña anterior |
Cmd/Ctrl+] | Pestaña siguiente |
Preguntas frecuentes
Instalación y autenticación
P: ¿Cómo instalar Codex CLI?
Usando npm o Homebrew:
npm install -g @openai/codex # 或 brew install codex
P: ¿Cómo autenticarse en el primer uso?
Ejecutar el comando codex abrirá automáticamente el navegador para autenticarse, iniciando sesión con una cuenta de ChatGPT o una clave API.
P: ¿Situación del soporte en Windows?
El soporte nativo de Windows es experimental; se recomienda usar WSL2 para obtener la mejor experiencia.
Problemas de uso
P: ¿Cómo ver la configuración actual?
Usa el/statuscomando para ver la configuración y el estado de la sesión actual.
P: ¿Cómo deshabilitar la pantalla alternativa?
Usacodex --no-alt-screeno configuraalternate_screen = "never"。
P: ¿Qué hago si no se encuentra el comando?
Asegúrate de que PATH incluya el directorio de instalación global de npm, o instala usando Homebrew.
P: ¿Cómo ver los registros?
Los registros se encuentran en el~/.codex/log/directorio.
Problemas de funciones
P: ¿Diferencia entre exec y modo interactivo?
exec se ejecuta una sola vez y sale, adecuado para scripts de automatización; el modo interactivo mantiene la conversación, adecuado para el desarrollo diario.
P: ¿Cómo restaurar una sesión anterior?
Usa el/resumecomando ocodex resume --last。
P: ¿Puede GitHub Action modificar archivos?
Sí, configura sandbox: workspace-write.
P: ¿Cómo autenticarse en CI/CD?
Usa la variable de entorno CODEX_API_KEY, almacenada como Secrets.
Problemas de seguridad
P: ¿Cómo evitar que Codex elimine archivos importantes?
Usa el modo sandbox read-only o workspace-write, configura Rules para prohibir comandos peligrosos.
P: ¿Es seguro el modo full-auto?
full-auto ejecuta automáticamente todas las operaciones, incluida la eliminación de archivos, úsalo con precaución.
P: ¿Cómo manejar datos sensibles?
Usa el almacenamiento de Secrets, solo disponible en el script de configuración.
Actualizaciones de versión
Actualizaciones recientes
| Versión | Fecha | Contenido de la actualización |
|---|---|---|
| v1.5.0 | 2026-04 | Nuevo soporte para la serie de modelos GPT-5.4 |
| v1.4.0 | 2026-03 | Mejora de la funcionalidad Worktree |
| v1.3.0 | 2026-02 | Nuevo modo de revisión |
| v1.2.0 | 2026-01 | Optimización del soporte de MCP Server |
| v1.1.0 | 2025-12 | Nueva integración con GitHub |
| v1.0.0 | 2025-11 | Lanzamiento oficial de Codex |
Actualizar CLI
Comandos de actualización
npm install -g @openai/codex@latest
# Actualizar con Homebrew
brew upgrade codex
# Ver la versión actual
codex --version
Recursos relacionados
Recursos oficiales
| Recurso | Dirección |
|---|---|
| Documentación oficial | https://developers.openai.com/codex |
| GitHub | https://github.com/openai/codex |
| Codex Web | https://chatgpt.com/codex |
| Discord | https://discord.gg/openai |
Serie de tutoriales
| Capítulo | Título | Contenido |
|---|---|---|
| 01 | Introducción a Codex | Capacidades principales, comparación de planes |
| 02 | Conceptos centrales | Prompt、Thread、Context、Sandbox |
| 03 | Aplicación de escritorio | Funciones de la App, modo de revisión |
| 04 | Extensión de IDE | VS Code、Cursor、Windsurf |
| 05 | Herramienta de línea de comandos | Instalación de CLI, TUI, aprobación |
| 06 | Versión en la nube | Interfaz web, entornos |
| 07 | Integración y conexión | GitHub、Slack、Linear、MCP |
| 08 | Configuración y personalización | Config、Rules、Skills |
| 09 | Automatización y CI/CD | exec、SDK、GitHub Action |
| 10 | Modos de flujo de trabajo | Flujo de desarrollo, refactorización, corrección de errores |
| 11 | Mejores prácticas de prompts | Estructura del prompt, descomposición de tareas |
| 12 | Seguridad y gestión empresarial | Sandbox, permisos, registros de auditoría |
| 13 | Selección de modelos | Serie GPT-5.4, intensidad de razonamiento |
| 14 | Apéndice | Hoja de referencia de comandos, preguntas frecuentes |
Glosario
| Término | Descripción |
|---|---|
| Agent | Unidad de ejecución central de Codex, capaz de comprender tareas y ejecutar operaciones |
| Prompt | Instrucciones de tarea enviadas por el usuario a Codex |
| Thread | Secuencia de sesión que contiene el historial completo de la conversación |
| Context | El alcance de información disponible para Codex, incluyendo archivos, conversaciones y configuración |
| Sandbox | Entorno de ejecución aislado, que limita el alcance de operación de Codex |
| Approval | Política de aprobación, que controla el comportamiento de confirmación antes de ejecutar operaciones |
| AGENTS.md | Archivo de instrucciones del proyecto, que define las normas de comportamiento de Codex |
| Skill | Módulos de capacidades personalizadas reutilizables |
| Subagent | Subagentes, utilizados para procesar tareas complejas en paralelo |
| Rules | Motor de reglas, que define los permisos de ejecución de comandos |
| MCP | Model Context Protocol, protocolo para conectar herramientas externas |
| Worktree | Árbol de trabajo de Git, directorio de trabajo para aislar diferentes tareas |
Comentarios y soporte
Obtener ayuda
- Uso
/helpComando para ver la ayuda integrada - Visite la documentación oficial para obtener instrucciones detalladas
- Únase a la comunidad de Discord para debatir
Reportar problemas
- GitHub Issues:Enviar errores o solicitudes de funciones
- Enviar sugerencias a través de la función de comentarios de Codex
Otras extensionesCodex se actualiza e itera continuamente; siga los canales oficiales para obtener la información más reciente.