---
title: Preguntas frecuentes
description: Preguntas comunes sobre Verdent for VS Code
---



Respuestas a las preguntas frecuentes sobre las características, capacidades y uso de Verdent.

---

## Primeros pasos

<Tip>
Completa la guía de inicio rápido antes de profundizar en las características avanzadas; cubre conceptos esenciales que aparecen a lo largo de la documentación.
</Tip>

---

## Problemas comunes (los 4 principales)

<Accordion title="¿Por qué no puedo iniciar sesión en Verdent for VS Code?">
**Causa más común:** problema de configuración del proxy

**Solución:**
1. Abre la configuración de VS Code (`Cmd+,` en macOS o `Ctrl+,` en Windows/Linux)
2. Busca "useProxy" o "verdent.enableProxy"
3. Activa o desactiva la configuración del proxy (lo opuesto a su estado actual)
4. Intenta iniciar sesión de nuevo

**Explicación:** si estás detrás del firewall de una empresa, es posible que debas habilitar la configuración del proxy. Si estás en una red doméstica, intenta desactivarla.
</Accordion>

<Accordion title="¿Por qué no recibí mis créditos de prueba gratuita?">
**Error:** no se recibieron los créditos de prueba gratuita o se denegó el acceso a la prueba gratuita

**Motivo:** se detectó una violación de los términos de servicio durante el registro

**Solución:** contacta a support@verdent.ai para obtener ayuda con tu acceso a la prueba gratuita. El equipo de soporte revisará tu cuenta y te ayudará a resolver el problema.
</Accordion>

<Accordion title="¿Por qué falló mi registro?">
**Error:** el registro de la cuenta fue rechazado o restringido

**Motivo:** el registro violó los términos de servicio de Verdent, lo que resultó en una restricción de acceso

**Solución:** contacta a support@verdent.ai para obtener ayuda. El equipo de soporte puede revisar tu registro y orientarte sobre cómo resolver el problema.
</Accordion>

<Accordion title="¿Por qué no encuentro los modelos Claude, GPT o Gemini?">
**Problema:** no se encuentran ciertos modelos de IA en el menú de selección de modelos

**Motivo:** restricciones por ubicación de los proveedores de modelos

**Explicación:** algunos proveedores de modelos de IA (Anthropic, OpenAI, Google) tienen restricciones regionales que impiden que ciertos modelos estén disponibles en determinadas ubicaciones geográficas. Cuando esto ocurre:
- Los modelos restringidos no aparecerán en tu menú de selección de modelos
- Puedes seguir usando todos los demás modelos disponibles sin interrupciones
- No afecta tu suscripción ni tus créditos

**Consultar modelos disponibles:** visita https://www.verdent.ai/regions para ver qué modelos están disponibles en tu región

**Nota:** las restricciones regionales las establecen los proveedores de modelos de IA, no Verdent. Verdent no puede anular estas restricciones.
</Accordion>

---

<Accordion title="¿Qué es Visual Studio Code?">
Visual Studio Code es un editor de código gratuito y de código abierto desarrollado por Microsoft. Es un entorno de desarrollo ligero pero potente que admite múltiples lenguajes de programación y ofrece características como depuración, resaltado de sintaxis, autocompletado inteligente de código y control de versiones integrado. Verdent se integra directamente en Visual Studio Code como una extensión, añadiendo capacidades de programación con IA a tu flujo de trabajo existente.
</Accordion>

<Accordion title="¿Qué es Verdent for VS Code?">
Verdent es una extensión de asistente de programación con IA para Visual Studio Code que ayuda con la generación de código, la refactorización, la depuración y la navegación por proyectos mediante conversaciones en lenguaje natural.

**Capacidades clave:**
- Generación y modificación de código mediante herramientas de archivos
- Exploración del código base con subagentes especializados
- Ejecución de comandos mediante integración con bash
- Extensibilidad personalizada mediante reglas y servidores MCP
</Accordion>

<Accordion title="¿Cuáles son los requisitos del sistema?">
**Requisitos mínimos:**
- Visual Studio Code 1.90.0 o superior
- Suscripción activa a Verdent
- Conexión a internet

**Plataformas compatibles:** macOS, Windows, Linux, WSL
</Accordion>

