atrás

Guías paso a paso

4 min de lecturasolo variables de entorno

Claude Code con modelos open source, sin pagar la API de Anthropic

Claude Code es un agente de código de terminal que habla el protocolo de Anthropic. Como Token Factory expone /v1/messages, puedes apuntarlo a GPU Flow y que use modelos open source (GLM, Qwen, Nemotron) servidos por Token Factory.

Equipo GPU Flow. Actualizado el 9 de noviembre de 2026.

Hay dos caminos: configurarlo en tu máquina con variables de entorno, o levantarlo ya precableado dentro de un Sandbox de GPU Flow. Vemos los dos.

1

Elige el modelo

Para un agente de código conviene un modelo con buen razonamiento y buen manejo de herramientas: glm-5.3-nvfp4 o qwen-3.8-27b son buenas opciones. Para tareas ligeras y respuestas rápidas, qwen-3.5-9b.

Las herramientas (function calling) son lo que usa el agente para leer y editar tus ficheros y ejecutar comandos, así que sin ellas no hace su trabajo. En el catálogo vienen marcadas; elige uno que las tenga.

Esto vale si vas a configurarlo en tu máquina, el paso siguiente. Si prefieres el Sandbox ya montado, el modelo lo fija la plantilla y te lo contamos ahí.

2

Configúralo en tu máquina

Claude Code lee de variables de entorno la URL base, la key y los modelos. Pon en GPUFLOW_MODEL el modelo del paso anterior, y en ANTHROPIC_AUTH_TOKEN la key que creaste en el panel: así viaja como Authorization: Bearer y Claude Code no te pide confirmarla al arrancar.

El resto de líneas evita dos sorpresas. Claude Code no usa un solo modelo: los subagentes y las tareas de fondo (títulos, resúmenes) tiran de los alias opus, sonnet y haiku, y si no los apuntas a tu modelo pedirán modelos de Anthropic que Token Factory no sirve. Y en modo automático, Claude Code pide que el servidor revise cada acción, algo que solo hace la API de Anthropic: las dos variables de auto mode hacen que la revise tu modelo y quitan el aviso de sesión no compatible.

bash

export GPUFLOW_MODEL="glm-5.3-nvfp4"

export ANTHROPIC_BASE_URL="https://api.gpuflow.ai"
export ANTHROPIC_AUTH_TOKEN="$GPUFLOW_API_KEY"
export ANTHROPIC_MODEL="$GPUFLOW_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$GPUFLOW_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$GPUFLOW_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$GPUFLOW_MODEL"
export CLAUDE_CODE_AUTO_MODE_MODEL="$GPUFLOW_MODEL"
export CLAUDE_CODE_AUTO_MODE_SERVER=0

claude
3

O arráncalo ya montado en un Sandbox

Si creas un Sandbox con una de las plantillas de asistente, el entorno arranca ya configurado contra la inferencia del clúster: la API key se inyecta sola. Entras por SSH y a trabajar.

Ojo con el modelo, que aquí no lo eliges igual. La plantilla de Claude Code va con tu propia cuenta de Anthropic o con tokens nuestros usando GLM 5.3 NVFP4, que es su modelo fijo. La que te deja elegir cualquier modelo del catálogo es la de Open Code.

Aun así suele ser la vía más limpia: no manejas claves a mano.

4

Comprueba que funciona

Lanza una tarea sencilla ("resume este repo" o "añade un test a esta función") y verifica en el panel que el consumo de tokens aparece bajo tu cuenta. Si ves gasto, Claude Code está hablando con Token Factory.

Qué tener en cuenta

Claude Code está afinado para los modelos de Anthropic. Con modelos open source funciona a nivel de protocolo (mensajes, tools, streaming) y rinde bien en la mayoría de flujos, pero algún comportamiento muy específico puede variar. Pruébalo con tu repo y ajusta el modelo. En modo automático, Claude Code revisa con el mismo modelo cada acción antes de ejecutarla: son peticiones cortas, pero también gastan saldo.

Levanta un Sandbox con tu agente

Un contenedor SSH con Claude Code u Open Code preinstalado y conectado a Token Factory por la red interna. Los tokens salen de tu saldo de Token Factory.