Capítulo 7. Usarlo en el terminal — comprobar Herramienta de orden con una sola línea, codex exec
En una línea: Codex CLI es Codex para usar en el terminal. Lee el
AGENTS.mdy los skills de la carpeta donde lo ejecutas.codex exec "tarea"se ejecuta una vez y termina, y por defecto es de solo lectura. Se parece alclaude -pde Claude Code, pero en esto es distinto.
Este capítulo se escribió con la documentación oficial de Codex consultada el 1 de noviembre de 2026 y con el resultado de ejecutar Codex CLI 0.166.0 en el terminal de macOS. Si es la primera vez que usas el terminal, puedes saltarte este capítulo. Qué es el terminal se explicó en el capítulo 10 de Claude Code.
Instalar y empezar
El comando de instalación de la documentación oficial es este.[1]
# macOS, Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Antes de ejecutar el comando de instalación, comprueba que es exactamente el que aparece en la documentación oficial (learn.chatgpt.com). Es porque es un comando que ejecuta directamente un script descargado de internet.
Cuando termine la instalación, ve a la carpeta Herramienta de orden (정리도구) y escribe codex. La primera vez, elige Sign in with ChatGPT.[2]
cd ~/hello-ai-연습/정리도구
codexEl Codex del terminal considera la carpeta donde lo ejecutaste como el proyecto de esa conversación.[3] Lo que en la aplicación hacías eligiendo la carpeta con Choose project, aquí lo hace cd.
Comprueba lo aprendido
Vas a ejecutar en el terminal el comando de instalación de Codex CLI. ¿Qué debes comprobar sí o sí antes?
codex exec — preguntar una vez y terminar
codex exec es una forma de ejecutar una vez y terminar sin abrir la pantalla de conversación.[4] Hice la misma pregunta que en el capítulo 10 de Claude Code.
cd ~/hello-ai-연습/정리도구
codex exec "Muéstrame la lista de archivos de la carpeta notes y dime en una línea por archivo con qué plantilla (de las de templates) está escrito cada uno. No modifiques los archivos. Responde brevemente y solo con una tabla."Salió solo la respuesta, limpia (salida completa: 7장-codex-exec-출력.txt).
| Archivo de notes | Plantilla usada |
|---|---|
| 공부-2026-10-28-프롬프트-강의.md | templates/공부노트.md |
| 주간회고-2026-10-26.md | templates/주간회고.md |
| 회의록-2026-10-27-주간회의.md | templates/회의록.md |
Fuente: resultado de la práctica de esta guía (2026-11-01). El registro de progreso se descartó aparte y se dejó solo la respuesta final.
codex exec saca el progreso y la respuesta final por caminos distintos. El progreso va por el camino lateral de la pantalla (stderr) y solo la respuesta final es la salida normal (stdout).[5] Por eso, si lo usas como codex exec "…" > resultado.md, en el archivo solo se guarda la respuesta final.
codex exec es de solo lectura por defecto. Para que pueda modificar archivos, añade --sandbox workspace-write.[6] Las prácticas de los capítulos 2, 3 y 5 de esta guía también se ejecutaron con esta opción.
codex exec --sandbox workspace-write '$weekly-review'codex exec se ejecuta con la forma de permisos fijada de antemano.[7] En la práctica del capítulo 5 de esta guía, cuando se bloqueó la escritura en la carpeta .agents, Codex no pudo preguntar y se detuvo ahí. Lo que necesita permiso es más cómodo hacerlo en la aplicación o en el codex interactivo.
La opción --full-auto que aparece en textos antiguos ya no se admite.[8] Existen opciones como --dangerously-bypass-approvals-and-sandbox, que desactiva tanto el sandbox como los permisos[9], pero para ordenar notas no hacen falta.
Comprueba lo aprendido
Quieres que codex exec modifique archivos, pero no ha cambiado nada. ¿Cuál es la razón más probable?
Comandos dentro de codex interactivo
Si abres el modo interactivo con codex, usas comandos que empiezan por /.
| Comando | Qué hace |
|---|---|
/permissions | Cambiar los permisos (el menú de permisos de la aplicación) |
/import | Traer la configuración de Claude Code o Cursor |
/resume | Continuar una conversación guardada |
/status | Ver la información de la conversación y el límite que queda |
Fuente: documentación oficial de Codex[10][11][12][13]
Para continuar desde fuera después de terminar el modo interactivo, escribe codex resume.[12:1]
/permissions y /import son comandos del lado del terminal. En la aplicación se usan el menú de permisos de debajo del cuadro de entrada (capítulo 4) y el menú Import de la configuración (capítulo 3).
Comprueba lo aprendido
En la pantalla interactiva de Codex CLI, ¿qué comando usas para ver la información de la conversación y el límite que queda?
Pruébalo tú
- Comprueba que el comando de instalación de la documentación oficial es igual que el de arriba y, entonces, instala (si ya lo tienes,
codex --version). - Ve a la carpeta Herramienta de orden y ejecuta la pregunta
codex execde solo lectura de arriba. - Abre el modo interactivo con
codexy escribe/status. - Escribe
$o ejecuta/skillspara comprobar que se ven los nombres de los skills del capítulo 5.[14]
Proyecto continuo: en el capítulo 8 ordenaremos los costes, los datos y la seguridad, y comprobaremos cómo trata Codex una nota con una instrucción oculta.
Resumen
- El Codex del terminal considera proyecto la carpeta donde lo ejecutas y lee el
AGENTS.mdy los skills de esa carpeta. - Comprueba que el comando de instalación es igual que el de la documentación oficial antes de ejecutarlo.
codex execse ejecuta una vez y termina, y es de solo lectura por defecto. Para modificar,--sandbox workspace-write.codex execse ejecuta con los permisos fijados de antemano. Lo que necesita permiso, en la aplicación o en el modo interactivo.
Glosario
| Término | En español | En una línea |
|---|---|---|
| Codex CLI | Codex CLI | Codex para usar en el terminal |
codex exec | codex exec | Forma de ejecutar una vez y terminar |
| stdout / stderr | stdout / stderr | La salida normal / el camino lateral por el que salen el progreso y los errores |
¿Terminaste este capítulo?
El progreso se guarda solo en este navegador. Puedes ver tu avance en el índice completo.
Siguiente capítulo: Capítulo 8. Costes, datos y seguridad, y cómo elegir la herramienta
Referencias (14)
Documentación oficial de Codex, «Codex CLI». "curl -fsSL chatgpt.com | sh" / "powershell -ExecutionPolicy ByPass -c "irm chatgpt.com | iex"" learn.chatgpt.com (consultado el 2026-11-01) ↩︎
Documentación oficial de Codex, «Codex CLI». "Open a project directory and run
codex. The first time you run Codex, choose Sign in with ChatGPT or another available sign-in method." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Projects and chats». "Codex CLI treats the directory where you start it as the project for the chat." learn.chatgpt.com (consultado el 2026-11-01) ↩︎
Documentación oficial de Codex, «Non-interactive mode». "Non-interactive mode lets you run Codex from scripts (for example, continuous integration (CI) jobs) without opening the interactive TUI." learn.chatgpt.com (consultado el 2026-11-01) ↩︎
Documentación oficial de Codex, «Non-interactive mode». "While
codex execruns, Codex streams progress tostderrand prints only the final agent message tostdout." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Non-interactive mode». "By default,
codex execruns in a read-only sandbox." / "Allow edits:codex exec --sandbox workspace-write "<task>"" learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Non-interactive mode». "Run with explicit, pre-set sandbox and approval settings." learn.chatgpt.com (consultado el 2026-11-01) ↩︎
Documentación oficial de Codex, «Non-interactive mode». "
--full-autois no longer supported." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Agent approvals & security». "
--dangerously-bypass-approvals-and-sandbox(alias:--yolo)" learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Permissions». "In the CLI, enter
/permissions." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Import from another agent». "Start a local Codex CLI session and type
/import." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Projects and chats». "Use
/resumewhile Codex is open, or runcodex resume, to continue a saved chat." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Pricing». "If you want to see your remaining limits during an active Codex CLI session, you can use
/status." learn.chatgpt.com (consultado el 2026-11-01) ↩︎Documentación oficial de Codex, «Build skills». "In Codex CLI or the IDE extension, run
/skillsor type$to mention a skill." learn.chatgpt.com (consultado el 2026-11-01) ↩︎