<Accordion title="¿Cómo empiezo a usar Verdent después de la instalación?">
1. Instala la extensión Verdent desde el marketplace de VS Code
2. Inicia sesión con tu cuenta de Verdent cuando se te solicite
3. Abre cualquier archivo de código o proyecto
4. Abre la vista de chat y empieza a conversar con Verdent

**Sugerencia para la primera tarea:** pídele a Verdent que te explique la estructura de tu proyecto o que revise un archivo específico.
</Accordion>

<Accordion title="¿Cómo verifico mi versión de Visual Studio Code?">
Abre Visual Studio Code y ve a **Help** → **About** (o **Code** → **About Visual Studio Code** en macOS). El número de versión se muestra en el cuadro de diálogo. Verdent requiere la versión 1.90.0 o superior de Visual Studio Code.

También puedes verificarlo desde la línea de comandos:
```bash
code --version
```
</Accordion>

<Accordion title="¿Qué son los créditos?">
Consulta [Créditos y planes](/docs/account-billing/credits-and-plans) para ver la definición común de créditos, los niveles de precios y los conceptos básicos de uso en los productos de Verdent.
</Accordion>

<Accordion title="¿Qué pasa si me quedo sin créditos?">
Consulta [Qué pasa si te quedas sin créditos](/docs/account-billing/run-out-of-credits) para conocer la política común de cuentas y las opciones de recuperación.
</Accordion>

<Accordion title="¿Verdent sube mis imágenes a servidores externos?">
Las imágenes pegadas desde el portapapeles o referenciadas por ruta de archivo se procesan dentro de tu sesión de conversación. Las imágenes no se almacenan de forma permanente y se eliminan cuando inicias una nueva conversación. Las referencias por ruta de archivo leen la imagen localmente sin subirla.
</Accordion>

<Accordion title="¿Qué es Plan Mode?">
Plan Mode es un modo de ejecución de solo lectura en el que Verdent analiza el código, realiza investigaciones y crea planes de implementación detallados sin modificar archivos ni ejecutar comandos. Después de generar un plan, Verdent presenta dos opciones: **Edit** (para solicitar modificaciones y refinar el plan) o **Start Building** (para cambiar a Agent Mode y comenzar la ejecución). El agente puede hacer preguntas aclaratorias para eliminar la incertidumbre antes de la ejecución. Este modo es ideal para tareas complejas en las que quieres revisar el enfoque antes de comprometerte con los cambios, garantizando la alineación entre tus expectativas y la solución propuesta por Verdent.
</Accordion>

<Accordion title="¿Plan Mode realmente escribe código en mis archivos?">
**No.** Plan Mode es estrictamente de solo lectura:

- Verdent puede leer archivos, buscar código y analizar tu código base
- **No se producen escrituras, ediciones ni eliminaciones de archivos** durante Plan Mode
- Los planes se muestran solo en la vista de chat
- La ejecución de código comienza únicamente después de que apruebes explícitamente y cambies a Agent Mode

**Garantía de seguridad:** Plan Mode no puede modificar tu código accidentalmente. Está diseñado para la exploración segura y el desarrollo de estrategias.
</Accordion>

<Accordion title="¿Cómo cambio entre Plan Mode y Agent Mode?">
**El cambio es instantáneo desde el cuadro de entrada:**

**Para entrar en Plan Mode:**
- Selecciona el botón **Switch Mode** en el cuadro de entrada
- Selecciona **Plan Mode** en el menú desplegable
- O di: "Switch to Plan Mode"

**Para salir de Plan Mode:**
- Selecciona el botón **Switch Mode** en el cuadro de entrada
- Selecciona **Agent Mode** en el menú desplegable
- O elige **Start Building** después de revisar un plan

**Persistencia del modo:**
- La elección del modo persiste dentro de la sesión actual
- Las sesiones nuevas comienzan en el Agent Mode predeterminado
- Puedes cambiar de modo libremente en cualquier momento

**Flujo de trabajo típico:** Plan Mode → revisar → Agent Mode → ejecutar → volver a Plan Mode para la siguiente característica compleja.
</Accordion>

