Material prático · vídeo “O seu Claude Code sem internet”

O seu Claude Code sem internet: passo a passo

Aqui estão os comandos para usar o Claude Code com um modelo aberto no seu computador, depois de instalar as ferramentas e baixar o modelo.

Ir para os comandos ↓
01 / Entenda a troca

O programa continua sendo o Claude Code

O Claude Code é a interface que lê o projeto, conversa com você e chama ferramentas. Quem gera as respostas nesta configuração é o Qwen 3.5 9B, servido pelo Ollama no seu computador. O Ollama oferece uma API compatível com parte da API da Anthropic em http://localhost:11434.

A internet é necessária para instalar o Ollama e o Claude Code e baixar o modelo. Depois, você pode usar o modelo local sem conexão, dentro dos limites descritos abaixo.

02 / Antes de começar

O que você precisa

  • Ollama instalado ↗ e Claude Code instalado ↗.
  • Um modelo com suporte a chamadas de ferramentas. O exemplo usa qwen3.5:9b.
  • Janela de contexto de pelo menos 64k tokens. O padrão do Ollama é 4.096; configure 65.536 antes de iniciar o servidor.

Os comandos abaixo usam sintaxe de shell de macOS, Linux ou WSL. Se o Ollama já estiver rodando como aplicativo ou serviço, pare essa instância antes de usar ollama serve; as variáveis precisam estar no processo que inicia o servidor.

03 / Passo a passo

Baixe, inicie e conecte

  1. 1. Baixe o modelo enquanto tem internet

    Baixar Qwen 3.5 9B
    ollama pull qwen3.5:9b
  2. 2. Inicie o Ollama com 64k de contexto

    Deixe este terminal aberto. Abra outro terminal para o próximo comando.

    Iniciar servidor local
    OLLAMA_CONTEXT_LENGTH=65536 ollama serve
  3. 3. Abra o Claude Code pelo Ollama

    Conectar Claude Code
    ollama launch claude --model qwen3.5:9b

Alternativa: conexão manual

Use este comando no lugar do passo 3 se preferir configurar o endpoint diretamente. ollama é apenas o valor de autenticação exigido pelo cliente local; o servidor Ollama não valida essa chave.

Conexão manual
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3.5:9b
04 / Confira se está local

Verifique o modelo em uso

Use a tag qwen3.5:9b, sem -cloud. Após enviar uma mensagem no Claude Code, rode o comando abaixo em outro terminal e confira se o modelo aparece carregado.

Ver modelos carregados
ollama ps

Para bloquear os recursos de nuvem do Ollama, inicie o servidor com esta variante no lugar do comando do passo 2. Reinicie o Ollama se alterar essa configuração.

Servidor sem recursos de nuvem
OLLAMA_NO_CLOUD=1 OLLAMA_CONTEXT_LENGTH=65536 ollama serve

Opcionalmente, no terminal em que abrirá o Claude Code, configure as variáveis abaixo antes do passo 3 para reduzir tráfego não essencial e desativar atualizações automáticas. Elas não substituem a escolha do modelo local nem bloqueiam ferramentas remotas.

Opcional · tráfego e atualizações
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export DISABLE_AUTOUPDATER=1
05 / Limites reais

O que muda sem internet

  • Quem pensa é o Qwen 3.5 9B, um modelo aberto com pesos sob Apache-2.0. Ele é menor e pode errar mais que um modelo Claude; revise comandos e alterações de código.
  • Velocidade, memória necessária e tamanho de contexto que funciona bem dependem do computador e do projeto.
  • Sem conexão, busca na web, WebFetch e MCPs remotos não funcionam. Ferramentas locais continuam dependendo das permissões e da configuração do Claude Code.
  • A API compatível do Ollama cobre apenas parte da API da Anthropic: não há prompt caching nem o endpoint count_tokens; controles de tool_choice para forçar ou desativar ferramentas não são suportados.
Para conferir

Fontes oficiais

Informações conferidas em 14/11/2026. Ferramentas e instruções externas podem mudar.

@brunopaim.dev

© 2026 Bruno Paim. Engenharia de software, IA e produtos digitais.