Para usar o Claude Code de graça, existem três caminhos funcionais até 29 de outubro de 2026: um passe de convidado de sete dias de um assinante Max, um modelo local executado pelo Ollama ou um modelo gratuito no OpenRouter. Apenas o passe de convidado oferece o próprio Claude. As outras duas opções mantêm as ferramentas do Claude Code e substituem o modelo por trás dos panos.
O Claude Code é o agente de codificação da Anthropic: ele analisa seu repositório, edita arquivos e executa comandos diretamente do terminal. O aplicativo pode ser instalado sem custo. O que você realmente paga é pelo modelo em execução, e é aí que cada alternativa gratuita exige uma concessão.
Se você quer apenas uma resposta direta de "sim ou não" sobre os planos da Anthropic, leia O Claude Code é gratuito?. Esta página é o guia prático: o passo a passo de configuração para cada método que realmente funciona e os que parecem gratuitos, mas não são.
Todas as opções a custo zero, verificadas hoje
Cada linha abaixo foi verificada diretamente na página oficial de cada provedor em 29 de outubro de 2026.
| Opção | Custo | Modelo disponível | Ponto de atenção |
|---|---|---|---|
| Passe de convidado | $0 por 7 dias | Claude (plano Pro) | Exige convite de um assinante Max, cartão cadastrado e renova como pago |
| Modelo local via Ollama | $0 | Modelo aberto em hardware próprio | A qualidade e a velocidade dependem da sua GPU e RAM |
| Modelos gratuitos do OpenRouter | $0 | Modelos cujo ID termina em :free |
Exige conta, chave de API e possui limite diário de requisições |
| Plano Claude Free | Não funciona | Nenhum | O Claude Code não está incluso |
| Modelos na nuvem do Ollama | Não é gratuito | Modelos abertos hospedados | Cobrado por token |
O que não funciona
Três alternativas parecem gratuitas, mas não são. Descarte-as primeiro e você economizará uma tarde inteira lidando com erros de login.
O plano Claude Free. A documentação de configuração da Anthropic afirma: “O Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console. O plano gratuito do claude.ai não inclui acesso ao Claude Code.” A página de preços confirma: o Claude Code aparece como “Não” na coluna Free, e o FAQ esclarece que “O Claude Code está incluído em todos os planos pagos.” O plano Pro custa US$ 17 por mês na cobrança anual ou US$ 20 mensais.
Modelos na nuvem do Ollama. A página de preços do Ollama descreve seu nível de $0 como “Pay as you go: Pague por token para qualquer modelo na nuvem.” Executar modelos localmente continua sendo gratuito. Qualquer nome de modelo que termine com :cloud será cobrado na sua conta do Ollama.
Créditos de API do plano Max. O plano Max inclui créditos mensais de API, mas o artigo de ajuda do Pro e Max da Anthropic informa que eles “não podem ser usados no Claude Code nem nos aplicativos Claude.” Novas contas no Console também não recebem créditos iniciais de cadastro: o artigo de ajuda do Console orienta a “inserir seus dados de pagamento e adicionar saldo à sua conta.”
Opção 1: passe de convidado (o único Claude gratuito)
O passe de convidado é a única maneira de usar o Claude Code com os modelos oficiais do Claude sem pagar. Segundo o artigo sobre passes de convidado da Anthropic, “No momento, os passes de convidado estão disponíveis apenas para assinantes Max qualificados”, e cada um concede “Sete dias de acesso gratuito ao plano Pro do Claude, que inclui o Claude Code.”
Como usar:
- Peça para um amigo ou colega assinante do plano Max enviar um passe para você.
- Aceite o convite usando uma conta que nunca teve uma assinatura do Claude. Os destinatários “devem ser novos em assinaturas pagas do Claude”.
- Insira uma forma de pagamento. Você não será cobrado durante os sete dias.
- Instale o Claude Code e faça login com essa conta.
- Crie um lembrete para o sexto dia. O período de teste “será convertido automaticamente em um plano Pro pago”, a menos que você cancele antes.
Sete dias de Pro são suficientes para avaliar se o Claude Code se encaixa no seu fluxo de trabalho. Os limites do plano Pro continuam valendo: uma janela de sessão de cinco horas, além de um limite semanal compartilhado com o chat. Nosso guia sobre limites de uso do Claude Code explica como aproveitá-los ao máximo.
Opção 2: Claude Code com modelo local via Ollama
Esta é a única opção que permanece a custo zero sem limite de tempo e sem teto diário de requisições. O Claude Code envia suas requisições para qualquer servidor definido em ANTHROPIC_BASE_URL, e o Ollama disponibiliza uma API compatível com a da Anthropic diretamente no seu computador.
Como configurar o Claude Code com o Ollama?
O guia do Claude Code do Ollama apresenta um comando de inicialização rápida em uma linha e uma configuração manual. A versão manual deixa claro o que muda:
# 1. Install Claude Code (macOS / Linux)
curl -fsSL https://claude.ai/install.sh | bash
# 2. Pull a local model with Ollama installed and running
ollama pull qwen3.5
# 3. Point Claude Code at Ollama instead of Anthropic
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
# 4. Start a session on the local model
claude --model qwen3.5
O atalho é ollama launch claude, que define essas mesmas variáveis para você.
O que esperar de um modelo local
A documentação do Ollama recomenda “uma janela de contexto de mais de 64k” para modelos locais, já que o ciclo de execução do agente envia uma grande quantidade de conteúdo de arquivos a cada interação. Eles também alertam que “o WebSearch hospedado e os controles avançados de ferramentas não são totalmente suportados”. Espere respostas mais lentas e mais tentativas do que com o Claude oficial, e divida as tarefas em partes menores: uma função, um arquivo de teste, um bug por vez.
Atenção ao nome do modelo: qwen3.5 roda no seu próprio hardware. Já o kimi-k2.7-code:cloud, mencionado na mesma documentação, roda nos servidores do Ollama e é cobrado por token.
Opção 3: modelos gratuitos do OpenRouter
O OpenRouter é um gateway de modelos que opera no formato de API da Anthropic. Sua lista pública de modelos retornava 16 opções com IDs terminados em :free em 29 de outubro de 2026, sendo que 15 delas têm suporte a chamadas de ferramentas (tool calling), requisito indispensável para o Claude Code. Alguns exemplos incluem cohere/north-mini-code:free, poolside/laguna-s-2.1:free e google/gemma-4-31b-it:free.
Como conectar o Claude Code ao OpenRouter gratuitamente?
O guia do Claude Code no OpenRouter define quatro variáveis. Como os padrões do próprio guia apontam para os modelos pagos da Anthropic, você também precisa sobrescrever as variáveis de modelo com um ID gratuito:
export OPENROUTER_API_KEY="sk-or-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # must be explicitly empty
# Route every role to a free model, or you pay for Claude through OpenRouter
export ANTHROPIC_DEFAULT_OPUS_MODEL="cohere/north-mini-code:free"
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"
claude
Se você já tiver feito login com uma conta do Claude anteriormente, execute /logout uma vez dentro do Claude Code. Depois, execute /status e confirme se a linha de autenticação indica ANTHROPIC_AUTH_TOKEN e se a URL base é a do OpenRouter.
Limites do plano gratuito
Os modelos gratuitos possuem limites de requisições por minuto e por dia. De acordo com a documentação de limites do OpenRouter, o teto diário aumenta depois que você compra créditos, e um saldo negativo também pode bloquear os modelos gratuitos. Verifique sua contagem real no campo free_model_daily_requests em GET /api/v1/key. O OpenRouter também ressalta que “o Claude Code é otimizado para modelos da Anthropic e pode não funcionar corretamente com outros provedores”. A lista de modelos gratuitos muda com frequência, portanto, revise-a antes de escolher um.
Duas armadilhas que custam dinheiro
Estas duas configurações podem transformar uma sessão “gratuita” em cobrança real sem nenhum aviso na tela.
- Definir apenas a URL base mantém seu login anterior. A documentação de gateway LLM da Anthropic adverte que configurar apenas
ANTHROPIC_BASE_URL, “sem uma credencial de gateway, não substitui a assinatura.” Seu login salvo do claude.ai permanece ativo, com seus limites e cobranças. Sempre definaANTHROPIC_AUTH_TOKENtambém. - Uma chave de API residual assume o controle. Se
ANTHROPIC_API_KEYcontiver uma chave real, o artigo de ajuda da Anthropic alerta que o Claude Code a utilizará “em vez da sua assinatura do Claude”, o que resulta em cobranças por token. Todos os tutoriais acima definem essa variável intencionalmente como uma string vazia.
Qual opção gratuita você deve escolher?
| Se você busca | Escolha |
|---|---|
| Experimentar o Claude Code com o Claude antes de pagar | Passe de convidado |
| $0 para sempre e possui uma GPU potente | Modelo local via Ollama |
| $0 sem precisar de hardware potente, para uso diário leve | Modelo gratuito do OpenRouter |
| Um agente de codificação gratuito, seja o Claude Code ou não | OpenCode com modelo gratuito |
Se o objetivo for apenas usar um agente gratuito em vez do Claude Code especificamente, o OpenCode já vem com modelos gratuitos integrados e não exige conta. Nosso teste dos modelos gratuitos do OpenCode detalha o comportamento de cada um com seu código e quais são seus limites. Para chaves que você pode chamar em seus próprios scripts, confira chaves de API de IA gratuitas. O guia do Claude Code gratuito da Apidog traz outra perspectiva sobre o mesmo tema.
Como gerenciar sessões gratuitas do Claude Code em equipe
As opções gratuitas se tornam caóticas quando mais de uma pessoa começa a usá-las. Um colega de equipe está com um passe de convidado que expira na sexta-feira, outro está no notebook com o Ollama e um terceiro esgota o limite do OpenRouter antes do meio-dia. Ninguém consegue acompanhar qual agente trabalhou em quê.
O Sharkly é um quadro de trabalho para agentes de codificação. Você conecta um Computador (Computer), o Sharkly detecta o ambiente do Claude Code nele e você atribui tarefas a esse Agente (Agent) da mesma forma que faria com uma pessoa. De acordo com a documentação de Agentes, cada Agente pode ter suas próprias variáveis de ambiente públicas e secretas. Isso significa que um Agente pode rodar o Claude Code conectado a um modelo local no Ollama e outro conectado ao seu plano pago, ambos no mesmo painel.
O Sharkly não altera os custos do modelo. Segundo a página de preços, “O Sharkly não vende tokens”, o plano Free atende organizações de até 5 pessoas, e Agentes e Computadores não ocupam assentos. O artigo Entenda os preços do Sharkly traz todos os detalhes.
Conclusão
É possível usar o Claude Code de graça hoje, com concessões bem claras em cada alternativa. O passe de convidado oferece o Claude original por sete dias. O Ollama garante sessões ilimitadas com um modelo local, na velocidade do seu próprio hardware. O OpenRouter disponibiliza modelos gratuitos hospedados, limitados por um teto diário. Já o plano Claude Free, os modelos em nuvem do Ollama e os créditos de API do plano Max não funcionam para essa finalidade.
Escolha o caminho mais compatível com o seu hardware e com a sua paciência. Em seguida, conecte seu primeiro Computador ao Sharkly para reunir todas as sessões do Claude Code, gratuitas ou pagas, em um só lugar.
Perguntas frequentes
Posso usar o Claude Code de graça? Sim, por três caminhos: um passe de convidado de sete dias de um assinante Max, um modelo local disponibilizado pelo Ollama ou um modelo :free no OpenRouter. Apenas o passe de convidado executa os modelos oficiais do Claude.
O plano Claude Free inclui o Claude Code? Não. A documentação da Anthropic afirma que “o plano gratuito do claude.ai não inclui acesso ao Claude Code.” O plano Pro, a US$ 17 por mês no faturamento anual ou US$ 20 mensais, é o plano mais acessível que inclui o recurso.
O Claude Code com Ollama é gratuito? Os modelos locais são gratuitos e ilimitados. Modelos com o sufixo :cloud rodam nos servidores do Ollama e são cobrados por token, segundo a página de preços do Ollama.
Os modelos gratuitos do OpenRouter são gratuitos no Claude Code? Sim, dentro de um limite de requisições por minuto e por dia. É necessário sobrescrever as variáveis ANTHROPIC_DEFAULT_*_MODEL com um ID :free, caso contrário, o Claude Code solicitará modelos pagos da Anthropic consumindo seus créditos do OpenRouter.
Existe um teste gratuito do Claude Code? Apenas o passe de convidado. Ele exige um convite de um assinante Max qualificado, uma conta sem histórico de assinaturas do Claude e uma forma de pagamento cadastrada. Ele é convertido para o plano Pro após sete dias, a menos que você cancele.
Por que o Claude Code continua usando minha assinatura depois de definir ANTHROPIC_BASE_URL? Porque configurar apenas a URL base não substitui o seu login salvo. Defina ANTHROPIC_AUTH_TOKEN e deixe ANTHROPIC_API_KEY vazia, ou execute /logout uma vez.