<Accordion title="¿Cómo inicio una nueva conversación con contexto limpio?">
Selecciona el botón "New Session" en la barra superior. Esto borra el historial de la conversación actual y le da a Verdent una ventana de contexto nueva para tu siguiente tarea.
</Accordion>

<Accordion title="¿Puedo usar Verdent en varios proyectos a la vez?">
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 por separado.
</Accordion>

<Accordion title="¿Verdent funciona con GitHub, GitLab, Bitbucket y otras plataformas de Git?">
Sí. Verdent usa comandos estándar de Git, por lo que funciona con cualquier repositorio de Git sin importar la plataforma de alojamiento. Para crear pull requests, Verdent usa la CLI `gh` que requiere GitHub, pero todas las demás operaciones de Git funcionan de forma universal.
</Accordion>

---

## Herramientas y capacidades

<Accordion title="¿Con qué formatos de archivo puede trabajar Verdent?">
**Compatibles:** todos los formatos de archivo basados en texto, incluyendo:
- Código fuente (JavaScript, Python, TypeScript, Java, Go, etc.)
- Archivos de configuración (JSON, YAML, TOML, XML, ENV)
- Documentación (Markdown, HTML, LaTeX)
- Archivos de compilación (package.json, Makefile, requirements.txt)

**No compatibles:** archivos binarios (imágenes, videos, PDF, binarios compilados, documentos de Office)

**Solución alternativa:** puedes referenciar archivos binarios en el código, pero las modificaciones requieren herramientas externas.
</Accordion>

<Accordion title="¿Qué lenguajes de programación admite mejor Verdent?">
**Soporte excelente:**
- JavaScript, TypeScript, Python, React, Vue, Angular
- Node.js, Go, Java/Spring, C#/.NET
- Swift, Kotlin, Flutter

**Soporte muy bueno:** Rust, C/C++, Ruby, R

**Soporte bueno:** PHP, Assembly, Julia

Los lenguajes comunes tienen mejor soporte debido a la abundancia de datos de entrenamiento.
</Accordion>

<Accordion title="¿Cómo lee y modifica archivos Verdent?">
Tres herramientas de operación de archivos:
- **file_read:** lee archivos completos o rangos de líneas específicos
- **file_edit:** reemplaza patrones de texto específicos (modificaciones puntuales)
- **file_write:** crea archivos nuevos o reescribe archivos completos

**Buena práctica:** usa `file_edit` para modificaciones y `file_write` solo para archivos nuevos.
</Accordion>

<Accordion title="¿Qué es la ejecución de comandos?">
Es la ejecución de 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 deseados en el sistema.
</Accordion>

<Accordion title="¿Puede Verdent ejecutar comandos en mi terminal?">
Sí, mediante la herramienta `bash`. Verdent puede ejecutar comandos de terminal con:
- Tiempo de espera máximo: 120 segundos (2 minutos)
- Encadenamiento de comandos con `&&`
- Soporte multiplataforma (bash en Unix, PowerShell en Windows)

**Seguridad:** los comandos se ejecutan con tus permisos de usuario. Usa Manual Accept Mode para revisarlos antes de la ejecución.
</Accordion>

<Accordion title="¿Cuánto tiempo pueden ejecutarse los comandos de bash?">
**Tiempo de espera máximo:** 120 segundos (2 minutos)

Los comandos que superen los 2 minutos se terminarán automáticamente. Para operaciones más largas, considera:

**Alternativas:**
- Divide en comandos más pequeños: `bash("task1") && bash("task2")`
- Divide en operaciones más pequeñas
- Ejecuta en segundo plano y verifica los resultados por separado
</Accordion>

<Accordion title="¿Qué es el ciclo Multipass de generación-prueba-reparación?">
Es un proceso de verificación iterativo en el que se genera, prueba y repara el código hasta que pasa pruebas exhaustivas. Verdent ejecuta pruebas automáticamente, analiza los fallos, corrige los problemas y vuelve a probar en varias pasadas hasta que el código funciona correctamente. Esto produce 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ó.
</Accordion>

<Check>
Los ciclos de pruebas Multipass corrigen y vuelven a probar el código automáticamente hasta que pasa; así es como Verdent garantiza que esté listo para producción.
</Check>

