Como usar o Claude Code de graça e sem assinatura

O que é o Claude Code?

Claude Code é a ferramenta agentic de programação da Anthropic para o terminal. Ele roda dentro do diretório do seu projeto, lê seus arquivos, edita, executa comandos e conduz tarefas em várias etapas sem você precisar copiar nada para o navegador.

O fato de ter custo é mais estrutural do que comercial. Cada ação é uma chamada de API, e sessões agentic são naturalmente “conversadeiras”: o modelo relê o contexto, chama ferramentas, confere resultados e tenta de novo. Uma tarde movimentada em um repositório grande pode custar alguns dólares em tokens sem nem parecer tão produtiva.

Se você quer ver o que a ferramenta faz no dia a dia, nosso tutorial de Claude Code cobre instalação, refatoração e depuração na prática.

Claude Code é gratuito?

A resposta direta é não. A documentação de instalação da Anthropic afirma que o Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console, e que o plano gratuito do Claude.ai não inclui acesso. O Pro começa em US$ 20 por mês, ou US$ 17/mês se você pagar US$ 200 à vista pelo ano.

A alternativa é a cobrança via console, em que você paga por token sem assinatura. O Claude Sonnet 5 geralmente sai a US$ 3 por milhão de tokens de entrada e US$ 15 por milhão de tokens de saída. O Claude Opus 5 fica em US$ 5 e US$ 25, e o Haiku 4.5 em US$ 1 e US$ 5.

Essas duas rotas cobram com lógicas completamente diferentes, e escolher a errada é como as pessoas acabam pagando caro demais ou sendo limitadas no meio da tarefa. Aqui vai a comparação.

O ponto de cruzamento é a constância de uso, não o volume. Uma assinatura compra tokens a uma taxa efetiva bem melhor do que a API até você encostar no teto do plano, então quem usa todo dia quase sempre sai ganhando no Pro. A cobrança medida vence quando suas semanas não se parecem entre si, já que nas semanas tranquilas você não paga nada.

Então de onde vem o “grátis”? De três lugares, grosso modo. 

• Crédito inicial que a Anthropic concede a novas contas de API
• O fato de o Claude Code conversar com qualquer servidor que fale o formato Anthropic Messages, inclusive gratuitos, sejam hospedados (OpenRouter) ou locais (Ollama)
• Um programa de bolsas direcionado a mantenedores de open source

Essa segunda categoria merece um aviso logo de cara. Apontar o Claude Code para um modelo gratuito te dá a interface e o loop agentic, não o Claude. A diferença de qualidade em raciocínio de várias etapas é real, e eu volto a isso já já.

O plano gratuito inclui Claude Code?

Vamos ao mal‑entendido mais comum, porque ele rouba a noite de muita gente.

O nível gratuito não inclui o Claude Code. Não há versão limitada, nem teste — nada. A documentação da própria Anthropic é clara: o plano grátis cobre o Claude na web, iOS, Android e desktop; o agente de terminal fica fora.

O que você recebe é realmente bom. Desde 1º de julho de 2026, o plano gratuito roda o Claude Sonnet 5 como modelo padrão, com busca na web, upload de arquivos, Projects e Artifacts — tudo que antes ficava atrás do paywall. Para colar um stack trace e perguntar o que deu errado, ele dá conta.

Limites do plano grátis que atingem devs primeiro

A Anthropic não publica contagem de mensagens, e quem cita um número exato está chutando. A empresa descreve o Pro como pelo menos cinco vezes o uso por sessão do Free, o que faz do Free a linha de base, não uma cota fixa. Na prática, relatos se concentram entre 15 e 40 mensagens por janela móvel de 5 horas, com mensagens longas e anexos consumindo mais rápido.

Alguns limites pesam mais que a contagem de mensagens:

• A janela de cinco horas começa a rolar quando você envia a primeira mensagem.
• Sem acesso ao CLI do Claude Code. Este é o duro, e não há gambiarra que resolva.
• Os limites variam conforme a carga do servidor — horários de pico são piores.
• Conversas longas custam mais por mensagem porque o histórico inteiro é relido a cada turno.

Em resumo: o chat gratuito é ok para dúvidas pontuais e revisão de código, e desanda no momento em que você precisa de um vai‑e‑vem sustentado sobre um codebase. Que é exatamente o papel do Claude Code.

Opção 1: créditos gratuitos da API da Anthropic

Esta é a rota oficial menos conhecida e, na minha visão, a que mais gente deveria começar.

Criar uma conta em platform.claude.com concede um crédito inicial único. A documentação de preços da Anthropic descreve apenas como “uma pequena quantidade de créditos grátis”, sem especificar valor, mas relatos de terceiros apontam de forma consistente para algo em torno de US$ 5.

Créditos de API autenticam o CLI do Claude Code. Você usa o agente de verdade, rodando modelos Claude de verdade, no seu codebase de verdade. Os créditos não renovam e expiram após 14 dias, então encare como um teste, não um suprimento.

Configurando a conta de API e resgatando os créditos

Todo o caminho, do cadastro do zero até o agente funcionando, leva uns 10 minutos — a maior parte esperando o instalador. Dividi em cinco passos porque o terceiro tem uma pegadinha que costuma obrigar a recomeçar.

Passo 1: crie sua conta no Console

Acesse platform.claude.com e cadastre seu e‑mail. O console é um produto separado da interface de chat do claude.ai, então uma conta existente não migra — você pode precisar se registrar de novo com o mesmo endereço.

Para esclarecer: algumas contas precisam verificar o número de telefone nessa etapa. Concluída a verificação, o crédito inicial é aplicado automaticamente; não há campo de cupom para resgate.

Passo 2: confira seu saldo de créditos

Abra a seção Billing no menu do console. Seu saldo inicial aparece ali, junto com a opção de adicionar um método de pagamento, que você ainda não precisa.

Cheque isso antes de qualquer outra coisa. Se o saldo estiver zerado, nenhuma configuração correta mais adiante vai resultar em uma sessão funcional.

Passo 3: crie uma chave de API

Vá em Settings > API Keys e crie uma nova chave. Dê um nome que você reconheça daqui a três meses — a maioria acaba tendo várias.

O valor completo da chave é exibido uma única vez. Copie para o seu gerenciador de senhas na hora, porque fechar a janela sem copiar significa perder a chave e ter que refazer o passo.

Passo 4: exporte a chave e instale o Claude Code

Exporte a chave como variável de ambiente no seu shell e depois instale a CLI. A Anthropic recomenda o instalador nativo, que traz o próprio runtime e não precisa de Node.js.

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

No Windows PowerShell, o instalador é irm https://claude.ai/install.ps1 | iex. Se preferir npm, note que a partir do Claude Code v2.1.198, o pacote exige Node.js 22 ou superior — uma mudança em relação ao mínimo Node.js 18 que guias antigos ainda citam:

npm install -g @anthropic-ai/claude-code

Adicione a linha com export ao seu ~/.zshrc ou ~/.bashrc se quiser que a chave persista em novas janelas do terminal. Depois confirme se a instalação foi concluída:

claude --version

Passo 5: rode sua primeira sessão

Entre no diretório de um projeto e inicie o agente. Rodar claude a partir do seu diretório home tecnicamente funciona, mas a ferramenta é quase inútil sem um codebase para ler.

cd ~/projects/my-app
claude

No primeiro lançamento com ANTHROPIC_API_KEY definido, o Claude Code pede uma única aprovação da chave em vez de abrir o navegador para OAuth. Aprove e você cai na tela de boas‑vindas com o diretório de trabalho confirmado no rodapé:

Para confirmar a rota de cobrança e não só a instalação, rode /status dentro da sessão. A linha API key citando ANTHROPIC_API_KEY é o que indica que a sessão está usando créditos do Console, e não um login salvo do claude.ai.

Se algo parecer errado aqui, claude doctor imprime diagnósticos de instalação e configurações sem abrir sessão — é um primeiro passo mais rápido do que buscar o erro no Google.

Quanto os créditos gratuitos rendem?

Uma conta de padeiro, usando Sonnet 5 nas tarifas introdutórias atuais. Imagine quinze trocas num repositório real, cada uma enviando ~30.000 tokens de contexto e produzindo ~1.500 tokens de saída. O primeiro turno paga o preço cheio de entrada, e os quatorze seguintes batem majoritariamente no cache de prompt por 10% do valor.

Trate isso como ordem de grandeza, não como cotação. O modelo acima assume contexto plano e ignora o prêmio de gravação no cache — 1,25× o preço base de entrada para um cache de cinco minutos —, então suas sessões reais vão cair de um lado ou de outro.

A diferença entre as duas últimas linhas é o que vale memorizar. O cache corta algo como três quartos da conta, por isso sessões do Claude Code custam bem menos do que uma contagem ingênua de tokens sugeriria — e qualquer coisa que quebre o cache (pular entre repositórios, reiniciar sessões toda hora, trocar de modelo no meio) triplica silenciosamente o que você paga. A documentação de preços da Anthropic traz a tabela completa de multiplicadores para você modelar isso direito.

Diferenças por modelo

