← Claude Code Hub
Nov 16, 2026 · 6 min de lectura ✦ Tip #273

Subagentes de Claude Code esperando permiso: haz que sigan sin ti

Un subagente en segundo plano que llega a un permiso se queda esperando a que vuelvas, y la tarea entera con él. Un ajuste de tu configuración convierte ese aviso en una denegación y el turno sigue.

Subagente de Claude Code esperando permiso: sin el ajuste, el aviso espera en la sesión principal y la tarea se queda parada; con permissions.denyInsteadOfPrompting, la llamada se deniega y el turno sigue

TL;DR Antes de dejar a Claude Code trabajando solo, lánzalo con claude --settings '{"permissions":{"denyInsteadOfPrompting":true}}' y deja en permissions.allow lo que sí tiene que poder hacer. Lo que pediría permiso se deniega, Claude te dice qué quedó fuera y sigue con el resto.

Un subagente en segundo plano que llega a una llamada que necesita permiso no la resuelve solo: el aviso sube a tu sesión principal y el subagente espera a que contestes. Con los teammates de un agent team pasa lo mismo, el aviso aparece en la sesión líder. Si te has ido, la tarea entera se queda ahí. Desde la v2.1.319, permissions.denyInsteadOfPrompting convierte cada uno de esos avisos en una denegación, y el turno sigue.

Lo que ves sin el ajuste

Una sesión en modo Manual, un subagente en segundo plano y un comando que no está en tus reglas. La v2.1.325 enseña esto en la sesión principal:

● Agent(Run touch and date command)
  ⎿  Backgrounded agent (↓ to manage · ctrl+o to expand)
● The subagent is running in the background and is creating made-by-subagent.txt.
✻ Waiting for 1 background agent to finish

 Bash command · from the general-purpose agent
 touch made-by-subagent.txt && date > made-by-subagent.txt
 Do you want to proceed?
 ❯ 1. Yes
   2. Yes, and don't ask again for touch made-by-subagent.txt and date commands in …
   3. Yes, and switch to auto mode · auto mode handles these prompts for you
   4. No

El aviso dice de qué subagente viene, como cuenta el tip de las herramientas que pierde en segundo plano. Lo que no hace es resolverse solo: veinte minutos después seguía en pantalla, con el subagente parado y el fichero sin crear.

Lo que ves con el ajuste

La misma petición, en una sesión lanzada con el ajuste:

● Agent "Run touch and date command" finished · 3s
● The subagent's run failed. The permission system denied its Bash call, so
  made-by-subagent.txt was never created. The command needed approval, the
  subagent's session couldn't answer a permission prompt, and it didn't retry.

Tres segundos. El subagente recibe esta denegación, que le prohíbe reintentar y le pide seguir con lo que no necesita aprobación:

Permission for this tool use was denied. It requires approval, and this session has no approval surface — nobody can answer a permission prompt here — so it was denied automatically. The action was NOT performed; do not claim it succeeded, and do not retry it: this action, and anything else that requires approval, will be denied the same way for the rest of this session. Tell the user what was blocked and why you needed it, then continue with the parts of the task that do not require approval. What required approval: This Bash command contains multiple operations. The following parts require approval: touch made-by-subagent.txt, date

Cómo activarlo

1. Solo en la sesión que vas a dejar sola

claude --settings '{"permissions":{"denyInsteadOfPrompting":true}}'

El ajuste no distingue quién pregunta: con él puesto, tu sesión principal también deja de preguntarte. Un touch pedido directamente en esa sesión acabó en Not run · permission denied. Por eso conviene lanzarlo así, para la tarea larga, y no tenerlo siempre activo.

2. O para siempre, en tu configuración de usuario

En ~/.claude/settings.json:

{
  "permissions": {
    "denyInsteadOfPrompting": true
  }
}

Ojo con el sentido único: un false en --settings no lo apaga para una sesión, porque basta con que una fuente diga true. Si lo pones aquí, tu sesión principal no te vuelve a preguntar nada hasta que edites el fichero.

Solo vale ahí, en managed settings o con --settings. Un repositorio no puede activártelo: con el mismo bloque en .claude/settings.json del proyecto, el touch volvió a abrir el aviso de siempre.

3. Aprueba de antemano lo que sí necesita

