Claude Code + DeepSeek V4 Flash: cómo conectarlo y cuánto cuesta una tarea

DeepSeek tiene una dirección en formato Anthropic — https://api.deepseek.com/anthropic — y una guía oficial para Claude Code. La clave se crea en el panel de DeepSeek (platform.deepseek.com) y el saldo se recarga por adelantado. Las variables de la guía de DeepSeek al 2 de noviembre de 2026:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432
claude

Lo que conviene saber antes del primer arranque:

• Nombre del modelo. Desde el 10 de septiembre de 2026, deepseek-flash es V4.1 Flash, y desde el 17 de octubre, su actualización 1017 al mismo precio. DeepSeek todavía acepta el nombre antiguo deepseek-v4-flash, pero responde con la misma V4.1 Flash. El sufijo [1m] le indica a Claude Code que la ventana del modelo es de 1 millón de tokens, y CLAUDE_CODE_AUTO_COMPACT_WINDOW define a partir de qué volumen se comprime el historial.
• Nombres de Claude. Si dejas en Claude Code un modelo con nombre de Claude, DeepSeek sustituye el suyo: los nombres basados en claude-opus van a V4 Pro y se cobran a precio de V4 Pro, el resto va a deepseek-flash. Por eso en la guía todos los alias están fijados explícitamente.
• Horas pico. Desde el 16 de agosto de 2026, DeepSeek cobra el doble los días laborables de 01:00 a 04:00 y de 06:00 a 10:00 UTC, excepto festivos en China. En hora de Pekín eso es casi toda la jornada laboral; en Europa, la mañana; en EE. UU., la tarde y la noche.
• Búsqueda web. Cuando Claude Code busca en internet con su herramienta integrada, la búsqueda la realiza la propia DeepSeek. Desde el 31 de octubre de 2026 es de pago: $0.75 por cada 1000 búsquedas exitosas, más los tokens que el modelo gasta en leer lo encontrado.

En la red Gonka funciona DeepSeek V4 Flash en la versión 0731, con pesos abiertos bajo licencia MIT. La pasarela acepta por sí misma las solicitudes de Claude Code en formato Anthropic (/v1/messages), sin necesidad de ninguna capa intermedia.

Paso 1. La clave. Regístrate en JoinGonka Gateway — las cuentas nuevas reciben 3M tokens gratis — y crea en el panel una clave jg-….

Paso 2. El instalador.

npx @joingonka/setup --tool claude-code --model deepseek

El instalador te pedirá la clave, guardará una copia de ~/.claude/settings.json y escribirá en el bloque env solo sus propias variables: la dirección de la pasarela y la clave; el modelo para la sesión actual y las nuevas, para los alias opus, sonnet, fable y para los subagentes; MiniMax M2.7 para el alias haiku, donde Claude Code mantiene las tareas en segundo plano; y los límites reales del modelo — ventana de 380 000 tokens y respuestas de hasta 32 768. No toca el resto de tu configuración y asigna permisos 600 al archivo con la clave. Al final, el instalador verifica la clave con una solicitud real. El mismo instalador también configura otros programas — ya son 25, entre ellos Codex CLI y OpenCode.

Paso 3. Verificación. Ejecuta claude y abre /status: ahí deben aparecer la línea Anthropic base URL con la dirección de la pasarela y la línea Auth token con ANTHROPIC_AUTH_TOKEN. Después pídele una tarea de código, por ejemplo Read calc.py and tell me in one sentence whether it has a bug.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Todas las variantes de configuración, incluidas Windows y la configuración para un solo proyecto, están en la guía de Claude Code.

Qué significa esto en la práctica:

• Versión del modelo. V4.1 Flash es más nueva y, según los propios benchmarks de DeepSeek, es más potente: en Terminal-Bench 2.1, V4.1 Flash saca 90,6 frente a 82,7 de V4 Flash 0731 (según los lanzamientos del 10 de septiembre y el 31 de julio). Si necesitas imágenes, una ventana de un millón de tokens o la versión más reciente, usa la API oficial de DeepSeek. Si lo que más te importa es el coste de un gran volumen de trabajo y un precio estable a cualquier hora, pon a prueba V4 Flash a través del gateway con tus propias tareas: puedes empezar con tokens gratis.
• Sesiones largas. En una ventana de 380 000 tokens cabe menos historial que en un millón. Para el trabajo habitual es suficiente: la consulta media de Claude Code a DeepSeek V4 Flash a través de nuestro gateway en octubre de 2026 fue de unos 96 mil tokens.

Más sobre el modelo, en el artículo sobre DeepSeek V4 Flash en la red Gonka.

Empecemos con los precios por 1M de tokens al 2 de noviembre de 2026, según la página de precios de DeepSeek y la API de OpenRouter. Junto a DeepSeek aparece el mismo V4 Flash 0731 de los proveedores más baratos de OpenRouter:

