---
title: "Conceptos básicos"
description: "Comprende la arquitectura y la terminología clave de Verdent"
---
Verdent for VS Code aporta precisión y control al desarrollo impulsado por IA. Las herramientas tradicionales de codificación con IA adivinan tu intención. Verdent te permite ver exactamente qué hará la IA antes de ejecutarlo, verificar que funciona correctamente y entregar código confiable cada vez.
**Planifica primero, verifica pronto, entrega código confiable**
El flujo de trabajo de Verdent se construye en torno a tres fases centrales:
- **Plan** - Antes de ejecutar nada, conversa con la IA en un ciclo de aclaración. Puedes personalizar su comportamiento con reglas de planificación, y usar la planificación interactiva de arquitectura, diagramas visuales y desgloses de tareas para que tus requisitos queden totalmente claros
- **Code** - Revisa los cambios con el análisis de nivel empresarial de Code Diff y entrega resultados listos para producción con confianza
- **Verify** - Aseguramiento de calidad con el subagente Verify y acción del navegador. Itera a través de ciclos de reparación de varias pasadas hasta que el código pase una validación integral
Comprender estos conceptos básicos y la arquitectura de Verdent te ayudará a trabajar de forma más eficaz con la extensión.
**Más información: Flujo de trabajo Plan-Code-Verify**
---
## Descripción general de la arquitectura
Las tareas complejas se descomponen y se delegan a agentes de IA especializados, optimizados para propósitos específicos. Cada subagente opera con su propio prompt de sistema personalizado y una ventana de contexto separada, aislada del agente principal que lo invocó.
Esta separación mantiene un rendimiento óptimo y evita la contaminación del contexto, lo que permite que cada subagente se concentre en su tarea especializada sin sobrecargar al agente principal con cada detalle de implementación.
**Subagentes predeterminados integrados:**
Verdent incluye tres subagentes predeterminados disponibles de inmediato:
| Subagente | Propósito | Cuándo se usa |
| ------------------ | -------------------------------- | ------------------------------------------------------------------------ |
| **@Verifier** | Comprobaciones rápidas de código y validación | Durante las tareas de codificación para garantizar la calidad y corrección del código |
| **@Explorer** | Exploración rápida del código base | Encontrar archivos y responder preguntas sobre la estructura de tu código base |
| **@Code-reviewer** | Evaluación instantánea de la calidad del código | Análisis proactivo de seguridad, mantenibilidad y problemas de rendimiento |
**Subagentes personalizados:**
Puedes crear subagentes personalizados adaptados a tus necesidades específicas. Cada subagente personalizado opera con su propio prompt de sistema, lo que te permite definir un comportamiento especializado para tareas o flujos de trabajo particulares.
Los subagentes personalizados pueden invocarse automáticamente según patrones de tareas o manualmente mediante menciones con @. Los casos de uso comunes incluyen:
- **Especialistas en stack tecnológico** - Optimizador de rendimiento de React, optimizador de consultas SQL, revisor de configuración de Docker
- **Aseguramiento de calidad** - Analizador de cobertura de pruebas, revisor de manejo de errores, verificador de estándares de registro
- **Flujos de trabajo específicos del equipo** - Verificador de estilo de código, comprobador de consistencia de documentación, auditor de dependencias
- **Necesidades específicas del proyecto** - Modernizador de código heredado, asistente de migración, verificador de presupuesto de rendimiento
**Más información:** [Gestión de subagentes](/docs/verdent-for-vscode/agents-rules/subagent-management)
---
## Modos de ejecución
Verdent admite varios modos de ejecución que controlan cómo la IA maneja los permisos y las interacciones:
**Modos de permisos:**
- **Manual Accept Mode** - Solicita permiso en el primer uso de cada herramienta. Ideal para aprender y para el desarrollo general con el máximo control.
- **Auto-Run Mode** (predeterminado) - Acepta automáticamente los permisos para operaciones seguras (lecturas de archivos, búsquedas web). Las ediciones de archivos y la ejecución de comandos aún requieren aprobación. Ideal para proyectos confiables y prototipado rápido.
- **Skip Permissions Mode** - Operación totalmente autónoma que omite todas las solicitudes. Solo para entornos aislados y seguros, como pruebas automatizadas o entornos sandbox.
Para cambiar entre los modos de permisos, selecciona el botón **Switch Permission** en el cuadro de entrada (muestra el modo actual, como "Manual" o "Auto") y elige el modo deseado en el menú desplegable.
**Switch Mode** (controla el estilo de interacción):
- **Agent Mode** - Comportamiento totalmente agéntico con ejecución autónoma de tareas y operaciones con archivos
- **Plan Mode** - Interacción enfocada en la planificación para revisar los enfoques antes de la ejecución
- **Chat Mode** - Interacción conversacional sin operaciones autónomas con archivos
Para cambiar entre estilos de interacción, selecciona el botón **Switch Mode** en el cuadro de entrada (muestra el modo actual, como "Agent" o "Plan") y elige el modo deseado en el menú desplegable.
**Modos adicionales:**
- **Think Hard Mode** - Asigna el máximo de recursos computacionales para analizar problemas en profundidad, explorar múltiples enfoques y ofrecer soluciones más completas. Ideal para decisiones de arquitectura, depuración compleja y tareas que requieren un razonamiento sofisticado.
Para activar Think Hard Mode, selecciona el botón **Think Hard** en el cuadro de entrada antes de enviar tu solicitud.
**Más información:** [Descripción general de los modos de ejecución](/docs/verdent-for-vscode/execution-modes/overview)
---
## Gestión del contexto
La gestión del contexto controla a qué información tiene acceso Verdent durante tu sesión. La **ventana de contexto** es el límite de memoria del agente, medido en tokens y compartido entre varios componentes: instrucciones del sistema, contenido de archivos, mensajes de la conversación y respuestas del agente.
**Cómo funciona el contexto:**
- **Menciones con @** - Agrega archivos al contexto de forma explícita usando `@filename.js` para un control preciso
- **Carga automática** - Verdent incluye automáticamente los archivos relevantes según la tarea
- **Contexto separado de subagentes** - Cada subagente opera con ventanas de contexto aisladas, lo que evita la contaminación de la memoria del agente principal
- **Límites de la ventana de contexto** - Contexto finito medido en tokens. A medida que las conversaciones crecen, el espacio disponible disminuye y el rendimiento del modelo se degrada
**Buenas prácticas:**
- Divide las tareas grandes en fragmentos más pequeños con puntos de corte naturales
- Usa Plan Mode para tareas complejas con el fin de revisar los enfoques antes de la ejecución
- Completa los componentes individuales antes de la integración para evitar el agotamiento del contexto
- Inicia una nueva conversación al comenzar una nueva tarea para limpiar el contexto y mantener un rendimiento óptimo
**Más información:** [Buenas prácticas de gestión del contexto](/docs/verdent-for-vscode/best-practices/context)
---
## Selección de modelos
Verdent orquesta modelos de múltiples proveedores de IA (Claude, GPT-5, Gemini, MiniMax) dentro de un solo flujo de trabajo. Cada agente especializado puede aprovechar el modelo óptimo para su tarea específica.
**Modelos preestablecidos:**
- **Performance** - Máximo contexto, modelos de frontera (uso de 1-2x créditos)
- **Balance** - Combinación óptima de rendimiento y costo (uso de 1x créditos)
- **Efficiency** - Tareas rápidas, ágiles y rentables (~0,3x de uso de créditos)
**Modelos individuales disponibles:**
| Proveedor | Modelo | Mejor para | Eficiencia de costo |
| --------- | -------------------- | ------------------------------------------------ | ------------------------------- |
| Anthropic | Claude 4.5 Opus | Excelente para tareas de codificación profunda y resolución de problemas. | costo de 1,5x |
| Anthropic | Claude 4.5 Sonnet | Tareas complejas equilibradas | base de 1x |
| Anthropic | Claude 4.5 Sonnet 1M | Tareas largas o complejas (\>200k de entrada) | eficiencia de 0,5x (costo de 2x) |
| Anthropic | Claude 4.5 Haiku | Tareas rápidas y simples | 3,2x más eficiente que Sonnet |
| OpenAI | GPT-5 (Beta) | Razonamiento y creatividad | 1,3x más eficiente que Sonnet |
| OpenAI | GPT-5 Codex (Beta) | Codificación y depuración | 1,3x más eficiente que Sonnet |
| Google | Gemini 3 Pro | Razonamiento avanzado y multimodal | Variable |
| Kimi | Kimi 2 Turbo (Beta) | Modelo ágil y veloz para codificación | 3,1x más eficiente que Sonnet |
**Más información:** [Ajustes de configuración](/docs/verdent-for-vscode/configuration/settings)
---
## Preguntas frecuentes
Ocurre cuando acciones e información previas en el contexto crean patrones de comportamiento no intencionados que afectan tareas futuras. Por ejemplo, si actualizas código repetidamente y luego lo despliegas, el agente puede empezar a asociar todas las actualizaciones de código con un despliegue inmediato, incluso cuando solo estás experimentando. Los subagentes evitan la contaminación del contexto al operar con ventanas de contexto aisladas, lo que permite que cada tarea especializada comience con un contexto limpio y evita la contaminación cruzada entre distintos tipos de trabajo.
Operaciones que solo leen datos sin realizar cambios: lecturas de archivos y búsquedas web. Estas se aprueban automáticamente en Auto-Run Mode, mientras que las ediciones de archivos y la ejecución de comandos aún requieren aprobación por seguridad.
Ejecutar comandos de terminal o scripts de shell a través de Verdent, incluyendo operaciones como ejecutar pruebas, instalar paquetes o ejecutar comandos de compilación. La ejecución de comandos requiere aprobación en la mayoría de los modos de permisos para evitar cambios no intencionados en el sistema.
La unidad de medida de las ventanas de contexto. Los tokens representan fragmentos de texto (palabras, partes de palabras o caracteres) que el modelo de IA procesa. Los límites de contexto se miden en tokens en lugar de caracteres o palabras, y las conversaciones típicas consumen miles de tokens.
La moneda de uso de Verdent. Los distintos modelos tienen diferente eficiencia de costo (por ejemplo, Haiku es 3,2x más eficiente que la base de Sonnet, y Sonnet es la base de 1x). Tu suscripción incluye una asignación mensual de créditos (por ejemplo, 640 créditos para Starter, 2.000 para Pro, 6.000 para Max).
Un proceso de verificación iterativo en el que el código se genera, se prueba y se repara hasta que pasa pruebas integrales. Verdent ejecuta automáticamente las pruebas, analiza las fallas, corrige los problemas y vuelve a probar en múltiples pasadas hasta que el código funciona correctamente. Esto entrega código listo para producción, no solo sugerencias. Cada resultado incluye resúmenes detallados y diffs de código que muestran exactamente qué cambió.
---
## Véase también
Profundiza en Manual Accept, Auto-Run, Plan Mode y los permisos
Crea y personaliza subagentes para tareas especializadas