Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 32
Glossário 12

Ferramentas

Claude Code + Gonka AI — LLM para terminal

O Claude Code é um poderoso assistente de AI para desenvolvimento diretamente no terminal. Funciona com Git, sistema de arquivos, executa testes e refatora código. Mas o Claude Sonnet 4.6 nativo custa entre $3 e $15 por 1M de tokens, e com trabalho ativo, a conta semanal pode ultrapassar os $200.

O JoinGonka Gateway suporta a API nativa da Anthropic (/v1/messages) — o Claude Code conecta-se diretamente, sem proxy. O modelo Kimi K2.6 via rede descentralizada Gonka por $0.003/1M de tokens é milhares de vezes mais barato, com qualidade comparável em 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

O JoinGonka Gateway suporta nativamente a Anthropic Messages API (/v1/messages) — sem necessidade de proxy.

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

npx @joingonka/setup --tool claude-code

Este é o instalador universal do JoinGonka: execute sem flags — npx @joingonka/setup — e ele sugerirá escolher uma ferramenta (Claude Code, OpenClaw ou Cline). O instalador solicitará sua API-key, fará um backup da configuração atual e adicionará cuidadosamente apenas os campos necessários às configurações do Claude Code, sem afetar seus outros parâmetros. Detalhes: GitHub.

Configurar manualmente (plano B)

Ou manualmente — através de duas variáveis de ambiente:

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

Pronto. O Claude Code enviará solicitações ao JoinGonka Gateway no formato nativo da Anthropic. O Gateway converte-as em solicitações para a rede Gonka e retorna 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. Tool calling nativo via Kimi K2.6.
  • System prompts — os system prompts são transmitidos como estão

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

Para Windows/PowerShell:

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

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

Comparação de custos com Anthropic

Claude Code é uma das ferramentas de IA mais «vorazes»: envia o contexto completo dos ficheiros, o histórico de comandos e os diffs. Uma sessão típica consome entre 20 e 50 M de tokens.

FornecedorModeloPreço input/output por 1MSessão 4h (~30M tokens)Mês (20 dias úteis)
JoinGonkaKimi K2.6$0.003 / $0.009$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 da JoinGonka, obtém o que custa mais de $4,200 na Anthropic. Para um programador independente, essa é a diferença entre «posso ter um assistente de IA» e «não posso».

Dicas de trabalho

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

  • Contexto: O Kimi K2.6 possui uma janela de contexto de 200K tokens (~100K palavras) — o suficiente para a maioria dos projetos. O comprimento máximo de resposta via Gateway é de até 8192 tokens (para todos os modelos da rede). Para gerações longas, pode ser necessário dividir a tarefa em partes. A lista atual de modelos da rede é 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: O Kimi K2.6 suporta tool calling nativo, o que é importante para o Claude Code — a ferramenta usa ativamente funções para trabalhar com arquivos e comandos.
  • Latência: A primeira solicitação pode levar de 5-10 segundos (cold start do nó). As subsequentes — 1-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 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.
← 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.

Obtenha 10M tokens grátis →