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

ComandoDescripción
codexIniciar TUI interactivo
codex "任务"Iniciar y ejecutar la tarea especificada
codex exec "任务"Ejecutar tareas en modo no interactivo
codex --versionMostrar información de versión
codex --helpMostrar información de ayuda

Comandos de barra diagonal

ComandoDescripción
/model <name>Cambiar de modelo
/fastCambiar al modo Fast
/planEntrar al modo de planificación
/reviewRevisar cambios de código
/newIniciar nueva sesión
/resumeRestaurar sesión anterior
/forkClonar sesión actual
/compactComprimir contexto
/statusMostrar estado de la sesión
/clearLimpiar pantalla
/quitSalir de Codex
/approval <mode>Cambiar modo de aprobación

Parámetros de CLI

ParámetroDescripció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-autoEjecución totalmente automática
--ephemeralNo guardar archivos de sesión
--reasoning-effort <level>Intensidad de razonamiento

Ejecución de comandos Shell

FormatoDescripción
! <command>Ejecutar comandos Shell en Codex
! git statusVer estado de Git
! npm testEjecutar pruebas

Rutas de archivos de configuración

Ubicación de archivos de configuración

ArchivoRutaFunción
Configuración de usuario~/.codex/config.tomlConfiguración global predeterminada
Configuración del proyecto.codex/config.tomlConfiguración específica del proyecto
Instrucciones del proyectoAGENTS.mdNormas 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ónRuta
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 tecladoFunción
EnterEnviar mensaje
Shift+EnterNueva línea
Ctrl+CInterrumpir operación
Ctrl+C (两次)Salir de Codex
Ctrl+DSalir (cuando la entrada está vacía)
Ctrl+RBuscar historial
Up/DownNavegar por el historial
TabAutocompletar
Esc EscEditar el mensaje anterior
Ctrl+OCopiar la última respuesta

Atajos de teclado de la App

Atajo de tecladoFunción
Cmd/Ctrl+NNueva sesión
Cmd/Ctrl+Shift+NNueva ventana
Cmd/Ctrl+WCerrar 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ónFechaContenido de la actualización
v1.5.02026-04Nuevo soporte para la serie de modelos GPT-5.4
v1.4.02026-03Mejora de la funcionalidad Worktree
v1.3.02026-02Nuevo modo de revisión
v1.2.02026-01Optimización del soporte de MCP Server
v1.1.02025-12Nueva integración con GitHub
v1.0.02025-11Lanzamiento oficial de Codex

Actualizar CLI

Comandos de actualización

# Actualizar con npm
npm install -g @openai/codex@latest

# Actualizar con Homebrew
brew upgrade codex

# Ver la versión actual
codex --version

Recursos relacionados

Recursos oficiales

RecursoDirección
Documentación oficialhttps://developers.openai.com/codex
GitHubhttps://github.com/openai/codex
Codex Webhttps://chatgpt.com/codex
Discordhttps://discord.gg/openai

Serie de tutoriales

CapítuloTítuloContenido
01Introducción a CodexCapacidades principales, comparación de planes
02Conceptos centralesPrompt、Thread、Context、Sandbox
03Aplicación de escritorioFunciones de la App, modo de revisión
04Extensión de IDEVS Code、Cursor、Windsurf
05Herramienta de línea de comandosInstalación de CLI, TUI, aprobación
06Versión en la nubeInterfaz web, entornos
07Integración y conexiónGitHub、Slack、Linear、MCP
08Configuración y personalizaciónConfig、Rules、Skills
09Automatización y CI/CDexec、SDK、GitHub Action
10Modos de flujo de trabajoFlujo de desarrollo, refactorización, corrección de errores
11Mejores prácticas de promptsEstructura del prompt, descomposición de tareas
12Seguridad y gestión empresarialSandbox, permisos, registros de auditoría
13Selección de modelosSerie GPT-5.4, intensidad de razonamiento
14ApéndiceHoja de referencia de comandos, preguntas frecuentes

Glosario

TérminoDescripción
AgentUnidad de ejecución central de Codex, capaz de comprender tareas y ejecutar operaciones
PromptInstrucciones de tarea enviadas por el usuario a Codex
ThreadSecuencia de sesión que contiene el historial completo de la conversación
ContextEl alcance de información disponible para Codex, incluyendo archivos, conversaciones y configuración
SandboxEntorno de ejecución aislado, que limita el alcance de operación de Codex
ApprovalPolítica de aprobación, que controla el comportamiento de confirmación antes de ejecutar operaciones
AGENTS.mdArchivo de instrucciones del proyecto, que define las normas de comportamiento de Codex
SkillMódulos de capacidades personalizadas reutilizables
SubagentSubagentes, utilizados para procesar tareas complejas en paralelo
RulesMotor de reglas, que define los permisos de ejecución de comandos
MCPModel 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

Codex se actualiza e itera continuamente; siga los canales oficiales para obtener la información más reciente.

Otras extensiones