Agentes de programación con IA y harness

Claude Code envía el valor predeterminado que tenga configurado (por ejemplo, claude-opus-5 o claude-sonnet-5), no el nombre de su gateway. O asigne al modelo del gateway exactamente el nombre que solicita el harness, o configure la variable de entorno del modelo del harness (por ejemplo, ANTHROPIC_MODEL) con el nombre de su gateway. Una discrepancia produce 404 model_not_found en el primer mensaje.

La URL base para clientes de estilo Anthropic apunta a la raíz del gateway (sin /v1); el cliente añade /v1/messages por su cuenta. Añadir /v1 aquí duplica el segmento de ruta.

Codex CLI exige wire_api = "responses" para un bloque personalizado [model_providers.*]. El gateway implementa /v1/responses de forma nativa: apunte allí base_url y asigne env_key a una clave de acceso del gateway.

Aider, OpenHands y SWE-agent se apoyan en LiteLLM: configure OPENAI_API_BASE con el gateway y dé al modelo un prefijo openai/ (por ejemplo, openai/nombre-del-modelo-del-gateway) para que LiteLLM lo enrute como un endpoint compatible con OpenAI.

Codex, Gemini CLI y Qwen Code usan por defecto el inicio de sesión OAuth o de suscripción del proveedor. Para pasar por el gateway debe cambiar a autenticación con clave de API (configurar la clave y la URL base explícitamente); de lo contrario, el agente omite el gateway por completo.

Cline / Roo / Kilo y otros deciden la capacidad de llamada a herramientas y de visión a partir del nombre del modelo. Un nombre personalizado del gateway puede desactivar el function calling; si fallan las llamadas a herramientas, revise las reglas de detección de capacidades del cliente o asigne al modelo un nombre que coincida con una familia conocida.

Durante una inferencia upstream larga, el gateway emite líneas de comentario SSE :keep-alive (inofensivas: omita las líneas que empiezan por :) y, si la transmisión se corta a mitad, inserta un campo _gateway_warning en lugar de devolver un error, para que harness como Claude Code no aborten toda la conversación.

En modo automático, Claude Code espera un veredicto del lado del servidor (un campo safeguards en la solicitud) antes de una acción potencialmente peligrosa. Cuando el upstream es Anthropic oficial, el veredicto se produce dentro de esa misma solicitud y el gateway lo deja pasar sin tocarlo. Cuando el upstream es un tercero que ignora el campo, el gateway responde en su lugar, y el valor predeterminado de fábrica (allow_all) libera todas las acciones, lo cual es más permisivo que no intervenir en la llamada. Devuelva una ruta a su upstream escribiendo "anthropic_server_safeguards": "upstream" en el extra_config de ese upstream; la opción de la consola es solo para administradores.