Oficiales de Anthropic Guía paso a paso

Modos de permisos de Claude Code: manual, plan, auto y bypass

Guía práctica de los modos de permisos de Claude Code: qué puede hacer el agente sin preguntarte en cada uno, cómo cambiar de modo en la terminal, VS Code y la app de escritorio, y un flujo de trabajo seguro para dejar de aprobar acciones una a una sin poner en riesgo tu código ni tu servidor.

Nivel
Principiante
Qué necesitas
Claude Code instalado (terminal, VS Code o app de escritorio) con una cuenta de Claude o una clave de API.
Cuánto lleva
Unos 15 minutos para entender los modos y probarlos en un proyecto.

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

01

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».

02

VS Code

Haz clic en el indicador de modo, debajo de la caja de texto, y elige Manual, Edit automatically, Plan o Auto.

03

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).

04

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:

bash · Arrancar en modo plan o en modo auto
claude --permission-mode plan
claude --permission-mode auto
json · Modo por defecto en ~/.claude/settings.json
{
  "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).

bash · Las dos formas equivalentes de arrancar en bypass
claude --permission-mode bypassPermissions
claude --dangerously-skip-permissions

05 Un flujo seguro para soltar el volante

  1. 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. 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. 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. 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. 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.

Prompt · Prompt para arrancar en modo plan
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.

Sigue con estas guías

Guía paso a paso · Intermedio

Modo plan y modo automático en Claude Code: planifica antes de soltarlo

El modo automático de Claude Code deja trabajar sin pedir permiso en cada paso y un clasificador bloquea lo destructivo. Pero el clasificador protege del daño, no del rumbo equivocado. Esta guía explica los seis modos de permisos, qué bloquea el automático, cómo dejar tus proyectos arrancando en modo plan y cómo convertir tus límites en reglas.

Unos 15 minutos para configurarlo en un proyecto. Leer la guía →
Guía paso a paso · Intermedio

6 trucos de Boris Cherny, creador de Claude Code, para trabajar más rápido

Boris Cherny, creador de Claude Code, compartió seis hábitos que usa a diario con los modelos Opus: dejar trabajar al agente en modo auto, preaprobar comandos seguros, leer los resúmenes de sesión, ocultar los pasos intermedios, ajustar el nivel de esfuerzo por tarea y, sobre todo, darle a Claude una forma de comprobar su propio trabajo.

Unos 15 minutos para activar los seis y una semana para convertirlos en costumbre. Leer la guía →
Guía paso a paso · Intermedio

/goal en Claude Code: que trabaje solo hasta cumplir un objetivo

Con /goal le das a Claude Code una condición de llegada, por ejemplo que todos los tests pasen, y sigue trabajando turno tras turno sin que tengas que escribirle «continúa». Un segundo modelo comprueba al final de cada turno si se ha cumplido. Aprendes a redactar buenas condiciones, a ponerle límites y a evitar sorpresas de consumo.

Cinco minutos para aprenderlo; cada objetivo dura lo que tarde el trabajo Leer la guía →
Guía paso a paso · Principiante

Seguridad en Claude: permisos, conectores, privacidad y Claude Code sin sustos

Conectar tu correo, tus documentos o tu código a Claude es seguro si sabes dónde están los controles. Esta guía explica cómo limitar lo que puede hacer cada conector, cómo leer una aprobación, qué datos se usan o no para entrenar modelos, qué ofrece el panel de administración y qué precauciones tomar en Claude Code.

Unos 20 minutos para revisar tu configuración Leer la guía →
Guía paso a paso · Principiante

Los 6 comandos de Claude Code que más vas a usar

Una guía práctica de los seis comandos con barra que cubren la mayor parte del trabajo diario en Claude Code: memoria del proyecto, planificar antes de tocar código, deshacer cambios, trabajar hasta cumplir un objetivo, repartir trabajo en paralelo y crear subagentes especializados.

Unos 20 minutos para probarlos todos Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp