Início / Guias / Como usar o Claude Code gratuitamente

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 | bash

Abra 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>
claude

Configuração manual (Windows PowerShell)

$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claude
Importante: use ANTHROPIC_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.

Modelos gratuitos para o Claude Code: chamada de ferramentas e contexto de 128K+
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
SimNão
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNão
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySimSim

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 haiku a um modelo pequeno e rápido. O Claude Code o usa para tarefas curtas em segundo plano.
  • Mantenha o contexto pequeno. Use /clear entre tarefas para enviar menos tokens.

Solução de problemas

ProblemaCausaSolução
O Claude Code pede para você entrarAs variáveis de ambiente não estão definidas neste shellDefina ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN e, depois, inicie o claude de novo
"Credencial conflitante" ou não iniciaANTHROPIC_API_KEY está definidaRemova-a com unset ANTHROPIC_API_KEY
Erro 429 em todas as requisiçõesTodas as suas chaves de provedores estão no limiteAdicione chaves de mais provedores na página Keys
As chamadas de ferramenta falham ou o agente paraO modelo não suporta bem a chamada de ferramentasAssocie a família a um modelo da tabela acima
As requisições são lentasPrompts grandes em um modelo gratuito lentoFixe um modelo rápido, por exemplo um modelo do Groq ou da Cerebras
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos