Guía de inicio rápido

Esta guía de inicio rápido te permitirá usar el flujo de trabajo Planificar-Verificar-Codificar de Verdent en menos de 15 minutos. Instalarás la extensión, completarás tu primera tarea y entenderás el flujo de trabajo central al trabajar con Verdent for VS Code.

Lo que aprenderás

Instalar Verdent for VS Code desde el marketplace
Autenticarte y verificar tu configuración
Completar tu primera tarea asistida por IA
Entender los modos de ejecución (Manual Accept, Auto-Run, Plan Mode)
Usar funciones esenciales para programar a diario

Requisitos previos

Antes de comenzar, asegúrate de tener:

Visual Studio Code instalado en tu sistema
Una conexión a internet activa
Una cuenta de suscripción de Verdent (o comienza con la prueba gratuita de 7 días)

Paso 1: Instalar Verdent

Visita la página de la extensión Verdent y selecciona Install.

Abre Visual Studio Code
Presiona Ctrl+Shift+X (o Cmd+Shift+X en macOS)
Busca "Verdent"
Selecciona Install

code --install-extension verdentai.verdent

Paso 2: Empezar a usar Verdent

Abrir Visual Studio Code

Abre Visual Studio Code en la carpeta de tu proyecto.

Acceder a Verdent

Selecciona el icono de Verdent en la barra lateral o presiona Ctrl+L (Windows/Linux) / Cmd+L (macOS).

Iniciar sesión

Inicia sesión cuando se te solicite para autenticarte con tu cuenta de Verdent.

Paso 3: Tu primera tarea

Empecemos con una tarea simple y no destructiva que demuestra cómo Verdent entiende tu espacio de trabajo.

Abre un proyecto en VS Code y luego prueba uno de estos prompts en el cuadro de entrada de Verdent:

What kind of project is this?

Verdent analizará la estructura de tu espacio de trabajo, leerá los archivos clave y explicará qué tipo de aplicación estás desarrollando. Esto demuestra la conciencia del contexto sin realizar ningún cambio.

Deberías ver:

Verdent analizando archivos en tu espacio de trabajo
Un resumen del tipo de proyecto, las tecnologías y la estructura
Sin modificaciones de archivos (análisis de solo lectura)

Prueba estos prompts de seguimiento:

Explain what this project does

What dependencies does this project have?

Show me the main entry point of this application

Cada prompt te ayuda a verificar que Verdent puede acceder a tu espacio de trabajo y entiende tu base de código.

Estos prompts exploratorios son perfectos para entender bases de código desconocidas. Verdent lee los archivos según sea necesario sin requerir que agregues contexto manualmente.

Paso 4: Realizar tu primer cambio de código

Ahora hagamos que Verdent cree algo. Prueba esta tarea simple:

Create a hello_world.txt file with a greeting message

Qué sucede:

Verdent propone el cambioVerás una vista previa que muestra el archivo que se creará y su contenido
Solicitud de permiso En Auto Run Mode (el predeterminado), Verdent aprobará automáticamente la creación del archivo
Tú apruebas Selecciona "Accept" o aprueba el cambio
Archivo creadoVerdent crea el archivo y confirma la finalización

Entender los permisos:

Manual Accept Mode garantiza que no se produzcan modificaciones no deseadas sin tu aprobación. Verás solicitudes de permiso para:

Ediciones y creaciones de archivos
Ejecuciones de comandos
Uso de herramientas (primer uso de cada tipo de herramienta)

Esto te da control total y te ayuda a aprender qué operaciones realiza Verdent para diferentes tareas.

Manual Accept Mode es el punto de partida recomendado para nuevos usuarios. Una vez que te sientas cómodo, puedes cambiar a Auto-Run Mode o Plan Mode para diferentes flujos de trabajo.

Paso 5: Usar Plan Mode para tareas complejas

Plan Mode es el modo de planificación de solo lectura de Verdent donde puedes revisar los enfoques antes de la ejecución. Probémoslo:

Cambia a Plan Mode:

Selecciona el botón Switch Mode en el cuadro de entrada y elige Plan Mode

Prueba una tarea de planificación:

Suggest ways to build a website for my project

Qué sucede:

Verdent analiza tu proyectoLee los archivos y entiende la estructura y los requisitos de tu proyecto
Crea un plan detalladoMuestra qué tecnologías usar, qué páginas crear y cómo estructurar el sitio web
Sin modificacionesPlan Mode es de solo lectura. Verdent no puede modificar archivos hasta que lo apruebes explícitamente
Aclaración interactivaVerdent puede hacer preguntas sobre las preferencias de diseño, el público objetivo o las funciones antes de finalizar el plan

Por qué usar Plan Mode:

Exploración segura: entiende bases de código desconocidas sin cambios accidentales
Revisión de código: analiza la calidad y la arquitectura antes de realizar modificaciones
Planificación estratégica: divide tareas complejas en pasos revisables
Reducción de la incertidumbre: Verdent hace preguntas aclaratorias para eliminar la ambigüedad

Usa Plan Mode para cualquier tarea en la que quieras revisar el enfoque antes de comprometerte con la ejecución. Es especialmente valioso cuando aprendes cómo Verdent piensa sobre tu base de código.

Para ejecutar el plan:

Después de revisar el plan, Verdent presenta dos opciones:

Elige Edit para solicitar modificaciones o hacer preguntas aclaratorias
Elige Start Building para cambiar a Agent Mode y comenzar la ejecución

Paso 6: Entender los modos de ejecución

Verdent ofrece varios modos de ejecución para adaptarse a diferentes flujos de trabajo:

Modos de permiso:

Modo	Descripción	Cuándo usarlo
Manual Accept	Solicita permiso en el primer uso de cada herramienta	Aprendizaje y desarrollo general con el máximo control
Auto-Run (predeterminado)	Acepta automáticamente operaciones seguras (lecturas de archivos, búsquedas web); las ediciones de archivos y los comandos aún requieren aprobación	Proyectos de confianza y prototipado rápido
Plan Mode	Modo de solo lectura para análisis y planificación sin modificaciones de archivos	Tareas complejas y revisión de código
Skip Permissions	Operación totalmente autónoma que omite todas las solicitudes	Entornos aislados y seguros como pruebas automatizadas o sandboxes

Modo adicional:

Think Hard Mode: presupuesto máximo de pensamiento para razonamiento complejo y decisiones de arquitectura

Skip Permissions Mode elimina todas las comprobaciones de seguridad. Úsalo solo en entornos aislados y desechables donde los errores no tengan consecuencias.

Acciones esenciales

Estas son las acciones clave que usarás a diario en Verdent for VS Code:

Acción	Cómo acceder	Descripción
Abrir Verdent	`Cmd+L` / `Ctrl+L` o seleccionar el icono de la barra lateral	Abre el panel de Verdent
Nueva sesión	Selecciona "New Session" en la barra superior	Inicia una conversación nueva con un contexto limpio
Agregar contexto	Selecciona el botón "Add Context"	Referencia archivos con menciones @
Agregar imágenes	Selecciona el botón "Add Images or Files"	Sube capturas de pantalla, maquetas o diagramas
Cambiar de modo	Selecciona el botón "Switch Mode"	Alterna entre los modos Agent/Plan/Chat
Cambiar de modelo	Selecciona el selector de modelo	Elige los preajustes Performance/Balance/Efficiency
Think Hard	Selecciona el botón "Think Hard Mode"	Habilita el razonamiento extendido para tareas complejas
Cambiar permisos	Selecciona el botón "Switch Permission"	Cambia el modo de permiso
Ver historial	Selecciona "Project History" en la barra superior	Explora sesiones anteriores
Centro de usuario	Selecciona "User Center" en la barra superior	Consulta el saldo de créditos y la información de la cuenta
Configuración	Selecciona "Settings" en la barra superior	Configura servidores MCP, subagentes y reglas

