Edição em Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Faça uma alteração verificada no Claude Code com um modelo local do Ollama

> Um guia baseado na documentação para direcionar o Claude Code a um modelo local do Ollama, verificar endpoint e contexto e revisar uma alteração do repositório com sua verificação original.

By BIG CHANGE Editorial

Published: 2026-10-20T11:36:37.990Z
Updated: 2026-10-20T11:36:37.990Z
Canonical: https://bigchange.ai/blog/claude-code-local-ollama-checked-change-guide

![Conceptual charcoal illustration of an open desktop workstation showing its fan, memory modules, graphics card and internal cables.](https://bigchange.ai/api/media/file/local-model-workstation-open-chassis-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

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](https://docs.ollama.com/integrations/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](https://docs.ollama.com/quickstart) e [da CLI do Claude Code](https://code.claude.com/docs/en/setup) 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](https://ollama.com/library/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](https://docs.ollama.com/context-length) 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](https://docs.ollama.com/context-length); 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](https://code.claude.com/docs/en/llm-gateway) 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](https://docs.ollama.com/integrations/claude-code#manual-setup) 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:

```bash
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](https://docs.ollama.com/faq). 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](https://code.claude.com/docs/en/permissions). 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](https://docs.ollama.com/api/anthropic-compatibility), 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](https://bigchange.ai/blog/junie-local-windows-coding-agent-setup); este procedimento mantém especificamente o Claude Code e confere sua rota Ollama.

## Fontes e leituras adicionais

- [Ollama, “Claude Code”](https://docs.ollama.com/integrations/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”](https://docs.ollama.com/api/anthropic-compatibility) 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”](https://docs.ollama.com/context-length) 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](https://ollama.com/library/qwen3-coder:30b) 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](https://code.claude.com/docs/en/setup) e [ajustes de permissão](https://code.claude.com/docs/en/permissions) 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”](https://code.claude.com/docs/en/llm-gateway) 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.

## Sources

- [Claude Code — Ollama](https://docs.ollama.com/integrations/claude-code) — Instruções principais do inicializador e do endpoint local manual, além da rota cloud separada. Não provam que uma execução usou localhost.
- [Compatibilidade com Anthropic — Ollama](https://docs.ollama.com/api/anthropic-compatibility) — Endpoint Messages local, token de exemplo ignorado, download de modelos e funções não suportadas. A compatibilidade varia por modelo e ferramenta.
- [Comprimento de contexto — Ollama](https://docs.ollama.com/context-length) — Recomendação de 64k para programação, equilíbrio de memória e leitura de contexto/processador com ollama ps; nenhuma capacidade específica de máquina é certificada.
- [qwen3-coder:30b — Biblioteca de modelos Ollama](https://ollama.com/library/qwen3-coder:30b) — Tag local exata do exemplo, ferramentas, arquivo Q4_K_M de cerca de 19 GB e link Apache 2.0; tamanho de download não é memória de trabalho necessária.
- [Início rápido — Ollama](https://docs.ollama.com/quickstart) — Instalação e início oficiais; o leitor deve conferir instruções atuais da plataforma e a versão instalada.
- [Perguntas frequentes — Ollama](https://docs.ollama.com/faq) — Configuração do servidor local e fronteira de rede/cloud; não é uma auditoria completa de privacidade do Claude Code ou integrações.
- [Suporte a Claude Code — Ollama](https://ollama.com/blog/claude) — Data a compatibilidade Messages na v0.14.0; não estabelece a versão mínima do inicializador atual.
- [Configuração avançada — Claude Code Docs](https://code.claude.com/docs/en/setup) — Instalação oficial e requisitos da plataforma; nenhuma instância do Claude Code foi instalada ou executada para a reportagem.
- [Configurar permissões — Claude Code Docs](https://code.claude.com/docs/en/permissions) — Aprovações de ferramentas e permissões efetivas; uma instrução de caminho em linguagem comum não é um sandbox.
- [Outros gateways de LLM — Claude Code Docs](https://code.claude.com/docs/en/llm-gateway) — A Anthropic não oferece suporte ao roteamento do Claude Code para modelos não Claude por um gateway. Esse é o limite de suporte do fornecedor junto à integração local documentada pelo Ollama, não uma conclusão jurídica.