Nuestra entrada normal es entre 24 y 49 veces más barata que la de DeepSeek, y la salida, entre 32 y 65 veces. Pero leer de caché en DeepSeek cuesta en horas pico más o menos como nuestra entrada, y el resto del tiempo la mitad, y Claude Code se pasa casi todo el rato releyendo lo mismo: el prompt del sistema, la descripción de las herramientas y el historial de la sesión. Por eso hay que comparar la tarea completa, no el precio por token.

La tarea. Tomemos una tarea de 30 llamadas al modelo: por ejemplo, encontrar un error, corregir el código y pasar las pruebas. Según los datos de nuestro gateway de octubre de 2026, una consulta de Claude Code a DeepSeek V4 Flash supone de media unos 96 mil tokens de entrada y 0,9 mil de salida. En total, la tarea son 2,9 millones de tokens de entrada y 27,5 mil de salida. Claude Code reenvía la sesión entera en cada paso, y casi toda coincide con la consulta anterior, así que asumamos que tanto en DeepSeek como en OpenRouter el 95% de la entrada se lee de caché.

Los importes están calculados con los precios al 2 de noviembre de 2026; nuestro precio por token en esta página es dinámico y cambia junto con el tipo de cambio de GNK. Para una tarea así, el gateway sale unas 5 veces más barato que DeepSeek en horas pico, 2,5 veces en el resto del tiempo y 2,3 veces más barato que el proveedor más económico del mismo modelo en OpenRouter.

La diferencia depende de la caché. Si se lee el 98% de la entrada desde caché, DeepSeek es unas 1,8 veces más caro que nosotros fuera de pico y 3,7 veces en horas pico. Si es el 90%, 3,7 y 7,4 veces. En nuestro caso, la proporción de caché no afecta al importe: toda la entrada cuesta lo mismo. El cálculo mensual, la variante con GLM-5.3 Flash y los precios del propio Claude como referencia están en el artículo «Claude Code más barato».

Claude Code Router (CCR) es un proyecto de código abierto con licencia MIT: una puerta de enlace local en tu ordenador, por defecto http://127.0.0.1:3456. Claude Code y otros agentes le envían las peticiones a él, y él a los proveedores que elijas: traduce las peticiones entre formatos (Anthropic Messages, OpenAI Chat y Responses, Gemini), reparte las tareas entre modelos según reglas, cambia a un modelo de reserva cuando algo falla y lleva un registro de peticiones con tokens y estimación de coste. Se instala como aplicación para macOS, Windows y Linux o con el comando npm install -g @musistudio/claude-code-router (necesita Node.js 22 o superior).

Para un solo DeepSeek no hace falta: DeepSeek tiene su propia dirección en formato Anthropic, y JoinGonka Gateway también acepta peticiones de Claude Code directamente. CCR tiene sentido si quieres:

• tener varios proveedores y reglas sobre qué tarea va a dónde;
• pasar automáticamente a un modelo de reserva cuando el principal no responde;
• ver el registro de peticiones, tokens y gastos en un solo lugar;
• conectar un proveedor que solo entiende el formato de OpenAI.

CCR conecta una dirección propia (custom endpoint) con el protocolo Anthropic Messages o OpenAI Chat, y la puerta de enlace tiene ambos protocolos: la dirección base https://gate.joingonka.ai para Anthropic y https://gate.joingonka.ai/v1 para OpenAI. Los detalles están en la documentación de Gonka API, sección Anthropic Messages.

Claude Code toma la clave de una API externa de una de estas dos variables:

• ANTHROPIC_AUTH_TOKEN — la clave se envía en el encabezado Authorization: Bearer y funciona de inmediato. Así lo hacen tanto la guía de DeepSeek como nuestro instalador.
• ANTHROPIC_API_KEY — la clave se envía en el encabezado x-api-key; en modo interactivo Claude Code preguntará una vez si usarla.

DeepSeek y JoinGonka aceptan ambos encabezados. Mientras la variable con la clave esté definida, la suscripción de claude.ai no se consume: Claude Code recuerda tu sesión, pero no la envía, y las peticiones se pagan con el saldo de esa clave. Si solo defines la dirección sin la clave, Claude Code enviará su sesión de claude.ai a la nueva dirección y la petición no pasará.

Guarda la clave en ~/.claude/settings.json o en .claude/settings.local.json del proyecto, pero no en el .claude/settings.json común del repositorio, porque normalmente se sube al commit. El instalador con el flag --scope local escribe en settings.local.json y lo añade él mismo a .gitignore.

Volver a Claude — quita del bloque env las líneas que apuntan a DeepSeek o a la puerta de enlace y reinicia Claude Code: volverá a tomar tu sesión de claude.ai.