Herramientasgemini cli
Gemini CLI Plan Mode: planifica cambios paso a paso
Aprende a activar Plan Mode en Gemini CLI, revisar un plan y pasar a la ejecución con controles y ejemplos para tus proyectos profesionales.
- Autor: humAIns
- 10 min de lectura
índice · 6 apartados
Gemini CLI Plan Mode sirve para analizar un repositorio y acordar una estrategia antes de pedirle que implemente cambios. Para activarlo una vez, inicia con gemini --approval-mode=plan; durante una sesión también puedes usar /plan o Shift+Tab. Revisa el plan y los permisos antes de aprobar: en modo no interactivo el paso a ejecución puede comportarse de forma más permisiva.
Qué es Plan Mode y cuándo conviene usarlo
Plan Mode es una modalidad para investigar, diseñar y preparar una solución sin empezar directamente a editar el código del proyecto. La documentación oficial de Gemini CLI describe las herramientas permitidas como lectura, búsqueda e interacción para aclarar requisitos; la escritura está limitada a archivos Markdown dentro del directorio de planes configurado. El plan, por tanto, es un artefacto distinto del código que describe.
Este paso intermedio resulta útil cuando una tarea toca varios componentes, cuando quieres acordar el alcance antes de implementar o cuando necesitas documentar riesgos y comprobaciones. Por ejemplo, mantener una página de portfolio puede implicar revisar su estructura, identificar estilos compartidos y proponer una modificación pequeña. Si el objetivo es un cambio trivial y ya conoces los archivos, iniciar directamente en el modo de aprobación habitual puede ser más rápido.
Plan Mode no convierte una petición vaga en una especificación correcta por arte de magia. La calidad depende del contexto que proporciones, de las restricciones explícitas y de que compruebes las conclusiones contra el proyecto. Tampoco reemplaza el control de versiones, una revisión de diferencias ni las pruebas.
Cómo activar el modo plan
Las instrucciones de la documentación vigente consultada el 17 de noviembre de 2026 describen varias maneras de entrar:
| Necesidad | Acción documentada | Cuándo usarla |
|---|---|---|
| Iniciar una sesión concreta en modo plan | gemini --approval-mode=plan | Para planificar esta tarea desde el arranque |
| Usarlo como valor inicial habitual | En la sesión, abre /settings y establece Default Approval Mode en Plan | Si prefieres comenzar en modo de lectura y cambiar cuando haga falta |
| Cambiar durante una sesión | Escribe /plan en la entrada | Para entrar en planificación desde la conversación |
| Recorrer modalidades | Pulsa Shift+Tab | Para alternar por los modos disponibles |
La tecla de alternancia recorre Default, Auto-Edit y Plan, pero la documentación indica que Plan puede retirarse temporalmente de esa rotación mientras Gemini CLI procesa una solicitud o muestra un diálogo de confirmación. En /plan puedes incluir una meta, por ejemplo /plan mejorar la navegación del portfolio; si omites el objetivo, solo cambias de modalidad.
Las opciones pueden cambiar entre versiones. Si el comando no se reconoce o la interfaz difiere, consulta la ayuda de tu instalación y la guía oficial de Plan Mode, en lugar de asumir que una instrucción antigua sigue vigente.
Ejemplo paso a paso: mejorar una página de portfolio
Supón que mantienes un portfolio profesional ficticio y quieres que la página principal destaque un proyecto reciente. El objetivo es reorganizar la presentación sin alterar formularios, datos de contacto ni otras secciones. Trabaja en una rama o copia de prueba y no pegues información confidencial en el prompt.
1. Define el resultado y los límites
Inicia Gemini CLI en el directorio del proyecto y activa Plan Mode. Formula una petición concreta, por ejemplo: «Analiza cómo se construye la página principal del portfolio. Propón una reorganización visual de la sección de proyectos para que el proyecto destacado aparezca primero. No implementes nada todavía. No cambies formularios, rutas, textos de contacto ni dependencias. Indica qué archivos revisarías y qué pruebas comprobarían el resultado».
El detalle ayuda a diferenciar objetivo de implementación: describes el resultado deseado, indicas lo que debe quedar intacto y pides comprobaciones. Evita proporcionar claves, datos de clientes o material privado que no sea necesario para entender la estructura.
2. Deja que inspeccione y pregunta por supuestos
En esta fase Gemini CLI puede recorrer archivos y buscar componentes o estilos relevantes conforme a sus herramientas de lectura. Contrasta si ha localizado la página real o si está extrapolando desde nombres de archivo. Si hay varias opciones —por ejemplo, una plantilla común o un componente exclusivo de esa página—, pide que explique el impacto de cada una antes de cerrar el enfoque.
No trates una lista de archivos mencionados en la conversación como si fuera todavía el plan formal. Aclara qué significa «proyecto destacado» en los datos existentes, qué estados vacíos deben conservarse y qué dispositivos se deben comprobar. Si la herramienta no puede verificar un supuesto, anótalo como una comprobación pendiente, no como un hecho.
3. Revisa el archivo del plan
Cuando haya acuerdo sobre la estrategia, Gemini CLI prepara un plan en Markdown dentro de su directorio de planes. La documentación indica que puedes abrirlo con Ctrl+X en el editor configurado, leerlo y modificarlo o añadir comentarios. Comprueba que el plan:
- se limita a la página y componentes estrictamente necesarios;
- respeta las rutas, formularios y datos que pediste conservar;
- separa cambios visuales de cambios de comportamiento;
- incluye cómo validar escritorio, móvil y estados sin contenido;
- señala dudas en vez de convertirlas en requisitos inventados.
Si un paso es demasiado amplio, deja una observación o edita el documento; Gemini CLI puede revisar la estrategia y presentarla de nuevo para aprobación. Un buen plan permite entender qué se va a hacer y cómo decidir si quedó bien, no solo enumera tareas genéricas como «mejorar diseño».
4. Aprueba conscientemente y verifica la implementación
La CLI presenta una aprobación formal para el plan. Según la guía, puedes aceptar automáticamente las ediciones o aceptar manualmente; si falta precisión, itera, y si ya no quieres continuar puedes cancelar con Esc. La aprobación inicia la implementación y saca a Gemini CLI de Plan Mode. No es una garantía de que el resultado sea correcto: revisa los cambios con Git, ejecuta las pruebas relevantes y comprueba que no haya archivos inesperados.
Como cierre práctico, compara la página antes y después en móvil y escritorio, verifica que el proyecto destacado aparece en el orden acordado y prueba que los enlaces y formularios siguen funcionando. Si el diff incluye una dependencia, una ruta o un archivo ajeno al objetivo, detén esa parte y pide una explicación antes de continuar.
Permisos, archivos del plan y límites
La separación fundamental es entre lectura del proyecto y escritura del plan. El modo restringe las herramientas disponibles durante la planificación; permite herramientas de lectura y búsqueda y la escritura de archivos de plan en una ubicación autorizada. No lo describas como un sandbox absoluto: hay que considerar las políticas configuradas, herramientas MCP, acceso a red y otros procesos del entorno según el caso.
El motor de políticas oficial define decisiones allow, deny y ask_user, que pueden depender de la herramienta, sus argumentos, modalidad y entorno interactivo. Las reglas más específicas de la organización pueden afectar qué ocurre. Además, la documentación de políticas consultada señala una limitación importante: las políticas de nivel Workspace en .gemini/policies figuran como no funcionales actualmente; no confíes en ellas para hacer cumplir una restricción. Usa las políticas User o Admin cuando corresponda y comprueba la referencia vigente.
El plan puede contener nombres de archivos o detalles de arquitectura. Trátalo como documentación del proyecto y aplica las mismas precauciones de almacenamiento y acceso que al historial de la sesión. Para criterios de privacidad laboral y manejo de información, consulta privacidad de la IA en el trabajo. Para comparar herramientas y flujos sin confundirlo con esta guía paso a paso, revisa Gemini CLI frente a Claude Code y Gemini Code Assist frente a CLI.
Precaución con la ejecución no interactiva
En scripts o pipelines sin una persona delante, el flujo no puede quedarse esperando confirmación. La documentación de Plan Mode indica que las transiciones de entrada y salida pueden aprobarse automáticamente y que, al salir hacia la implementación, Gemini CLI pasa a YOLO para ejecutar el plan sin detenerse ante aprobaciones interactivas. YOLO permite aprobar herramientas automáticamente, así que no es equivalente a una revisión paso a paso.
No uses esa combinación sobre un repositorio importante solo porque el comando parece una planificación inofensiva. Primero prueba en un repositorio desechable, limita permisos en el entorno que sí controle tu organización y revisa con cuidado el comando completo y la configuración. Para ejecución automatizada, la política efectiva y la versión instalada importan más que la promesa general de que el plan era de solo lectura.
Errores habituales
La opción no se reconoce. Revisa la ortografía y ejecuta la ayuda de la versión instalada; confirma también que estás ejecutando Gemini CLI y no otra herramienta con una interfaz parecida. Los comandos y atajos cambian con el tiempo.
Shift+Tab no cambia de modo. Puede que la CLI esté ocupada o mostrando una confirmación, situaciones en las que Plan puede desaparecer de la rotación. Espera a que termine o usa /plan en la entrada.
El plan no refleja el alcance. Aclara el resultado, los elementos que no se deben tocar y las pruebas esperadas; después pide una revisión del plan. No apruebes un documento que cambie requisitos por su cuenta.
El modo no interactivo ejecuta más de lo previsto. Recuerda la transición automática a YOLO descrita en la documentación. Evita CI o scripts contra código real hasta haber probado la política y el impacto en un entorno aislado.
Aprender a dar instrucciones, revisar resultados y trabajar con proyectos reales es parte de aplicar IA con criterio. Si quieres practicar ese enfoque en una formación aplicada a proyectos audiovisuales, consulta el curso de IA audiovisual; revisa su ficha para conocer el temario y condiciones actuales. También puedes empezar por el test gratuito ¿Cuánto te queda?.
Preguntas frecuentes
¿Plan Mode modifica mi proyecto?
Su propósito es investigar y diseñar antes de implementar. La guía delimita la escritura permitida a archivos Markdown del plan, no a los archivos de código del proyecto. Al aprobar el plan se inicia la ejecución; revisa las políticas activas y el diff posterior, pues el modo no debe confundirse con aislamiento total.
¿Cómo activo el modo plan al iniciar Gemini CLI?
Ejecuta gemini --approval-mode=plan para iniciar una sesión así. Para establecerlo como valor por defecto, usa /settings y selecciona Plan como Default Approval Mode. Consulta la documentación de tu versión si la interfaz ha cambiado.
¿Cómo se pasa del plan a la ejecución?
Revisa el plan Markdown y apruébalo en la confirmación formal. Esa aprobación inicia la implementación y sale de Plan Mode. Si aún hay dudas, añade comentarios o modifica el plan y vuelve a revisarlo antes de aceptar.
¿Qué cambia en ejecución no interactiva?
Sin una persona para responder confirmaciones, la transición hacia implementación puede pasar automáticamente a YOLO según la documentación. Eso puede aprobar herramientas sin interacción; prueba primero con un repositorio descartable y no lo trates como equivalente al modo interactivo.