Una regla allow gana a la denegación. Con "allow": ["Bash(touch *)"] junto al ajuste y la orden touch made-by-subagent.txt sola, el subagente creó el fichero sin preguntar y permission_denials salió vacío. En un comando encadenado, cada parte tiene que estar permitida: con el && date > de arriba, esa regla sola no basta. Haz la lista de lo que la tarea necesita y deja que el ajuste se coma el resto. En auto mode, el clasificador sigue aprobando lo que considera seguro y solo se deniega lo que caería en un aviso.

4. Mira qué se denegó

En sesión interactiva, Claude lo resume al final, porque la propia denegación se lo exige. En claude -p con --output-format stream-json --verbose, cada una llega como evento y el resultado final las lista en permission_denials:

"subtype": "permission_denied", "tool_name": "Bash", "agent_id": "a15becbcafa4ea09e",
"decision_reason": "no approval surface in this session; permission request denied automatically"

El agent_id te dice qué subagente fue. Es el mismo array que hace que un claude -p acabe en verde sin hacer nada: léelo en el script.

Lo que también deja de preguntar

  • AskUserQuestion, EnterPlanMode y ExitPlanMode desaparecen, así que una sesión en plan mode no puede salir de él sola. Un teammate conserva las dos de plan mode.
  • Una petición de elicitation de un MCP se cancela, salvo que la conteste un hook Elicitation.
  • No se consulta tu --permission-prompt-tool ni el canUseTool del Agent SDK. Para aprobar desde código, usa un hook PermissionRequest, aunque algunas llamadas se deniegan antes de llegar a él, como el borrado de una ruta crítica en auto mode.
  • Si el aviso de facturación del clasificador de auto mode tuviera que abrir un diálogo, no aparece, y se deniegan las acciones que lo necesitan.
  • En auto mode, 20 llamadas rechazadas seguidas terminan el turno: 20 actions were refused and no work went ahead in between, so Claude stopped. En un subagente, el binario de la v2.1.325 lo dice de otra forma: so this agent was stopped before it finished. Nobody interrupted it; whatever it returned is partial.

Dos cosas siguen esperando: el diálogo de confianza de la carpeta y la aprobación de los servidores MCP del proyecto. Contéstalos antes de irte.

Frente a las otras opciones

Opción Qué hace con lo que preguntaría Dónde se queda corto
denyInsteadOfPrompting Lo deniega en cualquier modo, para la sesión, subagentes y teammates Tu propia sesión tampoco te pregunta
Modo dontAsk Lo deniega, pero sustituye a tu modo Un subagente con permissionMode: default vuelve a preguntar, y un teammate de un líder en dontAsk arranca en Manual
--permission-prompts none Lo deniega en una ejecución claude -p Solo esa ejecución, y solo headless
Reglas allow Lo aprueban Lo que no listaste sigue preguntando

La diferencia con los modos de permisos es esa: el ajuste se suma al modo en el que estés, auto, acceptEdits o Manual, en vez de reemplazarlo. Y donde más se nota es en un agent team, donde cada aviso de un teammate sube al líder.

Documentación oficial: Settings reference: permissions.denyInsteadOfPrompting

Requisitos

Claude Code v2.1.319 o posterior. Probado en la v2.1.325 en Linux: el aviso del subagente en segundo plano, la denegación con el ajuste en la sesión y en el subagente, la regla allow que lo deja pasar, el ajuste ignorado en la configuración del proyecto y los eventos de stream-json. Lo de agent teams, plan mode, elicitation y el tope de auto mode sale de la documentación.

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
Guía gratuita

Los 51 imprescindibles, en una guía.

Una página por tip. Cinco capítulos. Lo que de verdad uso a diario en producción. Sin teoría, sin humo.

  • 1. Empieza bien 10 tips
  • 2. Conciencia 3 tips
  • 3. Maestría 22 tips
  • 4. Autonomía 15 tips
  • 5. Comparativa 1 tip
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 51
#

Wmedia · 51 tips
Guía gratuita · 51 tips · 5 capítulos

Los 51 imprescindibles, en una guía.

Una página por tip. Cinco capítulos. Lo que de verdad uso a diario en producción. Sin teoría, sin humo.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Quieres los 51 imprescindibles de Claude Code en una guía?