---

## Subagentes y ejecución

<Accordion title="¿Qué son los subagentes y cuándo debería usarlos?">
Los subagentes son agentes de IA especializados con ventanas de contexto aisladas para tareas específicas.

**Subagentes integrados:**
- **@Explorer:** búsquedas en el código base, preguntas sobre arquitectura
- **@Verifier:** comprobaciones rápidas de validación
- **@Code-reviewer:** revisiones de seguridad y calidad

**Cuándo usarlos:** delega tareas de investigación, validación o revisión para ahorrar contexto en la conversación principal.

**Cómo crear subagentes personalizados:**

Crea un archivo markdown en `~/.verdent/subagents/`:

```markdown
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]
```

**Casos de uso:** experiencia en dominios específicos (finanzas, salud), flujos de trabajo de equipo, especialistas en tecnología.
</Accordion>

<Accordion title="¿Qué es la contaminación del contexto?">
Ocurre cuando acciones e información previas en el contexto crean patrones de comportamiento no deseados que afectan a 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 el 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.
</Accordion>

<Accordion title="¿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.
</Accordion>

<Accordion title="¿Cuál es la diferencia entre Auto-Run Mode y Manual Accept Mode?">
**Auto-Run Mode:**
- Las operaciones con archivos se ejecutan automáticamente sin aprobación
- Los comandos siguen requiriendo permiso
- Flujo de trabajo más rápido para códigos base de confianza
- Ideal para proyectos individuales con control de versiones

**Manual Accept Mode:**
- Revisa y aprueba cada operación protegida
- Más seguro para códigos base compartidos o de producción
- Ve exactamente qué se ejecutará antes de hacerlo

Cambia de modo desde la configuración o la paleta de comandos.
</Accordion>

<Accordion title="¿Qué son las operaciones seguras?">
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.
</Accordion>

<Accordion title="¿Puedo usar varios modos de permisos al mismo tiempo?">
No, los modos de permisos 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 mediante 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 características complejas, Auto-Run para correcciones rápidas).
</Accordion>

<Accordion title="¿Cuándo debería usar el agente Explorer en lugar de cargar archivos directamente?">
Usa el agente Explorer para tareas de descubrimiento y búsqueda sin consumir el contexto principal. Carga los archivos directamente con menciones @ solo cuando necesites modificarlos. Explorer es ideal para preguntas del tipo "encuentra todos los archivos que...", mientras que las menciones @ son para tareas del tipo "actualiza este archivo específico".
</Accordion>

<Accordion title="¿Puedo crear subagentes personalizados para mi proyecto?">
¡Sí! Crea subagentes personalizados en `~/.verdent/subagents/`:

```markdown
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]
```

**Casos de uso:** experiencia en dominios específicos (finanzas, salud), flujos de trabajo de equipo, especialistas en tecnología.
</Accordion>

<Accordion title="¿Puedo detener a Verdent en medio de una tarea de varios pasos?">
Sí. Puedes interrumpir la ejecución en cualquier momento. Verdent completará el paso en el que está trabajando y luego se detendrá. El progreso hasta ese punto se conserva. Puedes revisar lo que se ha hecho, hacer ajustes y continuar o tomar un enfoque diferente.
</Accordion>

<Accordion title="¿Cómo sé qué está haciendo Verdent en este momento en una tarea larga?">
Observa la lista de tareas pendientes. Muestra el estado en tiempo real con un elemento marcado como "in progress" en cada momento. El elemento activo muestra exactamente en qué está trabajando Verdent actualmente. Los elementos completados se marcan como terminados y los pendientes muestran lo que queda por hacer.
</Accordion>

<Accordion title="¿Verdent confirma mis cambios automáticamente?">
No. Verdent solo crea commits cuando lo solicitas explícitamente. Mantienes el control total sobre cuándo se confirman los cambios. Simplemente di "Stage all changes and create a commit" cuando estés listo.
</Accordion>

<Accordion title="¿Verdent hará push a los repositorios remotos sin preguntar?">
No. Verdent solo hace push a los repositorios remotos cuando lo solicitas explícitamente. Todas las operaciones de Git (commit, push, merge, rebase) requieren tu instrucción explícita por seguridad.
</Accordion>

