Claude Code de Graça? FreeLLMAPI com Outros Modelos (e os Limites)
Entenda o que é grátis de verdade ao rodar o Claude Code com a FreeLLMAPI: exige plano pago, usa outros modelos e tem limites. Passo a passo e avisos.
O que é
Claude Code de Graça? FreeLLMAPI com Outros Modelos (e os Limites)
A FreeLLMAPI é um roteador local de código aberto (licença MIT) que junta os planos gratuitos de vários provedores de IA num endereço só, com um endpoint compatível com a Anthropic em localhost:3001. O comando npx freellmapi setup-claude aponta o Claude Code para ele, e o roteador troca de modelo quando um provedor dá erro de cota. Esta página mostra como instalar, ligar e testar, e diz com clareza o que o título do reel não diz.
O Claude Code em si não é de graça: ele exige conta Pro, Max, Team, Enterprise ou Console. O que pode custar zero é o modelo por trás, e só enquanto cada provedor mantiver a cota gratuita. Você sai sabendo montar o roteador, apontar o Claude Code para ele, testar com dado público e desfazer a configuração.
A ressalva principal: nesse modo o modelo que responde pode não ser o Claude. A Anthropic diz que não suporta rotear o Claude Code para modelos não-Claude por gateway, e o repositório da FreeLLMAPI se descreve como ferramenta de experimentação pessoal, não de produção. Os dados enviados passam pelos provedores gratuitos.
Um endereço local, vários provedores
O roteador junta os planos gratuitos de dezenas de provedores atrás de um endpoint em localhost:3001.
setup-claude com dry-run
O comando lê o catálogo do servidor local, faz backup da configuração existente e mescla. Rode antes com --dry-run.
Troca quando o provedor falha
Em erro 429 ou 5xx o roteador esfria a chave e tenta o próximo modelo da cadeia. A capacidade gratuita muda e cai no fim do dia.
Avisos antes do primeiro passo
Plano pago, modelo que pode não ser Claude, uso pessoal e dados enviados a terceiros, tudo antes de instalar.
Resumo de passagem
O resumo na troca é opcional no README. A página traz um prompt para fazer o resumo à mão, sem depender do recurso.
Nível: intermediário · Tempo estimado: ~45 min, incluindo Docker e a criação das chaves nos provedores
Antes de tudo: o Claude Code não é de graça. Segundo a documentação oficial, ele exige conta Pro, Max, Team, Enterprise ou Console, e o plano gratuito do claude.ai não inclui acesso. O que esta página trata é usar o Claude Code com outros modelos, que podem não custar nada, e só enquanto cada provedor mantiver a cota gratuita. Esses planos podem mudar ou acabar a qualquer momento.
O modelo pode não ser o Claude. No modo gateway, quem responde é o modelo do provedor que o roteador escolheu, e não necessariamente um modelo Claude. A Anthropic diz, na documentação de gateways, que não suporta rotear o Claude Code para modelos não-Claude por nenhum gateway. A qualidade, o comportamento com ferramentas e os limites vão ser diferentes do Claude de verdade, e o repositório avisa que não há modelos de fronteira, que a latência varia e que não há SLA. Segundo a documentação (code.claude.com/docs/en/llm-gateway, conferida em 20/10/2026), com a credencial do gateway ativa as requisições usam essa credencial no lugar do login claude.ai e os limites do plano não valem para elas.
Uso pessoal e de teste, e não de produção. O README da FreeLLMAPI se descreve como projeto para experimentação pessoal e aprendizado, e manda trocar por uma API paga antes de construir algo real. Cada provedor segue os termos que você aceitou ao criar a conta, mesmo com o tráfego passando pelo roteador, e você responde por cumpri-los. Não use com código ou dados de cliente.
Seus dados passam por terceiros. O que você enviar vai aos provedores gratuitos. Os termos da Gemini API em plano gratuito dizem que o Google usa o conteúdo enviado para fornecer, melhorar e desenvolver seus produtos, e que revisores humanos podem ler e processar entradas e saídas (vigência de 23/03/2026, conferida em 20/10/2026). O Google orienta a não enviar informação sensível, confidencial ou pessoal. Os termos dos demais provedores não foram verificados nesta página.
Não testado. Os comandos foram conferidos no README da FreeLLMAPI e na documentação do Claude Code em 20/10/2026, mas esta página não executou a instalação completa nem a troca automática de modelo. O README não diz qual arquivo ou variável o setup-claude altera, só que faz backup e mescla; o comportamento do npx freellmapi launch também não foi conferido em detalhe. O que o resumo da troca contém e se a sua sessão segue idêntica depois da troca não foi verificado. DeepSeek e Qwen aparecem no README, pelo ModelScope (o próprio README ressalva que ele exige vínculo com conta Aliyun da China); o Kimi não foi encontrado no README. Gemini, GLM e Mistral também estão listados.
Nunca peça ao modelo que leia, liste ou mostre o ~/.claude/settings.json, arquivos .env, chaves de API, senhas, credenciais ou qualquer arquivo privado enquanto o roteador estiver ligado: o conteúdo seria enviado a um provedor de terceiros. Para conferir a configuração, olhe os arquivos você mesmo, no terminal.
Pré-requisitos
- Claude Code com plano pago (Pro, Max, Team ou Enterprise) ou conta Console. Segundo a documentação oficial (code.claude.com/docs/en/setup, conferida em 20/10/2026), o Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console, e o plano gratuito do claude.ai não inclui acesso. Instalação e planos na documentação oficial: https://code.claude.com/docs/en/setup
- Docker instalado, porque o instalador de uma linha da FreeLLMAPI exige Docker. O README também oferece um app de desktop para macOS e Windows nas releases do GitHub, que esta página não cobre
- Node.js 20 ou mais novo, para rodar os comandos npx (o README da FreeLLMAPI diz que ela roda onde o Node 20+ roda, conferido em 20/10/2026)
- Contas gratuitas, com chaves próprias, em pelo menos dois ou três provedores que a FreeLLMAPI lista, como Google, Groq, Mistral ou Cerebras. Leia os termos de cada um
- Um projeto de teste com dados públicos ou fictícios. Nada de cliente
- Custo: o plano do Claude Code continua sendo cobrado normalmente; os planos gratuitos dos provedores não cobram enquanto existirem, e podem ter limites e quedas
Conceitos-chave
- 01
Gateway ou roteador
Um servidor local entre o Claude Code e os provedores de IA. O Claude Code fala com o endereço local, e o roteador escolhe qual provedor e modelo atende cada pedido. A FreeLLMAPI é um desses roteadores.
- 02
Chave unificada e chaves de provedor
Cada provedor emite uma chave (que você cadastra no painel). A FreeLLMAPI dá uma chave unificada, que é o que o Claude Code usa. Trate as duas como senha. As chaves dos provedores ficam criptografadas no banco local (AES-256-GCM, segundo o README).
- 03
Failover e cota
Quando um provedor devolve 429 ou 5xx, o roteador esfria aquela chave e tenta o próximo modelo da cadeia. A conversa tende a ficar no mesmo modelo por 30 minutos. A capacidade gratuita cai no fim do dia, quando modelos atingem cotas diárias.
- 04
Nota de passagem opcional
O README descreve uma nota compacta de passagem na troca de modelo como recurso opcional. Não conta como garantia de que o novo modelo chega sabendo de tudo.
Passo a passo
- 01
Confirme que o Claude Code funciona com o seu plano
Abra o terminal e confira a versão. Se o comando não existir, instale pelo guia oficial e faça login com a conta paga antes de continuar. A documentação oficial (code.claude.com/docs/en/setup, 20/10/2026) diz que o Claude Code requer conta Pro, Max, Team, Enterprise ou Console.
claude --version - 02
Instale a FreeLLMAPI com o instalador oficial
O comando prepara a pasta ~/freellmapi, gera a chave de criptografia, baixa a imagem do Docker e inicia o contêiner. Quem prefere ler antes de executar pode abrir o script em https://freellmapi.co/install.sh. Rodar de novo é seguro: o .env e a chave são preservados.
curl -fsSL https://freellmapi.co/install.sh | bash - 03
Cadastre as chaves dos provedores no painel
Abra o painel no navegador, vá à página Keys e adicione a chave de cada provedor em que você criou conta. Ajuste a Fallback Chain se quiser. A chave unificada aparece no cabeçalho da página Keys: guarde-a, porque é a que o Claude Code vai usar. O painel local tem login com e-mail e senha em instalações de servidor, e a senha de reset aparece no log do servidor. Não exponha a porta na rede.
http://localhost:3001 - 04
Veja o que o setup-claude vai mudar (dry-run)
O README diz que todo gerador aceita --dry-run. Rode primeiro assim, troque SUA_CHAVE_UNIFICADA pela chave do painel e leia o que ele mostraria. Não foi conferido nesta página o formato da saída.
npx freellmapi setup-claude --url http://localhost:3001 --api-key SUA_CHAVE_UNIFICADA --dry-run - 05
Aponte o Claude Code para a FreeLLMAPI
Este é o comando completo do README. O setup-claude lê o catálogo do servidor local, faz backup da configuração existente e mescla a nova. Ele precisa do servidor do passo 2 de pé: sem a instalação, o comando não funciona. O comando só com npx freellmapi setup-claude, sem as flags, não traz a URL nem a chave, então use a forma completa.
npx freellmapi setup-claude --url http://localhost:3001 --api-key SUA_CHAVE_UNIFICADA - 06
Alternativa: lançar o Claude Code sem gravar credenciais
O README diz que npx freellmapi launch abre o Claude Code mantendo as credenciais fora dos arquivos de configuração. Os detalhes desse comando não foram conferidos aqui, então confira no repositório antes de usar.
npx freellmapi launch - 07
Teste com uma tarefa de dado público
Abra o Claude Code num projeto de teste e peça uma tarefa pequena (veja o primeiro prompt abaixo). Confira no painel da FreeLLMAPI qual provedor e modelo atenderam. Não assuma que foi um modelo Claude.
- 08
Desfaça quando terminar o teste
Restaure o backup que o setup-claude fez da configuração do Claude Code e pare o contêiner. O README não diz onde o backup fica, então procure-o logo após rodar o comando e anote o caminho. O comando abaixo, rodado na pasta que o instalador criou, só para o contêiner: o README usa docker compose down -v para desinstalar e apagar os dados, e o -v é o que apaga. Que a pasta tenha o arquivo do compose não foi conferido nesta página.
cd ~/freellmapi && docker compose down
Prompts prontos
Use dentro do Claude Code, depois de ligar o roteador, em um projeto de teste. Nunca peça ao modelo para ler ou mostrar settings.json, .env, chaves, senhas ou arquivos privados: nesse modo quem lê é um provedor de terceiros. Os exemplos abaixo usam texto fictício. O primeiro é a tarefa de teste do passo 7, e o último faz à mão o resumo de passagem que o reel promete, sem depender do recurso opcional da ferramenta. Nenhum prompt tem placeholder para trocar. O prompt de resumo de passagem pede a sua confirmação antes de salvar.
Prompt: tarefa de teste com dado público
Liste os arquivos deste projeto, explique em até 5 linhas o que ele faz e proponha uma melhoria pequena. Não altere nenhum arquivo.
Prompt: tarefa de teste com arquivo fictício
Vou colar abaixo um texto fictício de teste, sem dados reais. Resuma em 3 linhas e sugira um título. A padaria Exemplo abre às 7h, vende pães e bolos, e quer um texto curto para o Instagram.
Prompt: checklist de verificação do roteador
Sem pedir nem ler nenhum arquivo meu, liste as verificações que eu devo fazer sozinho no terminal e no painel para confirmar que o Claude Code está apontando para um roteador local em localhost:3001 e como eu volto ao login normal. Responda em uma lista curta e avise o que você não tem como confirmar.
Prompt: resumo de passagem feito à mão
Escreva uma nota de passagem curta para o próximo modelo que continuar este trabalho: o que já foi feito, o que falta e os arquivos envolvidos. Salve em HANDOFF.md e me mostre antes de eu trocar de modelo.
Erros comuns
- O Claude Code continua usando o plano em vez do roteador → o login claude.ai salvo continua sendo a credencial ativa quando só há o endereço base → confirme o que o setup-claude gravou, use a chave unificada e confira o painel para ver se houve tráfego
- O setup-claude falha ou não acha modelos → ele lê o catálogo do servidor local e o servidor não está de pé → confira se o contêiner está rodando e se http://localhost:3001 abre
- O curl do instalador falha → o Docker não está instalado ou não está rodando → instale e inicie o Docker e rode o instalador de novo
- As respostas pioram ou travam no fim do dia → a capacidade gratuita cai quando os modelos atingem as cotas diárias → espere o ciclo, cadastre mais provedores ou use uma API paga
- Erro 429 do provedor → a cota gratuita acabou naquela chave → o roteador esfria a chave e tenta a próxima da cadeia; se a cadeia inteira falhar, adicione outro provedor
- A resposta não parece o Claude → o roteador usou o modelo de outro provedor → veja no painel qual modelo atendeu; para tarefas que exigem Claude, desligue o roteador
- Você esqueceu a senha do painel → a instalação de servidor tem login → use Forgot password? na tela de login e leia o código de uso único no log do servidor (docker compose logs -f freellmapi)
Checklist final
- Você tem plano pago do Claude Code ou conta Console, e claude --version responde
- Você leu os avisos de dados e usa só projeto de teste, sem dado de cliente nem sensível
- O painel em localhost:3001 abre e tem ao menos dois provedores com chave testada
- Você rodou o setup-claude com --dry-run antes de rodar de verdade
- O painel mostra qual provedor e modelo atenderam o seu teste
- Você sabe onde ficou o backup da configuração e como desfazer
- A porta 3001 não está exposta na rede
Perguntas frequentes
O Claude Code fica de graça com a FreeLLMAPI?
Não. O Claude Code exige plano Pro, Max, Team, Enterprise ou Console, e o plano gratuito do claude.ai não o inclui. O que a FreeLLMAPI pode zerar é o custo do modelo por trás, e só enquanto os provedores mantiverem a cota gratuita.
Quantos tokens por mês eu tenho?
O README fala em cerca de 7,4 bilhões de tokens por mês de capacidade gratuita listada, em 34 provedores e 635 endpoints de modelo (README em out/2026). É a soma do que está listado, não uma garantia: a capacidade muda toda semana e cai no fim do dia.
A Anthropic suporta esse uso?
Não. A documentação oficial diz que não suporta rotear o Claude Code para modelos não-Claude por nenhum gateway.
Posso usar no trabalho de um cliente?
Não é recomendado. O repositório diz que é para experimentação pessoal e manda trocar por uma API paga antes de entregar algo real, e os dados passam por provedores com termos próprios.
Fontes oficiais
- README da FreeLLMAPIgithub.com/tashfeenahmed/freellmapi (abre em nova aba)
- Instalador oficial da FreeLLMAPIfreellmapi.co (abre em nova aba)
- Planos que incluem o Claude Codecode.claude.com/docs/en/setup (abre em nova aba)
- Claude Code e gateways de LLMcode.claude.com/docs/en/llm-gateway (abre em nova aba)
- Termos da Gemini APIai.google.dev/gemini-api/terms (abre em nova aba)
Próximos passos
Comece agora
Pronto para colocar Claude Code de Graça? FreeLLMAPI com Outros Modelos (e os Limites) para rodar?
Ver a FreeLLMAPI no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo