En este documento, se describe cómo puedes usar Gemini Code Assist Standard y Enterprise, un colaborador potenciado por IA en tu IDE, para ayudarte a hacer lo siguiente en VS Code o IntelliJ y otros IDE de JetBrains compatibles:
- Recibir orientación para resolver problemas con tu código
- Genera código para tu proyecto.
- Administra el contexto de tu proyecto especificando archivos y carpetas.
- Crea comandos y reglas personalizados.
La personalización de código te permite obtener sugerencias de código basadas en la base de código privada de tu organización directamente desde Gemini Code Assist Enterprise. Obtén más información para configurar la personalización del código.
Este documento está dirigido a desarrolladores de todos los niveles de habilidad. Se supone que tienes conocimientos prácticos de VS Code o IntelliJ y otros IDE de JetBrains compatibles, y que conoces Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en el editor de Cloud Shell, Cloud Workstations y Android Studio.
Antes de comenzar
VS Code
Configura Gemini Code Assist Standard o Enterprise si aún no lo hiciste.
Antes de probar las capacidades de Gemini Code Assist en tu archivo de código, asegúrate de que el lenguaje de programación del archivo sea compatible. Para obtener más información sobre los lenguajes de programación admitidos, consulta Lenguajes de programación admitidos.
Si prefieres usar tu IDE detrás de un proxy, consulta Conexiones de red en Visual Studio Code.
IntelliJ
Configura Gemini Code Assist Standard o Enterprise si aún no lo hiciste.
Antes de probar las capacidades de Gemini Code Assist en tu archivo de código, asegúrate de que el lenguaje de programación del archivo sea compatible. Para obtener más información sobre los lenguajes de programación admitidos, consulta Lenguajes de programación admitidos.
Si prefieres usar tu IDE detrás de un proxy, consulta Proxy HTTP.
Usa el chat de Gemini Code Assist para explicar tu código
En esta sección, le darás una instrucción a Gemini Code Assist para que proporcione una explicación de tu código existente.
VS Code
Para obtener una explicación de tu código, sigue estos pasos:
Abre el archivo de código.
En la barra de actividad de tu IDE, haz clic en spark Gemini Code Assist.
En el panel de Gemini Code Assist, ingresa la instrucción
Explain this code to me
y haz clic en send Enviar.Gemini Code Assist usa el código de tu archivo de código como referencia para tu instrucción y responde con una explicación del código.
Para hacer referencia a un bloque de código específico en lugar de todo el código del archivo, puedes seleccionar el bloque en tu archivo de código y, luego, solicitarle ayuda a Gemini Code Assist.
IntelliJ
Para obtener una explicación de tu código, sigue estos pasos:
En tu IDE, abre el archivo de código.
En la ventana de la herramienta Gemini Code Assist, ingresa la instrucción
Explain this code to me
y haz clic en Enviar.
Gemini Code Assist usa el código de tu archivo de código como referencia para tu instrucción y responde con una explicación del código.
Si solo quieres una explicación de una parte específica de tu código, puedes seleccionar cierto código y, luego, volver a solicitarle a Gemini Code Assist. Gemini Code Assist solo usará el código seleccionado como referencia para su respuesta generada.
Cuando Gemini Code Assist te proporcione código en su respuesta, puedes seleccionar las siguientes opciones que se enumeran al final de la respuesta:
Insert at Cursor: Inserta el código generado en tu archivo actual, en la posición actual del cursor.
Insertar en archivo nuevo: Abre un archivo nuevo y, luego, inserta el código generado en él.
Estas opciones están disponibles cuando Gemini Code Assist identifica el lenguaje que se usa en tu bloque de código y si este lenguaje es compatible con tu IDE actual.
Cómo ver el historial de consultas
Si quieres volver a usar tus instrucciones anteriores, puedes encontrarlas en tu Historial de consultas en la ventana de herramientas de Gemini Code Assist haciendo clic en schedule Mostrar historial de consultas.
Crea varios chats
Puedes crear varios chats con Gemini Code Assist que contengan su propio contexto, separado de otros chats. En tu historial de chat, se muestran tu primer chat y la marca de tiempo de la última actualización. Hay un límite de 20 chats. Cuando alcances este límite, el chat más antiguo se borrará automáticamente cuando agregues uno nuevo.
VS Code
- Para agregar un chat nuevo, haz clic en agregar Nuevo chat y escribe tu instrucción en el campo de texto. Después de ingresar la instrucción, Gemini Code Assist crea el nuevo chat.
- Para acceder a tu chat anterior, haz clic en Historial Reanudar chat anterior. Aparecerá una lista de tus chats. Selecciona el chat que quieres ver.
- Para borrar una conversación de chat, haz clic en Reanudar chat anterior y, luego, en borrar Borrar junto al chat que quieras borrar.
IntelliJ
Por el momento, esta función no es compatible con Gemini Code Assist para IntelliJ ni otros IDE de JetBrains compatibles.
Cómo restablecer el historial de chat
Gemini Code Assist usa el historial de chat para obtener contexto adicional cuando responde a tus instrucciones. Si tu historial de chat ya no es relevante para lo que intentas lograr, puedes restablecerlo.
Administra tu chat
Para administrar la configuración del chat de Gemini Code Assist, haz lo siguiente:
Cómo configurar el desplazamiento automático
VS Code
De forma predeterminada, Gemini Code Assist se desplaza automáticamente por el chat. Para inhabilitar este comportamiento, realiza las siguientes tareas:
Navega a Configuración > Extensiones > Gemini Code Assist.
Busca el parámetro de configuración Desplazamiento automático y desmarca la casilla de verificación.
IntelliJ
Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.
Cómo detener un chat en curso
VS Code
Para detener una respuesta de chat en curso, presiona detener Detener:
IntelliJ
Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.
Cómo configurar el panel de vista previa
De forma predeterminada, está habilitado el parámetro de configuración del panel de vista previa para el chat de Gemini Code Assist. Con este parámetro de configuración habilitado, el bloque de código de vista previa en el chat de Gemini Code Assist muestra las primeras 6 líneas de código. Puedes expandir y contraer bloques de código.
Para cambiar el parámetro de configuración predeterminado, realiza las siguientes tareas:
VS Code
En tu IDE, navega a Configuración > Extensiones > Gemini Code Assist.
Busca el parámetro de configuración Default Code Block Display.
Selecciona una de las siguientes opciones:
Expandido: Expande automáticamente todos los bloques de código en las respuestas del chat de Gemini Code Assist.
Vista previa: Solo muestra las primeras 6 líneas de código del bloque de código. Debes expandir el bloque de código en la respuesta del chat de Gemini Code Assist para ver el resto del código. Esta es la configuración predeterminada.
Contraer: Contrae automáticamente todos los bloques de código en las respuestas del chat de Gemini Code Assist.
Cuando se vuelva a cargar el IDE, se aplicará el nuevo parámetro de configuración.
IntelliJ
Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.
Cómo solicitarle ayuda a Gemini Code Assist con el código seleccionado a través del chat
Gemini Code Assist puede realizar tareas o responder tus preguntas según el código que selecciones. Para obtener código generado basado en una instrucción con código seleccionado, sigue estos pasos:
VS Code
En la barra de actividades, haz clic en spark Gemini Code Assist para abrir el panel Gemini Code Assist.
En tu archivo de código, selecciona un bloque de código.
En el campo de texto del panel de Gemini Code Assist, ingresa una instrucción para el código seleccionado.
Por ejemplo, selecciona una función en tu código y, luego, ingresa la instrucción
Write a unit test for this function
.Gemini usa el código que seleccionaste como referencia y responde a tu instrucción.
IntelliJ
En la barra de actividades, haz clic en spark Gemini Code Assist para abrir la ventana de herramientas de Gemini Code Assist.
En tu archivo de código, selecciona un bloque de código.
En el campo de texto de la ventana de herramientas de Gemini Code Assist, ingresa una instrucción para el código seleccionado.
Por ejemplo, selecciona una función en tu código y, luego, ingresa la instrucción
Write a unit test for this function.
.Gemini Code Assist usa el código seleccionado como referencia y responde a tu instrucción.
Agregar fragmentos de código seleccionados al contexto
Puedes seleccionar, adjuntar y dirigir Gemini Code Assist para que se centre en fragmentos de código. La selección de fragmentos de código permite el análisis discreto de bloques de código más pequeños en lugar de archivos completos.
Cuando seleccionas un fragmento de código en tu archivo de código, puedes indicarle a Gemini Code Assist que lo agregue al cajón de contexto.
Todo lo que se selecciona en la ventana del editor, pero que aún no se agregó al panel de contexto, también se incluye automáticamente en el contexto. Los fragmentos de código seleccionados solo se muestran durante un turno de chat. No persistirán en el panel contextual, pero permanecerán en el historial de chat de Gemini Code Assist.
En esta sección, agregarás un fragmento de código seleccionado a tu contexto y obtendrás una explicación sobre el fragmento de código de Gemini Code Assist:
VS Code
En tu archivo de código, selecciona un fragmento de código.
En el campo de texto de Gemini Code Assist Chat, haz clic en Agregar al contexto del chat.
Gemini Code Assist agrega el fragmento de código seleccionado al panel Context Drawer.
En el campo de texto del chat de Gemini Code Assist, ingresa la instrucción
what does this code do?
.Gemini Code Assist responde a tu instrucción según el fragmento de código que seleccionaste en el panel Context Drawer.
IntelliJ
Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.
Cómo solicitarle ayuda a Gemini Code Assist con la salida de la terminal seleccionada a través del chat
Gemini Code Assist puede realizar tareas o responder tus preguntas según el resultado de la terminal seleccionado. Para obtener una explicación del resultado de la terminal seleccionado, sigue estos pasos:
VS Code
En tu IDE, abre la terminal (Ver > Terminal).
Selecciona cualquier salida de la terminal.
Haz clic con el botón derecho en el resultado de la terminal seleccionado y elige Gemini Code Assist: Add to Chat Context.
Gemini Code Assist agrega el resultado de la terminal al panel Context Drawer.
En el campo de texto del chat de Gemini Code Assist, ingresa la instrucción
what does this do?
.Gemini Code Assist responde a tu instrucción en función del resultado de la terminal que seleccionaste en el panel Context Drawer.
IntelliJ
Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.
Cómo especificar archivos y carpetas en el contexto de tu espacio de trabajo
Puedes especificar archivos o carpetas en tu espacio de trabajo para que Gemini Code Assist los use como contexto. Cuando especificas una carpeta, Gemini Code Assist usa los archivos de la carpeta y los de las subcarpetas como contexto.
VS Code
Para especificar archivos o carpetas en tu instrucción de chat, escribe @ y selecciona el archivo o la carpeta que quieras especificar.
Para obtener una explicación sobre las diferencias entre dos archivos de tu base de código, sigue estos pasos:
En la barra de actividades, haz clic en spark Gemini Code Assist.
En el panel Gemini Code Assist, ingresa la instrucción
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
y presiona Intro (para Windows y Linux) o Retorno (para macOS), o bien Tab. También puedes hacer clic en el nombre del archivo en la lista para seleccionarlo. Si haces clic en el nombre del archivo, se agregará al contexto de la instrucción y se abrirá en tu IDE.
Gemini Code Assist responde a tu instrucción mientras usa los dos archivos que especificaste para el contexto. Gemini Code Assist también incluye los archivos que especificaste en Fuentes de contexto.
Ahora que especificaste esos archivos, puedes seguir haciendo preguntas o dando instrucciones adicionales en el mismo historial de chat, sin tener que volver a especificar los archivos.
Por ejemplo, en el panel Gemini Code Assist, ingresa la instrucción How can I
improve YOUR_FILE_NAME_1?
(sin el símbolo @) y presiona Intro (para Windows y Linux) o Retorno (para macOS).
Gemini Code Assist responderá tu consulta sobre el archivo que especificaste en tu instrucción.
IntelliJ
Para especificar archivos o carpetas en la instrucción del chat, escribe @ y selecciona los archivos o las carpetas que quieras especificar.
Para obtener una explicación sobre las diferencias entre dos archivos de tu base de código, sigue estos pasos:
En la barra de actividades, haz clic en spark Gemini Code Assist.
En el panel Gemini Code Assist, ingresa la instrucción
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
y presiona Intro (para Windows y Linux) o Retorno (para macOS), o bien Tab. También puedes hacer clic en el nombre del archivo en la lista para seleccionarlo. Si haces clic en el nombre del archivo, se agregará al contexto de la instrucción y se abrirá en tu IDE.
Gemini Code Assist responde a tu instrucción mientras usa los dos archivos que especificaste para el contexto. Gemini Code Assist también incluye los archivos que especificaste en Fuentes de contexto.
Ahora que especificaste esos archivos, puedes seguir haciendo preguntas o dando instrucciones adicionales en el mismo historial de chat, sin tener que volver a especificarlos.
Por ejemplo, en el panel Gemini Code Assist, ingresa la instrucción How can I
improve YOUR_FILE_NAME_1?
(sin el símbolo @) y presiona Intro (para Windows y Linux) o Retorno (para macOS).
Gemini Code Assist responderá tu consulta sobre el archivo que especificaste en tu instrucción.
Administra archivos y carpetas en el panel contextual
Después de especificar un archivo o una carpeta para que se usen como contexto para tus instrucciones de Gemini Code Assist, estos archivos y carpetas se colocan en el cajón de contexto, donde puedes verlos y quitarlos del contexto de la instrucción.
Para administrar los archivos y las carpetas en el panel de contexto, realiza las siguientes tareas:
VS Code
En la barra de actividad de tu IDE, haz clic en spark Gemini Code Assist.
Para ver los archivos y las carpetas en tu panel contextual, haz clic en Elementos contextuales.
Para quitar elementos del panel contextual, haz clic en close Quitar.
IntelliJ
En la barra de actividades, haz clic en spark Gemini Code Assist.
Para ver los archivos y las carpetas en el panel contextual, haz clic en Contexto.
Para quitar archivos y carpetas del panel contextual, haz clic en close Quitar.
Excluye archivos del contexto local
De forma predeterminada, Gemini Code Assist excluye los archivos del uso local en el contexto para la finalización, la generación, la transformación y el chat de código si los archivos se especifican en un archivo .aiexclude
o .gitignore
.
Para obtener información sobre cómo excluir archivos del uso local, consulta Cómo excluir archivos del uso de Gemini Code Assist.
Cómo volver a un punto de control en el chat
Después de aplicar los cambios que genera Gemini Code Assist según tu instrucción, puedes optar por revertir los archivos de código modificados a un punto de control determinado, lo que revierte todos los cambios aplicados a los archivos de código.
Volver a un punto de control no revierte los cambios manuales que hayas realizado en los archivos de código.
Para revertir tu archivo de código a un punto de control, sigue estos pasos:
VS Code
En el panel de chat de Gemini Code Assist, haz clic en Revertir al punto de control. Esto revertirá tu archivo de código al estado del punto de control anterior a las ediciones.
IntelliJ
Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.
Cómo crear comandos personalizados
De forma predeterminada, Gemini Code Assist proporciona comandos como /generate
para VS Code y Generate Code para IntelliJ y otros IDE de JetBrains compatibles.
También puedes crear tus propios comandos personalizados para realizar tareas repetitivas más rápido en tu IDE.
En esta sección, crearás un comando personalizado llamado add-comments
que agrega comentarios al código en tu archivo de código. En IntelliJ y otros IDE de JetBrains compatibles, crearás, guardarás y ejecutarás el comando personalizado desde la biblioteca de instrucciones y desde la instrucción en el editor.
VS Code
En tu archivo de código, presiona Control + I (para Windows y Linux) o Comando + I (para macOS) para abrir el menú Gemini Code Assist Quick Pick.
En el menú, busca y selecciona Preferences: Open Settings (UI).
En el campo Configuración de búsqueda, ingresa
Geminicodeassist: Custom Commands
.En el cuadro Comandos personalizados, selecciona Agregar elemento.
En el campo Elemento, ingresa
add-comments
como el nombre del comando.En el campo Valor, ingresa
add comments to all functions without comments in my code
como la instrucción.Haz clic en Aceptar.
Ahora puedes usar el comando personalizado add-comments
en tu IDE. El comando aparece en la lista de comandos del menú de selección rápida de Gemini Code Assist (Control + I para Windows y Linux, o Comando + I para macOS).
IntelliJ
En tu IDE, navega a Settings > Tools > Gemini > Prompt Library.
En la ventana Biblioteca de instrucciones, haz clic en add Agregar.
Asigna el nombre
add-comments
a tu comando personalizado.En el cuadro de texto de la Biblioteca de instrucciones, ingresa la siguiente instrucción:
Add comments to all functions without comments in this code
.Selecciona la casilla de verificación Mostrar en la instrucción del editor si no está seleccionada.
Haz clic en Aceptar para guardar el comando personalizado en la Biblioteca de instrucciones.
En tu archivo de código, destaca el código que deseas modificar.
Haz clic con el botón derecho en el código destacado y navega a Gemini > Biblioteca de instrucciones y, luego, selecciona el comando personalizado
add-comments
.Gemini Code Assist ejecuta el comando
add-comments
y agrega comentarios al código destacado.
También puedes invocar el comando personalizado con la instrucción en el editor si realizas las siguientes tareas:
En tu archivo de código, destaca el código que deseas modificar y presiona Alt+\ (para Windows y Linux) o Cmd+\ (para macOS) para abrir el menú Selección rápida de Gemini Code Assist.
En el menú, selecciona tu comando personalizado
add-comments
.Gemini Code Assist ejecuta el comando
add-comments
y agrega comentarios al código destacado.
Cómo crear reglas
Puedes crear reglas para que Gemini Code Assist las siga, y estas se incluyen en cada instrucción de chat que ingreses.
Las reglas en Gemini te permiten definir tus preferencias, como las siguientes:
- Estilo de codificación
- Formatos de salida
- Pila tecnológica
- Idioma
Por ejemplo, puedes crear una regla como "Siempre dame respuestas concisas en Kotlin".
VS Code
En tu archivo de código, presiona Control + I (para Windows y Linux) o Comando + I (para macOS) para abrir el menú Gemini Code Assist Quick Pick.
En el menú, busca y selecciona Preferences: Open Settings (UI).
En el campo Configuración de búsqueda, ingresa
Geminicodeassist: Rules
.En el campo de texto, ingresa una regla como
Always generate unit tests when creating a new function
. También puedes agregar una o más reglas con varias líneas en el campo de texto.Después de agregar reglas en la configuración de Rules, Gemini Code Assist las tendrá en cuenta para cada instrucción o solicitud que realices.
Para quitar la regla, borra el contenido del campo de texto Reglas.
IntelliJ
- Para crear una regla, ve a Configuración > Herramientas > Gemini > Biblioteca de instrucciones > Reglas y, luego, edita el texto en el editor.
Para establecer el alcance de la regla, en el menú desplegable Alcance, selecciona IDE o Proyecto.
- Las reglas a nivel del IDE son privadas y se pueden usar en varios proyectos.
- Las reglas a nivel del proyecto se pueden compartir entre los miembros del equipo que trabajan en el mismo proyecto.
Para compartir instrucciones con todo el equipo, debes agregar la carpeta
.idea
al sistema de control de versión.

