Integrar asistencia de IA directamente en Visual Studio Code agiliza las rutinas de desarrollo, acelera la depuración y simplifica la navegación en repositorios desconocidos. Codeium ofrece completado de código en línea impulsado por IA y chat interactivo fundamentado en el contexto del repositorio local, brindando a los desarrolladores asistencia ágil de programación sin barreras de suscripción. Esta guía detalla cómo instalar y autenticar la extensión de Codeium en VS Code, dominar los atajos de autocompletado, aprovechar las herramientas de chat contextual, configurar los límites de privacidad y evaluar las diferencias entre el plan gratuito individual y los planes empresariales para equipos.
Instalación de la extensión Codeium en VS Code
La configuración de Codeium comienza directamente dentro de la interfaz de Visual Studio Code. Dado que la extensión se apoya en un proceso en segundo plano ligero para coordinar la inferencia del modelo, la instalación inicial toma solo unos minutos.
- Abre Visual Studio Code y dirígete a la vista de Extensiones haciendo clic en el icono de Extensiones en la barra de actividad izquierda, o presionando
Ctrl+Shift+Xen Windows y Linux (Cmd+Shift+Xen macOS). - En la barra de búsqueda del marketplace en la parte superior del panel de Extensiones, escribe
Codeium(oWindsurf, que comparte la extensión de plataforma subyacente). - Localiza la extensión oficial publicada por Codeium y haz clic en Install.
- Una vez completada la instalación, aparecerá un widget de Codeium en la barra de estado en la parte inferior del editor, junto con un icono dedicado de chat de Codeium en la barra de actividad.
La extensión está diseñada para funcionar junto con los servidores de lenguaje y linters estándar, lo que permite a los desarrolladores mantener intactas sus configuraciones existentes de IntelliSense mientras incorporan sugerencias de IA.
Autenticación e inicialización del servidor de lenguaje
Antes de generar completados o abrir conversaciones, la extensión debe autenticar tu cuenta de desarrollador e inicializar su servidor de lenguaje local.
- Activar la autenticación: Tras la instalación inicial, aparece una notificación en la esquina inferior derecha de VS Code solicitándote iniciar sesión. Si no aparece la notificación, haz clic en el widget de perfil de Codeium en la barra de estado o en el icono de cuenta de usuario en la parte inferior de la barra de actividad izquierda para iniciar la autenticación.
- Autorización en el navegador: Al hacer clic en el aviso de inicio de sesión se abrirá una página de autenticación en tu navegador web predeterminado. Inicia sesión con tus credenciales existentes o crea una nueva cuenta. Una vez autorizado, el navegador te solicitará volver a Visual Studio Code.
- Gestión de token en entornos remotos: Al trabajar en entornos basados en navegador, sesiones remotas por SSH, GitHub Codespaces o Gitpod donde la redirección del navegador no puede comunicarse directamente con el editor, la pantalla de autorización proporciona un token de acceso. Copia este token, abre la paleta de comandos de VS Code (
Ctrl+Shift+PoCmd+Shift+P), ejecuta el comandoCodeium: Provide Auth Tokeny pega el valor. - Descarga del servidor de lenguaje: Una vez autenticado, la extensión descarga e inicia automáticamente el binario del servidor de lenguaje correspondiente a la arquitectura de tu sistema operativo. Esta descarga única suele completarse en un lapso de 10 a 30 segundos y gestiona la tokenización, la recopilación de contexto local y la comunicación con la API.
Cuando el widget de la barra de estado muestra una marca de verificación activa o un indicador de perfil, Codeium está totalmente listo para las tareas de programación cotidianas.
Dominio del completado de código en línea
Codeium proporciona sugerencias de autocompletado en línea en tiempo real (texto fantasma) a medida que escribes en el búfer del editor. El motor evalúa la posición del cursor, la lógica precedente, los archivos circundantes y las importaciones activas para proponer bloques de código.
Atajos esenciales de autocompletado
El uso eficiente del autocompletado depende de saber cómo aceptar, descartar o ajustar el código propuesto sin interrumpir tu ritmo de escritura:
| Acción | Atajo en macOS | Atajo en Windows y Linux | Descripción |
|---|---|---|---|
| Aceptar sugerencia | Tab | Tab | Inserta todo el bloque de código sugerido en el documento. |
| Descartar sugerencia | Esc | Esc | Rechaza el texto fantasma propuesto sin modificar el documento. |
| Aceptar palabra por palabra | Cmd+Right Arrow | Ctrl+Right Arrow | Acepta únicamente la siguiente palabra o token para una adopción parcial. |
| Alternar variantes | Option+] / Option+[ | Alt+] / Alt+[ | Navega hacia adelante o hacia atrás entre las distintas alternativas de completado generadas. |
| Activar manualmente | Option+\ | Alt+\ | Solicita una nueva sugerencia bajo demanda cuando el autocompletado no se activa de forma automática. |
Uso de comentarios y firmas de funciones como prompts
El autocompletado funciona mejor cuando recibe señales de contexto claras. En lugar de escribir código repetitivo manualmente, puedes recurrir al desarrollo guiado por comentarios para orientar el resultado:
- Firmas descriptivas: Escribir una firma de función explícita con anotaciones de tipo (como interfaces de TypeScript o anotaciones de tipo en Python) guía al modelo para generar el cuerpo completo de la función adaptado a los parámetros de entrada y tipos de retorno especificados.
- Comentarios en lenguaje natural: Colocar un comentario conciso antes de un bloque de lógica (por ejemplo,
// parse query parameters and validate timestamp within range) orienta a Codeium para sintetizar la implementación correspondiente con limpieza. - Relleno en el medio (Fill-in-the-Middle / FIM): Codeium analiza el código tanto por encima como por debajo del cursor, lo que te permite insertar lógica faltante dentro de funciones existentes conservando las sentencias de retorno y los ámbitos de variables posteriores.
Interacción con Codeium Chat
Codeium Chat proporciona un asistente conversacional integrado en el editor, lo que permite a los desarrolladores consultar, refactorizar y generar rutinas complejas sin salir de su espacio de trabajo.
Apertura del chat y referencia a contextos
Abre el panel de chat haciendo clic en el icono de Codeium en la barra de actividad, o presionando Cmd+Shift+A en macOS (Ctrl+Shift+A en Windows y Linux). Como alternativa, presiona Cmd+Shift+L o Ctrl+Shift+L para abrir la barra de prompt de chat rápido.
El motor de chat utiliza menciones estructuradas @-mentions para incorporar partes precisas de tu base de código en el contexto del prompt:
@functiony@class: Inyecta símbolos de sintaxis analizados en el prompt. El analizador de Árbol de Sintaxis Abstracta (AST) del motor indexa clases y funciones en los principales lenguajes, incluidos Python, TypeScript, JavaScript, Go, Java, C++, Rust y C#.@filey@directory: Incorpora el contenido de un archivo o jerarquía de carpetas específicos directamente en la sesión de chat, garantizando que el modelo haga referencia a las convenciones del proyecto.@diff: Introduce los cambios de Git preparados o sin preparar en la conversación, facilitando la revisión de modificaciones, la verificación de casos extremos o la redacción de mensajes de commit.- Salida de terminal: En VS Code, puedes incluir la salida reciente de la terminal para depurar errores de compilación, ejecuciones de pruebas fallidas o trazas de pila sin necesidad de copiar y pegar líneas manualmente.
Comandos de barra diagonal y acciones en el editor
Codeium Chat incluye comandos de barra diagonal integrados para agilizar tareas repetitivas de desarrollo:
/explain: Analiza el bloque de código resaltado o el archivo activo, desglosando el flujo de ejecución, los posibles modos de fallo y la complejidad algorítmica./refactor: Propone implementaciones modernizadas, más limpias o más eficientes del código seleccionado, identificando condiciones redundantes y bucles subóptimos./test: Genera la estructura de pruebas unitarias exhaustivas que cubren flujos normales y condiciones límite adaptadas a la biblioteca de pruebas activa de tu proyecto (como Jest, Pytest o JUnit)./docstring: Genera comentarios de documentación estandarizados que se ajustan a las convenciones del lenguaje, como JSDoc, PEP 257 o el formato doc de Go.
Las respuestas del chat incluyen acciones con un solo clic: puedes copiar fragmentos al portapapeles o hacer clic en Insert at Cursor para colocar el código generado directamente en el búfer del editor activo en la posición actual de inserción.
Configuración de reconocimiento de contexto y controles de privacidad
Codeium utiliza un motor de contexto local basado en Generación Aumentada por Recuperación (RAG) que escanea tu repositorio para localizar definiciones, importaciones y documentación relevantes antes de consultar el backend de IA. Una configuración adecuada garantiza una alta precisión en las sugerencias mientras protege los archivos confidenciales.
Exclusión de archivos confidenciales con .codeiumignore
Para evitar que activos sensibles, archivos de entorno o módulos propietarios sean indexados o analizados, añade un archivo .codeiumignore en la raíz de tu proyecto. La sintaxis sigue las reglas de .gitignore:
# Archivos de configuración confidenciales
.env
.env.*
secrets/
*.pem
*.key
# Salidas de compilación y recursos pesados
dist/
build/
node_modules/
vendor/
# Documentación interna de cumplimiento normativo
compliance/internal-audits/
Los archivos que coincidan con estos patrones se excluyen de la indexación local, del autocompletado con @-mention en el chat y de la construcción de prompts de autocompletado.
Instrucciones personalizadas persistentes para el chat
En la configuración de la extensión (Settings > Extensions > Codeium), puedes definir pautas de chat personalizadas y persistentes. Por ejemplo, puedes indicar al asistente que responda siempre con tipos estrictos de TypeScript, priorice patrones de programación funcional o evite APIs obsoletas específicas. Estas instrucciones se aplican globalmente a todas las conversaciones dentro de ese espacio de trabajo.
Evaluación de los planes Individual, Teams y Enterprise
Al adoptar Codeium, los líderes de ingeniería y los desarrolladores individuales deben elegir el nivel que mejor se adapte a su escala de colaboración, preferencia de modelos y requisitos de cumplimiento normativo.
| Dimensión | Plan Free Individual | Plan Pro Individual | Plan Teams | Plan Enterprise |
|---|---|---|---|---|
| Público objetivo | Desarrolladores independientes, estudiantes, colaboradores de código abierto | Desarrolladores profesionales individuales | Equipos de ingeniería pequeños a medianos | Grandes empresas con estrictas exigencias de cumplimiento |
| Autocompletado de código | Completados de código en línea ilimitados | Completados de código en línea ilimitados | Completados de código en línea ilimitados | Completados de código en línea ilimitados |
| Acceso a modelos | Modelos base rápidos para completado y chat | Acceso a modelos de frontera destacados (p. ej., Claude 3.5 Sonnet, GPT-4o) | Modelos de frontera destacados con cupo compartido | Enrutamiento de modelos personalizado, modelos de frontera o despliegue autohospedado |
| Contexto e indexación | Indexación RAG en el espacio de trabajo local | Ventana de contexto ampliada y mayores límites de indexación local | Contexto compartido e indexación centralizada de repositorios | Indexación remota multirrepositorio en GitHub, GitLab y BitBucket |
| Administración | Gestión de cuenta individual | Gestión de facturación individual | Consola de administración central, asignación de puestos y facturación compartida | Portal de administración empresarial con RBAC, aprovisionamiento SCIM y SSO |
| Gobernanza de datos | Telemetría estándar (con opción de exclusión) | Telemetría estándar con controles de privacidad | Telemetría a nivel de equipo y analíticas de uso | Acuerdos estrictos de retención cero de datos, cumplimiento de FedRAMP / SOC 2 |
Selección del plan adecuado
- Free Individual: Ofrece un excelente retorno de inversión para desarrolladores que buscan asistencia rápida y cotidiana de codificación sin tarifas de suscripción. El autocompletado permanece sin restricciones y la indexación del espacio de trabajo local cubre proyectos de un solo repositorio sin inconvenientes.
- Pro Individual: Ideal para desarrolladores que trabajan en lógica compleja y necesitan modelos de razonamiento de frontera como Claude 3.5 Sonnet o GPT-4o para consultas arquitectónicas complejas y razonamiento en contextos extensos.
- Teams: Recomendado cuando las organizaciones de ingeniería requieren aprovisionamiento centralizado de puestos, visibilidad de la adopción de herramientas mediante métricas agregadas de aceptación y facturación consolidada por tarjeta o factura.
- Enterprise: Imprescindible para sectores regulados que exigen inicio de sesión único (SAML, Okta, Azure AD), incorporación automatizada mediante SCIM, garantías contractuales de que el código propietario no se conserva ni se utiliza para entrenar modelos públicos, e indexación remota de múltiples repositorios.
Solución de problemas comunes de la extensión
Si la extensión de Codeium presenta un comportamiento inesperado o deja de proporcionar completados, revisa estos pasos estándar de resolución de problemas:
- Revisar registros de la extensión: Abre la paleta de comandos (
Ctrl+Shift+P/Cmd+Shift+P), escribeDeveloper: Show Logs, seleccionaExtension Hosty luego eligeCodeiumoWindsurf. La revisión de las entradas recientes revelará errores de conexión, tiempos de espera de autenticación o excepciones del analizador sintáctico. - Proxy corporativo e interceptación SSL: Si trabajas detrás de un firewall corporativo o un proxy Zscaler, asegúrate de que Visual Studio Code tenga configurado su proxy bajo
http.proxyen los ajustes. Si se requieren autoridades de certificación personalizadas, configurahttp.proxyStrictSSL: falseo vincula el almacén de certificados del sistema al certificado CA raíz de tu organización. - Reinstalar el servidor de lenguaje: Si el binario del servidor de lenguaje falla al ejecutarse o se daña durante una actualización, deshabilita y vuelve a habilitar la extensión en el panel de Extensiones, o elimina la carpeta Codeium dentro de
~/.codeiumpara forzar una descarga limpia del binario de ejecución. - Conflictos de atajos de teclado: Si
Tabno acepta los completados, revisaPreferences: Open Keyboard Shortcutspara asegurarte de que extensiones de terceros (como otros gestores de fragmentos de código u otras herramientas de IA) no anulen los comandoseditorTabocodeium.acceptCompletion.