Verdent Docs
Configuración

Optimización de la configuración

Optimiza Verdent para tu flujo de trabajo

Optimiza Verdent for VS Code para equilibrar velocidad, costo y exhaustividad según los requisitos de tu flujo de trabajo. Configura los ajustes preestablecidos de modelos, los modos de ejecución y las estrategias de gestión de contexto para lograr un rendimiento óptimo.

Áreas de optimización

  • Selección de ajuste preestablecido de modelo para equilibrar costo y rendimiento
  • Configuración del modo de ejecución para la eficiencia del flujo de trabajo
  • Gestión de contexto para bases de código grandes
  • Personalización por proyecto y a nivel de espacio de trabajo

Ajuste de la configuración para tu flujo de trabajo

Selección de ajuste preestablecido de modelo

Elige el ajuste preestablecido de modelo adecuado según la complejidad de la tarea y el presupuesto:

Ajuste preestablecidoCostoEficiencia de costoMejor para
Efficiency~0.3x Balance (70 % de reducción)3.2x más eficiente que SonnetTareas simples, correcciones rápidas, prototipado ágil
Balance (predeterminado)1x de referencia1x de referenciaTareas de desarrollo generales, programación diaria
Performance1-2x Balance0.5x de eficiencia (2x de costo, contexto de 1M)Decisiones arquitectónicas complejas, refactorizaciones intrincadas

Modelos adicionales:

  • Claude-4.5-sonnet: modelo equilibrado de propósito general (1x de referencia)
  • Claude-4.5-sonnet-1m: contexto ampliado para tareas complejas (0.5x de eficiencia, 2x de costo cuando la entrada supera los 200k tokens)
  • Claude-4.5-haiku: el más rápido y económico (3.2x más eficiente que Sonnet)
  • GPT-5 / GPT-5-codex: enfoque en razonamiento y creatividad (Beta, 1.3x más eficiente que Sonnet)
  • Minimax-m2: rápido y rentable (Beta, gratis hasta el 10 de noviembre)

Configuración del modo de ejecución

  • Autonomía total sin solicitudes de aprobación
  • Sin interrupciones por permisos
  • Riesgo más alto: úsalo solo en entornos automatizados
  • Los comandos requieren aprobación, las operaciones con archivos son automáticas
  • Menos solicitudes de permiso
  • Menor riesgo manteniendo la seguridad para operaciones peligrosas
  • Cada operación requiere aprobación
  • Visibilidad y control completos
  • El más lento pero el más seguro: ideal para aprender y para código de producción
  • Planificación estratégica antes de la ejecución
  • Fase de análisis de solo lectura
  • Revisa y aprueba antes de cualquier cambio

Think Hard Mode

Habilítalo para tareas de razonamiento complejo:

  • Exhaustividad: máxima profundidad de razonamiento para problemas sofisticados
  • Velocidad: más lento debido al presupuesto de pensamiento ampliado
  • Mejor para: decisiones arquitectónicas, depuración compleja, análisis intrincados

Equilibrio entre velocidad y exhaustividad

Equilibra la velocidad de ejecución frente a la profundidad del análisis según los requisitos de la tarea.

Configuración:

  • Modelo: ajuste preestablecido Efficiency (Claude-4.5-haiku)
  • Modo de permisos: Auto-Run Mode
  • Modo de ejecución: Agent Mode para ejecución directa
  • Casos de uso: correcciones rápidas, operaciones rutinarias, tareas simples

Beneficios:

  • Tiempos de respuesta más rápidos
  • Interrupciones mínimas
  • 70 % de reducción de costo frente al ajuste preestablecido Balance

Configuración:

  • Modelo: ajuste preestablecido Performance (Claude-4.5-sonnet-1m)
  • Modo de permisos: Manual Accept Mode
  • Modo de ejecución: Plan Mode para revisión estratégica
  • Think Hard: habilitado para razonamiento sofisticado
  • Casos de uso: funciones complejas, código de producción, decisiones arquitectónicas

Beneficios:

  • Ventana de contexto máxima (1M tokens)
  • Visibilidad y control completos
  • Razonamiento profundo para problemas complejos
  • Revisión antes de la ejecución

