O Claude Code pode trabalhar em um repositório autorizado por meio de um modelo servido pelo Ollama na sua máquina. A atual integração do Ollama com Claude Code conecta diretamente à API compatível com Anthropic. Este guia acompanha uma alteração limitada desde uma base registrada até uma decisão humana sobre o diff. É para desenvolvedores que podem instalar ambas as ferramentas, autorizar edições no repositório e executar um modelo local de programação adequado. A BIG CHANGE consultou os manuais em 20 de outubro de 2026; não executamos o modelo nem testamos um repositório.

A grande mudança

  • O que mudou: O Ollama agora documenta uma rota direta do Claude Code ao servidor local compatível com Anthropic, usando um inicializador ou configurações explícitas do endpoint. Um proxy separado é desnecessário para essa configuração documentada.
  • Por que importa: Você mantém o fluxo do Claude Code, escolhe um modelo local, confere sua alocação real de contexto e revisa uma edição real do repositório em relação à verificação de aceitação original.
  • O que observar: Uma tag local selecionada e um modelo ativo não provam que todas as solicitações ficaram locais nem que o código está correto. Confira roteamento efetivo, acesso das ferramentas, diff completo e resultado da verificação antes de aceitar.

1. Registre o ponto de partida do repositório

Trabalhe em um repositório Git próprio ou autorizado. Use uma branch revisável ou uma cópia de trabalho descartável. Defina um pequeno comportamento ou defeito para mudar, os arquivos permitidos e uma condição de parada. Encontre o comando de aceitação existente, como o teste ou build documentado; não o substitua por um comando genérico. Execute-o antes de qualquer edição do agente e registre o comando, o status de saída e o resultado relevante. Registre também a branch, git status e qualquer diff existente. Mudanças prévias pertencem à base, não ao resultado da IA.

Confirme que as políticas de código e dependências da organização permitem o modelo e as ferramentas escolhidos. O Claude Code pode ler arquivos e executar comandos segundo suas permissões efetivas. Pedir “toque apenas nestes arquivos” orienta o agente, mas não limita seu acesso ao sistema de arquivos.

2. Instale um modelo local adequado e aloque contexto

Instale uma versão atual do Ollama e da CLI do Claude Code pelas instruções oficiais, seguindo as regras da máquina e da organização. Registre ollama --version e claude --version. O Ollama introduziu compatibilidade com Anthropic Messages na versão 0.14.0 em janeiro de 2026; essa data não estabelece a versão mínima para o comando atual ollama launch.

Escolha um modelo cuja ficha atual indique suporte a ferramentas, cuja licença permita o uso e cujos pesos e alocação de contexto caibam na máquina. Um exemplo local concreto é qwen3-coder:30b, listado com ferramentas, um arquivo Q4_K_M de cerca de 19 GB e Apache License 2.0. Esse é o tamanho do download, não a exigência de RAM ou VRAM. O contexto anunciado não significa que a máquina possa alocá-lo. Se não couber, escolha outra tag local documentada com suporte a ferramentas e substitua-a de modo consistente nos comandos seguintes.

Em um terminal, com o aplicativo ou servidor local do Ollama ativo, baixe e confirme a tag exata:

Text
ollama pull qwen3-coder:30b
ollama list

O Ollama recomenda pelo menos 64.000 tokens para agentes de programação e informa que mais contexto usa mais memória. Defina 64k ou mais nas configurações do aplicativo Ollama existente, se o hardware permitir. Se você administra o servidor, configure esse serviço existente com OLLAMA_CONTEXT_LENGTH=64000 seguindo as instruções do servidor para a plataforma; não inicie outro servidor na porta 11434. Depois que uma solicitação carrega o modelo, ollama ps mostra os valores reais de CONTEXT e PROCESSOR. Pare, ou reduza a tarefa e escolha uma configuração adequada, se a alocação pretendida não carregar. Não apresente o máximo do catálogo como contexto alocado.

3. Direcione o Claude Code ao servidor local

Abra um terminal no repositório escolhido. O Ollama documenta este inicializador; use a mesma tag local confirmada por ollama list:

Text
ollama launch claude --model qwen3-coder:30b

O Ollama documenta esta rota para um modelo que não é Claude. O manual de gateways da Anthropic diz que a Anthropic não oferece suporte ao roteamento do Claude Code para modelos não Claude por um gateway. Trate como uma integração documentada pelo Ollama, sem suporte da Anthropic a esse roteamento, e confira a sessão real antes de confiar nela.

Para configuração manual, as instruções de integração do Ollama usam ANTHROPIC_AUTH_TOKEN=ollama, um valor explicitamente vazio para ANTHROPIC_API_KEY, e ANTHROPIC_BASE_URL=http://localhost:11434. Este comando opcional de Bash define os três apenas para este processo do Claude Code, a partir do diretório autorizado; ele não modifica um perfil global do shell:

Terminal
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3-coder:30b

