Como usar o Claude Code gratuitamente
O Claude Code é um agente de código da Anthropic. Ele precisa de uma API de Mensagens da Anthropic. Este guia mostra como conectar o Claude Code a modelos gratuitos por meio do FreeLLMAPI. Você define duas variáveis de ambiente. Você não precisa de uma chave da Anthropic.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
O que você recebe e o que não recebe
O Claude Code envia cada requisição a uma API no formato da Anthropic. O FreeLLMAPI fala esse formato em /v1/messages. Ele traduz cada requisição e a envia a um modelo gratuito, por exemplo Gemini, GPT-OSS, Qwen ou GLM.
- Você recebe: a interface do Claude Code, as suas ferramentas, as edições de arquivos e o loop do agente, com modelos gratuitos.
- Você não recebe: os modelos Claude da Anthropic. Nenhum provedor oferece os modelos Claude gratuitamente por meio de API. Leia Existe uma API Claude gratuita? para ver os detalhes.
- Custo: US$ 0 de inferência. As camadas gratuitas têm limites de taxa. O FreeLLMAPI passa para o próximo provedor quando um limite interrompe uma requisição.
Passo 1: instale o FreeLLMAPI
O FreeLLMAPI é de código aberto. Ele roda no seu computador em Docker. As suas chaves de provedores ficam no seu computador.
macOS ou Linux
curl -fsSL https://freellmapi.co/install.sh | bashAbra o painel em http://localhost:3001. Adicione pelo menos duas chaves gratuitas de provedores na página Keys. O Google AI Studio e o Groq dão, cada um, uma chave gratuita em cerca de um minuto. Copie a sua chave unificada na mesma página.
Passo 2: conecte o Claude Code
O método mais rápido é o comando de configuração. Ele lê o seu catálogo atual, faz um backup de ~/.claude/settings.json e adiciona as configurações do gateway.
Um comando
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>Para configurar manualmente, defina duas variáveis de ambiente e inicie o Claude Code:
Configuração manual (macOS ou Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claudeConfiguração manual (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN. Não use ANTHROPIC_API_KEY. Se ANTHROPIC_API_KEY estiver definida, o Claude Code vê uma credencial conflitante e não inicia.Para confirmar que as requisições vão para o gateway, execute npx freellmapi doctor. Cada resposta também tem um cabeçalho X-Routed-Via. Esse cabeçalho mostra o provedor e o modelo que responderam.
Passo 3: escolha modelos para trabalho com agente
O Claude Code envia prompts longos. Uma requisição típica tem um prompt de sistema grande, definições de ferramentas e o conteúdo de arquivos. Use modelos com chamada de ferramentas e uma janela de contexto grande. Camadas gratuitas pequenas, com poucos tokens por minuto, falham nessas requisições.
Na aba Keys, Anthropic, associe cada família Claude (opus, sonnet, haiku) a auto ou a um modelo. Com auto, o roteador seleciona um modelo gratuito para cada requisição. A tabela mostra os modelos gratuitos com chamada de ferramentas e pelo menos 128K de contexto, do catálogo atual.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Sim | Não |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/dia Shared rate limit | Sim | Não |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sim | Sim |
Mostrando 12 de 109 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Limites de taxa e como o failover ajuda
Uma tarefa do Claude Code pode enviar de 20 a 100 requisições. Uma única camada gratuita para você rapidamente. Por exemplo, uma chave gratuita do Gemini Flash permite poucas requisições por dia. O FreeLLMAPI mantém a contagem da cota de cada chave. Quando um provedor envia um erro 429, o roteador tenta o próximo provedor do conjunto. A sua sessão do Claude Code continua.
- Adicione chaves de quatro ou mais provedores. Mais chaves dão mais requisições por dia.
- Associe
haikua um modelo pequeno e rápido. O Claude Code o usa para tarefas curtas em segundo plano. - Mantenha o contexto pequeno. Use
/clearentre tarefas para enviar menos tokens.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| O Claude Code pede para você entrar | As variáveis de ambiente não estão definidas neste shell | Defina ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN e, depois, inicie o claude de novo |
| "Credencial conflitante" ou não inicia | ANTHROPIC_API_KEY está definida | Remova-a com unset ANTHROPIC_API_KEY |
| Erro 429 em todas as requisições | Todas as suas chaves de provedores estão no limite | Adicione chaves de mais provedores na página Keys |
| As chamadas de ferramenta falham ou o agente para | O modelo não suporta bem a chamada de ferramentas | Associe a família a um modelo da tabela acima |
| As requisições são lentas | Prompts grandes em um modelo gratuito lento | Fixe um modelo rápido, por exemplo um modelo do Groq ou da Cerebras |
Perguntas frequentes
O Claude Code é gratuito para usar?
O programa Claude Code é gratuito para instalar. Ele precisa de uma API de modelo para funcionar. Com o FreeLLMAPI, ele usa camadas gratuitas de provedores, então a inferência custa US$ 0.
Eu consigo os modelos Claude reais de graça?
Não. A Anthropic não oferece uma API Claude gratuita. O Claude Code roda em outros modelos gratuitos, por exemplo Gemini, GPT-OSS, Qwen ou GLM, pelo endpoint no formato da Anthropic.
Por que usar ANTHROPIC_AUTH_TOKEN e não ANTHROPIC_API_KEY?
O Claude Code envia ANTHROPIC_AUTH_TOKEN como um token Bearer para o seu gateway. Se ANTHROPIC_API_KEY estiver definida, o Claude Code a trata como uma credencial de primeira parte e se recusa a iniciar.
Qual modelo gratuito é o melhor para o Claude Code?
Use um modelo com chamada de ferramentas e uma janela de contexto de 128K tokens ou mais. A tabela desta página mostra os modelos gratuitos mais fortes que atendem às duas regras hoje.
Isto funciona no Windows?
Sim. Defina as duas variáveis no PowerShell com $env:ANTHROPIC_BASE_URL e $env:ANTHROPIC_AUTH_TOKEN e, depois, inicie o claude.
Guias relacionados
- Existe uma API Claude gratuita?
- Melhores APIs gratuitas de modelos para código
- Use o Codex CLI com modelos gratuitos
- Cline, Roo Code e Kilo Code com uma API gratuita
- Limites de taxa da API LLM gratuita
Fontes
- FreeLLMAPI docs: Anthropic and Claude clients (verificado em 20 November 2026)
- FreeLLMAPI CLI generators (verificado em 20 November 2026)
- Claude Code documentation: LLM gateway configuration (verificado em 20 November 2026)