A escolha do modelo mexe mais no número do que qualquer outra coisa sob seu controle. Rodando a mesma sessão de quinze trocas na linha:

Ou seja, um saldo de cinco dólares compra algo entre cinco e vinte e sete sessões, dependendo só do modelo escolhido. Sonnet 5 é o padrão sensato para avaliação.

Gaste esse saldo em uma tarefa de verdade, não em exemplos de brinquedo. Refatore um módulo seu ou persiga um bug por três arquivos — é o único jeito de saber se a ferramenta merece um lugar na sua semana.

Quando o saldo zera, não há rede de segurança. A cobrança do Console é por uso, e o Claude Code não tem camada gratuita por baixo.

Opção 2: modelos gratuitos no OpenRouter

OpenRouter é um gateway de API na frente de algumas centenas de modelos, e um conjunto rotativo deles não custa nada para chamar. Sem cartão, sem mensalidade, sem assinatura.

Isso se conecta ao Claude Code porque a CLI lê o endpoint de uma variável de ambiente. Mude a variável, muda para onde as requisições vão. O OpenRouter oferece o que chama de “Anthropic Skin”, um endpoint que aceita o formato Anthropic Messages e repassa thinking blocks e uso nativo de ferramentas sem alteração — sem proxy local no meio.

Seja claro sobre o que você está recebendo: não são modelos Claude. Você mantém a interface do Claude Code, o loop agentic, a edição de arquivos e os comandos de barra, enquanto um Qwen ou Llama faz o raciocínio.

A própria documentação do OpenRouter alerta que o Claude Code só é garantido quando as requisições vão para provedores de primeira parte da Anthropic e “pode não funcionar corretamente com outros”. Prefiro citar do que fingir o contrário.

Como funciona o redirecionamento

Três variáveis fazem o serviço:

• ANTHROPIC_BASE_URL aponta para https://openrouter.ai/api em vez do endpoint da Anthropic.

• ANTHROPIC_AUTH_TOKEN carrega sua chave do OpenRouter e vai no header Authorization: Bearer.

• ANTHROPIC_API_KEY deve ser definido como string vazia explicitamente; caso contrário, o Claude Code pode voltar a autenticar na Anthropic.

Você pode definir isso no seu profile do shell ou em um arquivo de configurações do Claude Code. O que evitar: um arquivo .env do projeto não funciona, porque o instalador nativo não lê arquivos .env padrão.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_API_KEY": ""
  }
}

Onde você coloca esse arquivo importa mais do que parece. Use ~/.claude/settings.json para configuração global, ou .claude/settings.local.json para um único projeto — o Claude Code adiciona este ao seu gitignore. 

Não coloque credencial em .claude/settings.json do projeto — esse arquivo é commitado e compartilhado com todo mundo que clonar o repositório.

Configurando o Claude Code com OpenRouter

1. Instale o Claude Code com o instalador nativo, se ainda não instalou.

2. Crie uma conta gratuita em openrouter.ai e gere uma chave em Settings > Keys. Não precisa de cartão para usar apenas modelos gratuitos.

3. Escreva a configuração em ~/.claude/settings.json usando o bloco acima, ou exporte as mesmas três variáveis no seu profile do shell.

4. Se você já fez login no Claude Code com uma conta Anthropic, rode /logout na CLI, feche e reabra. Uma sessão em cache ignora suas variáveis e aparece como erros confusos de modelo não encontrado.

5. Inicie o claude e confira para onde as requisições estão indo.

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

Suas requisições também devem aparecer no painel de atividade do OpenRouter em alguns segundos — é o jeito mais rápido de confirmar o redirecionamento.

Escolhendo um modelo grátis no OpenRouter

IDs de modelos grátis terminam em :free, e a lista muda o tempo todo conforme provedores adicionam, removem ou repr precificam modelos. A coleção de modelos gratuitos do OpenRouter mostra o que está disponível sem custo. openrouter/free é o auto‑router do OpenRouter para modelos grátis: ele escolhe o que estiver disponível e casar com seu pedido, mantendo sua configuração funcionando quando modelos saem de rotação. É o começo mais simples, mas a qualidade varia muito.

Preços, créditos e a lista de modelos gratuitos no OpenRouter mudam mensalmente — alguns mudaram enquanto eu escrevia isto. Consulte a página de preços da Anthropic e o filtro de gratuitos do OpenRouter antes de decidir com base em qualquer número daqui.

E tem os rate limits, que doem mais do que a escolha do modelo. Modelos gratuitos permitem 20 requisições por minuto em qualquer conta, e 50 por dia se você nunca comprou créditos. Compre US$ 10 em créditos uma única vez e esse limite diário sobe para 1.000 e fica assim mesmo depois que o saldo volta a zero.

