Instalación
Guía paso a paso para instalar y configurar Verdent
Esta guía te muestra cómo instalar Verdent for VS Code desde el Marketplace de Visual Studio Code y completar la autenticación inicial.
Requisitos
Antes de instalar Verdent, asegúrate de que tu sistema cumpla estos requisitos previos:
Requisitos del sistema
- Visual Studio Code: versión 1.90.0 o superior
- Sistema operativo: macOS 11+, Windows 10+ o Linux (Ubuntu 20.04+, Debian 10+, RHEL 8+)
- Conexión a Internet: se requiere una conexión activa para la comunicación con el servicio de IA
Opcional pero recomendado
- Git: para la integración con el control de versiones y el seguimiento de cambios en el código
Consulta Requisitos del sistema para obtener información detallada sobre compatibilidad.
Instalación de la extensión
Verdent for VS Code se distribuye a través del Marketplace de Visual Studio Code.
Visita el Marketplace
Ve a la página de la extensión Verdent en tu navegador.
Selecciona Install
Selecciona el botón Install en la página del marketplace.
Abre en VS Code
VS Code se abrirá automáticamente e iniciará el proceso de instalación.
Abre VS Code
Inicia Visual Studio Code en tu equipo.
Accede a las extensiones
Selecciona el icono de Extensiones en la barra lateral izquierda (icono de cuatro cuadrados) o pulsa:
- macOS:
Cmd+Shift+X - Windows/Linux:
Ctrl+Shift+X
Busca Verdent
Escribe "Verdent" en el cuadro de búsqueda en la parte superior del panel de extensiones. Busca "Verdent" de Verdent AI en los resultados.
Instala
Selecciona el botón Install junto a la extensión Verdent. La instalación suele tardar unos segundos.
code --install-extension verdentai.verdentEste método resulta útil para:
- Scripts de configuración automatizada
- Instalaciones en servidores remotos vía SSH
- Configuración de entornos CI/CD
- Instalar en varias máquinas rápidamente
Si utilizas la sincronización de configuración (Settings Sync) de VS Code, Verdent se instalará automáticamente en las máquinas nuevas cuando sincronices tu lista de extensiones.
Autenticación y configuración
Tras la instalación, deberás autenticarte con tu cuenta de Verdent para empezar a usar la extensión.
Autenticación inicial
Abre Verdent
Tras la instalación, selecciona el icono de Verdent en la barra lateral de VS Code. Verás las opciones de Sign In / Sign Up.
Inicia sesión
Selecciona Sign In. VS Code mostrará una ventana emergente con la pregunta "Do you want Code to open the external website?"; selecciona Open.
Autenticación en el navegador
Tu navegador abrirá la página de autenticación de Verdent. Inicia sesión con las credenciales de tu cuenta de Verdent (correo electrónico/contraseña o proveedores de OAuth como Google, GitHub, etc.).
Autoriza a VS Code
Concede a VS Code acceso a tu cuenta de Verdent cuando se te solicite.
Vuelve a VS Code
Vuelve a VS Code una vez que se complete la autenticación. El panel de Verdent mostrará ahora la interfaz de entrada.
Tiempo total: de 2 a 3 minutos para completar la instalación y la configuración.
Configuración inicial (opcional)
Verdent for VS Code está diseñado para usarse de inmediato tras la autenticación, con una configuración mínima requerida.
Ajustes predeterminados:
- Modo de permisos: Auto-Run Mode (aprobación automática para operaciones seguras)
- Preajuste de modelo: Balance (combinación óptima de rendimiento y costo)
- Gestión de contexto: automática
Personalización opcional:
Puedes ajustar estos parámetros más adelante desde el panel de Verdent:
- Modo de permisos: elige Manual Accept, Auto-Run, Plan Mode o Skip Permissions
- Selección de modelo: selecciona los preajustes Performance, Balance, Efficiency o modelos específicos
- Ajustes del espacio de trabajo: configura preferencias específicas del proyecto
La mayoría de los usuarios pueden empezar a usar Verdent de inmediato tras iniciar sesión, sin necesidad de configuración adicional. Los ajustes avanzados se pueden modificar según sea necesario.
Verificación de la instalación
Confirma que tu instalación funciona correctamente con estas comprobaciones sencillas:
Verificación visual
- Icono en la barra lateral: busca el icono de Verdent en la barra lateral de VS Code (lado izquierdo)
- Lista de extensiones: abre el panel de Extensiones (
Cmd+Shift+X/Ctrl+Shift+X) y confirma que "Verdent" aparece como instalado con una marca de verificación
Verificación funcional
Abre el panel de Verdent
Selecciona el icono de Verdent en la barra lateral o pulsa Cmd+L (macOS) / Ctrl+L (Windows/Linux).
Envía un prompt de prueba
Prueba una solicitud sencilla como "Explica qué contiene este espacio de trabajo" en el cuadro de entrada.
Recibe una respuesta
Verdent debería analizar tu espacio de trabajo y ofrecer una respuesta en segundos.
Indicadores de éxito:
- El icono de Verdent es visible en la barra lateral
- La cuenta se autenticó correctamente
- Puedes enviar prompts y recibir respuestas
Solución de problemas
Si la verificación falla, prueba estas soluciones:
| Problema | Solución |
|---|---|
| Falta el icono en la barra lateral | Reinicia VS Code o busca actualizaciones de la extensión |
| Los prompts no responden | Comprueba la conexión a Internet y la configuración del firewall |
| No se encuentra la extensión | Asegúrate de que la versión de VS Code sea 1.90.0 o superior |
Verdent requiere una conexión a Internet activa. Si los prompts no responden, verifica tu conectividad de red y que la configuración del firewall permita el tráfico HTTPS saliente hacia los endpoints de API de Verdent.