O Claude Code é o programa: ele lê seus arquivos, roda comandos e faz as tarefas. O modelo é o cérebro que responde por trás. Normalmente esse cérebro é o Claude, pago pelo seu plano. Neste guia, você troca o cérebro por modelos grátis de outras empresas (Google, Groq, NVIDIA e os da OpenRouter).
Quem faz a ponte é o FreeLLMAPI, um app grátis e de código aberto (licença MIT) que junta o plano grátis de várias empresas de IA num endereço só. Segundo o próprio projeto, são 34 provedores e uns 7,4 bilhões de tokens por mês somando todos os planos grátis. Quando um bate o limite, ele passa pro próximo sozinho.
7 passosGrátis e open source (MIT)Atualizado em novembro de 2026
Você
Pede a tarefa
No terminal, como sempre
Programa
Claude Code
Lê arquivos, roda comandos, faz a tarefa
Ponte
FreeLLMAPI
Junta os planos grátis num endereço só
Cérebro
Modelos grátis
Google, Groq, NVIDIA e OpenRouter
Seja honesto com você mesmo: os modelos grátis são mais fracos que o Claude, e a Anthropic não dá suporte ao Claude Code ligado em modelos que não são Claude. Use pra tarefas simples, testes e pra quando o seu limite acabou. Pro trabalho pesado, o Claude ainda é o Claude.
O que você vai guardar
Os dados que aparecem no caminho e onde cada um vai ser usado.
Dado
Onde aparece
Onde vai
Endereço do painelhttp://127.0.0.1:31415
passo 02 no navegador, ao abrir o painel
passos 05 a 07 nos comandos
4 chaves dos provedores
passo 03 Gemini, Groq, OpenRouter e NVIDIA
passo 03 página Keys do painel
Chave únicafreellmapi-…
passo 03 topo da página Keys
passos 05 a 07 no lugar de SUA_CHAVE_UNICA
Chaves dão acesso às suas contas. Guarde num gerenciador de senhas, nunca em arquivo compartilhado ou print.
O passo a passo
Marque cada passo como concluído: o progresso fica salvo e aparece no topo.
Mac com chip da Apple (M1 em diante): o .dmg que tem arm64 no nome.
Mac com Intel: o que tem x64.
Windows: o FreeLLMAPI-Setup-….exe.
Instale e abra. O app fica no ícone da barra de menu (Mac) ou da bandeja (Windows). Não precisa criar conta nem senha.
Pelo ícone, abra o painel. Ele roda no seu computador, no endereço http://127.0.0.1:31415. Se essa porta estiver ocupada, o app escolhe outra: use o endereço que aparecer no navegador quando o painel abrir.
Tem servidor ou usa Docker? Dá pra instalar por lá também (o README tem o comando). Nesse caso, o endereço é http://localhost:3001: troque nos comandos dos passos 05 a 07.
Pronto quando: o painel abriu no navegador e você anotou o endereço dele.
03
Pegue as 4 chaves grátis
Uma conta grátis em cada provedor
Uma chave de API é uma senha que deixa um programa usar a IA da empresa. Crie uma em cada lugar abaixo e cole na página Keys do painel do FreeLLMAPI.
Google
Gemini
aistudio.google.com › Get API key. O cérebro do grupo: modelos fortes de graça, alguns com contexto de 1 milhão de tokens.
Velocidade
Groq
console.groq.com › API Keys. Feita pra responder rápido. O plano Free tem limite por minuto e por dia em cada modelo.
Reserva
OpenRouter
openrouter.ai › Keys. Segura os pedidos quando os outros batem o limite. Os modelos grátis têm :free no nome e liberam 50 pedidos por dia (1.000 por dia se você já comprou US$ 10 em créditos). Veja os limites oficiais.
Modelos abertos
NVIDIA
build.nvidia.com › Get API Key. APIs grátis pra testar e criar, com muitos modelos abertos.
Depois: no topo da página Keys do painel fica a sua chave única (começa com freellmapi-). É só ela que o Claude Code vai usar. Guarde.
Pronto quando: as 4 chaves estão na página Keys e você guardou a chave única.
04
Desligue os modelos fracos
Pro roteador nunca cair num modelo ruim
Cada chave libera um monte de modelos. Na página Models do painel, desligue os que não servem pra trabalhar com código e arquivos:
✕Desligue
Memória curtaModelo de contexto pequeno não cabe o seu projeto. Use o filtro de contexto e fique com os de 128 mil tokens ou mais.
Lite e flash-liteRespondem rápido, mas erram mais. Você acaba refazendo o trabalho.
Fora do assuntoModelos de robótica, moderação e outros nichos. Não é pra isso.
Fica ligado: os de contexto grande e que usam ferramentas (marcados com Tools). No topo da página, o orçamento do mês mostra quanto do grátis você já usou.
Pronto quando: só ficaram ligados os modelos de 128 mil tokens ou mais, marcados com Tools.
05
Conecte o Claude Code (jeito rápido)
Um comando, e todo claude passa a usar os modelos grátis
Atenção: este jeito grava a configuração no Claude Code. Depois dele, o comando claude de sempre passa a usar os modelos grátis, e não o seu plano. Tem plano pago? Pule pro passo 06.
Seus dados (preenchem os comandos dos passos 05, 06 e 07)
A chave fica só nesta página: não é salva nem enviada pra lugar nenhum. Se a porta mudou ou você usa Docker, troque o endereço.
Teste antes: o --dry-run só mostra o que vai mudar, sem gravar nada.
Se estiver tudo certo, rode o mesmo comando sem o --dry-run. Ele faz uma cópia de segurança da sua configuração antes de mudar.
Abra o Claude Code (claude) e mande um oi. Se ele responder, deu certo.
Pra desfazer: peça pro próprio Claude Code o pedido abaixo. Ou volte a cópia de segurança que o comando criou.
tira do meu ~/.claude/settings.json as variáveis ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN e ANTHROPIC_MODEL
Pronto quando: o Claude Code respondeu o seu oi usando os modelos grátis.
06
O jeito claude-free (guarda o seu plano)
Um segundo comando só pros modelos grátis
Aqui o claude normal continua no seu plano, e você ganha um comando novo, o claude-free, que abre o Claude Code ligado no FreeLLMAPI. Use este ou o do passo 05, não os dois: se o passo 05 já gravou a configuração, ela vale pra tudo.
Abra o Claude Code normal e cole o prompt abaixo. Ele já vem com a chave e o endereço que você preencheu no passo 05.
Feche e abra o terminal de novo. Digite claude-free.
Dentro dele, digite /status. Na aba Status, tem que aparecer a linha Anthropic base URL com o endereço do painel (http://127.0.0.1:31415). Se essa linha não aparecer, o comando não pegou o endereço.
Prompt pra colar no Claude Code
Cria um comando de terminal chamado claude-free que abre o Claude Code com ANTHROPIC_BASE_URL= e ANTHROPIC_AUTH_TOKEN= (a minha chave única do FreeLLMAPI). Não mexe no comando claude normal nem no meu ~/.claude/settings.json. Use o arquivo de configuração do terminal que eu uso e me diga como testar.
Repare: o Claude Code pode mostrar nome de modelo Claude no rodapé. É só o rótulo: o FreeLLMAPI recebe esse nome e manda pra um modelo grátis. Quem decide qual é a aba Anthropic da página Keys do painel.
Importante: a chave vai no ANTHROPIC_AUTH_TOKEN, não no ANTHROPIC_API_KEY. Com a outra variável, o Claude Code acha que é uma chave da Anthropic e pode nem abrir.
Pronto quando: o /status do claude-free mostra o Anthropic base URL com o endereço do painel.
07
Extra: quer fazer na mão? (Mac)
A mesma coisa do passo 06, sem pedir pro Claude
No Mac, o terminal padrão usa o arquivo ~/.zshrc. Abra o terminal, rode o comando abaixo (já com a sua chave), depois feche e abra o terminal de novo. Pronto: é só digitar claude-free.
Pra testar só uma vez, sem criar comando nenhum, use este: ele abre o Claude Code com os modelos grátis só naquela vez.
Testa uma vez
ANTHROPIC_BASE_URL= ANTHROPIC_AUTH_TOKEN= claude
Pronto quando: o claude-free abre o Claude Code depois de reabrir o terminal.
Bônus: o que muda e os cuidados
O que vale saber antes de usar no dia a dia.
Não é o Claude
Os modelos grátis erram mais em tarefa longa. Peça tarefas menores, confira o que ele mudou nos arquivos e deixe o trabalho importante pro Claude.
O que para de funcionar
Com o endereço trocado, o Remote Control (continuar a sessão pelo celular) fica desligado. Pra voltar a usar, abra o claude normal.
Conversa fixa por 30 minutos
O FreeLLMAPI deixa cada conversa no mesmo modelo por 30 minutos. Se um provedor bate o limite no meio, ele troca, e dá pra ligar uma opção que passa um resumo da conversa pro próximo modelo.
Limites mudam toda semana
As empresas mudam as cotas grátis sem avisar. O painel mostra o orçamento do mês e o catálogo se atualiza sozinho.
Uso pessoal e termos de cada empresa
O próprio projeto diz que é pra uso pessoal e testes, não pra produto em produção. Os termos que você aceitou em cada provedor continuam valendo. Não mande dados sensíveis de clientes: o pedido vai pro provedor que estiver respondendo.
Suas chaves ficam com você
As chaves ficam criptografadas no seu computador, e o Claude Code só vê a chave única do FreeLLMAPI.
Dica do Ivan Mendes
Use os dois juntos: o claude normal pro trabalho que importa e o claude-free pras tarefas repetitivas, pra testar ideia e pra quando o seu limite acabou no meio do dia. Assim o seu plano rende mais, e você não fica parado esperando o limite voltar.