La mayoría de los usuarios se benefician de alternar el contexto entre configuraciones:

  • Correcciones rápidas: Efficiency + Agent Mode
  • Funciones complejas: Balance/Performance + Plan Mode
  • Exploración: Plan Mode para la estrategia y luego Agent Mode para la ejecución

Estrategia: adapta la configuración al tipo de tarea en lugar de usar un enfoque único para todo.

Usa Auto-Run Mode para proyectos de confianza y reduce las solicitudes de permiso manteniendo la seguridad para operaciones peligrosas. Esto agiliza el flujo de trabajo sin sacrificar las protecciones críticas.


Configuración a nivel de espacio de trabajo

Verdent admite configuración por proyecto y por espacio de trabajo para lograr coherencia en todo el equipo.

Configuración específica del proyecto

Reglas del proyecto (AGENTS.md):

  • Ubicación: directorio raíz del proyecto o carpeta del espacio de trabajo
  • Alcance: se aplica solo al proyecto actual
  • Control de versiones: confírmalo en git para estándares de todo el equipo
  • Contenido: estándares de programación, requisitos de pruebas, patrones arquitectónicos

Ejemplo:

# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing

Configuración del espacio de trabajo de VS Code

Configura los ajustes de la extensión a nivel de espacio de trabajo:

Ubicación: .vscode/settings.json en la raíz del espacio de trabajo

Ejemplo:

{
  "verdent.enableCheckpoints": true
}

Prioridad de configuración

Cuando las configuraciones entran en conflicto, Verdent aplica este orden de prioridad:

  1. Reglas del proyecto (AGENTS.md): prioridad más alta (específica del proyecto)
  2. Configuración del espacio de trabajo: ajustes a nivel de espacio de trabajo de VS Code
  3. Reglas del usuario (VERDENT.md): preferencias globales del usuario
  4. Configuración predeterminada: valores predeterminados integrados de Verdent

Personalización específica del proyecto

Gestión de contexto para proyectos grandes

  • Delega operaciones complejas a subagentes con ventanas de contexto separadas
  • Solo los resultados del subagente consumen el contexto principal, no todo el proceso
  • Evita que el contexto principal se llene de detalles de implementación
  • Agrega explícitamente solo los archivos relevantes con @filename
  • Evita cargar todo el proyecto en el contexto innecesariamente
  • Apunta a componentes específicos para un análisis enfocado
  • Divide las tareas grandes en fragmentos más pequeños y completables
  • Inicia nuevas sesiones para funciones o componentes distintos
  • Los puntos de interrupción naturales evitan el agotamiento del contexto
  • Revisa el enfoque antes de consumir el contexto de ejecución
  • Reduce el contexto desperdiciado en implementaciones incorrectas
  • Plan Mode tiene una gestión de contexto separada

Optimización del rendimiento

Habilita los checkpoints de forma selectiva:

El ajuste verdent.enableCheckpoints usa git para el control de versiones:

  • Puede afectar el rendimiento en repositorios muy grandes
  • Habilítalo solo cuando se necesite la funcionalidad de checkpoint
  • Desactívalo para obtener el máximo rendimiento en bases de código grandes

Habilita los checkpoints de forma selectiva, solo para tareas críticas; el uso excesivo de checkpoints ralentiza los flujos de trabajo sin aportar valor.

Selección de modelo:

  • Usa el ajuste preestablecido Efficiency (Haiku) para tareas simples y aisladas
  • Reserva el ajuste preestablecido Performance (Sonnet-1M) para operaciones con mucho contexto
  • Usa el ajuste preestablecido Balance para el trabajo general

Modo de ejecución:

  • Auto-Run Mode reduce el contexto que consumen las solicitudes de permiso
  • Skip Permissions Mode maximiza la eficiencia para entornos automatizados

Los escenarios con múltiples espacios de trabajo aplican automáticamente las reglas de proyecto adecuadas al cambiar de espacio de trabajo. No se requiere cambiar la configuración manualmente.

Las configuraciones con múltiples espacios de trabajo te permiten optimizar los ajustes por tipo de proyecto, desarrollo frente a producción, monorepo frente a microservicios.


Consulta también