Modos de ejecución y permisos
Comprende los diferentes modos de ejecución y cuándo usarlos
Verdent for VS Code ofrece múltiples modos de ejecución que controlan cómo la IA interactúa con tus archivos y ejecuta comandos. Cada modo presenta diferentes equilibrios entre control, velocidad y seguridad.
Lo que aprenderás
- Cómo funciona cada modo de ejecución y cuándo usarlo
- Modelos de permisos y consideraciones de seguridad
- Comparación de modos y estrategias de cambio
- Think Hard Mode para tareas de razonamiento complejo
Modos clave disponibles
Manual Accept Mode
Modo predeterminado con solicitudes de permiso para cada operación protegida. Máximo control y supervisión.
Auto-Run Mode
Operaciones de archivos automáticas, con permiso requerido para los comandos. Equilibra velocidad y seguridad.
Skip Permission Mode
Autonomía total para entornos aislados. Sin solicitudes de permiso para nada.
Plan Mode
Modo de planificación de solo lectura. Revisa el plan completo antes de comenzar la ejecución.
Modos de ejecución
Manual Accept Mode es el modo de ejecución predeterminado que ofrece control sobre las modificaciones de archivos y la ejecución de comandos.
Operaciones automáticas:
- Lectura de archivos y análisis de código
- Exploración de directorios
Requiere permiso:
- Edición de archivos (crear, modificar, eliminar)
- Ejecución de comandos (comandos de terminal, pruebas, compilaciones)
Cuando Verdent necesita realizar una operación protegida, muestra qué acción quiere ejecutar y qué archivo o comando está involucrado. Puedes aceptar o rechazar cada operación.
Importante: Cada permiso es solo para esa operación específica. Manual Accept Mode requiere aprobación para cada operación protegida durante toda la sesión.
Cuándo usarlo
- Aprender las capacidades de Verdent y los patrones de flujo de trabajo
- Trabajar en bases de código desconocidas que requieren supervisión cuidadosa
- Cambios críticos en código de producción o áreas sensibles a la seguridad
- Requisitos de cumplimiento que necesitan registros de aprobación explícitos
Activación
Manual Accept Mode está activo de forma predeterminada. Para volver a él:
Abre el menú de permisos
Selecciona el botón "Switch Permission" en el cuadro de entrada
Selecciona Manual Accept Mode
Elige "Manual Accept Mode" en el menú desplegable
Verifica la activación
El botón muestra "Manual" para confirmar que el modo está activo
Consideraciones de seguridad
Ventajas:
- Aprobación en el primer uso por tipo de herramienta (ediciones de archivos, comandos, herramientas)
- Visibilidad completa antes de conceder acceso
- Máximo control y transparencia
Limitaciones:
- Tras la primera aprobación de un tipo de herramienta, los usos posteriores continúan sin solicitudes
- La aprobación es por tipo de herramienta, no por operación
- Inicia nuevas sesiones al trabajar en código crítico para restablecer las aprobaciones de herramientas
Auto-Run Mode aprueba automáticamente las operaciones de archivos mientras requiere permiso para los comandos. Esto reduce las solicitudes de permiso para el trabajo rutinario con archivos a la vez que mantiene la seguridad en las operaciones riesgosas.
Automático:
- Lectura, edición, creación y eliminación de archivos dentro del espacio de trabajo
- Mover, renombrar y organizar archivos dentro del espacio de trabajo
- Operaciones de búsqueda y navegación de archivos
Requiere permiso:
- Cualquier comando que involucre rutas fuera del espacio de trabajo actual
- Comandos bash peligrosos:
rm -rf,git commit,git push, etc. - Ejecución de comandos (terminal, scripts, compilaciones)
- Instalación de paquetes y modificaciones del sistema
Cuándo usarlo
| Usa Auto-Run para | No lo uses para |
|---|---|
| Bases de código confiables con control de versiones | Bases de código desconocidas |
| Prototipado y experimentación rápidos | Código de producción crítico |
| Refactorización multiarchivo (15+ archivos = 15 solicitudes ahorradas) | Sin red de seguridad de control de versiones |
| Desarrollo enfocado que minimiza interrupciones | Requisitos de cumplimiento |
Activación
Abre el menú de permisos
Selecciona el botón "Switch Permission" que muestra el modo actual
Selecciona Auto-Run Mode
Elige "Auto-Run Mode" en el menú desplegable
Verifica la activación
El botón muestra "Auto" para confirmar que el modo está activo
Persiste entre sesiones y reinicios de VS Code. Se aplica globalmente a todos los espacios de trabajo.
Ejemplo de flujo de trabajo
Construir un endpoint POST /api/tasks:
- Activa Auto-Run Mode
- Envía: "Crea un endpoint POST /api/tasks que valide que la categoría existe y guarde en la base de datos"
- Verdent lee más de 5 archivos y modifica 3 archivos automáticamente (sin solicitudes)
- Revisa los cambios en el panel de Source Control
- Solicita pruebas: "Ejecuta las pruebas del API de tareas"
- Solicitud de permiso para el comando
npm test: acepta - Agrega validación: "Agrega validación para títulos vacíos"
- Verdent edita automáticamente (sin solicitud)
- Solicita pruebas de nuevo: solicitud de permiso: acepta
- Revisa las diferencias y confirma los cambios
Resultado: 3 solicitudes de comando, 0 solicitudes de archivo. La aceptación manual requeriría 4 solicitudes de archivo adicionales.
Consideraciones de seguridad
Ventajas:
- Los cambios son visibles de inmediato en VS Code
- Alcance limitado al espacio de trabajo (no puede afectar archivos del sistema)
- Git ofrece seguridad de reversión
Riesgos:
- Sin supervisión de las operaciones de archivos
- Alcance inesperado ("Renombra User a Account" podría modificar docenas de archivos)
- Posible eliminación de archivos durante la limpieza
- Podría modificar archivos sensibles si se le indica
Mitigación:
- Usa prompts claros y específicos
- Revisa el panel de Source Control tras las finalizaciones
- Confirma con frecuencia para tener puntos de control limpios
- Usa primero Plan Mode para operaciones complejas
- Configura .gitignore para proteger archivos sensibles
Skip Permission Mode omite todas las solicitudes de permiso, permitiendo autonomía completa. Úsalo solo en entornos aislados y desechables.
Todas las operaciones automáticas:
- Operaciones de archivos
- Ejecución de comandos
- Instalación de paquetes
- Operaciones a nivel de sistema
Este modo elimina todas las protecciones de seguridad. Úsalo solo en entornos completamente aislados y desechables donde los errores no tengan consecuencias. Nunca lo uses en producción ni en ninguna base de código que te importe.
Cuándo usarlo
| Usa Skip Permission para | NUNCA lo uses para |
|---|---|
| Pipelines de CI/CD automatizados en contenedores aislados | Entornos de producción |
| Contenedores de desarrollo desechables (eliminados tras la experimentación) | Entornos de desarrollo con código importante |
| Entornos de sandbox sin conexiones a producción | Cualquier base de código que te importe |
| Flujos de trabajo automatizados donde la aprobación humana frustra el propósito | Repositorios compartidos |
| Entornos con datos sensibles |
Activación
Abre el menú de permisos
Selecciona el botón "Switch Permission"
Selecciona Skip Permission Mode
Elige "Skip Permission Mode" en el menú desplegable
Verifica la activación
El botón muestra "Skip" para confirmar que el modo está activo
Verificación de seguridad antes de activar:
- ¿Es este un contenedor o VM desechable?
- ¿Se puede eliminar este entorno sin consecuencias?
- ¿Hay aquí algún código de producción o importante?
Si respondes "no" a las dos primeras o "sí" a la tercera, NO lo actives.
Advertencias de seguridad
TODAS las protecciones de seguridad eliminadas:
- Los comandos se ejecutan de inmediato con permisos del sistema
- Los archivos pueden modificarse o eliminarse sin aviso
- Las operaciones de base de datos y las operaciones de Git (incluido el force push) proceden sin aprobación
- Podría instalar paquetes maliciosos o exponer credenciales
Solo es seguro cuando:
- El entorno es completamente desechable
- No existe código ni datos importantes
- No hay conexión a sistemas de producción
- Aceptas que todo puede ser destruido
Plan Mode
Plan Mode es un modo de interacción de solo lectura en el que Verdent analiza código, crea planes detallados y hace preguntas aclaratorias, pero no puede modificar archivos ni ejecutar comandos hasta que des tu aprobación.
Cómo funciona
- Análisis: lee los archivos automáticamente
- Planificación: crea un plan estructurado con una lista de tareas pendientes
- Aclaración: hace preguntas para eliminar la incertidumbre
- Aprobación: revisas y decides continuar
- Ejecución: cambia a tu modo de permisos para ejecutar
El plan muestra los archivos a modificar, los pasos de implementación, las dependencias y la estrategia de verificación.
Cuándo usarlo
- Cambios complejos multiarchivo (comprender el alcance antes de comprometerse)
- Bases de código desconocidas (exploración segura sin riesgo)
- Decisiones de arquitectura (revisar el enfoque antes de implementar)
- Evitar la fatiga de la aceptación manual (revisar una vez frente a 50 solicitudes individuales)
- Cambios de alto riesgo en producción (visibilidad completa antes de ejecutar)
Activación
Abre el menú de modos
Selecciona el botón "Switch Mode" en el cuadro de entrada
Selecciona Plan Mode
Elige "Plan Mode" en el menú desplegable
Verifica la activación
El indicador de modo cambia a "Plan" para confirmar que el modo está activo
Cuando está activo, Verdent analiza y crea planes, pero no modifica archivos ni ejecuta comandos hasta que des tu aprobación. Tras la aprobación, cambia a tu modo de permisos predeterminado (Manual Accept o Auto-Run).
Consideraciones de seguridad
Ventajas:
- Cero riesgo de ejecución durante la planificación
- Visibilidad completa antes de comprometerse
- La aclaración interactiva elimina la incertidumbre
- Seguro para el análisis de producción
Limitaciones:
- La aprobación no garantiza la corrección (los planes pueden tener errores lógicos)
- La seguridad de la ejecución depende del modo de permisos elegido tras la aprobación
- La calidad del plan depende de la claridad del prompt
Mejores prácticas:
- Revisa los planes en busca de errores lógicos o malentendidos
- Haz preguntas de seguimiento si algo no queda claro
- Refina los prompts antes de aprobar la ejecución
- Considera qué modo de permisos ejecutará (Manual Accept para supervisión, Auto-Run para velocidad)
Think Hard Mode
Think Hard Mode asigna el máximo de recursos computacionales para tareas de razonamiento complejo. El modelo explora múltiples enfoques y ofrece soluciones más exhaustivas.
Características:
- Tiempo de razonamiento extendido
- Análisis más profundo de múltiples enfoques de solución
- Mejor manejo de lógica compleja, casos límite y decisiones de arquitectura
- Mayor costo en créditos por solicitud
Cuándo usarlo
| Usa Think Hard Mode para | No lo uses para |
|---|---|
| Decisiones de arquitectura complejas con múltiples compensaciones | Tareas simples y directas |
| Depuración sofisticada con múltiples causas potenciales | Solicitudes urgentes |
| Diseño de algoritmos que requiere análisis de optimización | Presupuesto de créditos limitado |
| Lógica de negocio crítica donde la corrección es primordial | Cuando el modo estándar es suficiente |
| Optimización del rendimiento de cuellos de botella complejos |
Activación
Usa el botón de la interfaz para activarlo por solicitud:
Activa Think Hard
Selecciona el botón o interruptor "Think Hard" en el cuadro de entrada
Envía tu prompt
Escribe y envía tu solicitud
Solo una solicitud
Se aplica únicamente a esa solicitud específica, no es persistente
Funciona con todos los proveedores de IA. No es persistente: debes activarlo cada vez para las solicitudes que requieren razonamiento profundo.
Incluye palabras clave de razonamiento en tu prompt:
Think: Design the optimal database schema for this multi-tenant SaaS applicationO para el máximo razonamiento:
Ultrathink: Analyze the trade-offs between different authentication approaches"Think" y "ultrathink" son capacidades específicas de los modelos Claude. Estas palabras clave activan un razonamiento más profundo en los modelos Claude (Sonnet, Opus), pero pueden no funcionar con otros proveedores de IA (GPT-5, MiniMax).
Activación solo por solicitud: no es persistente como Manual Accept o Auto-Run.
Comparación de modos
| Modo | Control | Velocidad | Mejor para | Evítalo cuando |
|---|---|---|---|---|
| Manual Accept | Máximo | Más lento | Aprender, código desconocido, cambios críticos | Proyectos confiables, iteración rápida |
| Auto-Run | Moderado | Rápido | Bases de código confiables, prototipado, trabajo multiarchivo | Código desconocido, sin control de versiones |
| Skip Permission | Ninguno | Más rápido | CI/CD, contenedores desechables, sandboxes | Producción, código importante |
| Plan Mode | Revisión primero | N/D | Cambios complejos, decisiones de arquitectura | Tareas simples |
| Think Hard | Por solicitud | Más lento | Razonamiento complejo, algoritmos, lógica crítica | Tareas simples, solicitudes urgentes |
Cuándo usar cada modo
| Escenario | Manual Accept | Auto-Run | Skip Permission | Plan Mode |
|---|---|---|---|---|
| Aprender Verdent | ✓ | |||
| Base de código desconocida | ✓ | ✓ | ||
| Base de código confiable con Git | ✓ | |||
| Código crítico o de producción | ✓ | ✓ | ||
| Prototipado rápido | ✓ | |||
| Refactorización multiarchivo | ✓ | |||
| Planificación de arquitectura compleja | ✓ | |||
| Pipelines de CI/CD (aislados) | ✓ | |||
| Contenedores desechables | ✓ | |||
| Requisitos de cumplimiento | ✓ |
Mejores prácticas de seguridad
Jerarquía de seguridad (de más a menos seguro)
Comprender la clasificación de seguridad de cada modo te ayuda a elegir el adecuado para diferentes niveles de riesgo.
- Plan Mode: solo lectura hasta la aprobación. Cero riesgo de ejecución durante la planificación.
- Manual Accept Mode: control por operación con aprobación en el primer uso por tipo de herramienta.
- Auto-Run Mode: autonomía de archivos con aprobación de comandos. Se requiere la red de seguridad de Git.
- Skip Permission Mode: autonomía total. Solo entornos aislados.
Adapta tu modo al nivel de riesgo: el código crítico usa los modos más seguros (Plan, Manual Accept), el código confiable usa modos más rápidos (Auto-Run) y los entornos desechables usan el modo más rápido (Skip Permission).
Mejores prácticas generales
Prácticas esenciales que se aplican independientemente del modo de ejecución que estés usando.
Para todos los modos:
- Usa control de versiones: inicializa Git antes de usar modos permisivos, confirma con frecuencia y revisa las diferencias antes de confirmar
- Escribe prompts claros: sé específico sobre el alcance, especifica explícitamente los límites de archivos y usa menciones con @ para el contexto
- Revisa antes de confirmar: comprueba el panel de Source Control tras las finalizaciones, revisa todas las diferencias con cuidado y prueba los cambios
- Inicia sesiones nuevas: limpia el contexto entre tareas importantes, restablece las aprobaciones de herramientas para el trabajo sensible y evita la contaminación del contexto
- Adapta el modo al riesgo: código crítico → Manual Accept o Plan Mode, código confiable → Auto-Run, experimentos → Auto-Run con Git, desechable → solo Skip Permission
Recordatorios de seguridad:
- Nunca confirmes archivos sensibles (.env, credenciales)
- Configura .gitignore antes de usar Auto-Run
- Revisa los permisos de comandos con cuidado
- Usa Plan Mode para cambios que afecten la seguridad
- Las sesiones nuevas restablecen las aprobaciones de herramientas en Manual Accept
Progressive Permission Model
Comprender cómo funciona el sistema de permisos de Verdent te ayuda a usarlo de manera eficaz.
Cómo funciona:
- Primer uso: el sistema solicita permiso cuando usas cada tipo de herramienta por primera vez (ediciones de archivos, ejecuciones de comandos, uso de herramientas)
- Usos posteriores: tras la aprobación inicial, ese tipo de herramienta continúa sin solicitudes durante el resto de la sesión
- Nueva sesión: iniciar una nueva sesión restablece todas las aprobaciones, lo que te permite empezar de cero
Principio clave: este modelo equilibra la seguridad con la productividad. Revisas y apruebas los tipos de herramientas una vez y luego trabajas de manera eficiente dentro de ese contexto de aprobación. Para trabajo sensible, inicia una nueva sesión para restablecer las aprobaciones.
Para restablecer las aprobaciones: inicia una nueva sesión