# Optimización de la configuración (/es/docs/verdent-for-vscode/configuration/tuning)

> 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 [#á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 [#ajuste-de-la-configuración-para-tu-flujo-de-trabajo]

### Selección de ajuste preestablecido de modelo [#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 preestablecido        | Costo                              | Eficiencia de costo                              | Mejor para                                                          |
| ---------------------------- | ---------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------- |
| **Efficiency**               | \~0.3x Balance (70 % de reducción) | 3.2x más eficiente que Sonnet                    | Tareas simples, correcciones rápidas, prototipado ágil              |
| **Balance** (predeterminado) | 1x de referencia                   | 1x de referencia                                 | Tareas de desarrollo generales, programación diaria                 |
| **Performance**              | 1-2x Balance                       | 0.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 [#configuración-del-modo-de-ejecución]

<Tabs>
  <Tab title="Omitir permisos (velocidad)">
    * Autonomía total sin solicitudes de aprobación
    * Sin interrupciones por permisos
    * Riesgo más alto: úsalo solo en entornos automatizados
  </Tab>

  <Tab title="Ejecución automática (equilibrado)">
    * Los comandos requieren aprobación, las operaciones con archivos son automáticas
    * Menos solicitudes de permiso
    * Menor riesgo manteniendo la seguridad para operaciones peligrosas
  </Tab>

  <Tab title="Aceptación manual (exhaustividad)">
    * 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
  </Tab>

  <Tab title="Planificar (revisión)">
    * Planificación estratégica antes de la ejecución
    * Fase de análisis de solo lectura
    * Revisa y aprueba antes de cualquier cambio
  </Tab>
</Tabs>

### Think Hard Mode [#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 [#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.

<Tabs>
  <Tab title="Velocidad crítica">
    **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
  </Tab>

  <Tab title="Exhaustividad crítica">
    **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
  </Tab>

  <Tab title="Enfoque híbrido">
    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.
  </Tab>
</Tabs>

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

***

## Configuración a nivel de espacio de trabajo [#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 [#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:**

```markdown filename="AGENTS.md"
# 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 [#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:**

```json filename=".vscode/settings.json"
{
  "verdent.enableCheckpoints": true
}
```

### Prioridad de configuración [#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 [#personalización-específica-del-proyecto]

### Gestión de contexto para proyectos grandes [#gestión-de-contexto-para-proyectos-grandes]

<Tabs>
  <Tab title="Subagentes">
    * 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
  </Tab>

  <Tab title="Selección de archivos">
    * 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
  </Tab>

  <Tab title="División de tareas">
    * 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
  </Tab>

  <Tab title="Plan Mode">
    * 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
  </Tab>
</Tabs>

### Optimización del rendimiento [#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

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

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

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

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

***

## Consulta también [#consulta-también]

<CardGroup cols="2">
  <Card title="Ajustes de configuración" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    Opciones de configuración completas y selección de modelo
  </Card>

  <Card title="Supervisión de recursos" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    Supervisa el rendimiento y optimiza el uso de tokens
  </Card>
</CardGroup>