Para outros shells, prefira o inicializador acima ou a configuração específica do shell no manual oficial atual. Inspecione ajustes existentes do Claude Code que possam substituir as variáveis do comando. Não imprima nenhuma credencial preexistente ao verificar. O retorno efetivo esperado é a tag local escolhida e http://localhost:11434; é uma verificação para o leitor, não um resultado observado pela BIG CHANGE. O servidor local ignora o token de exemplo ollama; ele não é um segredo de controle de acesso. A rota local documentada não exige chave cloud do Ollama ou chave de inferência da Anthropic. Os termos do software Claude Code e dos serviços conectados continuam aplicáveis.

Mantenha o servidor vinculado localmente conforme as orientações de configuração do servidor Ollama. Uma tag :cloud ou URL base https://ollama.com é uma rota cloud com outra decisão de dados e custos. Pause antes de enviar conteúdo do repositório se o modelo ou destino não estiver claro.

4. Verifique a rota e peça uma edição

Antes de autorizar mudanças em arquivos, inspecione o modelo e a conexão efetivos do Claude Code com /status quando disponível. Compare o retorno com o inicializador ou endpoint manual, ollama list e, depois que uma solicitação carregar o modelo, ollama ps. Registre a tag exata carregada, o valor alocado de CONTEXT e PROCESSOR; uma divisão com CPU pode mudar a viabilidade prática. Quando houver, inspecione também evidências de solicitações do servidor local. Essas verificações estabelecem configuração e carregamento, não uma auditoria de todo o tráfego de rede. Revise separadamente ferramentas MCP, busca e leitura web, telemetria e ajustes cloud se o processamento local importar para sua política de código.

Use as solicitações normais de aprovação do Claude Code e seus controles de permissão. Peça a única tarefa do repositório autorizado em linguagem comum: comportamento necessário, escopo permitido, comando original de aceitação e ponto de parada. Peça os arquivos alterados e a saída das verificações. Mantenha commit, push e publicação sob decisão do proprietário e recuse ações de rede ou ferramenta inesperadas. A alegação do modelo de que usou o endpoint local ou passou em uma verificação não é confirmação.

5. Decida pelo diff completo e pela verificação original

Inspecione cada arquivo modificado e o diff completo do Git, incluindo mudanças fora do escopo. Compare a alteração com o comportamento original e a política do repositório, incluindo a licença de novas dependências. Execute você mesmo o comando de aceitação registrado após a edição. Registre o status de saída e o resultado relevante ao lado da base. Aceite apenas se o diff corresponder ao pedido, a verificação independente for aceitável e a evidência de roteamento e permissões atender aos requisitos. Caso contrário, deixe a branch sem aceitar e guarde a falha exata para revisão.

Se o Ollama não responder, confira o aplicativo ou serviço ativo e ollama list antes da tarefa. Se o modelo não carregar ou ollama ps indicar contexto insuficiente, confira memória e ajuste de contexto; reduza a tarefa ou use um modelo local adequado. Se /status ou os ajustes efetivos mostrarem um provedor hospedado, pare antes de enviar código e repare o shell atual ou as configurações do Claude Code. Um erro de ferramenta pode vir da compatibilidade do modelo ou de permissão negada; veja a resposta exata antes de mudar qualquer um. Se uma tentativa já editou arquivos, veja o diff antes de reverter ou continuar. Após falha na aceitação, diagnostique o código e repita a verificação somente depois de uma correção revisada.

A inferência local evita a cobrança por token do provedor para o modelo baixado, mas usa hardware, armazenamento e eletricidade. Downloads, telemetria, ferramentas web, integrações MCP ou ajustes de modelo cloud podem enviar dados ou gerar outros custos. O Ollama oferece suporte a um subconjunto da API Messages da Anthropic, com limites de contagem de tokens, cache de prompts, lotes, citações, PDFs e escolha forçada de ferramenta; os modelos também variam em capacidade de uso de ferramentas. A revisão documental da BIG CHANGE não mediu velocidade, qualidade, privacidade ou economia. Para outra configuração de agente local, veja nosso guia de Junie Local; este procedimento mantém especificamente o Claude Code e confere sua rota Ollama.

Fontes e leituras adicionais

  • Ollama, “Claude Code” fornece inicializador atual, ajustes locais manuais e alternativa cloud. Documenta uma rota, não uma execução bem-sucedida no repositório do leitor.
  • Ollama, “Compatibilidade com Anthropic” descreve endpoint local, token de exemplo ignorado, download do modelo e limites da API. Compatibilidade não certifica todo modelo ou chamada de ferramenta.
  • Ollama, “Comprimento de contexto” explica a recomendação de 64k para programação, o equilíbrio de memória e a leitura de ollama ps. A máquina real determina a alocação possível.
  • A ficha qwen3-coder:30b do Ollama lista o arquivo de exemplo, as ferramentas e a licença Apache 2.0 vinculada. Confira a ficha exata antes de baixar ou redistribuir.
  • Instalação do Claude Code e ajustes de permissão descrevem acesso e aprovações de ferramentas. Nenhum comprova o endpoint efetivo de uma sessão ou um resultado seguro no repositório.
  • Anthropic, “Outros gateways de LLM” informa que a Anthropic não oferece suporte ao roteamento do Claude Code para modelos não Claude por um gateway. O Ollama documenta separadamente a integração local descrita aqui.