Un modo de permisos de Claude Code decide qué acciones puede realizar el agente sin pararse a preguntar. Hay cuatro: plan lee pero no modifica nada, default pregunta antes de hacer ediciones y ejecutar comandos según tus reglas de permisos, acceptEdits aplica ediciones de archivos sin preguntar pero sigue preguntando por los comandos, y bypassPermissions no pregunta por nada. Elegir uno es una declaración sobre cuánto confías en el agente en este directorio.
Esa declaración se complica en cuanto la persona que escribe la solicitud no es la propietaria de la máquina. Este artículo explica los modos tal como los define Claude Code y qué cambia en una sala compartida.
Los cuatro modos
plan. El agente lee archivos, busca, razona y genera un plan. No edita ni ejecuta nada. Es el modo ideal para «dime qué harías» y para permitir que alguien explore una base de código sin poder modificarla.
default. El agente pregunta antes de cada edición y cada comando, a menos que tus reglas de permisos ya permitan esa herramienta o patrón específico. Es adecuado para hacer pairing, donde estás observando y cada prompt es una decisión real.
acceptEdits. Las ediciones de archivos se aplican sin preguntar; los comandos siguen requiriendo confirmación. Resulta útil en repositorios donde revertir una mala edición cuesta poco (está bajo control de versiones), pero ejecutar el comando equivocado no.
bypassPermissions. No pregunta nada. La recomendación de Anthropic es reservarlo para entornos aislados (sandboxed) y desechables, ya que cualquier instrucción errónea o inyectada se ejecutará con todos tus privilegios locales.
La escala de plan a bypassPermissions y las cuatro acciones que se pausan sea cual sea el modo cuando el agente se comparte.
Por qué los modos se aplican a directorios, no a personas
Un modo de permisos se define por sesión, lo que en la práctica significa por directorio de trabajo. Es la unidad adecuada cuando estás a solas: el repositorio de documentación puede funcionar en acceptEdits, el de infraestructura en default y un experimento desechable en bypassPermissions.
Deja de ser suficiente cuando una segunda persona puede enviar solicitudes. Su solicitud se ejecuta con el modo de tu sesión. Un cofundador que solo necesita leer el código ahora lo está editando porque tú configuraste acceptEdits para ti la semana pasada. El propio modo no contempla distinciones por persona.
Qué cambia en una sala
En una sala de muti, el agente sigue teniendo un modo de permisos de Claude Code, que se elige al crear el agente para un directorio. Por encima de este actúan dos elementos.
Permisos por persona. Cada solicitud de alguien que no sea el propietario se aprueba de forma puntual o queda cubierta por una autorización permanente «Allow always» concedida a esa persona para ese agente. Puedes revocar esa autorización permanente en cualquier momento; las solicitudes en cola de esa persona se cancelan.
Cuatro acciones que siempre se pausan. Sin importar el modo ni las autorizaciones concedidas, hacer push a una rama compartida, borrar, gastar dinero o tocar credenciales se detienen para que intervenga el propietario. Incluso un agente en bypassPermissions se pausa en estos casos si la solicitud procede de otra persona. El razonamiento detallado está en cuatro acciones sobre las que un agente siempre debería preguntar antes de actuar.
Una correspondencia práctica
- Exploración para otros: crea el agente en
plan. Los invitados pueden hacer preguntas y no cambia nada en el disco. - Trabajo diario con personas de confianza:
acceptEdits, con una autorización permanente para esas personas. Los comandos siguen requiriendo confirmación; las cuatro acciones se siguen pausando. - Tu propio sandbox desechable:
bypassPermissionsno plantea problemas porque no hay nadie más en la sala. En cuanto invites a alguien, reconsidéralo. - Cualquier cosa con credenciales de producción en el directorio:
default, sin autorizaciones permanentes y un agente independiente para las partes que no requieran esas credenciales.
Preguntas frecuentes
¿Invalida una sala el modo de Claude Code? No. El modo sigue rigiendo lo que hace el agente dentro de una ejecución. La sala añade quién puede iniciar una ejecución y qué acciones se pausan en cualquier caso.
¿Puede quien solicita elegir el modo? No. El propietario lo elige para cada agente. Quienes solicitan pueden pedir un comportamiento de solo lectura en su solicitud, y el propietario puede responder a una aprobación con «continue read-only».
¿Es aceptable bypassPermissions en algún caso para un agente compartido? Solo en directorios donde no pueda ocurrir nada irreversible y, aun así, las cuatro acciones se pausan. En otro artículo explicamos por qué bypassPermissions está bien para ti y es peligroso para los demás.
¿Qué ocurre con Codex? Codex tiene su propia configuración de aprobaciones con un esquema similar. En una sala, las autorizaciones por persona y las cuatro acciones que siempre se pausan se aplican de la misma forma.
Configura el modo para el directorio, define los permisos para la persona y deja que las cuatro acciones pregunten. Ese es todo el modelo. Dale una sala a tu agente para verlo en la práctica.
Publicado el