Secciones de la base de conocimientos ▾

Navegación

▸ Empiece aquí Por roles

Categorías

Herramientas 52
Glosario 12

Herramientas

Claude Code + Gonka AI — LLM para terminal

Claude Code es un potente asistente de IA para desarrollo directamente en la terminal. Funciona con Git, el sistema de archivos, ejecuta pruebas y refactoriza código. Sin embargo, el Claude Sonnet 4.6 nativo cuesta entre $3 y $15 por 1M de tokens, y con trabajo activo, la cuenta semanal puede superar los $200.

JoinGonka Gateway admite la API de Anthropic nativa (/v1/messages): Claude Code se conecta directamente, sin proxy. Los modelos MiniMax M2.7, DeepSeek V4 Flash y GLM-5.3 Flash a través de la red descentralizada Gonka cuestan $0.0069/1M tokens, cientos de veces más barato, con una calidad comparable en tareas de programación.

La configuración toma 2 minutos: un comando de instalación o algunas variables de entorno.

Paso 1: Obtener la clave API

Si aún no tiene una clave de JoinGonka Gateway:

  1. Regístrese en gate.joingonka.ai/register.
  2. Obtenga un bono de 3M tokens gratuitos.
  3. Cree una API-key en Dashboard → API Keys.
  4. Copie la clave (formato: jg-xxx).

Una clave funciona con cualquier herramienta compatible con OpenAI: Cursor, Aider, LangChain, etc.

Paso 2: Conectar Claude Code

JoinGonka Gateway admite de forma nativa la Anthropic Messages API (/v1/messages): no hace falta proxy.

El método recomendado es el instalador de un solo comando:

npx @joingonka/setup --tool claude-code

Este es el instalador universal de JoinGonka: ejecútalo sin flag —npx @joingonka/setup— y te ofrecerá elegir una herramienta de la lista. Ya son 25: Claude Code, Codex CLI, OpenClaw, Cursor, Cline y otras: lista completa en el README del paquete.

El instalador pedirá la API key, hará un backup de ~/.claude/settings.json y escribirá en el bloque env solo sus propios campos, sin tocar el resto de tu configuración: la dirección del gateway (ANTHROPIC_BASE_URL), la clave (ANTHROPIC_AUTH_TOKEN), el modelo (ANTHROPIC_MODEL y los alias opus, sonnet, haiku) y sus límites reales: CLAUDE_CODE_MAX_CONTEXT_TOKENS y CLAUDE_CODE_MAX_OUTPUT_TOKENS. Los límites importan: para un identificador desconocido, Claude Code asume su propia ventana de contexto y no alcanza a comprimir el historial a tiempo, y los modelos de la red tienen su propia ventana: de 200K a 390K tokens. El archivo con la clave recibe permisos 600. Por defecto se instala DeepSeek V4 Flash; para elegir otro modelo está el flag --model minimax|deepseek|glm. Con el flag --scope local, la configuración se escribe en .claude/settings.local.json del proyecto actual, y el archivo se agrega a .gitignore.

Configurar manualmente (plan B)

O manualmente: con variables de entorno:

export ANTHROPIC_BASE_URL=https://gate.joingonka.ai
export ANTHROPIC_AUTH_TOKEN=jg-your-key
export ANTHROPIC_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=380000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32768
claude

Las dos primeras variables dirigen Claude Code al gateway: las solicitudes van en el formato nativo de Anthropic, Gateway las convierte en solicitudes a la red Gonka y devuelve la respuesta en formato Anthropic. ANTHROPIC_MODEL fija el modelo de la red: sin ella, Claude Code enviará su propio identificador claude-* y el gateway sustituirá el modelo por defecto. Las dos últimas declaran la ventana de contexto real y el techo de respuesta del modelo elegido (requiere Claude Code 2.1.223 o más reciente); de lo contrario, para un identificador desconocido Claude Code asume su propia ventana y no alcanza a comprimir el historial a tiempo. Los valores para otros modelos de la red están en la sección «Consejos de trabajo» más abajo.