---

## Personalización e integración

<Accordion title="¿Cómo personalizo el comportamiento de Verdent para mi equipo?">
Tres métodos de personalización:

1. **VERDENT.md:** preferencias globales personales (`~/.verdent/VERDENT.md`)
2. **AGENTS.md:** estándares de equipo específicos del proyecto (raíz del proyecto, bajo control de versiones)
3. **plan_rules.md:** formato de salida de Plan Mode (`~/.verdent/plan_rules.md`)

AGENTS.md tiene prioridad sobre VERDENT.md para mantener la coherencia del equipo.
</Accordion>

<Accordion title="¿Cuándo surten efecto los cambios de configuración?">
La mayoría de las configuraciones de Verdent se aplican de inmediato sin necesidad de reiniciar:

- **Modos de permisos:** cambia al instante desde el cuadro de entrada
- **Presets de modelos:** se aplican a la siguiente solicitud
- **Archivos de reglas:** se aplican a conversaciones nuevas (guardar activa una recarga)
- **Subagentes:** disponibles de inmediato tras su creación
- **Atajos de teclado:** se aplican tras guardar en VS Code

**Excepción:** las configuraciones de la extensión de VS Code (como `verdent.enableCheckpoints`) surten efecto de inmediato, pero pueden requerir reabrir archivos o sesiones para aplicarse por completo.
</Accordion>

<Accordion title="¿Qué es MCP y cómo lo uso?">
El Model Context Protocol (MCP) extiende Verdent con herramientas y servicios externos:

**Configuración:** `~/.verdent/mcp.json` mediante Settings → MCP Servers

**Capacidades:**
- Conexiones a bases de datos (PostgreSQL, MySQL, MongoDB)
- Servicios en la nube (AWS, Azure, GCP)
- Herramientas de gestión de proyectos (Jira, Linear)
- Pipelines de CI/CD (Jenkins, GitHub Actions)

**Estado:** la documentación de integración de MCP está en desarrollo. Contacta a support@verdent.ai para obtener ayuda con la configuración.
</Accordion>

---

## Buenas prácticas y rendimiento

<Tip>
Supervisa el uso de créditos en el Centro de usuario para hacer un seguimiento de los patrones de consumo y optimizar la eficiencia de tu flujo de trabajo.
</Tip>

<Accordion title="¿Qué es un token?">
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.
</Accordion>

<Accordion title="¿Qué cuenta para mi ventana de contexto?">
Todo lo que hay en tu sesión: todos los mensajes de la conversación, el contenido de los archivos cargados en el contexto, las salidas de las herramientas (resultados de grep/búsqueda, lecturas de archivos), los prompts e instrucciones del sistema y las definiciones de los servidores MCP. Cada uno de estos consume tokens de tu capacidad total de contexto.
</Accordion>

<Accordion title="¿Cuál es la diferencia entre las ventanas de contexto de 200K y 1M?">
Los modelos estándar (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) tienen ventanas de contexto de `200K` tokens, suficientes para la mayoría de las tareas. Claude Sonnet 4.5 ofrece un contexto extendido de `1M` tokens (5 veces mayor) para códigos base grandes con archivos de `1000+`, refactorizaciones complejas de varios archivos o sesiones de desarrollo largas. El contexto de `1M` se activa automáticamente cuando la entrada supera los `200K` tokens o puede seleccionarse explícitamente.
</Accordion>

<Accordion title="¿Cuántos archivos puedo cargar de forma segura en el contexto?">
No hay un límite fijo de archivos: depende del tamaño de los archivos y del recuento total de tokens. Para contextos de `200K`, evita cargar `20+` archivos grandes (`>1000` líneas cada uno). Concéntrate en los archivos directamente relevantes para tu tarea actual. Usa `@-mentions` de forma selectiva y aprovecha la documentación de `AGENTS.md` en lugar de cargar muchos archivos de ejemplo. Con el contexto de `1M`, la selección de archivos pasa a ser mucho menos crítica.
</Accordion>

