01 Por qué importan los modos de permisos
Cuando Claude Code trabaja en una tarea larga, cada edición de archivo o comando de terminal puede ir acompañado de una petición de permiso. Si apruebas veinte seguidas sin leerlas, no estás supervisando nada: solo estás perdiendo tiempo y concentración.
El modo de permisos decide qué puede hacer Claude sin preguntarte. Elegir bien el modo para cada momento es lo que separa una sesión productiva de una en la que vigilas un botón de «aceptar». La idea de fondo es sencilla: supervisa mucho cuando el terreno es desconocido y suelta cuando el camino ya está trazado.
02 Los modos disponibles, uno a uno
| Modo | Qué hace sin preguntar | Cuándo usarlo |
|---|---|---|
| Manual (default) | Solo lecturas. Pide permiso para editar, ejecutar comandos o salir a la red. | Código que no conoces, trabajo sensible, primeras pruebas. |
| acceptEdits | Lecturas, edición de archivos y comandos básicos de archivos (mkdir, mv, cp…) dentro de tu carpeta. | Iterar sobre código que vas a revisar después con git diff. |
| plan | Lee, explora y redacta un plan. No toca tu código hasta que apruebas el plan. | Siempre antes de un cambio grande o en un proyecto nuevo. |
| auto | Todo, pero un segundo modelo (clasificador) revisa cada acción antes de ejecutarla. | Tareas largas cuya dirección ya has validado. |
| dontAsk | Solo lo que hayas preaprobado en reglas; lo demás se deniega. | Scripts y CI con una lista cerrada de herramientas. |
| bypassPermissions | Todo, sin comprobaciones. | Únicamente contenedores o máquinas virtuales aisladas. |
El modo auto es el que más tiempo ahorra. No significa «sin control»: el clasificador bloquea por defecto acciones como descargar y ejecutar scripts de internet, hacer git push --force, desplegar a producción, descartar cambios sin confirmar con git reset --hard o enviar datos sensibles fuera. Tus reglas de tipo ask siguen pidiendo confirmación igualmente.
03 Cómo cambiar de modo en cada interfaz
Terminal
Pulsa Shift+Tab para rotar entre modos. La barra de estado muestra el activo: «manual mode on», «accept edits on», «plan mode on» o «auto mode on».
VS Code
Haz clic en el indicador de modo, debajo de la caja de texto, y elige Manual, Edit automatically, Plan o Auto.
App de escritorio
En la pestaña Code, usa el selector de modo junto al botón de enviar. El modo elegido se recuerda por carpeta (salvo Plan).
Web y móvil
En las sesiones en la nube tienes Accept edits, Plan y Auto en el desplegable; bypass no está disponible.
También puedes arrancar directamente en un modo concreto con la opción --permission-mode, o fijarlo por defecto en ~/.claude/settings.json:
claude --permission-mode plan
claude --permission-mode auto
{
"permissions": {
"defaultMode": "acceptEdits"
}
}
04 El modo bypass y --dangerously-skip-permissions
bypassPermissions desactiva las comprobaciones: Claude ejecuta todo al instante. No aparece en el ciclo de Shift+Tab a menos que hayas arrancado con él habilitado, y en la app de escritorio hay que activar antes el interruptor Allow bypass permissions mode en los ajustes (en planes Team y Enterprise lo decide la organización).
claude --permission-mode bypassPermissions
claude --dangerously-skip-permissions
05 Un flujo seguro para soltar el volante
-
1
Planifica primero
Abre la tarea en modo plan. Claude explora el proyecto y te propone qué archivos va a tocar y en qué orden. Corrige el plan antes de aprobarlo.
-
2
Trabaja en una rama
Crea una rama o un worktree antes de que empiece a editar. Si algo sale mal, la descartas sin tocar main.
-
3
Aprueba el plan en modo auto
Al aceptar el plan, elige la opción de continuar en modo auto. Claude construirá sin pedirte permiso en cada paso rutinario.
-
4
Revisa el resultado, no cada clic
Cuando termine, lee el diff completo y ejecuta los tests. Tu supervisión se concentra en un único momento en lugar de repartirse en cincuenta confirmaciones.
-
5
Sube de nivel poco a poco
Empieza con acceptEdits, pasa a auto cuando confíes en el flujo y deja bypass solo para automatizaciones dentro de contenedores.
Antes de tocar nada, analiza el proyecto y prepara un plan para [describe la tarea]. Indica qué archivos vas a crear o modificar, qué comandos vas a ejecutar, qué riesgos ves y cómo comprobaremos que funciona (tests o pasos manuales). No edites hasta que yo apruebe el plan.
06 Qué modo usar según el tipo de trabajo
- ✓Auditar el código de un cliente o una web heredada: Manual o plan. Primero entiendes, después tocas.
- ✓Maquetar páginas o componentes que revisarás en el navegador: acceptEdits.
- ✓Refactorizaciones largas, migraciones de librerías o generación de tests: plan y después auto.
- ✓Tareas programadas en CI (informes, traducciones, revisión de PR): dontAsk con una lista de herramientas permitidas.
- ✓Agentes que corren solos durante horas: bypass, pero dentro de un contenedor sin credenciales reales.
- ✓Cualquier cosa que toque producción, bases de datos reales o dinero: Manual y revisión humana, siempre.
07 Si algo se rompe
Vuelve a modo plan o Manual con Shift+Tab, ejecuta git status y git diff para ver qué ha cambiado y pídele a Claude que te explique cada modificación antes de decidir. Si trabajabas en una rama, lo más rápido suele ser descartarla y repetir con un plan más concreto. Por eso la rama aislada no es opcional cuando le das autonomía.
Preguntas frecuentes
No. En modo auto un clasificador revisa cada acción y bloquea las peligrosas, como force push, despliegues o descargas de scripts. Con --dangerously-skip-permissions (bypass) no hay ninguna revisión: solo debe usarse en entornos aislados.
Normalmente es por la versión de Claude Code, por un modelo antiguo no compatible o porque tu organización lo ha desactivado con disableAutoMode. Actualiza, comprueba el modelo con /model y revisa tus archivos de ajustes.
El valor auto no se aplica desde el .claude/settings.json del proyecto por seguridad. Ponlo en tu configuración de usuario (~/.claude/settings.json) o arranca con --permission-mode auto.
No. Reduce las interrupciones y bloquea acciones claramente arriesgadas, pero no sustituye a revisar el diff ni a trabajar en una rama. Úsalo en tareas cuya dirección ya has validado.
Sí. Planificar antes de editar evita que Claude tome decisiones que no le has pedido y te da un documento para revisar con tu equipo o con el cliente antes de invertir tiempo en construir.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.