Claude Code 2.1.302 inicia las ejecuciones headless en proveedores de terceros en el modo de permisos por defecto

Nuestra opinión: nunca dejes el modo de permisos de un trabajo desatendido a un valor por defecto. Claude Code 2.1.302 cambia ese valor por defecto para las ejecuciones headless y del Agent SDK en proveedores de terceros. Configura el modo explícitamente en cada script ahora y el próximo cambio de valor por defecto no te afectará. Claude Code sigue Condicional en nuestro directorio: es un cambio de configuración que hay que absorber, no una razón para replantearse la herramienta.

Qué ha pasado

Anthropic lanzó Claude Code 2.1.302 el 16 de octubre de 2026. Dos cambios de la versión alteran el comportamiento de las ejecuciones programadas.

El valor por defecto de los permisos

Del changelog: «Modificado: las sesiones de claude -p y del Agent SDK sin modo de permisos ahora se inician en el modo default en proveedores de terceros, con la telemetría desactivada o en una instalación nueva; --permission-mode auto mantiene auto».

Subagentes fork en todas partes

«Modificado: los subagentes fork (subagent_type: "fork") ahora están activados por defecto en claude -p, el Agent SDK, la app de escritorio y VS Code, como ya lo estaban en el terminal; CLAUDE_CODE_FORK_SUBAGENT=0 los desactiva, y claude mcp serve nunca los ofrece».

La misma versión hace que la app de escritorio y VS Code ejecuten siempre en segundo plano los subagentes de la conversación principal, como hace el terminal. Las llamadas Agent propias de un subagente en claude -p, el Agent SDK, la app de escritorio y VS Code ahora se ejecutan en primer plano por defecto.

También en 2.1.302

• Hooks de prompt y de agente: «como máximo 12 de un mismo evento se ejecutan a la vez; el resto espera su turno».
• CLAUDE_CODE_AUTO_MODE_MODEL elige el modelo para el clasificador del modo auto del lado del cliente. No cambia el modelo del modo auto del lado del servidor.
• Una fila «Idle compaction» (compactación en reposo) en /config desactiva la compactación en reposo o la vuelve a activar.
• /design-sync y /design-login ahora avisan de que el Claude Design independiente (claude.ai/design) «cierra a más tardar el 14 de diciembre de 2026».

Por qué importa

El cambio de permisos afecta a una población muy concreta: trabajos en un proveedor de terceros que nunca configuraron un modo y que se ejecutan con la telemetría desactivada o desde una instalación nueva. La documentación de modos de permisos de Anthropic explica por qué: antes de 2.1.302, las ejecuciones que no obtenían los feature flags (en un proveedor de terceros o con DISABLE_TELEMETRY) podían iniciarse en modo auto. Ahora se inician en modo Manual, que aparece como default en las opciones del SDK y los ajustes. Una ejecución headless en ese modo no pregunta: las llamadas que necesitan aprobación se deniegan salvo que una regla de permiso, un hook, un callback canUseTool o --permission-prompt-tool las apruebe. Un pipeline desatendido que dependía del antiguo comportamiento auto puede fallar sin ningún cambio en su propio código.

Que los subagentes fork se activen por defecto en claude -p y el Agent SDK significa que una ejecución headless ahora puede generar forks que antes no generaba por defecto. Si tu trabajo presupuesta tokens o tiempo al detalle, es un cambio de comportamiento que conviene comprobar.

Qué cambia para ti

• Headless o SDK en un proveedor de terceros: pasa --permission-mode en cada trabajo (--permission-mode auto mantiene auto), o aprueba llamadas concretas con reglas de permiso como --allowedTools "Bash(npm test)" (el SDK tiene una opción de herramientas permitidas equivalente).
• Si no quieres forks fuera del terminal: configura CLAUDE_CODE_FORK_SUBAGENT=0.
• Configuraciones con muchos hooks: espera que los hooks de prompt y de agente por encima de 12 por evento hagan cola.
• Usuarios del Claude Design independiente: exporta lo que guardes ahí antes del 14 de diciembre de 2026.

Preguntas frecuentes

¿Afecta esto a las ejecuciones contra la API propia de Anthropic?

El changelog de 2.1.302 limita el cambio a proveedores de terceros, con la telemetría desactivada o en una instalación nueva. La documentación de modos de permisos de Anthropic dice que las ejecuciones de claude -p y del Agent SDK sin modo configurado se inician en default a partir de 2.1.302, así que configura el modo explícitamente dondequiera que ejecutes.

¿Cómo mantengo el modo auto en los trabajos headless?

Pasa --permission-mode auto explícitamente; el changelog afirma que mantiene auto.

¿Puedo desactivar los subagentes fork?

Sí. CLAUDE_CODE_FORK_SUBAGENT=0 los desactiva, y claude mcp serve nunca los ofrece.