Cinquenta requisições por dia parece viável até você lembrar que uma sessão agentic gasta chamadas como um colega falante gasta sua tarde. Uma tarefa um pouco mais envolvida pode consumir um terço da cota diária. Tentativas fracassadas contam também — insistir no retry às cegas só piora.

Para rotear papéis específicos de modelo, o Claude Code expõe variáveis separadas por tier:

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"

Refatorações simples, edições de um arquivo e tarefas de explicação funcionam bem. Dito isso, trabalhos longos em várias etapas degradam perceptivelmente, e o modo de falha costuma ser o uso de ferramentas, não a qualidade do código — o modelo escolhe a ferramenta errada, interpreta mal um resultado ou entra em loop.

Se você quer uma abordagem mais deliberada para misturar modelos por tarefa, nosso guia do Claude Code Router cobre roteamento multi‑modelo em detalhes.

Opção 3: modelos locais com Ollama

Ollama roda modelos abertos na sua própria máquina. Sem chaves de API, sem limites de taxa e sem internet depois de baixar os pesos.

Em janeiro de 2026, o Ollama adicionou compatibilidade com a Anthropic Messages API na v0.14.0, tornando esse fluxo viável. Antes, era preciso um proxy tradutor no meio. Agora o Claude Code fala direto com o localhost.

O custo não desaparece; ele migra para o hardware — especificamente para a largura de banda da memória, não só a capacidade. 

• Em Apple Silicon, memória unificada é o número a observar: 16 GB roda um modelo ~14B como gpt-oss:20b, mas modelos de código na faixa de 30B que valem a pena pedem 32 GB ou mais quando você adiciona janela de contexto de 32K. 

• Em Windows ou Linux, o número relevante é a VRAM da GPU, não a RAM do sistema — um modelo que cabe na RAM mas roda em CPU é lento demais para trabalho agentic, em que cada tarefa dispara dezenas de chamadas.

Configurando o Ollama com Claude Code

1. Instale o Ollama. No macOS e Linux, use curl -fsSL https://ollama.com/install.sh | sh; no Windows, baixe o instalador em ollama.com e rode.

2. Puxe um modelo de código. Embora não concorra com os Claude atuais, o Qwen3-Coder é uma boa escolha: ollama pull qwen3-coder.

3. Confirme que o modelo está presente com ollama list.

4. Aumente o contexto, porque é a configuração que o pessoal esquece e depois culpa o modelo. O Ollama sugere pelo menos 32K tokens para o Claude Code.

5. Aponte o Claude Code para o endpoint local e escolha o modelo.

bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3-coder

O auth token é exigido pelo protocolo e ignorado pelo Ollama — o valor não importa. Se preferir tornar permanente, use as mesmas três chaves no bloco env do ~/.claude/settings.json.

Dois pontos cegos valem ser conhecidos antes de julgar os resultados:

• O cache de prompt da Anthropic não se aplica, então cada chamada reprocessa o system prompt e todo o histórico — aqui o custo é tempo, não dinheiro.

• A camada de compatibilidade do Ollama ignora tool_choice, campo que o Claude Code às vezes usa para forçar uma ferramenta específica; quando isso importa, o agente pode escolher errado e entrar em loop.

Para um passo a passo mais profundo, temos um tutorial dedicado sobre usar Claude Code com modelos locais no Ollama, além de guias para rodar Qwen 3 e DeepSeek R1 localmente.

Checagem realista de hardware

Para a maioria dos devs, OpenRouter supera Ollama — a menos que você tenha 32 GB ou mais de memória unificada/VRAM, precise de acesso offline ou queira que seu código nunca saia da máquina. Esse último motivo é ótimo, e por isso eu não descartaria essa rota só por desempenho.

Opção 4: o programa Claude for Open Source

A maioria dos guias para por aqui e perde a opção que te dá o produto real, no nível mais alto, por meio ano.

A Anthropic lançou o Claude for Open Source em fevereiro de 2026 e ampliou em julho. Mantenedores e contribuidores qualificados recebem seis meses de Claude Max 20x, o plano de US$ 200/mês, sem custo. Inclui o Claude Code, com folga de uso no topo do nível consumidor.

Os critérios publicados são mais amplos do que muita gente imagina:

• Mantenedores de pacotes com 500+ repositórios dependentes, 100+ pacotes dependentes ou 200.000+ downloads mensais combinados em npm, PyPI, crates.io, RubyGems ou similares.
• Committers listados em projetos de fundações ou linguagens, como CPython, equipe do Rust, Node.js TSC, um PMC do Apache, CNCF, Kubernetes, kernel Linux, Django ou Rails.
• Quem criou 100+ pull requests mesclados em repositórios que não possui nos últimos 12 meses.
• Construtores de comunidade cujo repositório atraiu 20+ contribuidores externos únicos com PRs mesclados no último ano.
• Mantenedores de algo com score de criticality do OpenSSF de 0,4 ou mais.

