Claude Code "tool call could not be parsed" / llamada a herramienta mal formada: causas y soluciones (call / invoke / parameter aparecen como texto)
¿Hay una caída ahora mismo?
El estado oficial de Claude Code es operativo. Si este error persiste, probablemente sea un problema de implementación o de tu entorno.
Actualizado: 6 jun 2026, 3:36 UTC
Ver el estado de Claude Code →Qué significa este error
El modelo genera la llamada a la herramienta con un formato incorrecto, así que el sistema la rechaza como "tool call could not be parsed". En lugar de la llamada bien formada, se produce un invoke suelto que nunca se ejecuta, y aparecen "call", "<invoke name=…>" o "<parameter>" como texto visible. En sesiones largas, una vez que una llamada mal formada entra en el historial, cada llamada posterior copia el mismo formato roto (autocontaminación por few-shot en contexto). No es un error de tu código: es un problema conocido del lado de Claude Code (modelo/sistema).
Causas comunes
- •Sesión larga con muchas llamadas a herramientas encadenadas seguidas
- •Una vez que una llamada mal formada está en el historial, el modelo la reproduce de forma autorregresiva (few-shot poisoning)
- •Reintentar en la misma sesión ancla más el ejemplo roto y lo empeora
- •Cargar archivos o skills enormes y densos en XML/marcado diluye el control del formato
- •Contexto grande (p. ej. 1M) con alto esfuerzo durante una sesión larga
Cómo solucionarlo
- 1.Ejecuta /clear (o inicia una sesión nueva) para descartar el historial contaminado: la única recuperación confirmada
- 2.NO reintentes en la misma sesión (refuerza el formato roto)
- 3.Usa /compact con frecuencia antes de que la conversación se alargue
- 4.No agrupes demasiadas ediciones; intercala texto/comprobaciones entre llamadas
- 5.Evita cargar de golpe archivos o skills enormes densos en XML/heredoc
- 6.Actualiza Claude Code a la última versión (las correcciones están en curso)
- 7.Confirma arriba en esta página que no es una caída de la API de Anthropic (esto es del modelo/sistema, distinto de una caída de API)
Cuándo conviene esperar (y cuándo no)
Es un problema conocido del modelo/sistema (reportado en GitHub; aún se trabaja en una solución permanente) y esperar no lo arregla dentro de la misma sesión. Cambiar a una sesión nueva con /clear es la solución fiable. Para evitar que se repita, mantén las sesiones cortas, usa /compact a menudo y nunca reintentes una llamada mal formada.
Alternativas cuando Claude Code está caído
Errores relacionados
Preguntas frecuentes
¿Qué es Tool call could not be parsed?
El modelo genera la llamada a la herramienta con un formato incorrecto, así que el sistema la rechaza como "tool call could not be parsed". En lugar de la llamada bien formada, se produce un invoke suelto que nunca se ejecuta, y aparecen "call", "<invoke name=…>" o "<parameter>" como texto visible. En sesiones largas, una vez que una llamada mal formada entra en el historial, cada llamada posterior copia el mismo formato roto (autocontaminación por few-shot en contexto). No es un error de tu código: es un problema conocido del lado de Claude Code (modelo/sistema).
¿Cómo soluciono Tool call could not be parsed?
Ejecuta /clear (o inicia una sesión nueva) para descartar el historial contaminado: la única recuperación confirmada / NO reintentes en la misma sesión (refuerza el formato roto) / Usa /compact con frecuencia antes de que la conversación se alargue / No agrupes demasiadas ediciones; intercala texto/comprobaciones entre llamadas / Evita cargar de golpe archivos o skills enormes densos en XML/heredoc / Actualiza Claude Code a la última versión (las correcciones están en curso) / Confirma arriba en esta página que no es una caída de la API de Anthropic (esto es del modelo/sistema, distinto de una caída de API)