--- title: "Configuración y personalización" description: "Personaliza Verdent para adaptarlo a tu flujo de trabajo" --- Verdent for VS Code ofrece amplias opciones de configuración para adaptarse a tu flujo de trabajo de desarrollo, tus preferencias de programación y los estándares de tu equipo. Configura los ajustes mediante la interfaz nativa de configuración de VS Code, personaliza los atajos de teclado y crea reglas y subagentes para comportamientos especializados. ### Lo que aprenderás - Configurar los ajustes de la extensión VS Code para Verdent - Personalizar los atajos de teclado para un flujo de trabajo eficiente - Crear y gestionar reglas para personalizar el comportamiento del agente - Construir subagentes personalizados para tareas especializadas ### Requisitos previos - Verdent for VS Code instalado y autenticado - Acceso a la configuración de VS Code (`Cmd+,` o `Ctrl+,`) - Conocimientos básicos de JSON para los archivos de reglas (opcional) --- ## Ajustes de la extensión VS Code A los ajustes de Verdent for VS Code se accede desde varias ubicaciones según el tipo de configuración y su alcance. ### Acceder a los ajustes **Ajustes de la extensión (nativos de VS Code):** 1. Abre la configuración de VS Code: `Cmd+,` (macOS) o `Ctrl+,` (Windows/Linux) 2. Busca "Verdent" en la barra de búsqueda de ajustes 3. Modifica los ajustes de la extensión (por ejemplo, `verdent.enableCheckpoints`) **Ajustes específicos de Verdent:** Selecciona el botón **Settings** en la barra superior de Verdent para acceder a: - **Rules** - User Rules, Project Rules, Plan Rules - **Servidores MCP** - Configuraciones de Model Context Protocol - **Subagents** - Gestión de subagentes personalizados **Controles dentro del chat:** Muchos ajustes pueden activarse directamente desde el cuadro de entrada en la parte inferior del panel de Verdent: - **Switch Permission** - Manual Accept, Auto-Run, Plan, Skip Permissions - **Switch Mode** - modos Agent, Plan, Chat - **Switch/Customize AI Model** - presets de Performance, Balance, Efficiency - **Think Hard Mode** - presupuesto máximo de razonamiento para análisis complejos - **Add Context** - adjunta archivos usando menciones con @ - **Add Images or Files** - incluye capturas de pantalla o documentos - **Add Subagent** - delega en subagentes especializados Los cambios de configuración surten efecto de inmediato sin necesidad de reiniciar VS Code. --- ## Ajustes de extensión disponibles Verdent for VS Code ofrece **2 ajustes de extensión principales** que pueden configurarse mediante la interfaz de ajustes de VS Code: | Ajuste | Tipo | Predeterminado | Descripción | | --------------------------- | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------- | | `verdent.enableCheckpoints` | `boolean` | `true` | Permite que la extensión guarde puntos de control del espacio de trabajo durante las tareas usando git. Puede afectar el rendimiento en espacios de trabajo grandes. | | `verdent.enableProxy` | `boolean` | `true` | Habilita el soporte de proxy para las conexiones de red. Necesario para usuarios detrás de firewalls corporativos o servidores proxy. | Estos son los ajustes completos de la extensión VS Code para Verdent. Las opciones de configuración adicionales (Rules, Subagents, servidores MCP) se gestionan a través del menú Verdent Settings en la barra superior de la extensión. --- ## Referencia de controles del cuadro de entrada El cuadro de entrada en la parte inferior del panel de Verdent proporciona acceso rápido a los controles de configuración: | Control | Propósito | Opciones | | ----------------------------- | ------------------------------------- | ------------------------------------------------------------------ | | **Add Context** | Adjunta archivos usando menciones con @ | @nombredearchivo, @nombredecarpeta | | **Add Images or Files** | Incluye capturas de pantalla o documentos | Sube imágenes, PDF, archivos de texto | | **Add Subagent** | Delega en agentes especializados | @Verifier, @Explorer, @Code-reviewer, subagentes personalizados | | **Switch Mode** | Alterna el modo de ejecución | Agent Mode, Plan Mode, Chat Mode | | **Switch/Customize AI Model** | Selecciona un preset de modelo o un modelo específico | Performance (costo 1-2x), Balance (costo 1x), Efficiency (costo 0.3x) | | **Think Hard Mode** | Habilita el razonamiento extendido | Activa/desactiva para problemas complejos | | **Switch Permission** | Cambia el nivel de permisos | Manual Accept (predeterminado), Auto-Run, Plan, Skip Permissions | ### Modos de permiso - Cada operación requiere aprobación - Visibilidad y control completos - Ideal para aprender, bases de código desconocidas y código de producción - Los comandos requieren aprobación, las operaciones sobre archivos son automáticas - Menos solicitudes de permiso - Ideal para proyectos de confianza y prototipado rápido - Análisis y planificación de solo lectura - Sin modificaciones de código durante la planificación - Ideal para cambios complejos y decisiones de arquitectura - Autonomía total sin solicitudes de aprobación - Ejecución más rápida pero con mayor riesgo - Ideal para entornos automatizados y CI/CD ### Presets de modelo - **Costo:** 1x base - **Modelos:** Claude-4.5-sonnet - **Ideal para:** Desarrollo general, programación diaria, implementación de funcionalidades - **Costo:** 1-2x respecto a la base de Balance - **Modelos:** Claude-4.5-sonnet-1m (contexto de 1M de tokens) - **Ideal para:** Arquitecturas complejas, bases de código grandes, tareas que superan los 200k tokens - **Costo:** 3.2x más eficiente que Sonnet (70% de ahorro de créditos) - **Modelos:** Claude-4.5-haiku - **Ideal para:** Correcciones rápidas, tareas simples, operaciones rutinarias --- ## Personalización de atajos de teclado ### Atajos predeterminados **Atajo principal:** - **macOS:** `Cmd+L` - Abrir/enfocar el panel de Verdent - **Windows/Linux:** `Ctrl+L` - Abrir/enfocar el panel de Verdent - Comando: `verdent.addToChat` - Funciona desde la paleta de comandos y el contexto del editor Este es el atajo esencial para acceder rápidamente a Verdent desde cualquier lugar de VS Code sin interrumpir tu flujo de programación. **Comandos adicionales:** Disponibles a través de la paleta de comandos (los atajos predeterminados pueden personalizarse): - `verdent.addFeedBack` - Enviar comentarios - `verdent.addTerminalOutputToChat` - Añadir la salida del terminal a Verdent - `verdent.addToChatBySearch` - Añadir a Verdent mediante búsqueda - `verdent.centerButtonClicked` - Centro de usuario - `verdent.historyButtonClicked` - Historial del proyecto - `verdent.mcpButtonClicked` - Añadir servidor MCP - `verdent.openInNewTabByParams` - Abrir en una pestaña nueva - `verdent.plusButtonClicked` - Nueva sesión - `verdent.rulesButtonClicked` - Configuración de reglas - `verdent.SettingClicked` - Menú de ajustes - `verdent.subagentButtonClicked` - Añadir subagente ### Personalizar atajos Todos los atajos de teclado de Verdent pueden personalizarse mediante el sistema estándar de asignación de teclas de VS Code. Recomendado para la mayoría de los usuarios: interfaz visual para gestionar atajos. Presiona `Cmd+K Cmd+S` (macOS) o `Ctrl+K Ctrl+S` (Windows/Linux) Escribe "Verdent" en el cuadro de búsqueda para filtrar los comandos de Verdent Selecciona el icono del lápiz junto a cualquier comando, presiona la combinación de teclas que desees y presiona Enter para guardar Para usuarios avanzados: configuración JSON directa, compatible con el control de versiones. Presiona `Cmd+Shift+P` (macOS) o `Ctrl+Shift+P` (Windows/Linux) Escribe "Preferences: Open Keyboard Shortcuts (JSON)" y selecciónalo ```json macOS { "key": "cmd+shift+v", "command": "verdent.addToChat" } ``` ```json Windows/Linux { "key": "ctrl+shift+v", "command": "verdent.addToChat" } ``` **Alcance de la personalización:** - Todos los comandos de Verdent pueden reasignarse - Pueden asignarse múltiples atajos al mismo comando - Los atajos predeterminados pueden eliminarse - Los cambios se sincronizan entre equipos con la sincronización de ajustes de VS Code ### Atajos específicos de plataforma Verdent sigue las convenciones de teclado específicas de cada plataforma de VS Code: | Plataforma | Patrón de teclas modificadoras | | ----------------- | --------------------------------------------------- | | **macOS** | `Cmd` para los atajos principales, `Option` para los alternativos | | **Windows/Linux** | `Ctrl` para los atajos principales, `Alt` para los alternativos | **Patrones comunes:** - Ajustes: `Cmd+,` (macOS) frente a `Ctrl+,` (Windows/Linux) - Paleta de comandos: `Cmd+Shift+P` (macOS) frente a `Ctrl+Shift+P` (Windows/Linux) - Atajos de teclado: `Cmd+K Cmd+S` (macOS) frente a `Ctrl+K Ctrl+S` (Windows/Linux) --- ## Instrucciones personalizadas y personas Verdent for VS Code admite dos sistemas para personalizar el comportamiento de la IA: **Rules** para preferencias y directrices, y **Subagents** para personas de tareas especializadas. ### Sistema de reglas Las reglas definen cómo se comporta y responde Verdent durante las sesiones de programación. Las reglas se almacenan en archivos Markdown y se aplican de forma continua a lo largo de las conversaciones. #### Tres tipos de reglas **1. User Rules (VERDENT.md):** - **Ubicación:** `~/.verdent/` (directorio de configuración global) - **Alcance:** Se aplican a todas las conversaciones en todos los proyectos - **Propósito:** Preferencias personales de programación, estilo de comunicación, estándares de documentación **2. Project Rules (AGENTS.md):** - **Ubicación:** Directorio raíz del proyecto o espacio de trabajo - **Alcance:** Se aplican solo al proyecto actual - **Control de versiones:** Pueden confirmarse en git para estándares de todo el equipo - **Propósito:** Estándares de programación específicos del proyecto, patrones de arquitectura, requisitos de pruebas **3. Plan Rules (plan_rules.md):** - **Ubicación:** `~/.verdent/` (directorio de configuración global) - **Alcance:** Se aplican al usar Plan Mode en todos los proyectos - **Propósito:** Personalizar el contenido, el formato y el nivel de detalle del plan #### Crear y editar reglas Selecciona el botón **Settings** en la barra superior de Verdent y elige **Rules** en el menú desplegable Selecciona **User Rules**, **Project Rules** o **Plan Rules** según tus necesidades Los archivos de reglas se abren en el editor de VS Code. Usa formato Markdown para escribir instrucciones claras y directas Guarda el archivo. Las reglas se aplican de inmediato en las sesiones actuales y futuras, sin necesidad de reiniciar **Ejemplo de User Rules:** ```markdown # Code Style Preferences - Always use functional React components with hooks - Prefer TypeScript over JavaScript - Add JSDoc comments for all exported functions - Provide explanations before showing code ``` **Ejemplo de Project Rules:** ```markdown ## Testing instructions - Run `pnpm turbo run test --filter ` to run all checks - Fix test and type errors until suite is green - Add or update tests for code changes ## PR instructions - Title format: [] - Always run `pnpm lint` and `pnpm test` before committing ``` #### Almacenamiento y aplicación de las reglas | Tipo de regla | Ubicación | Alcance | Control de versiones | | ------------- | -------------------------- | ------------------------ | ------------------------------------- | | User Rules | `~/.verdent/VERDENT.md` | Todos los proyectos | Personal, no compartido | | Project Rules | `<project>/AGENTS.md` | Proyecto actual | Puede confirmarse para mantener la consistencia del equipo | | Plan Rules | `~/.verdent/plan_rules.md` | Todos los proyectos (Plan Mode) | Personal, no compartido | **Prioridad de configuración:** Cuando las reglas entran en conflicto, Verdent aplica este orden de prioridad: 1. **Project Rules (AGENTS.md)** - Máxima prioridad (específicas del proyecto) 2. **User Rules (VERDENT.md)** - Preferencias globales del usuario 3. **Comportamiento predeterminado** - Los valores predeterminados integrados de Verdent <Tip> Confirma AGENTS.md en el control de versiones para compartir los estándares de programación específicos del proyecto con todo tu equipo. El espacio de trabajo de cada miembro del equipo sigue automáticamente las reglas del proyecto mientras mantiene las preferencias individuales mediante VERDENT.md. </Tip> --- ## Subagentes Los subagentes son agentes de IA especializados con prompts de sistema personalizados y ventanas de contexto aisladas para gestionar tareas específicas. ### Subagentes integrados Verdent incluye tres subagentes predeterminados disponibles de inmediato sin configuración: <Tabs> <Tab title="@Verifier"> - Comprobaciones y verificaciones rápidas de código - Validación veloz sin una revisión completa - Úsalo para: comprobaciones rápidas de coherencia, validación de sintaxis, comprobaciones previas a la confirmación </Tab> <Tab title="@Explorer"> - Exploración y navegación rápidas de la base de código - Encuentra archivos rápidamente y responde preguntas sobre la base de código - Úsalo para: explorar bases de código desconocidas, encontrar componentes, entender la estructura </Tab> <Tab title="@Code-reviewer"> - Evaluación instantánea de la calidad del código - Identifica problemas de seguridad, mantenibilidad y rendimiento - Úsalo para: revisiones previas a la confirmación, auditorías de seguridad, optimización del rendimiento </Tab> </Tabs> ### Crear subagentes personalizados <Steps> <Step title="Acceder a la configuración de subagentes"> Selecciona **Settings** → **Subagents** en la barra superior de Verdent </Step> <Step title="Crear un nuevo subagente"> Crea un nuevo subagente o navega a `~/.verdent/subagents/` y crea un archivo markdown con frontmatter YAML </Step> <Step title="Definir el comportamiento del subagente"> Escribe un prompt de sistema que establezca la personalidad del subagente, su estilo de interpretación y su enfoque de las tareas </Step> <Step title="Especificar la política de invocación"> Define cuándo debe usarse el subagente (invocación estricta o flexible) </Step> </Steps> **Formato del archivo del subagente:** ```markdown --- name: security-reviewer description: Security-focused code review specialist --- # System Prompt You are a security-focused code reviewer. When analyzing code: - Prioritize security vulnerabilities (SQL injection, XSS, auth flaws) - Use skeptical, critical tone - assume code is vulnerable until proven otherwise - Provide specific remediation steps with code examples - Reference OWASP Top 10 and security best practices - Never approve code with unresolved security issues Invocation policy (strict): Only run security-reviewer if user explicitly requests it. When to use the security-reviewer agent: - User requests security review of authentication/authorization logic - User asks to audit code for vulnerabilities - User needs security assessment before deployment When NOT to use: - General code review without security focus - Opening or reading files without analysis ``` ### Gestionar subagentes Accede a través de **Settings → Subagents** para: - **Edit:** Modificar prompts de sistema, permisos de herramientas y configuraciones - **Copy:** Duplicar subagentes para crear variaciones o plantillas - **Delete:** Eliminar subagentes no utilizados - **Enable/Disable:** Alternar la disponibilidad sin eliminar ### Usar subagentes **Subagentes integrados:** - Referéncialos con menciones con @: `@Verifier`, `@Explorer`, `@Code-reviewer` - Se invocan automáticamente cuando se detectan los tipos de tarea apropiados **Subagentes personalizados:** - Selecciona el botón **Add Subagent** en el cuadro de entrada - Elige uno del menú desplegable - El agente principal delega automáticamente las tareas apropiadas ### Subagentes frente a reglas | Aspecto | Reglas | Subagentes | | ---------------- | ---------------------------- | --------------------------------- | | **Cuándo se aplican** | De forma continua, en cada respuesta | Bajo demanda para tareas específicas | | **Contexto** | Ventana de contexto principal compartida | Contexto separado y aislado | | **Comportamiento** | Preferencias y directrices | Personas de comportamiento específicas de cada tarea | | **Invocación** | Siempre activas | Delegación automática o manual | | **Propósito** | Definir QUÉ prefieres | Definir QUIÉN gestiona las tareas y CÓMO | **Ejemplo de flujo de trabajo:** 1. **User Rule:** "Generar pruebas unitarias para todas las funciones nuevas" 2. **Agente principal:** Detecta la necesidad de generar pruebas 3. **Delega en el subagente Test Generator:** Enfoque de pruebas exhaustivo y especializado 4. **Subagente:** Genera un conjunto completo de pruebas con contexto aislado 5. **Agente principal:** Recibe los resultados y continúa sin contaminar el contexto <Tip> Comparte subagentes con los miembros del equipo usando el botón **Copy** en Settings → Subagents, o compartiendo directamente los archivos markdown de los subagentes desde `~/.verdent/subagents/`. </Tip> --- ## Preguntas frecuentes <Accordion title="¿Cuándo surten efecto los cambios de configuración?"> La mayoría de los ajustes de Verdent se aplican de inmediato sin necesidad de reiniciar: - **Modos de permiso:** Cambian al instante desde el cuadro de entrada - **Presets de modelo:** Se aplican a la siguiente solicitud - **Archivos de reglas:** Se aplican a las nuevas conversaciones (al guardar se recargan) - **Subagentes:** Disponibles de inmediato tras su creación - **Atajos de teclado:** Se aplican tras guardar en VS Code **Excepción:** Los ajustes de la extensión VS Code (como `verdent.enableCheckpoints`) surten efecto de inmediato, pero pueden requerir volver a abrir archivos o sesiones para aplicarse por completo. </Accordion> <Accordion title="¿Cuál es la diferencia entre reglas y subagentes?"> Las **reglas** definen QUÉ prefieres de forma global: - Aplicación continua a todas las conversaciones - Estándares de programación, estilo de comunicación, preferencias - Se almacenan en archivos markdown (VERDENT.md, AGENTS.md, plan_rules.md) - Siempre activas en segundo plano Los **subagentes** definen QUIÉN gestiona tareas específicas y CÓMO: - Invocación bajo demanda para tipos de tarea específicos - Personas de comportamiento especializadas con prompts de sistema personalizados - Ventanas de contexto aisladas (no contaminan el contexto principal) - Delegación automática o manual mediante menciones con @ **Ejemplo:** Una regla dice "Generar pruebas unitarias para las funciones nuevas". Un subagente Test Generator se encarga de la creación real de las pruebas con una metodología de pruebas exhaustiva. </Accordion> <Accordion title="¿Puedo usar varios modos de permiso al mismo tiempo?"> No, los modos de permiso son mutuamente excluyentes: solo puedes usar UNO a la vez: - **Manual Accept** - Predeterminado, máximo control - **Auto-Run** - Optimizado para proyectos de confianza - **Plan** - Modo de planificación de solo lectura - **Skip Permissions** - Autonomía total Puedes cambiar de modo al instante con el botón **Switch Permission** en el cuadro de entrada. La mayoría de los usuarios alternan entre modos según el contexto de la tarea (por ejemplo, Plan Mode para funcionalidades complejas, Auto-Run para correcciones rápidas). </Accordion> <Accordion title="¿Cómo elijo el preset de modelo adecuado para mi tarea?"> Ajusta el preset de modelo a la complejidad de la tarea y al presupuesto: **Usa Efficiency (3.2x más eficiente que Sonnet):** - Correcciones rápidas de errores y generación de código sencilla - Operaciones rutinarias y tareas de alta frecuencia - Cuando la velocidad importa más que la profundidad **Usa Balance (1x base) - Predeterminado:** - Desarrollo general y programación diaria - Implementación de funcionalidades y revisiones de código - Rendimiento equilibrado para la mayoría de los escenarios **Usa Performance (0.5x de eficiencia, 2x de costo):** - Decisiones de arquitectura complejas - Bases de código grandes que requieren un contexto amplio (200k+ tokens) - Depuración y refactorización sofisticadas **Consejo profesional:** La mayoría de los usuarios mantienen Balance como predeterminado y cambian a Performance solo cuando alcanzan los límites de contexto o necesitan un razonamiento profundo. </Accordion> --- ## Consulta también <CardGroup cols={2}> <Card title="Flujos de trabajo con planificación primero" icon="sitemap" href="/docs/verdent-for-vscode/configuration/plan-workflows"> Configura la planificación de tareas asistida por IA y los flujos de trabajo de aprobación </Card> <Card title="Optimización de la configuración" icon="sliders" href="/docs/verdent-for-vscode/configuration/tuning"> Ajusta la configuración para optimizar la velocidad, el costo y el rendimiento </Card> </CardGroup>