Herramientasgemini cli
Gemini coding agent: primera tarea con Gemini CLI
Prueba Gemini CLI en un repositorio aislado: configura el acceso, pide un cambio pequeño, revisa el diff y ejecuta las pruebas antes de integrarlo.
- Autor: humAIns
- 8 min de lectura
índice · 6 apartados
Gemini CLI puede ayudarte a entender un repositorio, proponer código y trabajar en cambios de varios pasos desde el terminal. Para probar este agente de programación sin arriesgar un proyecto real, usa una copia desechable, pide una modificación pequeña y comprueba cada archivo cambiado antes de ejecutar las pruebas. La disponibilidad y autenticación dependen del método y la cuenta: no todas las funciones comparten las mismas condiciones de acceso.
Qué es Gemini CLI y cómo se diferencia de Jules
Gemini CLI es un agente de código de código abierto que lleva Gemini al terminal. El proyecto oficial describe un ciclo de razonamiento y acción con herramientas incorporadas y conexiones MCP locales o remotas. Puede explorar archivos, responder preguntas sobre el código y ayudar a corregir errores o proponer funcionalidades. No es simplemente un chat que completa una línea: puede operar sobre el directorio en el que lo inicias y usar herramientas habilitadas.
Jules resuelve una tarea diferente. Es un agente asíncrono alojado en la nube: eliges un repositorio y una rama, le describes el trabajo y revisas el plan y el diff que prepara. Gemini CLI se inicia en tu entorno; Jules ejecuta el trabajo en una máquina virtual en la nube y puede preparar una rama o una propuesta de integración. No son dos nombres para el mismo producto, y sus accesos, permisos y flujo de revisión no deben darse por equivalentes.
Para ampliar la diferencia entre agentes, consulta la página oficial de Jules y la comparativa de IA para programar, que ayuda a situar estas herramientas frente a otros asistentes. Si vas a conectar herramientas externas, revisa también cómo funciona Gemini CLI con servidores MCP.
Requisitos y configuración con cautela
El README oficial recomienda instalar el paquete @google/gemini-cli mediante npm o ejecutarlo con npx. Para hacerlo necesitas un entorno compatible con Node.js y npm; consulta los requisitos de la versión vigente en la guía de instalación oficial. Una instalación global se inicia así:
npm install -g @google/gemini-cli
Comprueba primero qué producto necesitas. El README vigente del repositorio distingue Gemini CLI de Antigravity CLI y señala que Gemini CLI está orientado a organizaciones con Gemini Code Assist Standard o Enterprise, Code Assist for GitHub en Google Cloud y ciertos flujos con claves de API o Vertex AI. La página de Gemini Code Assist describe cuotas de ediciones, pero no conviene interpretar páginas antiguas o generales como confirmación de que una cuenta personal concreta tiene acceso. Verifica las condiciones en la documentación oficial de Gemini CLI y en el README actual del proyecto antes de elegir autenticación o presupuestar uso.
El método de autenticación depende de tu cuenta y del entorno. La documentación del proyecto explica inicio de sesión con Google para licencias compatibles, clave Gemini API y Vertex AI. Si utilizas una clave, guárdala en el mecanismo de secretos de tu sistema o en una variable de entorno privada; nunca la pegues en el prompt, en un archivo versionado, una captura ni una conversación compartida. No publiques identificadores de proyecto ni credenciales en un repositorio.
Primera tarea: un cambio pequeño en una copia
Elige un repositorio de ejemplo, una rama temporal o una copia local de un proyecto no sensible. No empieces con el código de producción, credenciales reales ni datos de clientes. Revisa que el directorio esté limpio con git status y crea una rama o una copia antes de iniciar el agente.
Entra en el directorio de prueba y ejecuta gemini. Una tarea inicial útil para una persona que trabaja con una web podría ser añadir una función pequeña de formato para mostrar un importe con dos decimales. Mejor aún, pide primero que localice el lugar adecuado y explique la propuesta sin tocar archivos. Cuando entiendas el plan, puedes autorizar un cambio limitado.
Prueba una instrucción con alcance, restricciones y comprobación explícitos:
En este repositorio de prueba, busca dónde se muestran los importes.
Propón una función pequeña que formatee un importe con dos decimales.
Antes de editar, explica qué archivo cambiarías. No instales dependencias,
no modifiques otros archivos y no ejecutes comandos destructivos. Después,
resume el diff y dime qué prueba existente debería ejecutar.
La instrucción no sustituye los controles del programa, pero ayuda a delimitar el trabajo. Si la propuesta implica cambiar archivos inesperados, añadir dependencias o realizar acciones fuera de alcance, recházala y aclara la petición. Si no conoces el repositorio, solicita primero una explicación y comprueba por tu cuenta que la función elegida respeta las convenciones del proyecto.
Revisar cambios, ejecutar pruebas y limitar permisos
Al terminar, no integres a ciegas. Inspecciona el estado y el diff con Git:
git status --short
git diff --check
git diff
Confirma que solo se modificaron los archivos previstos, que no aparecieron claves ni datos privados y que el cambio resuelve el requisito. Lee especialmente cualquier modificación en configuración, scripts de instalación o dependencias. Ejecuta las pruebas y comprobaciones que ya documente el propio repositorio; no asumas que el agente las ha ejecutado bien solo porque lo diga. Si falla una prueba, identifica si la causa es el cambio, el entorno o un fallo previo antes de continuar.
Gemini CLI puede utilizar herramientas de terminal y de sistema de archivos. Reduce el riesgo con un directorio de trabajo de prueba, una cuenta autorizada, permisos mínimos y confirmación humana de operaciones con efectos importantes. No habilites un modo que omita confirmaciones para un primer ensayo. La documentación oficial también explica opciones de confianza y sandbox; verifica su disponibilidad y comportamiento en tu versión y sistema operativo, porque las opciones cambian. No des por supuesto que una carpeta de prueba vuelve inocua una orden de terminal.
Si el diff es correcto, las pruebas pasan y tienes permiso para continuar, integra el cambio según el flujo de tu equipo. Si no, descártalo o vuelve a una versión limpia con Git. Conserva una copia del diff si necesitas explicar qué ocurrió.
Errores habituales, costes y datos sensibles
Un error frecuente es instalar el paquete y asumir que la autenticación funcionará automáticamente. El acceso depende del tipo de cuenta, la licencia y la configuración; un fallo de acceso no se soluciona copiando una clave de otra persona. Otro es ejecutar el agente desde la raíz de un repositorio importante sin revisar antes el estado de Git: puede afectar más archivos de los previstos.
En coste, separa el método de acceso. La disponibilidad y las cuotas de Gemini Code Assist se rigen por la edición aplicable y el README indica además opciones de API con facturación por uso y Vertex AI. No ofrecemos una cifra universal de cuota o precio porque puede cambiar según producto, región y cuenta. Comprueba la consola y la página oficial de precios aplicable antes de un uso intensivo; establece límites si empleas una API facturada.
Trata el código privado como información sensible. Antes de usar el CLI, confirma que tu organización permite enviar ese contenido al servicio y qué condiciones de tratamiento corresponden a tu plan. No incluyas claves, tokens, datos personales, código de clientes ni ficheros de configuración secretos en un prompt. Para una primera prueba bastan archivos ficticios y un repositorio de ejemplo.
Si tu objetivo es aprender a integrar IA en procesos audiovisuales, consulta el curso práctico de IA audiovisual: es una formación de esa línea, no un curso específico de Gemini CLI. También puedes probar el diagnóstico «¿Cuánto te queda?» para orientar tu siguiente paso de aprendizaje.
Preguntas frecuentes
¿Gemini CLI y Jules son el mismo producto?
No. Gemini CLI se usa desde terminal en tu entorno de trabajo. Jules ejecuta tareas de forma asíncrona en la nube sobre un repositorio conectado. El modo de acceso, el entorno de ejecución y la forma de revisar los cambios son diferentes.
¿Necesito una cuenta?
Necesitas una vía de autenticación con acceso habilitado. Puede depender de una licencia organizativa, de una configuración de Google Cloud o de una clave API con facturación. Revisa el README y la documentación actuales antes de contar con que tu cuenta sirve.
¿Puede modificar archivos?
Sí, puede leer y escribir archivos mediante las herramientas disponibles. Trabaja sobre una copia, limita el alcance de la petición y revisa las confirmaciones y permisos antes de permitir cambios.
¿Cómo reviso lo que propone?
Examina git diff, valida los archivos modificados y ejecuta las pruebas pertinentes. Comprueba también que el cambio no filtre secretos ni altere requisitos ajenos a la tarea. Solo integra cambios que entiendas y que puedas justificar.
Sigue leyendo en humAIns