O truque é uma variável de ambiente
O Claude Code é um harness de agente que, por padrão, aponta para a Anthropic. Mas aponte-o para outro lugar e ele continua sendo o mesmo harness — mesmo loop de ferramentas, mesmo modelo de permissões, mesmas skills. A chave é uma única variável de ambiente: CLAUDE_CONFIG_DIR.
A questão não é só “usar outros modelos”. É poder trocar skills, provedores e contas independentemente uns dos outros — três coisas que normalmente vêm soldadas em um setup que você usa ou não usa.
Por que isso importa
Quatro motivos práticos, em ordem de frequência:
- Trabalho braçal não merece tokens premium. Renomear coisas em um repositório, resumir logs, triagem inicial de stack trace. Um modelo local resolve isso — e cada tarefa empurrada para fora da assinatura é capacidade liberada para o que realmente precisa do modelo bom.
- Alguns trabalhos não devem sair da máquina. Código de cliente sob NDA, qualquer coisa com credenciais no histórico. Um modelo Ollama local significa que a pergunta nunca cruza a rede — uma conversa muito mais fácil com a equipe de segurança.
- Duas assinaturas podem sair mais baratas que uma maior. Quando você sobe de plano, geralmente não está comprando um modelo mais inteligente — está comprando mais do mesmo. Limites de taxa são o que realmente interrompem seu dia. Há mais de uma maneira de comprar capacidade, e a óbvia não é a mais barata.
- Você não avalia um modelo através de uma pilha de instruções. Se o scaffolding está sempre ligado, você não tem grupo de controle.
O mecanismo
CLAUDE_CONFIG_DIR. Aponte para um diretório e o Claude Code mantém tudo lá: credenciais, histórico de sessão, configuração MCP por usuário, skills. O que realmente isola: credenciais, .claude.json (o perfil padrão tem 207 KB de estado acumulado; um perfil novo tem 389 bytes), servidores MCP com escopo de usuário e skills.
O que não isola: um .mcp.json commitado dentro de um repositório ainda carrega sob qualquer perfil — o que é correto, pois pertence ao projeto, não à identidade.
Ollama: nativo e gratuito
O Ollama oferece a API Anthropic Messages nativamente em /v1/messages. Sem proxy, sem camada de tradução. O perfil completo:
CLAUDE_CONFIG_DIR=$HOME/.claude-ollama
ANTHROPIC_BASE_URL=http://127.0.0.1:11434
ANTHROPIC_AUTH_TOKEN=*** # qualquer string não vazia
ANTHROPIC_API_KEY= # deve estar explicitamente em branco
ANTHROPIC_MODEL=glm-5.2:cloud
ANTHROPIC_SMALL_FAST_MODEL=gemma4:31b-cloudVale notar: o Ollama também serve modelos hospedados na nuvem — 21 modelos :cloud disponíveis — então um perfil “local” alcança bem além do que cabe na VRAM. Modelos verdadeiramente locais e hospedados ficam atrás do mesmo endpoint.
OpenRouter: proxy mínimo necessário
O OpenRouter não oferece endpoint Anthropic nativo — ele fala apenas OpenAI-style chat completions. Isso exige um proxy tradutor. A solução mais enxuta é um daemon litellm com um arquivo de configuração YAML mapeando modelos.
Perfil “cru”: sem instruções, sem skills
O experimento mais revelador: um perfil com ANTHROPIC_BASE_URL padrão (API da Anthropic), mas sem instruções de sistema, sem skills e com um .claude.json vazio. O modelo se comporta de forma muito mais direta — sem o tom prestativo padrão, sem suposições sobre o que você quer. É o Claude “sem máscara”, útil como grupo de controle para comparar o quanto o scaffolding está realmente moldando as respostas.
Implantação local: Claude Code em empresa
Para times, o empacotamento em um script launcher que carrega um arquivo .env por perfil e executa via exec é suficiente. Como usa "$@", todas as flags do Claude Code continuam funcionando. O claude padrão permanece intocado — um experimento quebrado nunca derruba o setup de trabalho.
A lição principal: o Claude Code é mais valioso como plataforma de agente do que como cliente de um modelo específico. A separação entre identidade, provedor e modelo transforma uma ferramenta de uso único em um canivete suíço para desenvolvimento com IA.
Descubra mais sobre noticiAI
Assine para receber nossas notícias mais recentes por e-mail.