A página da Anthropic convida explicitamente casos na fronteira a se candidatarem e explicarem do que o ecossistema depende silenciosamente. O programa é limitado a 10.000 contemplados e revisado de forma contínua; as inscrições são pelo claude.com/contact-sales/claude-for-oss.

Um porém: isso cobre a assinatura, não créditos de API. Seu uso de ANTHROPIC_API_KEY é cobrado à parte — é um plano pessoal, não algo para apontar em um pipeline de CI.

Como escolher a opção gratuita certa para você

Duas perguntas resolvem: para que você quer o Claude Code e quanta configuração está disposto a fazer antes de perder a paciência?

Tabela comparativa

Qual escolher?

• Se você nunca usou o Claude Code e quer saber se vale US$ 20/mês, pegue os créditos iniciais da API. É a única rota que mostra o produto real, e uma dúzia de sessões basta para formar opinião.
• Se você quer acesso grátis contínuo e não precisa especificamente do Claude, o OpenRouter oferece a melhor relação qualidade/esforço. Reserve uma noite para o setup inicial e espere bater no limite diário antes do que gostaria.
• Se você precisa de acesso offline ou sua empresa controla para onde o código viaja, o Ollama é a resposta, apesar do hardware. Abaixo de 16 GB de memória unificada/VRAM, eu não insistiria.
• Se você mantém algo que outros utilizam, verifique a bolsa para open source antes de qualquer coisa. Seis meses no topo encerram a discussão.

Resolvendo problemas nas configurações com redirecionamento

As opções 3 e 4 compartilham a mesma superfície de falhas, e um punhado de problemas responde pela maioria. Como nem a Anthropic nem os gateways conseguem depurar sua combinação específica, confira primeiro o seguinte:

• O Claude Code continua pedindo login. A CLI não tem credenciais próprias, e um base URL acessível não conta. Um bloco env em .claude/settings.json do projeto só vale depois do wizard de primeiro uso; então defina ANTHROPIC_AUTH_TOKEN em algo lido antes: export no shell ou ~/.claude/settings.json.

• Um aviso de inicialização cita duas fontes de credencial. Há uma credencial de gateway e um login salvo ativos. Rode /logout para limpar o login salvo ou desfaça a variável para voltar ao login anterior.

• Erros 400 citando campos não reconhecidos. O Claude Code envia campos para endpoints no formato Anthropic que alguns upstreams rejeitam. Definir CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 suprime a maioria dos campos de pré‑lançamento e esclarece o cenário.

• Erros 400 citando thinking ou adaptive. O upstream não aceita adaptive reasoning, que o Claude Code solicita para modelos Claude recentes. Geralmente exige atualizar o upstream do gateway, não um ajuste no cliente.

• Controle remoto e ditado por voz param. Ambos dependem de identidade do claude.ai e ficam indisponíveis enquanto houver credencial de gateway definida. Desde a v2.1.196, o controle remoto também é desativado sempre que ANTHROPIC_BASE_URL aponta para host que não é da Anthropic.

Quando algo estiver estranho e você não souber em qual camada está o problema, /status dentro da sessão mostra qual base URL e fonte de credencial estão de fato em uso. Esse único comando resolve mais casos do que qualquer quantidade de reexports.

Considerações finais

Quatro caminhos para usar o Claude Code de graça — nenhum perfeito — e os trade‑offs são a parte mais interessante, não um rodapé.

Minha recomendação é direta. Se o que você quer é o agente de CLI do Claude Code, e não uma janela de chat, comece pelos créditos da API, porque você aprende mais com uma sessão real no produto de verdade do que com uma noite configurando substitutos. Se ele ganhar lugar no seu fluxo, US$ 20/mês é uma linha defensável. Se não ganhar, você não perdeu nada — e ainda entendeu o motivo.

No longo prazo, o OpenRouter é a opção gratuita mais sustentável, e o Ollama vence no momento em que privacidade ou acesso offline deixa de ser desejável e vira inegociável.

Para os hábitos que separam uma sessão útil de uma frustrante, nosso Claude Code Best Practices traz planejamento, transferência de contexto e TDD em projetos reais. E se você está começando do zero, o Claude Code 101 ensina os fundamentos com aulas práticas e estruturadas, do primeiro install até um fluxo de trabalho funcional.