Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 52
Glossário 12

Ferramentas

Claude Code + Gonka AI — LLM para terminal

Claude Code é um poderoso assistente de IA para desenvolvimento direto no terminal. Funciona com Git, sistema de arquivos, executa testes e refatora código. No entanto, o Claude Sonnet 4.6 nativo custa entre US$ 3 e US$ 15 por 1 milhão de tokens, e com trabalho ativo, a conta semanal pode exceder US$ 200.

O JoinGonka Gateway oferece suporte à API nativa da Anthropic (/v1/messages) — o Claude Code conecta-se diretamente, sem proxy. Os modelos MiniMax M2.7, DeepSeek V4 Flash e GLM-5.3 Flash através da rede descentralizada Gonka custam $0.0069/1M tokens — centenas de vezes mais barato, com qualidade comparável em tarefas de programação.

A configuração leva 2 minutos: um comando de instalação ou algumas variáveis de ambiente.

Passo 1: Obter a chave API

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

  1. Registre-se em gate.joingonka.ai/register.
  2. Receba um bônus de 3M tokens gratuitos.
  3. Crie uma API-key no 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

O JoinGonka Gateway suporta nativamente a Anthropic Messages API (/v1/messages) — não precisa de proxy.

O método recomendado é o instalador de um só comando:

npx @joingonka/setup --tool claude-code

Esse é o instalador universal do JoinGonka: execute sem a flag — npx @joingonka/setup — e ele vai oferecer uma lista de ferramentas para escolher. Já são 25: Claude Code, Codex CLI, OpenClaw, Cursor, Cline e outras — lista completa no README do pacote.

O instalador vai pedir a API key, fazer backup do ~/.claude/settings.json e gravar no bloco env apenas os próprios campos, sem mexer no restante da sua configuração: o endereço do gateway (ANTHROPIC_BASE_URL), a chave (ANTHROPIC_AUTH_TOKEN), o modelo (ANTHROPIC_MODEL e os aliases opus, sonnet, haiku) e seus limites reais — CLAUDE_CODE_MAX_CONTEXT_TOKENS e CLAUDE_CODE_MAX_OUTPUT_TOKENS. Os limites importam: para um identificador desconhecido, o Claude Code assume a própria janela de contexto e não consegue comprimir o histórico a tempo, e os modelos da rede têm a própria janela — de 200K a 390K tokens. O arquivo com a chave recebe permissões 600. Por padrão, instala o DeepSeek V4 Flash; para escolher outro modelo use a flag --model minimax|deepseek|glm. Com a flag --scope local, as configurações vão para .claude/settings.local.json do projeto atual, e o arquivo é adicionado ao .gitignore.

Configurar manualmente (plano B)

Ou manualmente — via variáveis de ambiente:

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

As duas primeiras variáveis direcionam o Claude Code para o gateway: as requisições vão no formato nativo da Anthropic, o Gateway as converte em requisições para a rede Gonka e devolve a resposta em formato Anthropic. ANTHROPIC_MODEL fixa o modelo da rede — sem ela, o Claude Code envia o próprio identificador claude-* e o gateway substitui pelo modelo padrão. As duas últimas declaram a janela de contexto real e o teto de resposta do modelo escolhido (exige Claude Code 2.1.223 ou mais recente); caso contrário, para um identificador desconhecido o Claude Code assume a própria janela e não consegue comprimir o histórico a tempo. Os valores para outros modelos da rede estão na seção «Dicas de uso» mais abaixo.

O que é suportado:

  • Streaming — a resposta começa a aparecer na hora (SSE no formato Anthropic: message_start, content_block_delta, message_stop)
  • Tool calling — o Claude Code usa intensivamente funções para trabalhar com arquivos e comandos. Tool calling nativo em todos os modelos da rede.
  • System prompts — os prompts de sistema são repassados como estão

Verificação: no Claude Code, faça qualquer pergunta. Se a resposta apareceu, está tudo funcionando.

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

O antigo instalador específico npx @joingonka/claude-code foi substituído pelo universal @joingonka/setup e não é mais mantido — use o novo.

Comparação de custos com Anthropic

O 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 entre 20 e 50M de tokens.

ProvedorModeloPreço input/output por 1MSessão 4h (~30M tokens)Mês (20 dias úteis)
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

A diferença é de três ordens de magnitude. Por $2.9 por mês através do JoinGonka, você obtém o que custa mais de $4,200 na Anthropic. Para um desenvolvedor indie, essa é a diferença entre "posso pagar por um assistente de IA" e "não posso".

Dicas de trabalho

Algumas recomendações para trabalhar eficientemente com o Claude Code via Gonka:

  • Contexto: o MiniMax M2.7 tem uma janela de contexto de 200K tokens (~100K palavras) — suficiente para a maioria dos projetos, o DeepSeek V4 Flash tem 380K, e o GLM-5.3 Flash tem 390K. O comprimento máximo de resposta via Gateway é de 8192 tokens no MiniMax M2.7 e GLM-5.3 Flash, e 32768 no DeepSeek V4 Flash. Para gerações longas, pode ser necessário dividir a tarefa em partes. A lista atualizada de modelos da rede está em GET https://gate.joingonka.ai/v1/models.
  • Streaming: o Gateway suporta streaming no formato nativo Anthropic — a resposta começa a ser exibida imediatamente, como no Claude nativo.
  • Tool calling: todos os modelos da rede suportam tool calling nativo, o que é importante para o Claude Code — a ferramenta utiliza ativamente funções para trabalhar com arquivos e comandos.
  • Latência: a primeira solicitação pode levar de 5 a 10 segundos (cold start do nó). As seguintes — de 1 a 3 segundos.
  • Outras ferramentas: o JoinGonka Gateway é compatível com a OpenAI API — Aider, OpenCode, Cursor conectam-se via /v1/chat/completions.

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

Claude Code + Gonka = poderoso assistente de IA em terminal por ~$0.60/mês em vez de $4,200 com a Anthropic. Conexão direta via Anthropic API — sem proxy: um comando de instalação, 2 minutos. Tokens gratuitos no início.
← Cursor + Gonka AI — LLM barato para codificação OpenClaw + Gonka AI — agentes AI acessíveis →

Quer saber mais?

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

Obter tokens gratuitos →