Resolver problemas
Diagnósticos concretos para recuperar el trabajo.
En esta página
Empieza por identificar qué frontera falló. Repetir la petición completa puede duplicar efectos o gastar presupuesto sin cambiar la causa.
La cola está pausada
Abre F4 o consulta la barra. Después de un fallo, revisa el estado antes de seguir:
/queue resume
Esto reanuda pendientes; si el mensaje fallido ya no está en cola, vuelve a enviarlo tras corregir la causa. Un mensaje interrumpido no se reejecuta automáticamente.
Respuesta truncada: length
No significa siempre falta de contexto de entrada. Revisa /context, la reserva de --max-tokens y el tamaño del paso. Divide scripts grandes y conserva un plan con artefactos. Comal descarta herramientas de una respuesta incompleta antes de ejecutarlas.
/compact deriva memoria sin LLM cuando corresponde, pero no convierte un script demasiado largo en una salida corta.
Timeout
Revisa --model-timeout-ms y --model-idle-timeout-ms, la salud del servidor y si hubo progreso. Antes de repetir una operación externa, consulta /house: un inicio sin recibo exige inspección. Un timeout de red no prueba que un efecto remoto no haya ocurrido.
No aparece una herramienta MCP
Comprueba conexión con /mcp. Después distingue servidor conectado de pack adquirido. Usa ToolPack para la etapa necesaria y espera al siguiente catálogo; no adivines llamadas paralelas a herramientas que aún no estaban ofrecidas.
Read no abre una imagen
Read es UTF-8 de texto. Usa AnalyzeMedia con un modelo visual; FileInfo puede consultar formato/tamaño sin shell. Rechazar una operación de texto o Bash no prohíbe automáticamente el análisis de medios.
Visual no recibe el pedido
Usa /list-agents; comprueba nombre/ID, inbound, capacidades y que ambas instancias sigan vivas. Busy puede aceptar mensajes; PEER_SELF_SEND significa que el emisor se eligió a sí mismo. El archivo tiene que existir en el workspace receptor. Entregado no significa analizado.
Codex inicia, pero falla la respuesta
Actualiza Comal y reanuda con su configuración de perfiles. El adaptador ya reconoce SSE sin Content-Type y exige cierre completo. Una lista de modelos vacía tampoco demuestra falta de plan: puede ser una incompatibilidad de catálogo. Consulta /models y /login status antes de repetir login.
Effort no disponible
Consulta /effort. Un valor válido para otro modelo puede no estar anunciado aquí. auto omite el control; no se convierten alias silenciosamente. Un rechazo conserva el proveedor anterior.
No encuentro una sesión
Verifica --cwd, --state-dir, .comal/ frente a .harness/ y el archivo de perfiles usado. sessions lista libros guardados; /list-agents descubre procesos vivos. Son inventarios distintos.
Ver esta página como Markdown
Fuente editable de esta guía: problemas.md. Las páginas de referencia se regeneran desde el inventario auditado.