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 encaminhar o Claude Code para um modelo local do Ollama, verificar o endpoint e o contexto e rever uma alteração do repositório com a 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 num repositório autorizado através de um modelo servido pelo Ollama no seu computador. A atual [integração do Ollama com Claude Code](https://docs.ollama.com/integrations/claude-code) liga diretamente à API compatível com Anthropic. Este guia acompanha uma alteração limitada desde uma base registada até à decisão humana sobre o diff. Destina-se a um programador autorizado a instalar ambas as ferramentas, permitir 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 executámos o modelo nem testámos um repositório.

## A grande mudança

- **O que mudou:** O Ollama documenta agora um percurso direto do Claude Code ao servidor local compatível com Anthropic, por um iniciador ou definições explícitas do endpoint local. Esta configuração documentada não exige um proxy separado.
- **Porque importa:** Pode manter o fluxo do Claude Code, escolher um modelo local, verificar a atribuição real de contexto e rever uma edição real do repositório face à verificação de aceitação original.
- **O que acompanhar:** Uma etiqueta local selecionada e um modelo em execução não provam que todos os pedidos ficaram locais nem que o código esteja correto. Verifique o encaminhamento efetivo, os acessos das ferramentas, o diff completo e o resultado antes de aceitar.

### 1. Registe o ponto de partida do repositório

Trabalhe num repositório Git próprio ou autorizado. Utilize um ramo que possa ser revisto ou uma cópia de trabalho descartável. Defina um pequeno comportamento ou defeito a alterar, os ficheiros permitidos e uma condição de paragem. Encontre o comando de aceitação existente, como o teste ou a compilação documentados; não o substitua por um comando genérico. Execute-o **antes** de qualquer edição do agente e registe o comando, o estado de saída e o resultado relevante. Registe também o ramo, `git status` e qualquer diff existente. As alterações 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 ficheiros e executar comandos conforme as permissões efetivas. Pedir «altere apenas estes ficheiros» orienta o agente, mas não limita o acesso ao sistema de ficheiros.

### 2. Instale um modelo local adequado e atribua 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, respeitando as regras do computador e da organização. Registe `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 do comando atual `ollama launch`.

Escolha um modelo cuja ficha atual indique suporte de ferramentas, cuja licença permita o uso e cujos pesos **e atribuição de contexto** caibam no computador. Um exemplo local concreto é [qwen3-coder:30b](https://ollama.com/library/qwen3-coder:30b), apresentado com ferramentas, um ficheiro Q4\_K\_M de cerca de 19 GB e Apache License 2.0. É o tamanho da transferência, não um requisito de RAM ou VRAM. O contexto anunciado não significa que o computador o consiga atribuir. Se não for adequado, escolha outra etiqueta local documentada com suporte de ferramentas e substitua-a de forma consistente nos comandos seguintes.

Num terminal, com a aplicação ou servidor local do Ollama em execução, transfira e confirme a etiqueta 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 refere que um contexto maior usa mais memória. Defina 64k ou mais nas **definições da aplicação Ollama existente**, se o equipamento o permitir. Se administrar o servidor, configure esse serviço existente com `OLLAMA_CONTEXT_LENGTH=64000` seguindo as [instruções do servidor específicas da plataforma](https://docs.ollama.com/context-length); não inicie outro servidor na porta 11434. Depois de um pedido carregar 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 atribuição pretendida não carregar. Não apresente o máximo do catálogo como contexto atribuído.

### 3. Encaminhe o Claude Code para o servidor local

Abra um terminal **no repositório escolhido**. O Ollama documenta este iniciador; use a mesma etiqueta local confirmada por `ollama list`:

```text
ollama launch claude --model qwen3-coder:30b
```

O Ollama documenta este percurso para um modelo diferente de Claude. [O manual de gateways da Anthropic](https://code.claude.com/docs/en/llm-gateway) indica que a Anthropic não presta suporte ao encaminhamento do Claude Code para modelos não Claude através de um gateway. Trate-o como uma integração documentada pelo Ollama sem suporte da Anthropic para esse encaminhamento e confirme a sessão real antes de depender dela.

Para a configuração manual, as [instruções de integração do Ollama](https://docs.ollama.com/integrations/claude-code#manual-setup) utilizam `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; não altera um perfil global da shell:

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

Para outras shells, prefira o iniciador acima ou a configuração atual específica da shell no manual oficial. Inspecione definições existentes do Claude Code que possam substituir as variáveis do comando. Não apresente credenciais preexistentes durante a verificação. Os valores efetivos esperados são a etiqueta local escolhida e `http://localhost:11434`; é uma verificação a fazer pelo leitor, não um resultado observado pela BIG CHANGE. O servidor local ignora o token de exemplo `ollama`; não é um segredo de controlo de acesso. O percurso local documentado não exige chave cloud do Ollama ou chave de inferência da Anthropic. Continuam a aplicar-se as condições do software Claude Code e dos serviços ligados.

Mantenha o servidor associado localmente segundo as [orientações de configuração do servidor Ollama](https://docs.ollama.com/faq). Uma etiqueta `:cloud` ou URL base `https://ollama.com` é um percurso cloud com outra decisão sobre dados e custos. Suspenda o envio de conteúdo do repositório se o modelo ou destino não estiver claro.

### 4. Verifique o percurso e peça uma edição

Antes de permitir alterações a ficheiros, inspecione o modelo e a ligação efetivos do Claude Code com `/status` quando disponível. Compare essa informação com o iniciador ou endpoint manual, `ollama list` e, depois de um pedido carregar o modelo, `ollama ps`. Registe a etiqueta exata carregada, o valor atribuído de `CONTEXT` e `PROCESSOR`; uma distribuição por CPU pode alterar a viabilidade prática. Quando houver, veja também a evidência de pedidos do servidor local. Estas verificações estabelecem configuração e carregamento, não uma auditoria a todo o tráfego de rede. Reveja separadamente ferramentas MCP, pesquisa e leitura web, telemetria e definições cloud se o tratamento local importar para a política de código.

Use os pedidos normais de aprovação do Claude Code e os seus [controlos de permissões](https://code.claude.com/docs/en/permissions). Peça a tarefa única do repositório autorizado em linguagem corrente: comportamento necessário, âmbito permitido, comando original de aceitação e ponto de paragem. Peça os ficheiros alterados e os resultados das verificações. Deixe commit, push e publicação ao proprietário e recuse ações de rede ou ferramentas inesperadas. A afirmação do modelo de que usou o endpoint local ou passou numa verificação não é confirmação.

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

Examine cada ficheiro modificado e o **diff completo do Git**, incluindo alterações fora do âmbito pedido. Compare a mudança com o comportamento original e a política do repositório, incluindo a licença de novas dependências. Execute pessoalmente o comando de aceitação registado após a edição. Anote estado de saída e resultado relevante junto da base. Aceite apenas se o diff corresponder ao pedido, a verificação independente for aceitável e a evidência de encaminhamento e permissões cumprir os requisitos. Caso contrário, deixe o ramo por aceitar e guarde a falha exata para revisão.

Se o Ollama não responder, verifique a aplicação ou serviço ativo e `ollama list` antes da tarefa. Se o modelo não carregar ou `ollama ps` indicar contexto insuficiente, veja a memória e a definição de contexto; reduza a tarefa ou escolha um modelo local adequado. Se `/status` ou as definições efetivas mostrarem um fornecedor alojado, pare antes de enviar código e corrija a shell atual ou as definições do Claude Code. Um erro de ferramenta pode resultar de incompatibilidade do modelo ou permissão recusada; leia a resposta exata antes de alterar qualquer um. Se uma tentativa já editou ficheiros, veja o diff antes de reverter ou continuar. Após uma falha na aceitação, diagnostique o código e repita a verificação apenas depois de uma correção revista.

A inferência local evita a cobrança por token do fornecedor para o modelo transferido, mas utiliza equipamento, armazenamento e eletricidade. Transferências, telemetria, ferramentas web, integrações MCP ou definições de modelos cloud podem enviar dados ou gerar outros custos. O Ollama suporta um [subconjunto da API Messages da Anthropic](https://docs.ollama.com/api/anthropic-compatibility), com limites na contagem de tokens, cache de instruções, lotes, citações, PDFs e escolha forçada de ferramenta; a capacidade de ferramentas também varia por modelo. A análise documental da BIG CHANGE não mediu velocidade, qualidade, privacidade ou poupanças. Para outra configuração de agente local, consulte o nosso [guia de Junie Local](https://bigchange.ai/blog/junie-local-windows-coding-agent-setup); este procedimento mantém especificamente o Claude Code e verifica o seu percurso Ollama.

## Fontes e leituras adicionais

- [Ollama, «Claude Code»](https://docs.ollama.com/integrations/claude-code) apresenta o iniciador atual, definições locais manuais e alternativa cloud. Documenta um percurso, não uma execução bem-sucedida no repositório do leitor.
- [Ollama, «Compatibilidade com Anthropic»](https://docs.ollama.com/api/anthropic-compatibility) descreve o endpoint local, token de exemplo ignorado, transferência do modelo e limites da API. A compatibilidade não certifica cada modelo ou chamada de ferramenta.
- [Ollama, «Comprimento do 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`. O computador real determina a atribuição viável.
- [A ficha qwen3-coder:30b do Ollama](https://ollama.com/library/qwen3-coder:30b) apresenta o ficheiro de exemplo, ferramentas e licença Apache 2.0 ligada. Verifique a ficha exata antes de transferir ou redistribuir.
- [Instalação do Claude Code](https://code.claude.com/docs/en/setup) e [definições de permissões](https://code.claude.com/docs/en/permissions) descrevem o acesso e as aprovações de ferramentas. Nenhuma comprova o endpoint efetivo de uma sessão ou um resultado seguro no repositório.
- [Anthropic, «Outros gateways LLM»](https://code.claude.com/docs/en/llm-gateway) indica que a Anthropic não presta suporte ao encaminhamento do Claude Code para modelos não Claude através de 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 iniciador e do endpoint local manual, além do percurso cloud separado. 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, transferência do modelo e funções não suportadas. A compatibilidade varia com o modelo e a ferramenta.
- [Comprimento do 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; não certifica a capacidade de um computador específico.
- [qwen3-coder:30b — Biblioteca de modelos Ollama](https://ollama.com/library/qwen3-coder:30b) — Etiqueta local exata do exemplo, ferramentas, ficheiro Q4_K_M de cerca de 19 GB e ligação Apache 2.0; o tamanho da transferência não é a 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 verificar as 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 iniciador atual.
- [Configuração avançada — Claude Code Docs](https://code.claude.com/docs/en/setup) — Instalação oficial e requisitos da plataforma; não foi instalada ou executada uma instância do Claude Code para esta 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 corrente não é um sandbox.
- [Outros gateways LLM — Claude Code Docs](https://code.claude.com/docs/en/llm-gateway) — A Anthropic não presta suporte ao encaminhamento do Claude Code para modelos não Claude através de um gateway. É a fronteira de suporte do fornecedor, a par da integração local documentada pelo Ollama, não uma conclusão jurídica.