Flujos de agentes · 2026-10-10

Gateway para Claude Code: ANTHROPIC_DEFAULT_HAIKU_MODEL y Haiku gratis

Define ANTHROPIC_DEFAULT_HAIKU_MODEL para que Claude Code envíe las tareas de fondo a anthropic/claude-haiku-5.5-free en LLMTR, gratis hasta el 14 de octubre.

Diagrama simple: una terminal con Claude Code envía las solicitudes principales y las de fondo a https://llmtr.com, y las solicitudes de fondo van a anthropic/claude-haiku-5.5-free.

Respuesta corta: tareas de fondo gratis con una sola variable

LLMTR (llmtr.com) es una pasarela que da acceso a modelos de lenguaje alojados en Turquía y en proveedores globales a través de una única API compatible con OpenAI. Apunta Claude Code, el agente de programación de Anthropic, a llmtr.com con ANTHROPIC_BASE_URL y define ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-5.5-free: las tareas de fondo, como los títulos de sesión, irán a Claude Haiku 5.5 a 0,00 $ por 1M de tokens. Los clientes compatibles con OpenAI usan https://llmtr.com/v1.

Claude Haiku 5.5 es el modelo Haiku actual de Anthropic para trabajo de alto volumen y sensible a la latencia, como clasificación, enrutamiento, extracción y subagentes. En LLMTR es gratuito, sin descuento de crédito, hasta el 14 de octubre de 2026, 23:59 (hora de Turquía), con un límite diario por cuenta; puede terminar antes si se agota la cuota reservada para el uso gratuito. Después, devuelve HTTP 410 model_retired.

Cómo configurar el modelo de fondo de Claude Code con ANTHROPIC_DEFAULT_HAIKU_MODEL

Define ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-5.5-free junto con ANTHROPIC_BASE_URL=https://llmtr.com y tu clave de LLMTR en ANTHROPIC_AUTH_TOKEN, y arranca Claude Code desde esa terminal: las tareas de fondo y el alias haiku irán al modelo gratuito hasta el 14 de octubre de 2026, 23:59 (hora de Turquía).

El bloque también define CLAUDE_CODE_AUTO_COMPACT_WINDOW=100000 y CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000, que mantienen a Claude Code dentro de los límites del modelo gratuito (ver la sección de límites). Las variables valen para la sesión arrancada desde esa terminal; el modelo principal no cambia salvo que elijas otro con ANTHROPIC_MODEL, /model o --model.

Variables de entorno que envían las tareas de fondo de Claude Code a anthropic/claude-haiku-5.5-free (bash).

export ANTHROPIC_BASE_URL=https://llmtr.com
export ANTHROPIC_AUTH_TOKEN=llmtr-your_key
export ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-5.5-free
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=100000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000

Las variables y qué hace cada una

ANTHROPIC_BASE_URL recibe la raíz del host sin /v1, https://llmtr.com, y Claude Code envía sus solicitudes a https://llmtr.com/v1/messages. ANTHROPIC_AUTH_TOKEN lleva la clave de LLMTR como Authorization: Bearer. Con ANTHROPIC_API_KEY, Claude Code envía la clave en la cabecera x-api-key; LLMTR acepta la misma clave en ambas.

ANTHROPIC_DEFAULT_HAIKU_MODEL fija el id de modelo del alias haiku, y Claude Code también lo usa para funciones de fondo como los títulos de sesión. Detrás de una pasarela, sin esta variable, las tareas de fondo usan el modelo principal; con ella, esas solicitudes pequeñas tienen su propio modelo.

Variables de Claude Code con LLMTR (documentación de Claude Code, 2026-10-10)
VariableValorEfecto
ANTHROPIC_BASE_URLhttps://llmtr.comenvía las solicitudes a /v1/messages de LLMTR
ANTHROPIC_AUTH_TOKENtu clave de LLMTRse envía como Authorization: Bearer
ANTHROPIC_DEFAULT_HAIKU_MODELanthropic/claude-haiku-5.5-freemodelo para tareas de fondo y el alias haiku
ANTHROPIC_MODELanthropic/claude-haiku-5.5-freemodelo principal (opcional, toda la sesión)
CLAUDE_CODE_AUTO_COMPACT_WINDOW100000compacta la conversación a los 100.000 tokens
CLAUDE_CODE_MAX_OUTPUT_TOKENS32000máximo de tokens de salida por solicitud

Dos configuraciones: solo fondo o toda la sesión

Configuración A, solo fondo: define ANTHROPIC_DEFAULT_HAIKU_MODEL y no toques el modelo principal; las tareas de fondo envían prompts pequeños y quedan lejos del límite de prompt. Configuración B, toda la sesión: da el mismo id, anthropic/claude-haiku-5.5-free, a ANTHROPIC_MODEL y a ANTHROPIC_DEFAULT_HAIKU_MODEL, y cada solicitud irá a ese modelo. El comando /model y la opción --model tienen prioridad sobre ANTHROPIC_MODEL.

