El blog de Deska

Modos de aprobación de Codex CLI: Sugerir, Auto, Total

Guía profunda sobre los modos de aprobación de Codex CLI para optimizar tu flujo de trabajo con agentes de IA y equilibrar el control del desarrollador.

· 10 min de lectura

Comprender los diversos modos de aprobación de Codex CLI es esencial para los desarrolladores que buscan equilibrar la velocidad con la seguridad al trabajar con agentes de programación de IA. Estos modos determinan cuánta autonomía tiene el agente al ejecutar comandos o modificaciones en tu máquina local.

La palabra clave principal modos de aprobación de Codex CLI se refiere a los ajustes de configuración que rigen el ciclo de interacción entre el desarrollador humano y el motor de IA. Elegir el modo correcto depende de la complejidad de la tarea, tu familiaridad con el código base y el nivel de riesgo que estés dispuesto a tolerar durante una sesión.

El ciclo de interacción principal

Cada vez que envías un prompt a un agente de CLI, el modelo procesa la solicitud y propone un conjunto de acciones. Estas acciones generalmente implican leer archivos, escribir código o ejecutar comandos de terminal. El modo de aprobación actúa como un guardián en este ciclo.

En un flujo de trabajo manual tradicional, podrías copiar y pegar sugerencias de una ventana de chat en tu terminal. Un agente de CLI agiliza esto al interactuar con tu shell directamente. Sin los ajustes de aprobación correctos, corres el riesgo de que el agente ejecute un comando destructivo o realice cambios generalizados que sean difíciles de revertir.

Por qué son importantes los modos de aprobación

La seguridad y la alineación de la intención son los dos pilares de estos ajustes. Un agente de IA podría interpretar una solicitud para limpiar un directorio sugiriendo un comando de eliminación recursiva. Si estás en modo de solo ayuda, simplemente verás la sugerencia. Si estás en un modo más permisivo, el agente podría ejecutar ese comando de inmediato.

Los desarrolladores suelen alternar entre diferentes modos a lo largo del día. Podrías comenzar con un modo estricto mientras exploras una librería nueva y cambiar a un modo más automatizado una vez que confíes en la lógica del agente para movimientos repetitivos.

Análisis profundo de los modos de aprobación

La nomenclatura de estos modos puede variar según las diferentes implementaciones, pero generalmente se dividen en tres categorías: Sugerir, Auto y Total.

Modo Sugerir (Aprobación Estándar)

Este es el punto de entrada básico y más seguro para cualquier desarrollador. En este modo, el agente nunca realiza una acción sin una confirmación explícita del usuario.

  • Cada escritura de archivo requiere confirmación.
  • Cada comando de terminal se muestra para revisión antes de la ejecución.
  • El usuario puede editar el comando propuesto antes de que se ejecute.

Este modo es excelente para aprender cómo piensa el agente. Proporciona un beneficio pedagógico porque ves exactamente qué flags y parámetros elige usar el agente.

Modo Auto (Aprobación Filtrada)

El modo Auto intenta encontrar un punto medio categorizando las acciones en cubetas seguras e inseguras. Muchos desarrolladores encuentran que este es el ajuste más productivo para el trabajo diario.

En esta configuración, las acciones de solo lectura como ls, cat o grep podrían ejecutarse automáticamente para reunir contexto. Sin embargo, las acciones de escritura o los comandos que modifican el estado del sistema siguen requiriendo un activador manual. Esto reduce la cantidad de pulsaciones de teclas necesarias para que el agente comprenda el código base mientras mantiene la implementación final bajo control humano.

Modo Total (Ejecución Autónoma)

El modo Total permite al agente ejecutar secuencias de comandos y ediciones sin pausar para recibir intervención humana. Esto está diseñado para tareas complejas donde el agente necesita iterar a través de un ciclo de "probar, capturar error, corregir" para llegar a una solución.

Aunque es potente, el modo Total debe usarse con precaución. Es más adecuado para entornos con un control de versiones robusto donde puedas revertir cambios fácilmente si el agente se desvía del camino.

Integrando Codex CLI con Deska

Deska proporciona un entorno donde estos modos de aprobación pueden utilizarse eficazmente dentro de un contexto visual. Como una aplicación de escritorio gratuita para Mac, Windows y Linux, Deska te permite ejecutar agentes como Codex CLI junto con otras herramientas.

El diseño de Deska es un espacio de trabajo de lienzo infinito donde colocas paneles en cualquier lugar y haces zoom hacia afuera para verlo todo. Dentro de este lienzo, puedes tener una terminal de Codex CLI ejecutándose en un panel mientras agentes de programación como Claude Code se ejecutan en otro. Cada panel puede mantener su propia sesión y contexto de aprobación.

Visualizando el flujo de trabajo en Deska

