O que é o Claude Code?
O Claude Code é uma ferramenta de IA da Anthropic voltada para desenvolvimento de software.
Com ele, é possível interagir com projetos pelo terminal, analisar arquivos, entender códigos, sugerir melhorias e auxiliar em tarefas comuns do dia a dia de um desenvolvedor.
Como funciona?
O Claude Code Free funciona como um proxy/gateway entre o Claude Code e outras IAs/LLMs.
Na prática, o Claude Code continua sendo usado pelo terminal, mas as requisições são redirecionadas para outro provedor de IA configurado no proxy.
Ou seja, o proxy faz uma “ponte” entre o Claude Code e o modelo escolhido, permitindo usar outras opções além dos métodos oficiais de autenticação do Claude Code.
Instalação
Nesta etapa, vamos configurar a instalação da ferramenta e fazer a configuração do PATH.
OBS: Neste artigo, vamos seguir os passos direcionados para o Windows.
Baixando o Claude Code
Primeiramente vamos instalar a ferramenta do Claude Code no site oficial. Só posteriormente que vamos instalar e configurar o proxy nela.
Pré-requisitos:
- uv
- Python
- Claude Code Free
https://claude.com/product/claude-code
ou execute o script oficial do Claude Code no PowerShell:
irm https://claude.ai/install.ps1 | iex
Configuração do PATH
O próprio Claude Code avisa no terminal quando precisamos configurar manualmente o PATH da ferramenta no computador.
Sendo assim, siga as instruções:
System Properties → Environment Variables → Edit User PATH → New → Add the path above
1) Copie o seguinte endereço:
Esse é o caminho onde o Claude Code foi instalado no seu computador.
2) Cole no path das variáveis de ambiente do sistema:
Ao adicionar esse caminho no Path, o Windows passa a reconhecer o comando claude em qualquer terminal.
3) Feche e abra novamente o terminal.
Depois de alterar o PATH, feche o terminal atual e abra novamente.
Isso é necessário para que a nova configuração seja carregada.
4) Teste a configuração do PATH:
Copie e cole no terminal:
claude --version
Se tudo estiver correto, o terminal irá exibir a versão instalada do Claude Code.
Executando o Claude Code
Antes de configurar o proxy, vamos executar e realizar alguns pequenos testes no CLI.
Rode o comando no terminal:
claude
Resultado:
Esse comando inicia o Claude Code diretamente no terminal.
Na primeira execução, pode ser necessário realizar login ou autorizar o acesso da ferramenta.
Quais autenticações o Claude Code aceita por padrão?
Por padrão, o Claude Code oferece algumas formas oficiais de autenticação.
Isso também não significa usar qualquer API Key de qualquer IA.
Configurando o "Claude Code Free"
Agora chegamos ao principal tópico do artigo: configurar o proxy/gateway que possibilita o uso de outras IAs/LLMs no Claude Code.
Além do Claude Code, você também precisará do Python para rodar o Claude Code Free, mas não se preocupe, pois eles serão instalados automaticamente ou atualizados.
Integrando o repositório "Claude Code Free"
A primeira etapa é baixar ou clonar o repositório open source que possibilita a compatibilidade do CLI do Claude Code com outras LLMs.
Vá ao repositório oficial e siga as instruções:
https://github.com/Alishahryar1/free-claude-code
ou execute o comando no PowerShell:
irm "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.ps1?raw=1" | iex
Execute o proxy
Finalmente iremos testar o proxy. Execute o seguinte comando no terminal:
fcc-server
Resultado:
OBS: Acesse o link local com a seta vermelha para abrir o painel de "admin" do proxy.
Tela inicial do dashboard do proxy:
Entendendo o "server control" do free claude code
Antes de criar as nossas chaves de API em diversos provedores, vamos entender mais do "painel de controle" do proxy que acabamos de baixar.
Temos 3 seções principais:
- Providers
- Model Config
- Messaging
Providers
Botões de reset
Este painel serve para manusear e autenticar suas chaves de API e IAs que funcionam localmente no seu PC.
Literalmente são botões para resetar/iniciar a conexão com sua chave de API. Porém atenção para os status:
- Missing Key: A chave está faltando nos provedores.
- Offline: Server da IA local não está ativo.
- AuthenticationError: Não conseguiu conectar.
Campos das chaves
Aqui você só vai colar a sua chave de API da IA que você vai utilizar. Lembre-se, cole as devidas chaves de API em cada campo certo, se não, você pode acabar colocando o "motor" no "chassi" errado.
Também tem os campos que hospedam o endereço do servidor da sua IA local. Por exemplo http://localhost:1234/v1.
Runtime
De forma resumida:
Essa parte configura como o servidor do proxy vai funcionar.
Ela controla:
- Token de acesso: senha interna para o Claude Code conseguir conversar com o proxy.
- Rate limit: quantas requisições o proxy pode mandar para o provedor.
- Concorrência: quantas respostas/chamadas ele pode processar ao mesmo tempo.
- Timeouts: quanto tempo ele espera antes de desistir de uma resposta.
- Host e porta: onde o proxy vai rodar na sua máquina.
Model Config
Seção relacionada à configuração dos modelos.
Model Routing
Essa parte é o Model Routing, ou seja: ela define qual modelo real será usado quando o Claude Code pedir um modelo Claude.
Resumindo cada campo:
Default Model
É o modelo padrão. Se você não configurar mais nada, tudo vai cair nele.
Opus Override
Modelo específico para quando o Claude Code pedir algo equivalente ao Claude Opus.
Sonnet Override
Modelo específico para quando o Claude Code pedir algo equivalente ao Claude Sonnet.
Haiku Override
Modelo específico para quando o Claude Code pedir algo equivalente ao Claude Haiku.
Thinking
Essa parte controla o modo Thinking, ou seja, o comportamento de “raciocínio estendido” do modelo.
Em resumo:
Thinking = fazer o modelo pensar mais antes de responder.
Web Tools
Essa parte controla as ferramentas de web do proxy, ou seja, se o Claude Code/modelo poderá usar recursos parecidos com:
web_search
web_fetch
Em resumo:
Web Tools = permite o modelo pesquisar ou buscar conteúdo da internet através do proxy.
Messaging
Seção responsável por mensageria e inputs.
Messaging
Essa parte é a área de Messaging, ou seja, configurações para usar o proxy/Claude Code integrado com Discord ou Telegram.
De forma resumida:
Messaging = permite controlar/usar o Claude Code por mensagens, como se fosse um bot no Discord ou Telegram.
Voice
Essa parte é a área de Voice, ou seja, configurações para transcrever áudios/notas de voz.
De forma resumida:
Voice = permite o proxy transformar áudio em texto usando Whisper.
Configurando chave de API no OpenRouter
Agora vamos criar a nossa primeira chave de API para conectar modelos de IA no nosso claude code free.
Criação da Chave
Acesse o site para criar a chave de API:
https://openrouter.ai/
Crie uma nova chave em "New Key".
Integração da chave no Proxy
Após a criação da chave de API no OpenRouter, vá até ao painel do Proxy e conecte sua chave:
Escolha do modelo
Para o claude code free realmente ser free, você deve escolher modelos gratuitos no openRouter. Porém para fazer isso, basta você ir na aba de modelos e aplicar o filtro free.
Acesse a página:
Após você escolher o modelo que vai usar, basta ir no painel do proxy, na aba de "model config" e configurar com base no nome do modelo escolhido.
Por exemplo:
Modelo que escolhi: openai/gpt-oss-120b:free
Testando a CLI do claude code + openRouter
Neste teste prático, eu fiz a manutenção de alguns testes unitários de 3 componentes meus:
OBS: Caso algum modelo específico ou provedor começar a falhar ou dar erros, troque temporariamente para outros modelos e/ou provedores.
Desde já agradeço a todos e espero que tenham gostado!
Att.
Gustavo Machado Pontes
Top comments (2)
O "Claude Code Free" atualmente está com problema com a última versão do "Claude Code", ocorrendo problemas como "ERROR 401".
Portanto, baixe a versão:
Mais detalhes nos issues:
github.com/Alishahryar1/free-claud...
Caso encontrem alguma inconsistência nas informações, por favor, comentem ou me mandem mensagem!
Desde já agradeço a todos.