Antes de arrancar Claude Code, revisa la conexión con la solicitud de abajo: pide como máximo 16 tokens a /v1/messages con la clave de ANTHROPIC_AUTH_TOKEN; si llega una respuesta, la clave, la dirección y el id de modelo son correctos. Con CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, el selector de /model se llena desde https://llmtr.com/v1/models y muestra anthropic/claude-haiku-5.5-free, porque conserva los ids con claude o anthropic.

Solicitud a /v1/messages que revisa la clave y el id de modelo antes de arrancar Claude Code.

curl https://llmtr.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"anthropic/claude-haiku-5.5-free","max_tokens":16,"messages":[{"role":"user","content":"test"}]}'

Límites a planificar y fin el 14 de octubre

El modelo gratuito acepta hasta 100.000 tokens de prompt por solicitud, contando los mensajes y las definiciones de herramientas que envía Claude Code. Con CLAUDE_CODE_AUTO_COMPACT_WINDOW=100000, Claude Code compacta la conversación a ese tamaño. Es el mínimo documentado de la variable; si una sesión larga aun así recibe HTTP 400 prompt_too_large, ejecuta /compact. El límite de respuesta es de 32.768 tokens: no lo superes en CLAUDE_CODE_MAX_OUTPUT_TOKENS.

El uso gratuito tiene un límite diario por cuenta; al alcanzarlo, la API devuelve HTTP 429 con Retry-After y el límite se restablece solo. El periodo termina el 14 de octubre de 2026, 23:59 (hora de Turquía), o antes si se agota su cuota. Después, anthropic/claude-haiku-5.5-free devuelve HTTP 410 model_retired: cambia ANTHROPIC_DEFAULT_HAIKU_MODEL, y ANTHROPIC_MODEL si lo definiste, antes de esa fecha. En Windows, usa PowerShell así.

Las mismas variables en Windows PowerShell, con los valores de compactación y de salida de esta sección.

$env:ANTHROPIC_BASE_URL = "https://llmtr.com"
$env:ANTHROPIC_AUTH_TOKEN = "llmtr-your_key"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "anthropic/claude-haiku-5.5-free"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW = "100000"
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "32000"

Empezar en LLMTR: cuenta, clave y primera solicitud

Paso 1: crea una cuenta en llmtr.com. Paso 2: crea una clave API en Dashboard > API Keys; la clave se muestra una sola vez, así que guárdala en una variable de entorno como LLMTR_API_KEY, o en ANTHROPIC_AUTH_TOKEN para Claude Code. Paso 3: envía la primera solicitud a https://llmtr.com/v1 con cualquier SDK compatible con OpenAI, cambiando solo base_url y api_key, con el modelo anthropic/claude-haiku-5.5-free.

El uso por clave aparece en la página de uso del Dashboard. La misma clave sirve para todo el catálogo; cambiar de modelo es cambiar la cadena del modelo. Los demás modelos se facturan con crédito prepago a precio de catálogo; anthropic/claude-haiku-5.5-free cuesta 0,00 $ por 1M de tokens de entrada y salida hasta la fecha de fin.

Enviar las tareas de fondo de Claude Code al Claude Haiku 5.5 gratuito

Crea una clave API de LLMTR, define las variables de entorno de Claude Code y revisa la conexión con una solicitud a /v1/messages.

  1. Cuenta de LLMTR y clave API. Crea una cuenta en llmtr.com y una clave API en Dashboard > API Keys. La clave sin procesar se muestra una sola vez; guárdala en una variable de entorno.
  2. Definir las variables de entorno. En la terminal desde la que arrancas Claude Code, define ANTHROPIC_BASE_URL=https://llmtr.com, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-5.5-free, CLAUDE_CODE_AUTO_COMPACT_WINDOW=100000 y CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000.
  3. Revisar la conexión con curl. Envía la solicitud curl a https://llmtr.com/v1/messages con el id de modelo anthropic/claude-haiku-5.5-free; si llega una respuesta, la clave y el id de modelo son correctos.

Frequently asked questions

¿Qué variable de Claude Code define el modelo de fondo?

ANTHROPIC_DEFAULT_HAIKU_MODEL, con el valor anthropic/claude-haiku-5.5-free, junto con ANTHROPIC_BASE_URL=https://llmtr.com y tu clave de LLMTR. Detrás de una pasarela, sin esta variable, las tareas de fondo usan el modelo principal.

¿Por qué poner CLAUDE_CODE_AUTO_COMPACT_WINDOW en 100000 con Claude Haiku 5.5?

El modelo gratuito acepta prompts de hasta 100.000 tokens, herramientas incluidas; con 100000, Claude Code compacta a ese tamaño. Si una sesión larga aun así recibe HTTP 400 prompt_too_large, ejecuta /compact.

¿Qué pasa en Claude Code después del 14 de octubre de 2026?

Desde el 14 de octubre de 2026, 23:59 (hora de Turquía), o antes si se agota la cuota gratuita, anthropic/claude-haiku-5.5-free devuelve HTTP 410 model_retired. Cambia ANTHROPIC_DEFAULT_HAIKU_MODEL antes de esa fecha.

Artículos relacionados