Al usar Codex CLI dentro de una terminal de Deska, los beneficios del lienzo se vuelven claros:

  • Monitorea los cambios de archivos en un panel de editor de código Monaco mientras el agente escribe.
  • Usa el panel de navegador integrado para ver actualizaciones en vivo si el agente está trabajando en una tarea de frontend.
  • Utiliza Ask Deska para gestionar tu espacio de trabajo mediante voz mientras el agente de CLI procesa una tarea en segundo plano.

Dado que Deska es local-first, el código y los archivos con los que interactúa el agente permanecen en tu máquina. Esto es particularmente importante al usar modos autónomos, ya que mantienes el control físico sobre el entorno y los datos que se procesan.

Comparación de enfoques de aprobación

La siguiente tabla resume cómo los diferentes niveles de aprobación afectan la experiencia del desarrollador al usar herramientas de CLI.

CaracterísticaModo SugerirModo AutoModo Total
Acciones de LecturaRequiere confirmaciónAutomáticoAutomático
Acciones de EscrituraRequiere confirmaciónRequiere confirmaciónAutomático
Velocidad de EjecuciónLenta (humano en el ciclo)ModeradaRápida
Riesgo de SeguridadEl más bajoBajo a ModeradoAlto
Mejor Caso de UsoExploración/AprendizajeDesarrollo GeneralRefactorización/Corrección

Consideraciones de seguridad y el enlace móvil

Uno de los riesgos de dejar un agente de CLI ejecutándose en un modo autónomo es la pérdida de visibilidad cuando te alejas de tu escritorio. Deska soluciona esto a través de su aplicación móvil.

La aplicación móvil actúa como un relevo seguro, permitiéndote monitorear y continuar el trabajo desde tu teléfono. Debido a que los dispositivos se vinculan directamente y no se exponen puertos, puedes verificar el progreso de una tarea de Codex CLI de larga duración sin comprometer tu seguridad local. Si un agente entra en un ciclo infinito o comienza a realizar cambios inesperados mientras está en modo Total, puedes intervenir desde la interfaz móvil.

Eligiendo el modo correcto para tu proyecto

La decisión sobre cuál de los modos de aprobación de Codex CLI usar a menudo depende del ciclo de vida del proyecto.

  1. Inicialización: Usa el modo Sugerir para ver cómo el agente estructura un repositorio nuevo y para asegurar que siga tus patrones preferidos.
  2. Desarrollo de Funcionalidades: Transiciona al modo Auto una vez que te sientas cómodo con el conocimiento que tiene el agente sobre tus estructuras de datos y almacenamiento.
  3. Mantenimiento: Usa el modo Total para tareas repetitivas como actualizar dependencias o migrar patrones simples en muchos archivos, siempre que tengas un estado de git limpio.

Recuerda que Codex CLI opera sobre tus archivos locales. Incluso en modo Total, se recomienda revisar los diffs con frecuencia. Los paneles de notas y cuadernos en Deska son útiles para llevar un registro de los prompts que llevaron a los mejores resultados en cada modo.

Preguntas Frecuentes

¿Cómo cambio los modos de aprobación de Codex CLI durante una sesión?

La mayoría de los agentes de CLI te permiten alternar entre modos a través de un comando de configuración o un flag pasado durante el inicio. Generalmente puedes actualizar tu archivo de configuración local o usar un comando como /config dentro de la terminal del agente para cambiar entre Sugerir y Total sin reiniciar toda la sesión.

¿Es seguro usar el modo Total en un código base de producción?

Generalmente no se recomienda usar modos autónomos en un código base sin un sistema de control de versiones activo como Git. Aunque el agente busca la precisión, el riesgo de errores lógicos o eliminaciones involuntarias es mayor cuando se omite el paso de revisión humana. Asegúrate siempre de tener una forma de revertir los cambios.

¿Puedo limitar qué comandos están permitidos en el modo Auto?

Sí, muchas implementaciones permiten una lista blanca o negra de comandos. Esto permite una configuración granular donde comandos seguros como npm test pueden ejecutarse automáticamente, mientras que comandos destructivos como rm o git push siempre activan una solicitud de confirmación independientemente del modo general.

Comienza con Deska

Si estás listo para experimentar con agentes de IA en un entorno local-first, puedes descargar la aplicación Deska de forma gratuita. Ya sea que uses Codex CLI en modo Sugerir o lleves los límites al máximo con el modo Total, Deska proporciona las herramientas para gestionar tu espacio de trabajo de manera eficiente.

Al aprovechar el lienzo infinito y los paneles estándar, puedes construir un entorno de desarrollo personalizado que se adapte a tu flujo de trabajo específico. Combina el poder de los agentes de CLI con un espacio de trabajo controlado por voz y observa cómo se transforma tu productividad.

💡 Ideas+🐛 BugsPropón una feature o reporta un bug