Problemas conocidos
En esta sección, se describen los problemas conocidos de Gemini Code Assist:
VS Code
Las respuestas del chat pueden truncarse cuando incluyen una versión actualizada de un archivo abierto grande
Para solucionar este problema, selecciona una sección de código más pequeña y agrega una directiva adicional en la instrucción de chat, como
only output the selected code.
.Vim: No se pueden aceptar ni descartar sugerencias de generación de código, a menos que se esté en el modo de inserción
Cuando usas el complemento de Vim en modo normal, no puedes aceptar ni descartar sugerencias de código.
Para solucionar este problema, presiona I para ingresar al modo de inserción y, luego, presiona Tab para aceptar la sugerencia.
Vim: Comportamiento incoherente cuando se presiona Esc para descartar sugerencias
Cuando presionas Esc, se descartan tanto el IDE como las sugerencias de Gemini Code Assist. Este comportamiento es diferente del comportamiento que no es de Vim, en el que presionar Esc vuelve a activar Gemini Code Assist.
Los intentos de acceso se agotan
Si tus intentos de acceso siguen agotando el tiempo de espera, intenta agregar el parámetro de configuración
cloudcode.beta.forceOobLogin
a tu archivosettings.json
:"cloudcode.beta.forceOobLogin": true
Las advertencias sobre la recitación de licencias no persisten entre sesiones
Si las advertencias de recitación de licencias no persisten entre sesiones, consulta los registros persistentes:
Haz clic en Ver > Salida.
Selecciona Gemini Code Assist - Citations.
Problemas de conectividad en la ventana de salida de Gemini Code Assist
Si ves un error de conexión o algún otro problema de conectividad en la ventana de salida de Gemini Code Assist, prueba lo siguiente:
Configura tu firewall para permitir el acceso a
oauth2.googleapis.com
ycloudaicompanion.googleapis.com
.Configura tu firewall para permitir la comunicación a través de HTTP/2, que usa gRPC.
Puedes usar la herramienta
grpc-health-probe
para probar la conectividad. Una verificación exitosa genera el siguiente resultado:$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved
Si la verificación no se realiza correctamente, se mostrará el siguiente resultado:
timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s
Para obtener más detalles, ejecuta lo siguiente antes de
grpc-health-probe
:export GRPC_GO_LOG_SEVERITY_LEVEL=info
"Activar Gemini Code Assist" sigue apareciendo después de seleccionar el proyecto de Gemini Code Assist
Si seleccionaste tu proyecto según las instrucciones de esta guía, que incluyen habilitar la API de Gemini para Google Cloud, es posible que haya un problema con el servidor LS.
Para obtener más detalles sobre tu problema, realiza las siguientes acciones:
En la barra de estado, haz clic en spark Gemini Code Assist y, luego, selecciona Enviar comentarios.
Haz clic en Mostrar en cualquiera de los archivos de registro para ver más detalles y solucionar el problema.
IntelliJ
No se conocen problemas con Gemini Code Assist para IntelliJ y otros IDE de JetBrains compatibles.
Enviar comentarios
Para dejar comentarios sobre tu experiencia, sigue estos pasos:
VS Code
Puedes dejar comentarios de cualquiera de las siguientes maneras:
- En la barra de estado, haz clic en spark Gemini Code Assist y, luego, en el menú Quick Pick, selecciona Enviar comentarios.
- Abre la Paleta de comandos (
Ctrl
/Command
+Shift
+P
) y, luego, selecciona Gemini Code Assist: Send Feedback.
En el formulario, completa los campos Título y Comentarios.
En el formulario Comentarios sobre Gemini Code Assist, selecciona una opción en los menús desplegables Categoría de comentarios y Tipo.
Escribe una descripción detallada de tu experiencia en el campo Comentario.
Asegúrate de incluir tus registros de Gemini Code Assist en el informe de comentarios. De forma predeterminada, esta opción está seleccionada.
Marca o desmarca cualquiera de las otras opciones, según tus preferencias.
Haz clic en Enviar comentarios.
IntelliJ
En la barra de estado, haz clic en spark Gemini Code Assist.
Después de solicitarle ayuda a Gemini Code Assist en el chat, si no te satisface la respuesta, haz clic en thumb_down Negativo y, luego, selecciona Proporcionar comentarios.
En el campo de texto que se encuentra en la parte superior del formulario, ingresa tus comentarios.
Si quieres compartir tus registros de Gemini Code Assist, asegúrate de seleccionar los archivos de registro.
Haz clic en Enviar comentarios.
¿Qué sigue?
- Obtén más información para escribir mejores instrucciones.
- Descubre cómo Gemini para Google Cloud usa tus datos.
- Obtén más información sobre los precios de Gemini Code Assist.
- Obtén más información sobre el cumplimiento deGoogle Cloud .