Claude Code: modo automático y permisos predeterminados
Claude Code v2.1.283 cambia el inicio en terminal y VS Code. Conoce cada modo de permisos y cuál conviene para un servidor que no puedes supervisar.
Qué cambia el modo automático el 14 de agosto de 2026
El modo automático de Claude Code ejecuta llamadas a herramientas sin solicitar confirmación de forma rutinaria y utiliza un modelo clasificador independiente para revisar las acciones. Las lecturas y las modificaciones del directorio de trabajo fuera de las rutas protegidas omiten el clasificador. Desde el 14 de agosto de 2026, este es el modo con el que se inician las sesiones nuevas en los planes Pro, Max y Team. A fecha del 27 de octubre de 2026, la documentación amplía este comportamiento: con Claude Code v2.1.283 o posterior, el modo automático es el modo inicial integrado para las sesiones interactivas de terminal y VS Code en todos los planes y proveedores. Puede cambiar de modo en cualquier momento, y no se sobrescribe un valor predeterminado que ya haya configurado.
La documentación describe ahora el cambio así:
Con Claude Code v2.1.283 o posterior, el modo automático es el modo de permisos inicial integrado para las sesiones interactivas de terminal y VS Code. En versiones anteriores, sólo es el modo de permisos inicial integrado en los planes Pro, Max, Ultra y Team.
Dos reglas de la misma página son más importantes que el número de versión. Un defaultMode que configure en su propio ~/.claude/settings.json se conserva tras el cambio: Claude Code puede preguntarle una vez si quiere cambiarlo al modo automático y mantiene su configuración si rechaza el cambio. También se conserva un valor predeterminado que su organización distribuya mediante la configuración administrada. La publicación del anuncio indicaba que el modo automático seguiría siendo opcional al principio en los planes Enterprise y en Claude API. Una actualización publicada el 22 de octubre de 2026 indica que los administradores de Enterprise recibirán un correo electrónico antes de que el modo automático se convierta en el valor predeterminado de su organización. Desde v2.1.283, la documentación ya no establece esa excepción para las sesiones de terminal y VS Code, aunque con v2.1.285 o posterior una organización que tenga aplicada la configuración HIPAA sigue iniciando en modo Manual.
Si ejecuta Claude Code en un VPS (servidor privado virtual), el cambio es más importante que en un portátil. Una solicitud de permiso es un punto de control que requiere que haya una persona delante del teclado. En un sistema remoto, normalmente no estará allí, por lo que el modo con el que se inicia una sesión es el modo que mantiene durante horas. Las ejecuciones no interactivas de claude -p siguen otra regla: con v2.1.302 o posterior se inician en default, salvo que establezca un modo, incluso si usa un proveedor externo o tiene la telemetría desactivada. A fecha del 31 de octubre de 2026, la versión actual es v2.1.316, y la página sobre los modos de permisos documenta este comportamiento. Antes de v2.1.302, esos dos casos podían iniciarse en auto, por lo que debe ejecutar claude --version en el sistema si todavía puede tener una versión anterior.
Los modos de permisos de Claude Code, de mayor a menor supervisión
Hay seis modos. El nombre al principio de cada línea es el valor que se escribe en la configuración o se pasa a --permission-mode. Claude Code aplica los seis modos directamente, no el modelo, porque decidir qué puede hacer una llamada a una herramienta es responsabilidad del arnés que rodea al modelo.
default: Claude solicita confirmación antes de la mayoría de las acciones que editan archivos, ejecutan comandos de shell o acceden a la red. Las lecturas dentro del directorio de trabajo se ejecutan sin solicitar confirmación. La CLI (interfaz de línea de comandos) muestra este modo como Manual y aceptamanualcomo alias.plan: Claude lee archivos y ejecuta comandos para explorar, pero no edita el código fuente. Las ediciones permanecen bloqueadas hasta que apruebe el plan, excepto en sesiones interactivas de terminal con permisos de omisión disponibles: en ellas, ni el clasificador ni una solicitud de confirmación se aplican a los comandos de planificación.acceptEdits: las ediciones de archivos se ejecutan sin solicitar confirmación, junto con los comandos del sistema de archivosmkdir,touch,rm,rmdir,mv,cpysed. Esto sólo se aplica a las rutas dentro del directorio de trabajo o deadditionalDirectories. Las escrituras en rutas protegidas y las eliminaciones reconocidas de rutas críticas siguen solicitando confirmación, ytouchse aprueba automáticamente sólo con rutas de archivo simples. Todos los demás comandos de shell siguen las reglas de permisos habituales.auto: las solicitudes de permiso rutinarias se sustituyen por comprobaciones del clasificador. Las reglas explícitasasksiguen forzando una solicitud de confirmación.dontAsk: Claude Code deniega automáticamente cualquier acción que hubiera requerido confirmación. Se ejecutarán las llamadas que pueda aprobar un mod instalado, las lecturas de archivos dentro de los directorios de trabajo, las reglasallow, los comandos Bash integrados de sólo lectura, las descargas de documentación preaprobadas y las llamadas aprobadas por un hookPreToolUse. La sesión nunca espera una entrada.bypassPermissions: se omiten las solicitudes de confirmación y las comprobaciones de seguridad, incluidas las escrituras en rutas protegidas como.gity.claude.
Pulse Shift+Tab durante una sesión para recorrer default, acceptEdits y plan. Desde auto, la primera pulsación baja a default. La barra de estado muestra el modo seleccionado, como ⏵⏵ auto mode on o un ⏸ manual mode on gris. Los demás modos no forman parte de ese ciclo de forma predeterminada. auto se incorpora cuando su cuenta cumple los requisitos correspondientes. bypassPermissions sólo se incorpora si la sesión se inició con --permission-mode bypassPermissions, --dangerously-skip-permissions o --allow-dangerously-skip-permissions, o con defaultMode: "bypassPermissions" en la configuración de usuario, --settings o administrada. dontAsk nunca aparece en ese ciclo, por lo que debe establecerlo con claude --permission-mode dontAsk.
El modo automático también requiere un modelo reciente, que es la razón habitual por la que no aparece. A fecha de 27 de octubre de 2026, la documentación indica Claude Opus 4.6 o posterior, Sonnet 4.6 o posterior, Haiku 5.5 o un modelo Fable en la API de Anthropic; la lista es más corta en Amazon Bedrock, Google Cloud y Microsoft Foundry. También indica que los modelos anteriores, como Sonnet 4.5, no son compatibles con ningún proveedor. Si Claude Code informa de que el modo automático no está disponible, compruebe primero esos requisitos y cualquier configuración disableAutoMode. Anthropic también puede desactivar el modo automático en el servidor. Una sesión que recibe esa respuesta mantiene el modo automático desactivado hasta que termina. Por tanto, inicie una sesión nueva más tarde en lugar de esperar dentro de la sesión anterior.
Dos controles se aplican en todos los modos, incluido bypassPermissions: las reglas deny y las reglas explícitas ask. Ninguno se aplica a EndConversation mientras haya otra herramienta disponible. Estos son los controles que conserva con independencia del modo con el que se inicie una sesión.
Qué bloquea el clasificador del modo automático
El clasificador es un segundo modelo que lee la acción pendiente y decide si se ajusta a lo que usted solicitó. La documentación describe su función en una sola frase:
Un modelo clasificador independiente revisa las acciones antes de ejecutarlas y bloquea todo lo que vaya más allá de su solicitud, se dirija a una infraestructura no reconocida o parezca estar provocado por contenido hostil que Claude haya leído.
Bloqueado de forma predeterminada en las categorías que un operador de servidores encuentra con más frecuencia:
- Descargar y ejecutar código, como
curl | bash - Despliegues y migraciones en producción
- Force push
- Modificar infraestructura compartida
- Abrir un túnel o una reverse shell que haga accesible un servicio local desde Internet público
- Imprimir una credencial o un token activo en la transcripción o en un archivo
Permitido de forma predeterminada:
- Operaciones con archivos locales en el directorio de trabajo
- Instalar dependencias declaradas en los archivos de bloqueo o manifiestos
- Solicitudes HTTP de solo lectura
- Hacer push a ramas del repositorio en el que está trabajando, incluida la rama predeterminada, excepto las ramas no predeterminadas cuyos nombres indiquen que son destinos de despliegue o publicación. El contenido del push sigue pasando por las demás reglas del clasificador.
No trabaje a partir de un resumen como el anterior. Ejecute claude auto-mode defaults para imprimir las listas completas de reglas en formato JSON y lea el conjunto incluido en la versión que tiene instalada. /auto-mode-setup es un comando independiente: prepara entradas de autoMode.environment a partir de su proyecto y de sus sesiones recientes, y las escribe en ~/.claude/settings.json si acepta el borrador. Ese comando, no claude auto-mode defaults, establece los requisitos de versión. En los planes Pro, Max, Ultra y Team, /auto-mode-setup requiere v2.1.228 o posterior, o v2.1.233 o posterior en Windows nativo. En un plan Enterprise o con una clave de API de Claude Console, requiere v2.1.283 o posterior. Antes de v2.1.304, /auto-mode-setup no aparece en las sesiones que no obtienen indicadores de funciones, como un equipo con la telemetría desactivada o uno que usa un proveedor externo. Actualice primero si esa es la situación de su servidor.
Antes de basarse en esta función, debe tener en cuenta dos limitaciones documentadas. Primero, en las solicitudes al clasificador que Claude Code envía internamente, el clasificador ve sus mensajes, las llamadas a herramientas excepto las consultas de solo lectura, como lecturas y búsquedas de archivos, y el contenido de CLAUDE.md. Los resultados de las herramientas se eliminan, por lo que el texto de un archivo o de una página web que Claude haya leído no puede dirigirse directamente al clasificador. Segundo, cuando el clasificador bloquea una acción 3 veces seguidas o 20 veces en una sesión, el modo automático se pausa y Claude Code vuelve a pedirle confirmación. Aprobar la acción solicitada reanuda el modo automático. Estos límites no se pueden configurar. Una ejecución no interactiva con la opción -p y sin --permission-prompt-tool no tiene a nadie a quien pedir confirmación. La documentación indica expresamente que Claude Code no detiene la ejecución: la acción bloqueada no se ejecuta y Claude continúa trabajando.
Este segundo comportamiento es especialmente problemático en un equipo remoto, de dos formas distintas. Una sesión interactiva que alcanza el límite se detiene en una solicitud de confirmación y espera a una persona que no está mirando el terminal. Una ejecución -p nunca espera, por lo que un trabajo puede terminar con los pasos bloqueados sin realizar. Una segunda sesión de Claude Code en el mismo equipo no sustituye a esa persona, porque el texto enviado de una sesión a otra nunca cuenta como su consentimiento y no puede responder a una solicitud de permisos pendiente. Por tanto, una sesión pausada sigue necesitando una respuesta humana. Limitar lo que el agente intenta hacer es la otra parte de la solución, y una skill que dirija al agente hacia el cambio mínimo que funcione evita que una sesión se desvíe hacia acciones extensas que el clasificador detiene. Mientras una skill orienta una tarea, un estilo de salida modifica directamente el prompt del sistema, por lo que un estilo que solicite cambios pequeños y específicos se aplica a todos los turnos de la sesión, no sólo al trabajo para el que lo invocó.
Dónde se definen los modos en settings.json
Todo lo anterior forma un único objeto dentro de un archivo de configuración.
{
"permissions": {
"defaultMode": "auto",
"allow": [
"Bash(npm run test *)",
"Bash(git status)"
],
"ask": [
"Bash(git push *)",
"Bash(docker compose up *)"
],
"deny": [
"Read(./.env)",
"Read(./secrets/**)",
"Bash(curl *)"
]
}
}Las reglas se evalúan en este orden: deny, después ask y, por último, allow. La primera coincidencia de esa secuencia determina el resultado. Una regla más específica no prevalece sobre otra más amplia si esta aparece antes. Una regla deny para Bash(aws *) bloquea aws s3 ls aunque también se haya permitido ese comando exacto. Por tanto, una regla allow no puede crear una excepción dentro de una regla deny. Las reglas deny o ask de Read y Edit admiten la negación de gitignore: en la lista deny de un mismo archivo de configuración, Read(*.env) seguido de Read(!sample.env) excluye de la regla anterior los archivos cuyo nombre sea sample.env. La excepción sólo afecta a las reglas anteriores basadas en rutas relativas del mismo origen de configuración. No puede anular una regla deny de otro origen ni volver a permitir un archivo dentro de un directorio bloqueado por completo.
ask es el tipo de regla que resulta útil en el modo auto. El modo auto elimina la solicitud rutinaria de confirmación, y una regla ask vuelve a mostrarla para el comando específico que requiere intervención humana. El comando de despliegue debe estar ahí. También Bash(git push *) si quiere establecer un punto de control antes de que el código salga del servidor. Mantener los archivos de credenciales en deny es la otra parte de esta configuración. Además, se relaciona con mantener las credenciales fuera del alcance de un agente desde el principio.
Estos son los archivos de configuración, del que tiene menor precedencia al que tiene mayor:
~/.claude/settings.json: configuración de usuario, aplicada en todos los proyectos..claude/settings.json: configuración del proyecto, confirmada en el repositorio..claude/settings.local.json: configuración propia para un repositorio. Claude Code la excluye de Git cuando la crea; añádala a.gitignoresi la crea manualmente.- Configuración administrada, desplegada por un administrador. En Linux, ese archivo es
/etc/claude-code/managed-settings.json. Ninguna opción puede anular una regla de permisos administrada, incluida una opción de la línea de comandos.
Aquí hay un caso especial con una causa documentada. defaultMode: "auto" no tiene efecto cuando procede de .claude/settings.json o .claude/settings.local.json, para impedir que un repositorio active por sí mismo el modo auto mediante un archivo de configuración. bypassPermissions también se ignora en esos dos archivos. Si establece auto ahí, Claude Code vuelve a su valor predeterminado integrado y omite cualquier defaultMode en ~/.claude/settings.json, sin mostrar ningún error. En una versión o plan cuyo valor predeterminado integrado sea Manual, la sesión se inicia silenciosamente en el modo default. Mueva esa línea a ~/.claude/settings.json. Ejecute /permissions para mostrar cada regla activa junto al archivo del que procede.
Los dos interruptores que desactivan un modo
Los administradores disponen de dos interruptores de emergencia, y ambos reciben la cadena "disable" en lugar de un valor booleano.
{
"permissions": {
"disableAutoMode": "disable",
"disableBypassPermissionsMode": "disable"
}
}La documentación especifica que ambas opciones aceptan la cadena "disable" en cualquier archivo de configuración. Son especialmente útiles en configuraciones administradas que no se pueden sobrescribir.
disableAutoMode elimina auto del ciclo de Shift+Tab, y una sesión iniciada con --permission-mode auto comienza en modo Manual. disableBypassPermissionsMode hace lo mismo con el modo de omisión y funciona desde cualquier ámbito, por lo que puede establecerlo en su propio ~/.claude/settings.json para impedirse el acceso a un modo que preferiría no activar a las 2am en un servidor en producción. En un equipo que utilizan otras personas, incluya ambas opciones en /etc/claude-code/managed-settings.json, porque un archivo de configuración del usuario pertenece al usuario y uno administrado no.
Por qué el modo automático en un VPS necesita un límite de aislamiento
El clasificador revisa una acción cada vez. No contiene las consecuencias de una acción aprobada. La documentación establece claramente el límite:
El clasificador es un control por acción, no un límite de aislamiento, por lo que un límite de aislamiento sigue aportando defensa en profundidad en ejecuciones desatendidas y no es necesario del mismo modo que para --dangerously-skip-permissions.
Por tanto, la combinación adecuada para un equipo remoto es el modo automático más un entorno que esté dispuesto a perder, no bypassPermissions más esperanza. El modo de omisión está documentado sólo para entornos aislados: contenedores, máquinas virtuales o contenedores de desarrollo sin acceso a Internet, donde Claude Code no pueda dañar el sistema host. Un VPS que ejecuta la base de datos y el reverse proxy no pertenece a ninguna de esas categorías.
Tres medidas son las más importantes en un servidor. Ejecute Claude Code como un usuario normal, nunca como root. Asigne a ese usuario un directorio de trabajo y ningún otro contenido que merezca la pena leer. Vuelva a crear el equipo en lugar de repararlo; ese es el motivo para usar una máquina virtual desechable que se elimina después de cada trabajo. Los detalles de hardening que sustentan estas medidas, desde la creación del usuario hasta las reglas del firewall, se explican en la guía completa para ejecutar Claude Code de forma segura en un VPS, por lo que no se repiten aquí.
Claude Code aplica por sí mismo la regla sobre root. En Linux y macOS, se niega a iniciarse en modo de omisión con sudo o como root:
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasonsEsta comprobación se omite dentro de un sandbox reconocido. Por eso, la respuesta documentada para trabajar de forma autónoma con contenedores es un contenedor de desarrollo que ejecute Claude Code como un usuario que no sea root. Si controla el agente desde un teléfono o un portátil mediante SSH, el mismo razonamiento se aplica a una sesión de Claude Code de larga duración mantenida abierta en tmux: nadie está supervisando el prompt mientras la sesión está activa. Nada de esto comienza hasta que el inicio de sesión funciona. Por tanto, si el equipo rechaza la conexión con Permission denied (publickey), la salida detallada de SSH indicará cuál de los cinco fallos tiene realmente.
Configurar el sandbox de Bash en un VPS con Ubuntu
El sandbox integrado restringe el acceso al sistema de archivos y a la red de los comandos de Bash aislados que ejecuta Claude, y el sistema operativo aplica esas restricciones también a los procesos secundarios. Los comandos excluidos y los reintentos aprobados sin sandbox se ejecutan fuera de él. En Linux necesita dos paquetes.
sudo apt-get install bubblewrap socatInicie Claude Code y ejecute /sandbox. El panel se abre con las pestañas Mode, Overrides y Config. Si falta un paquete necesario, sólo se muestra la pestaña Dependencies, con la lista de elementos que debe instalar. La comprobación de dependencias se ejecuta al iniciar, por lo que debe reiniciar Claude Code después de instalar los paquetes. De lo contrario, el panel seguirá indicando que faltan.
En Ubuntu 24.04 y versiones posteriores, la política predeterminada de AppArmor impide que bubblewrap cree los espacios de nombres de usuario que necesita, por lo que el sandbox no puede iniciarse. Compruebe si esto se aplica a su servidor:
sysctl kernel.apparmor_restrict_unprivileged_usernsUn 0, o un error que indique que la clave no existe, significa que no debe hacer nada. Un 1 significa que bwrap necesita su propio perfil:
sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>
profile bwrap /usr/bin/bwrap flags=(unconfined) {
userns,
include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmorEl perfil se aplica al propio bwrap, no a los comandos que ejecuta dentro del sandbox. Después, restrinja el límite en la configuración:
{
"sandbox": {
"enabled": true,
"filesystem": {
"denyRead": ["~/"],
"allowRead": ["."]
},
"network": {
"allowedDomains": ["github.com", "*.npmjs.org"]
}
}
}Ese bloque debe estar en el .claude/settings.json del proyecto, porque . se resuelve en la raíz del proyecto sólo desde la configuración del proyecto. Si coloca las mismas líneas en ~/.claude/settings.json, . se resuelve en ~/.claude en su lugar. Así, la regla denyRead mantiene bloqueados los archivos del proyecto y todos los comandos fallan al intentar leer el código que deben editar.
Debe saber qué elementos no cubre esta configuración. El sandbox restringe Bash y sus procesos secundarios. Las herramientas de archivos integradas se ejecutan dentro del proceso de Claude Code, mientras que los servidores MCP (model context protocol) y los hooks son procesos independientes que se ejecutan sin restricciones en el host. Para colocar todos estos componentes detrás de un único límite, ejecute todo el proceso de Claude Code dentro de un contenedor, una máquina virtual o el paquete @anthropic-ai/sandbox-runtime, que en el momento de redactar este texto es una versión preliminar de investigación beta.
¿Qué modo corresponde a cada configuración?
Un repositorio personal en su propio portátil
Use auto, con reglas ask para las acciones que quiera revisar antes de que se ejecuten. Usted está delante del teclado, el mecanismo alternativo del clasificador puede pedirle confirmación y el impacto queda limitado a una máquina que controla. Este es el caso para el que se definió el valor predeterminado del 14 August.
Un VPS compartido
Use auto por usuario, configurado en el archivo ~/.claude/settings.json de cada usuario, en un sistema donde la cuenta que ejecuta Claude Code no sea root ni pueda leer el trabajo de los demás usuarios. Implemente disableBypassPermissionsMode como "disable" en /etc/claude-code/managed-settings.json, junto con las reglas de denegación que protegen las rutas compartidas. Un sistema compartido es el caso más claro en el que bypassPermissions es incorrecto, porque no existe el límite de aislamiento que presupone ese modo: los demás usuarios están dentro de él.
CI y sesiones desatendidas
Use dontAsk con una lista allow explícita de los comandos que necesita el trabajo. La denegación automática es el comportamiento correcto cuando ninguna persona verá una solicitud de confirmación. El modo automático también funciona de forma no interactiva, pero una ejecución -p que encuentra bloqueos repetidos del clasificador no se detiene: omite las acciones bloqueadas y Claude continúa trabajando, por lo que un trabajo puede finalizar con algunos pasos sin ejecutar. Reserve bypassPermissions para un contenedor o una máquina virtual que reconstruya desde una imagen, y no lo use en ningún host que también ejecute algo importante para usted.
FAQ
¿Cuándo pasa a ser el modo automático el modo predeterminado en Claude Code?
Pasó a ser el modo predeterminado el 14 August 2026 para las sesiones nuevas de los planes Pro, Max y Team. Desde el 27 October 2026, la documentación indica que Claude Code v2.1.283 o posterior lo establece como modo inicial integrado para las sesiones interactivas en el terminal y VS Code, en todos los planes y proveedores, excepto en las organizaciones que tienen aplicada la configuración HIPAA, que inician en modo Manual con v2.1.285 o posterior. Las ejecuciones no interactivas de claude -p se inician en default, salvo que establezca un modo. Antes de v2.1.302, las ejecuciones en un proveedor externo o con la telemetría desactivada podían iniciarse en auto; desde v2.1.302 también se inician en default. Un valor predeterminado que establezca usted se mantiene hasta que acepte el aviso de cambio único, y un valor predeterminado administrado por su organización no cambia. Compruebe el modo real de una sesión en la barra de estado, que muestra ⏵⏵ auto mode on en el modo automático.
¿Debo usar el modo automático o bypassPermissions en un VPS?
Use el modo automático junto con un límite de aislamiento. El clasificador revisa las acciones antes de ejecutarlas. Las lecturas y las modificaciones del directorio de trabajo fuera de las rutas protegidas no se revisan. Sin embargo, la documentación indica explícitamente que es un control por acción, no un límite de aislamiento. Por tanto, una ejecución desatendida sigue necesitando un contenedor, una máquina virtual o un equipo que pueda reconstruir. bypassPermissions omite completamente las comprobaciones y está documentado únicamente para entornos aislados. Claude Code no se inicia en ese modo como root en Linux y muestra --dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons.
¿Cómo impido que alguien use el modo automático o el modo bypass en mi servidor?
Establezca permissions.disableAutoMode y permissions.disableBypassPermissionsMode en la cadena "disable" dentro de /etc/claude-code/managed-settings.json. La configuración administrada tiene prioridad sobre cualquier otro ámbito. Por tanto, ningún archivo de configuración del usuario ni ninguna opción de la línea de comandos puede anularla. disableAutoMode elimina auto del ciclo de Shift+Tab, y una sesión iniciada con --permission-mode auto comienza en modo Manual. disableBypassPermissionsMode también funciona desde cualquier ámbito, por lo que un solo usuario puede establecerlo en su propio ~/.claude/settings.json.
¿Por qué se ignora mi configuración de defaultMode: "auto"?
Porque está en el archivo incorrecto. defaultMode: "auto" no tiene efecto cuando procede de .claude/settings.json o .claude/settings.local.json. Así se impide que un repositorio se conceda el modo automático mediante un archivo de configuración incluido en el repositorio. En su lugar, Claude Code usa su valor predeterminado integrado, omite cualquier defaultMode de la configuración del usuario y no muestra ningún error. Cuando ese valor predeterminado integrado es Manual, la sesión se inicia en modo default. Mueva la configuración a ~/.claude/settings.json y ejecute /permissions para confirmar de qué archivo procede cada regla activa. Si el modo automático sigue sin estar disponible, compruebe el requisito del modelo: los modelos antiguos, como Sonnet 4.5, no son compatibles con ningún proveedor.