Qué se admite:

  • Streaming: la respuesta empieza a mostrarse de inmediato (SSE en formato Anthropic: message_start, content_block_delta, message_stop)
  • Tool calling: Claude Code usa intensivamente funciones para trabajar con archivos y comandos. Tool calling nativo en todos los modelos de la red.
  • System prompts: los prompts de sistema se transmiten tal cual

Verificación: en Claude Code haz cualquier pregunta. Si apareció la respuesta, todo funciona.

Para Windows/PowerShell:

$env:ANTHROPIC_BASE_URL="https://gate.joingonka.ai"
$env:ANTHROPIC_AUTH_TOKEN="jg-your-key"
$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="380000"
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS="32768"
claude

El antiguo instalador específico npx @joingonka/claude-code fue reemplazado por el universal @joingonka/setup y ya no se desarrolla: usa el nuevo.

Comparación de costos con Anthropic

Claude Code es una de las herramientas de IA más «voraces»: envía el contexto completo de los archivos, el historial de comandos y los diffs. Una sesión típica consume entre 20 y 50M de tokens.

ProveedorModeloPrecio input/output por 1MSesión 4h (~30M tokens)Mes (20 días laborables)
JoinGonkaMiniMax M2.7 / DeepSeek V4 Flash / GLM-5.3 Flash$0.0069 / $0.021$0.14$2.9
AnthropicClaude Sonnet 4.6$3.00 / $15.00$210$4,200
OpenAIGPT-5.5$5.00 / $30.00$300$6,000

La diferencia es de tres órdenes de magnitud. Por $2.9 al mes a través de JoinGonka, obtiene lo que cuesta más de $4,200 en Anthropic. Para un desarrollador indie, esta es la diferencia entre «puedo permitirme un asistente de IA» y «no puedo».

Consejos para trabajar

Algunas recomendaciones para trabajar eficazmente con Claude Code a través de Gonka:

  • Contexto: MiniMax M2.7 tiene una ventana de contexto de 200K tokens (~100K palabras) — suficiente para la mayoría de los proyectos, DeepSeek V4 Flash tiene 380K, y GLM-5.3 Flash tiene 390K. La longitud máxima de respuesta a través de Gateway es de 8192 tokens en MiniMax M2.7 y GLM-5.3 Flash, y 32768 en DeepSeek V4 Flash. Para generaciones largas, puede ser necesario dividir la tarea en partes. La lista actualizada de modelos de red es GET https://gate.joingonka.ai/v1/models.
  • Streaming: Gateway soporta streaming en formato nativo Anthropic — la respuesta comienza a mostrarse inmediatamente, igual que con el Claude nativo.
  • Tool calling: todos los modelos de red soportan tool calling nativo, algo importante para Claude Code, ya que la herramienta utiliza activamente funciones para trabajar con archivos y comandos.
  • Latencia: la primera solicitud puede tardar de 5 a 10 segundos (arranque en frío del nodo). Las siguientes — de 1 a 3 segundos.
  • Otras herramientas: JoinGonka Gateway también es compatible con OpenAI API — Aider, OpenCode, Cursor se conectan a través de /v1/chat/completions.

Para desarrolladores que prefieren otras herramientas de terminal, ver también: Aider, OpenCode.

Claude Code + Gonka = potente asistente de IA en terminal por ~$0.60/mes en lugar de $4,200 con Anthropic. Conexión directa a través de Anthropic API — sin proxy: un comando de instalación, 2 minutos. Tokens gratuitos al comenzar.
← Cursor + Gonka AI — LLM barato para codificación OpenClaw + Gonka AI — Agentes de IA accesibles →

¿Quieres saber más?

Explora otras secciones o empieza a ganar GNK ahora mismo.

Obtener tokens gratuitos →