Consejos para principiantes

Comienza con prompts exploratorios

Antes de realizar cambios, deja que Verdent entienda tu base de código:

Analyze the database schema

Explain the authentication flow

Esto desarrolla el contexto de Verdent sobre tu proyecto y le ayuda a hacer mejores sugerencias.

Sé específico con tus solicitudes

En lugar de: "arregla el error"

Prueba: "arregla el error de inicio de sesión en LoginForm.tsx donde los usuarios ven una pantalla en blanco después de ingresar credenciales incorrectas"

Los prompts específicos conducen a soluciones más precisas y menos iteraciones.

Usa Plan Mode para código desconocido

Cuando trabajes con código que no entiendes del todo, usa Plan Mode primero:

Refactor the authentication module to use async/await instead of callbacks

Revisa el plan, elige Edit para hacer preguntas aclaratorias y refinarlo, luego elige Start Building cuando te sientas seguro.

Divide las tareas complejas en pasos

Para funciones de varios pasos, trabaja de forma incremental:

1. Create a new database table for user profiles

Luego, después de completar:

2. Create an API endpoint to get and update profiles

Esto mantiene la claridad y te permite verificar cada paso.

Aprovecha las menciones @ para el contexto

Referencia archivos explícitamente cuando sea necesario:

@components/UserProfile.tsx refactor this component to use hooks

Esto garantiza que Verdent se centre en el contexto correcto para tu tarea.

Usa subagentes para tareas especializadas

Verdent incluye tres subagentes integrados:

@Explorer: exploración rápida de la base de código y descubrimiento de archivos
@Verifier: validación y comprobaciones rápidas de código
@Code-reviewer: revisión integral de seguridad y calidad

Ejemplo:

@Explorer find all API endpoints in this project

Problemas comunes

Solución: Reinicia VS Code. Si sigue faltando, verifica la instalación en el panel de extensiones (Cmd+Shift+X / Ctrl+Shift+X) y confirma que "Verdent" aparece en la lista.

Solución:

Verifica que la conexión a internet esté activa
Comprueba que la configuración del firewall/proxy permite HTTPS a los servicios de Verdent
Confirma que te quedan créditos en el Centro de usuario
Prueba un prompt más simple para comprobar la conectividad

Solución: Cambia a Auto-Run Mode mediante el botón "Switch Permission". Esto aprueba automáticamente las operaciones de lectura seguras y sigue solicitando aprobación para las ediciones de archivos y los comandos.

Cómo obtener ayuda

Comunidad de Discord: https://discord.com/invite/NGjXEZcbJq - Comunidad activa con soporte en tiempo real
Documentación: Explora otras guías en esta documentación
Comentarios: Usa el botón Feedback en la barra superior de Verdent para reportar problemas o sugerir mejoras

Preguntas frecuentes

¿Cómo sé en qué modo de ejecución me encuentro actualmente?

Mira el cuadro de entrada en la parte inferior del panel de Verdent. El botón "Switch Permission" muestra tu modo actual (por ejemplo, "Manual", "Auto", "Plan"). Puedes seleccionarlo para cambiar de modo.

¿Qué sucede si me quedo sin créditos?

Las solicitudes estándar basadas en créditos se detienen cuando tu saldo llega a cero. Espera a la actualización de tu próximo ciclo de facturación o compra una recarga de créditos única para continuar.

¿Puedo usar Verdent en varios proyectos simultáneamente?

Sí, cada ventana de VS Code funciona de forma independiente. Puedes tener Verdent abierto en varios proyectos, y cada uno mantiene su propio contexto de conversación separado.

¿Cómo inicio una nueva conversación con un contexto limpio?

Selecciona el botón "New Session" en la barra superior. Esto borra el historial de conversación actual y le da a Verdent una ventana de contexto nueva para tu próxima tarea.