Claude Code envía cada solicitud en el formato de la Messages API de Anthropic, a /v1/messages en la dirección a la que apunte ANTHROPIC_BASE_URL. La mayoría de los proveedores de modelos abiertos, BroadNet Inference incluido, hablan en cambio el formato de OpenAI. Por eso necesita un proxy que traduzca entre ambos o un proveedor que publique su propio endpoint en formato Anthropic. Este artículo cubre las dos opciones, además de los límites que deciden si vale la pena.
¿Por qué Claude Code no puede llamar directamente a una API compatible con OpenAI?
La guía de compatibilidad de gateways de Claude Code enumera los formatos que debe exponer un gateway. Para una URL base simple, es la Messages API de Anthropic: /v1/messages, con /v1/messages/count_tokens opcional, y el reenvío de los encabezados anthropic-beta y anthropic-version. Una API compatible con OpenAI ofrece /v1/chat/completions, con otra forma de solicitud y de respuesta. Si apunta Claude Code directamente a una de ellas, las solicitudes fallan.
Hay algo más que debe saber antes de empezar. La propia documentación de Claude Code dice que Anthropic “doesn’t support routing Claude Code to non-Claude models through any gateway.” (Traducción: no da soporte al enrutamiento de Claude Code hacia modelos que no sean Claude a través de ningún gateway). Mucha gente lo hace igualmente, pero nadie en Anthropic lo depurará por usted.
¿Cuáles son sus tres opciones?
| Vía | Cómo funciona | Ideal para | Contrapartida |
|---|---|---|---|
| Proxy traductor (LiteLLM) | Claude Code habla en formato Anthropic con un proxy local; el proxy llama al proveedor compatible con OpenAI | Usar un proveedor concreto compatible con OpenAI, como BroadNet | Un proceso más que ejecutar y actualizar; huecos en la traducción |
| Endpoint nativo en formato Anthropic | El propio proveedor acepta /v1/messages |
Modelos DeepSeek o GLM de sus creadores | Cada uno asigna o ignora algunos campos |
| Otro agente | Use un agente que acepte una URL base compatible con OpenAI | Quien no necesite Claude Code en concreto | Renuncia a la interfaz y las funciones de Claude Code |
¿Cómo se ejecuta Claude Code a través de LiteLLM?
El tutorial de LiteLLM para modelos que no son de Anthropic funciona así: instale el proxy, defina los modelos en config.yaml, inícielo y luego defina dos variables en Claude Code. LiteLLM traduce entre formatos, así que Claude Code sigue enviando solicitudes de Anthropic.
Defina los modelos de BroadNet igual que en la guía de LiteLLM, con el prefijo openai/ y api_base:
model_list:
- model_name: glm
litellm_params:
model: openai/broadnet/glm-5.3
api_base: https://inference.broadnet.ai/v1
api_key: os.environ/BROADNET_API_KEY
rpm: 30
- model_name: qwen
litellm_params:
model: openai/broadnet/qwen3.8-27b
api_base: https://inference.broadnet.ai/v1
api_key: os.environ/BROADNET_API_KEY
rpm: 30
general_settings:
master_key: os.environ/LITELLM_MASTER_KEY
Inicie el proxy:
uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml # listens on http://0.0.0.0:4000
Después apunte Claude Code hacia él. ANTHROPIC_AUTH_TOKEN se envía como encabezado Authorization: Bearer, que es lo que lee LiteLLM:
export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm # subagents
claude
Ejecute /status en Claude Code. La línea Anthropic base URL debe mostrar la dirección del proxy.
Las variables de modelo importan. La página de Claude Code de LiteLLM advierte que elegir un nombre integrado de Claude que su configuración no define falla con “Invalid model name passed in” (Traducción: se pasó un nombre de modelo no válido). La referencia de variables de entorno de Claude Code dice que ANTHROPIC_DEFAULT_HAIKU_MODEL también se usa para funciones en segundo plano, así que asígnelo también, o las solicitudes en segundo plano pedirán un nombre de Haiku que el proxy no conoce. CLAUDE_CODE_SUBAGENT_MODEL define el modelo por defecto de los subagentes, pero el modelo que Claude pasa al crear uno, a menudo un alias como sonnet o haiku, tiene prioridad. Asignar también los alias sonnet y opus hace que esas solicitudes sigan resolviéndose a un modelo que el proxy conoce. Guarde su clave de BroadNet en el entorno del proxy, nunca en el .claude/settings.json que se sube al repositorio de un proyecto.
¿Qué endpoints de DeepSeek y GLM funcionan sin proxy?
Dos creadores de modelos publican URL base en formato Anthropic:
| Proveedor | URL base | Tratamiento de modelos (según su documentación, consultada el 2026-11-15) |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
Los nombres claude-sonnet* y claude-haiku* se asignan a deepseek-flash; claude-opus* se asigna a deepseek-v4-pro; los nombres que no empiezan por claude devuelven 400 |
| Z.ai (GLM Coding Plan) | https://api.z.ai/api/anthropic |
Clave en ANTHROPIC_AUTH_TOKEN; el ejemplo de configuración manual asigna Opus y Sonnet a glm-5.3[1m] y Haiku a glm-5.3-flash[1m] |
La nota de lanzamiento de DeepSeek del 10 de septiembre de 2026 dice que deepseek-flash sirve DeepSeek-V4.1-Flash. Su página de la API de Anthropic también enumera lo que ignora: cache_control, budget_tokens, disable_parallel_tool_use y el encabezado anthropic-version, entre otros. En deepseek-flash, las imágenes en mensajes del asistente devuelven 400, y deepseek-v4-pro sustituye las imágenes por “[Unsupported Image]”.
Si solo quiere DeepSeek o GLM en Claude Code, estos endpoints nativos son el camino más corto. Los precios y los límites de los planes de ambos se comparan en la página de alternativas a la API de Claude.
¿Qué falla o cambia con un modelo que no es Claude?
La traducción mantiene el flujo de solicitudes, pero varias funciones de Claude Code dependen de cosas que un proxy u otro modelo pueden no transmitir. La documentación de Claude Code nombra estas:
- Prompt caching. Claude Code marca los bloques
systemy de mensajes concache_control. Si el gateway o el proveedor lo descartan, no hay error, pero cada turno se factura como entrada sin caché. Con un proveedor compatible con OpenAI, la caché sigue las reglas de ese proveedor. BroadNet factura la entrada en caché a un precio menor cuando su bloque usage indica un acierto de caché; revisecached_tokensen sus registros. - Conteo de tokens. Sin
/v1/messages/count_tokens, Claude Code recurre a una estimación basada en caracteres, así que/contextes aproximado. - Ventana de contexto. Claude Code aplica su propia ventana por defecto a los nombres de modelo que no reconoce. Defina
CLAUDE_CODE_AUTO_COMPACT_WINDOW(de 100,000 a 1,000,000 tokens) según el modelo. Para Qwen3.8 27B, con un contexto de 262,144 tokens, póngalo bastante por debajo de esa cifra. - Campos desconocidos. Un
400que mencioneExtra inputs are not permittedo un valor deanthropic-betasignifica que algo en el camino rechazó un campo experimental. La documentación sugiereCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1. - Pensamiento.
MAX_THINKING_TOKENSy el pensamiento adaptativo son funciones de Claude. En BroadNet, DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B razonan antes de responder, y esos tokens de razonamiento cuentan dentro demax_tokens. Si las respuestas llegan vacías, suba el límite de salida o envíereasoning_effortbajo. Consulte por qué los modelos de razonamiento devuelven respuestas vacías. - Imágenes. GLM 5.3 es solo texto en BroadNet. Use Qwen3.8 27B si pega capturas de pantalla.
Pruebe una tarea real de principio a fin, con ediciones de archivos, comandos de shell y una sesión larga, antes de depender de esta configuración.
¿Qué modelo de BroadNet conviene poner detrás de Claude Code?
Claude Code lee archivos, los edita y ejecuta comandos mediante llamadas a herramientas. La referencia de la API de BroadNet documenta herramientas, salida estructurada y razonamiento para dos modelos:
| Modelo | Entrada / salida por 1M de tokens | Contexto | Imágenes | Herramientas documentadas |
|---|---|---|---|---|
| GLM 5.3 | $0.78 / $3.46 | 1,048,576 | No | Sí |
| Qwen3.8 27B | $0.175 / $2.17 | 262,144 | Sí | Sí |
| DeepSeek V4.1 Flash | $0.175 / $0.52 | 1,048,576 | Sí | No documentadas |
GLM 5.3 es el modelo principal natural para repositorios grandes. Qwen3.8 27B cuesta menos por token de entrada y sirve para imágenes y llamadas en segundo plano más ligeras. Ambos requieren una recarga; no los cubre el crédito inicial de $5. La comparación de GLM 5.3 y Qwen3.8 27B los muestra lado a lado.
¿Se puede usar el plan de tarifa plana de BroadNet con Claude Code?
No como uso documentado, y es mejor saberlo antes de comprar. Los planes Luna Llena (Full Moon), Órbita (Orbit) y Meteoro (Meteor) cubren solo DeepSeek V4.1 Flash, y BroadNet no documenta llamadas a herramientas para ese modelo. Además, cada sesión de plan ejecuta una solicitud a la vez. Claude Code puede ejecutar subagentes y tareas en segundo plano junto al bucle principal, y esas solicitudes harían cola en una sola sesión.
Si lo que busca es un precio fijo, use un agente que BroadNet documente con el plan, como Aider. Para Claude Code, use GLM 5.3 o Qwen3.8 27B con pago por uso, que permiten 30 solicitudes por minuto y 4 en curso por clave. Ante un 429, espere y reintente como en errores y reintentos.
¿Cuándo conviene más otro agente?
Si no necesita Claude Code en sí, prescinda del proxy. opencode, Cline, Roo Code, Continue y Aider aceptan directamente una URL base compatible con OpenAI, una clave y un ID de modelo. Los nombres de los campos de cada uno están en modelos abiertos en agentes de programación, con guías de configuración para opencode y Cline. Menos piezas móviles significan menos fallos de traducción. Para comparar modelos para este trabajo, consulte el mejor modelo abierto para agentes de programación.
Quédese con los modelos Claude si su trabajo depende de funciones propias de Claude, como el pensamiento extendido, el prompt caching de Anthropic o las betas más recientes de Claude Code. En ese caso, reduzca costos dentro de Claude Code en lugar de cambiar de modelo.
Dónde encaja BroadNet Inference
BroadNet Inference es una API compatible con OpenAI, así que solo llega a Claude Code a través de un proxy como LiteLLM. Detrás de uno, GLM 5.3 y Qwen3.8 27B son los dos modelos con llamadas a herramientas documentadas, facturados por token y sin conservar ningún contenido después de la solicitud. Si quiere un endpoint nativo en formato Anthropic, DeepSeek y Z.ai son más sencillos. Si quiere el plan fijo de BroadNet, combínelo con un agente que hable el formato de OpenAI.
