---
title: "Instalación"
description: "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](/docs/verdent-for-vscode/getting-started/system-requirements) 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.

<Tabs>
  <Tab title="Marketplace de VS Code">
    <Steps>
      <Step title="Visita el Marketplace">
        Ve a la [página de la extensión Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) en tu navegador.
      </Step>
      <Step title="Selecciona Install">
        Selecciona el botón **Install** en la página del marketplace.
      </Step>
      <Step title="Abre en VS Code">
        VS Code se abrirá automáticamente e iniciará el proceso de instalación.
      </Step>
    </Steps>
  </Tab>
  <Tab title="Panel de extensiones">
    <Steps>
      <Step title="Abre VS Code">
        Inicia Visual Studio Code en tu equipo.
      </Step>
      <Step title="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`
      </Step>
      <Step title="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.
      </Step>
      <Step title="Instala">
        Selecciona el botón **Install** junto a la extensión Verdent. La instalación suele tardar unos segundos.
      </Step>
    </Steps>
  </Tab>
  <Tab title="Línea de comandos">
    ```bash
    code --install-extension verdentai.verdent
    ```

    Este 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
  </Tab>
</Tabs>

<Tip>
  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.
</Tip>

---

## 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

<Steps>
  <Step title="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.
  </Step>
  <Step title="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**.
  </Step>
  <Step title="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.).
  </Step>
  <Step title="Autoriza a VS Code">
    Concede a VS Code acceso a tu cuenta de Verdent cuando se te solicite.
  </Step>
  <Step title="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.
  </Step>
</Steps>

**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

<Note>
  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.
</Note>

---

## Verificación de la instalación

Confirma que tu instalación funciona correctamente con estas comprobaciones sencillas:

### Verificación visual

1. **Icono en la barra lateral**: busca el icono de Verdent en la barra lateral de VS Code (lado izquierdo)
2. **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

<Steps>
  <Step title="Abre el panel de Verdent">
    Selecciona el icono de Verdent en la barra lateral o pulsa `Cmd+L` (macOS) / `Ctrl+L` (Windows/Linux).
  </Step>
  <Step title="Envía un prompt de prueba">
    Prueba una solicitud sencilla como "Explica qué contiene este espacio de trabajo" en el cuadro de entrada.
  </Step>
  <Step title="Recibe una respuesta">
    Verdent debería analizar tu espacio de trabajo y ofrecer una respuesta en segundos.
  </Step>
</Steps>

**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 |

<Warning>
  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.
</Warning>

---

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Inicio rápido" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    Completa tu primera tarea con Verdent en 5 minutos
  </Card>
  <Card title="Conceptos básicos" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Comprende los subagentes, los modos de ejecución y la arquitectura multiagente
  </Card>
</CardGroup>