Seções da Base de Conhecimento ▾

Ferramentas

Claude Code + Gonka AI — LLM para terminal

Claude Code é um poderoso assistente de IA para desenvolvimento diretamente no terminal. Ele funciona com Git, sistema de arquivos, executa testes e refatora código. Mas o Claude Sonnet 4 nativo custa $3-15 por 1M de tokens, e com trabalho ativo, a conta por uma semana pode exceder $200.

JoinGonka Gateway suporta a API nativa da Anthropic (/v1/messages) — Claude Code se conecta diretamente, sem proxy. O modelo Qwen3-235B através da rede descentralizada Gonka por $0.001/1M de tokens — milhares de vezes mais barato, com qualidade comparável para tarefas de codificação.

A configuração leva 2 minutos — duas variáveis de ambiente.

Passo 1: Obter a chave API

Se você ainda não tem uma chave JoinGonka Gateway:

  1. Registre-se em gate.joingonka.ai/register.
  2. Obtenha um bônus de 10M tokens grátis.
  3. Crie uma chave API em Dashboard → API Keys.
  4. Copie a chave (formato: jg-xxx).

Uma chave funciona com qualquer ferramenta compatível com OpenAI: Cursor, Aider, LangChain, etc.

Passo 2: Conectar o Claude Code

JoinGonka Gateway oferece suporte nativo à Anthropic Messages API (/v1/messages) — não é necessário proxy.

Configuração automática (1 comando):

npx @joingonka/claude-code

O instalador solicitará sua chave de API e salvará as configurações no Claude Code. Mais detalhes: GitHub.

Ou manualmente — usando duas variáveis de ambiente:

export ANTHROPIC_BASE_URL=https://gate.joingonka.ai
export ANTHROPIC_API_KEY=jg-sua-chave
claude

É isso. O Claude Code enviará solicitações para o JoinGonka Gateway no formato nativo da Anthropic. O Gateway as converterá em solicitações para a rede Gonka e retornará a resposta no formato Anthropic.

O que é suportado:

  • Streaming — a resposta começa a aparecer imediatamente (SSE no formato Anthropic: message_start, content_block_delta, message_stop)
  • Tool calling — o Claude Code usa ativamente funções para trabalhar com arquivos e comandos. Chamada de ferramentas nativa via Qwen3-235B.
  • System prompts — prompts do sistema são passados como estão

Verificação: No Claude Code, faça qualquer pergunta. Se uma resposta aparecer, está funcionando.

Para Windows/PowerShell:

$env:ANTHROPIC_BASE_URL="https://gate.joingonka.ai"
$env:ANTHROPIC_API_KEY="jg-sua-chave"
claude

Comparação de custos com Anthropic

Claude Code é uma das ferramentas de IA mais "vorazes": ele envia o contexto completo dos arquivos, histórico de comandos e diffs. Uma sessão típica consome 20-50M tokens.

ProvedorModeloPreço de entrada/saída por 1MSessão de 4h (~30M tokens)Mês (20 dias úteis)
JoinGonkaQwen3-235B$0.001 / $0.001$0.03$0.60
AnthropicClaude Sonnet 4$3.00 / $15.00$210$4,200
OpenAIGPT-4o$2.50 / $10.00$150$3,000

A diferença é de três a quatro ordens de magnitude. Por $0.60 por mês via JoinGonka, você obtém o que custaria mais de $4,200 na Anthropic. Para um desenvolvedor independente, isso é a diferença entre "posso ter um assistente de IA" e "não posso".

Dicas de trabalho

Algumas recomendações para um trabalho eficaz com Claude Code via Gonka:

  • Contexto: Qwen3-235B tem uma janela de contexto de 128K tokens (~100K palavras) — suficiente para a maioria dos projetos. O comprimento máximo de resposta via Gateway é de 2048 tokens. Para gerações longas, pode ser necessário dividir a tarefa em partes. Especificações do modelo: HuggingFace.
  • Streaming: Gateway suporta streaming no formato nativo da Anthropic — a resposta começa a ser exibida imediatamente, assim como com o Claude nativo.
  • Tool calling: Qwen3-235B suporta chamada de ferramenta nativa, o que é importante para o Claude Code — a ferramenta usa ativamente funções para trabalhar com arquivos e comandos.
  • Latência: A primeira requisição pode levar de 5 a 10 segundos (inicialização a frio do nó). As requisições subsequentes — de 1 a 3 segundos.
  • Outras ferramentas: JoinGonka Gateway também é compatível com a API OpenAI — Aider, OpenCode, Cursor conectam via /v1/chat/completions.

Para desenvolvedores que preferem outras ferramentas de terminal, veja também: Aider, OpenCode.

Claude Code + Gonka = poderoso assistente de IA terminal por ~$0.60/mês em vez de $4.200 da Anthropic. Conexão direta via Anthropic API — sem proxy, 2 variáveis, 2 minutos. 10M de tokens grátis para começar.

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

Obtenha 10M tokens grátis →