<Accordion title="¿Cómo sé cuándo me estoy acercando a los límites de contexto?">
Las señales incluyen tiempos de respuesta más lentos, sesiones que se ejecutan durante varias horas o muchos archivos grandes cargados. Supervisa la duración de tu sesión y el número de archivos. Cuando notes una degradación del rendimiento, completa tu tarea actual, confirma tu progreso e inicia una nueva sesión con contexto limpio.
</Accordion>

<Accordion title="¿Cómo evito el agotamiento de la ventana de contexto?">
**Estrategias:**
1. **Lectura estratégica de archivos:** usa rangos de líneas para archivos grandes
2. **Delegar a subagentes:** Explorer/Verifier para investigación en segundo plano
3. **Buscar antes de leer:** usa `grep_file` para identificar los archivos relevantes
4. **Dividir operaciones:** usa `todo_update` para hacer seguimiento de tareas de varios pasos

**Regla general:** los archivos de más de 500 líneas deberían usar rangos de líneas.
</Accordion>

<Accordion title="¿Debo reiniciar el contexto manualmente o Verdent lo hará automáticamente?">
Debes iniciar manualmente una nueva sesión para reiniciar el contexto: Verdent no borra el contexto automáticamente. Buena práctica: reinícialo tras completar una unidad de trabajo atómica, hacer pruebas y confirmar en el control de versiones. Para contextos de `1M` tokens, los reinicios se necesitan con mucha menos frecuencia.
</Accordion>

<Accordion title="¿Reiniciar el contexto hará que pierda mi trabajo?">
No: reiniciar el contexto solo borra de la memoria el historial de la conversación y los archivos cargados. Tus cambios reales de código, commits y modificaciones de archivos se conservan. Confirma siempre tu trabajo en el control de versiones antes de reiniciar el contexto, por seguridad. Reinicia → inicia una nueva sesión → continúa trabajando en la siguiente tarea.
</Accordion>

<Accordion title="¿Qué tan específicos deben ser mis prompts?">
Sé lo bastante específico para eliminar la ambigüedad, pero no expliques en exceso detalles obvios. Incluye: rutas de archivo exactas, enfoque de implementación, resultados esperados y restricciones. Malo: "Arregla el código", demasiado vago. Bueno: "Añade validación de entrada al campo de email en `ContactForm.js` para rechazar formatos de email inválidos", alcance y objetivo claros. En caso de duda, opta por una mayor especificidad.
</Accordion>

<Accordion title="¿Cuál es la diferencia entre las menciones @ y la carga automática de archivos?">
Verdent carga automáticamente los archivos mencionados por nombre en los prompts y los archivos relacionados del mismo directorio. `@-mentions` (`@filename.js`) garantizan explícitamente que un archivo esté en el contexto, lo cual es fundamental al trabajar con archivos estrechamente acoplados, al referenciar patrones de un archivo para aplicarlos en otro, o cuando la detección automática podría omitir contexto en códigos base grandes. Usa siempre `@-mentions` cuando le pidas a Verdent que "siga el mismo patrón que..." para asegurar una referencia de código exacta.
</Accordion>

<Accordion title="¿Necesito repetir el contexto del proyecto en cada prompt durante una sesión?">
No: Verdent mantiene el contexto de la conversación dentro de una sesión, así que no necesitas repetir detalles de arquitectura o convenciones que ya se hayan tratado. Sin embargo, para restricciones críticas o cuando las sesiones se vuelven largas (`100+` mensajes), reformula el contexto importante. Mejor enfoque: usa reglas de proyecto (`AGENTS.md`) para documentar el contexto persistente, como el stack tecnológico, los estándares de codificación y los patrones; así nunca necesitarás repetirlos.
</Accordion>

<Accordion title="¿Qué pasa si Verdent no entiende o no sigue correctamente mi prompt?">
Usa el refinamiento iterativo: revisa la salida, identifica qué está mal y luego proporciona correcciones en un prompt de seguimiento. Ejemplo: "La lógica de validación es buena, pero usa la validación de esquema de Joi en lugar de comprobaciones manuales. Sigue el patrón de validación de `ProductController.js`." También puedes pedir explicaciones: "¿Por qué usaste Redux en lugar de Context API?" y luego refinar según lo que entiendas. No repitas el mismo prompt: ajústalo según lo que falló.
</Accordion>

<Accordion title="¿Cuándo debería usar Plan Mode en lugar del modo normal?">
Usa Plan Mode para: refactorizaciones grandes o cambios de arquitectura, modificaciones de varios archivos en las que quieres revisar el alcance antes de la ejecución, tareas complejas en las que no tienes certeza sobre los requisitos, o cuando quieres que Verdent te entreviste con preguntas aclaratorias antes de la implementación. Omite Plan Mode para: tareas simples y bien definidas, correcciones rápidas de errores u operaciones rutinarias. Plan Mode añade sobrecarga, pero evita errores costosos en trabajos complejos.
</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,2 veces más eficiente que Sonnet):**
- Correcciones rápidas de errores y generación de código simple
- Operaciones rutinarias y tareas de alta frecuencia
- Cuando la velocidad importa más que la profundidad

**Usa Balance (línea base 1x) - predeterminado:**
- Desarrollo general y codificación cotidiana
- Implementación de características y revisiones de código
- Rendimiento equilibrado para la mayoría de los escenarios

**Usa Performance (eficiencia 0,5x, costo 2x):**
- Decisiones arquitectónicas complejas
- Códigos base grandes que requieren contexto extenso (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>

---

## Solución de problemas

<Accordion title="¿Cómo soluciono problemas de firewall o de conexión?">
Si Verdent no puede conectarse a los servicios de IA, revisa estos problemas comunes:

**Prueba la conectividad básica:**
- Verifica que tengas acceso activo a internet
- Intenta acceder a otros servicios HTTPS para confirmar que las conexiones salientes funcionan

**Entornos corporativos/empresariales:**
- Contacta al administrador de tu red para incluir en la lista blanca los endpoints de API de Verdent
- Asegúrate de que el tráfico HTTPS saliente esté permitido a través de tu firewall
- Verifica que los servidores proxy estén configurados correctamente para dejar pasar las solicitudes de API
- La inspección de SSL/TLS puede necesitar excepciones para los endpoints de Verdent

**Síntomas comunes:**
- La extensión parece colgarse o agotar el tiempo de espera
- Fallos de autenticación a pesar de tener credenciales correctas

Si los problemas persisten después de configurar el firewall, contacta al soporte de Verdent para obtener detalles específicos de los endpoints que debes incluir en la lista blanca.
</Accordion>

<Accordion title="Mis reglas de AGENTS.md no se están aplicando. ¿Por qué?">
**Verifica:**
- **Ubicación:** el archivo está en el directorio raíz del proyecto
- **Sintaxis:** Markdown válido
- **Especificidad:** las reglas son directivas ("Usa siempre..." en lugar de "Intenta usar...")
- **Prueba en limpio:** inicia una nueva conversación para probar la aplicación

**Precedencia:** AGENTS.md tiene prioridad sobre VERDENT.md para el comportamiento específico del proyecto.
</Accordion>

<Accordion title="¿Cómo soluciono los errores 'file_edit failed to find exact match'?">
**Causas:**
- El texto cambió desde la última lectura
- Diferencias de espacios en blanco (espacios frente a tabulaciones)
- La cadena no es única en el archivo

**Soluciones:**
- Lee el archivo de nuevo para obtener el contenido actual
- Proporciona una cadena de contexto más amplia para garantizar la unicidad
- Usa `replace_all=true` para múltiples cadenas idénticas
- Verifica que file_path sea correcto
</Accordion>

<Accordion title="¿Por qué mi subagente personalizado no se invoca automáticamente?">
**Verifica:**
- **Ubicación:** el archivo está en `~/.verdent/subagents/[name].md`
- **Política de invocación:** una política estricta requiere una mención @ explícita
- **Frontmatter YAML:** sintaxis válida
- **Pautas de "Cuándo usarlo":** coinciden con el patrón de tu solicitud

**Prueba:** usa una mención @ explícita para verificar que el subagente funciona: `@your-subagent do task`
</Accordion>

---

## Consulta también

<CardGroup cols={2}>
  <Card title="Referencia de herramientas" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Capacidades completas de las herramientas
  </Card>
  <Card title="Solución de problemas" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    Problemas comunes y soluciones
  </Card>
</CardGroup>