Use o Claude Code com DeepSeek, Ollama ou outros modelos

Aponte o Claude Code para o endpoint compatível com Anthropic de um fornecedor com ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN, e informe os modelos do fornecedor em ANTHROPIC_MODEL e nas variáveis ANTHROPIC_DEFAULT_*_MODEL. Funciona, mas a Anthropic não dá suporte a isso, uma sessão fala com um único fornecedor e recursos como o cache de prompt podem ser ignorados sem aviso.

Atualizado em

Como funciona

O Claude Code envia toda requisição no formato Messages da Anthropic para o endereço definido em ANTHROPIC_BASE_URL. Um fornecedor que sirva esse formato pode substituir a Anthropic, e o Claude Code não percebe a diferença até que uma requisição use algo que o fornecedor não implementou. A documentação de gateways da Anthropic é explícita ao dizer que isso não tem suporte: ela “não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de nenhum gateway”.

Endpoints que funcionam com ele

FornecedorANTHROPIC_BASE_URLObservações
DeepSeekhttps://api.deepseek.com/anthropicGuia oficial. Nomes claude-opus* vão para o V4 Pro, todo o resto para o V4 Flash
Ollama (local)http://localhost:11434Integração oficial a partir do Ollama 0.14; ollama launch claude faz a configuração
Kimi (Moonshot)https://api.moonshot.ai/anthropicGuia oficial; kimi-k2.7-code precisa do thinking ativado
Z.ai GLMhttps://api.z.ai/api/anthropicGuia oficial
Alibaba Coding Planhttps://coding-intl.dashscope.aliyuncs.com/apps/anthropicGuia oficial; os endpoints de pague pelo uso são por região
OpenRouterhttps://openrouter.ai/apiSó é garantido com a Anthropic como provedor upstream; defina ANTHROPIC_API_KEY como string vazia
LM Studio (local)http://localhost:1234Página de integração oficial

Exemplo: DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
claude

Esses são os valores da própria página do DeepSeek sobre o Claude Code. Defina todos os níveis, não só ANTHROPIC_MODEL: um nível sem definição continua enviando um nome de modelo Claude, que o endpoint não conhece, e as tarefas em segundo plano e os subagentes que o usam falham.

Exemplo: um modelo local com o Ollama

ollama launch claude

Isso configura o Claude Code para você. À mão, são três variáveis e um modelo que suporte chamadas de ferramentas:

export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
claude --model qwen3.5

O Ollama recomenda uma janela de contexto de 64K tokens ou mais para repositórios maiores; um agente de programação reenvia a conversa a cada turno, e uma janela pequena enche rápido.

O que quebra

  • Marcadores de cache de prompt. O DeepSeek e o Ollama ignoram o cache_control da Anthropic, e o Kimi só o respeita no nível superior. Nenhum erro aparece; se você ainda paga o preço de cache depende do cache do próprio fornecedor.
  • Troca de fornecedor. O Claude Code lê um único ANTHROPIC_BASE_URL, então passar do DeepSeek para o Claude exige reiniciar com outras configurações, não um comando /model.
  • Busca na web. A ferramenta WebSearch do Claude Code roda nos servidores da Anthropic. O DeepSeek diz que seu endpoint dá suporte a ela; o Ollama diz que a busca na web hospedada não tem suporte completo.
  • Campos de requisição desconhecidos. O Claude Code trata um nome de modelo não reconhecido como um modelo Claude atual e envia campos de thinking e effort que alguns endpoints rejeitam com um 400. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 remove os campos beta, ao custo da busca de ferramentas MCP.
  • Recursos da conta. O Remote Control e o ditado por voz ficam indisponíveis enquanto uma credencial de gateway estiver definida.
  • Credenciais antigas. Uma ANTHROPIC_API_KEY esquecida, um login salvo ou valores antigos de env em settings.json podem sobrescrever a configuração; o /status mostra qual está em uso.

Quando um agente independente do modelo é melhor

Se você quer um fornecedor por vez e já trabalha no Claude Code, as configurações acima bastam. Se você quer Claude, DeepSeek e um modelo local dentro da mesma tarefa, o OHarness faz isso nativamente: cada provedor é integrado, a conversa é guardada em formato neutro em relação ao fornecedor e o /model troca entre fornecedores sem reiniciar. OHarness vs. Claude Code compara os dois diretamente.

npm install -g oharness
oharness -m deepseek/deepseek-v4-flash

Depois, no meio da sessão, use /model anthropic/claude-sonnet-5 na etapa que precisar dele, e volte em seguida.

Fontes

Perguntas frequentes

O Claude Code pode usar modelos do DeepSeek?

Sim, de forma não oficial. O DeepSeek oferece um endpoint compatível com Anthropic em https://api.deepseek.com/anthropic: defina ANTHROPIC_BASE_URL com ele, ANTHROPIC_AUTH_TOKEN com uma chave de API do DeepSeek e as variáveis de modelo com os nomes de modelo do DeepSeek. A Anthropic não dá suporte a modelos que não sejam Claude no Claude Code.

O Claude Code pode rodar um modelo local com o Ollama?

Sim. O Ollama 0.14 e posteriores servem o formato Anthropic Messages, e `ollama launch claude` configura o Claude Code para usá-lo. Escolha um modelo que suporte chamadas de ferramentas e dê a ele uma janela de contexto de 64K tokens ou mais.

O Claude Code consegue alternar entre Claude e DeepSeek na mesma sessão?

Não. O Claude Code lê um único ANTHROPIC_BASE_URL, então uma sessão do Claude Code fala com um único fornecedor. O OHarness alterna entre Anthropic, DeepSeek, OpenAI, Gemini e modelos locais no meio da sessão com /model.

Por que o Claude Code retorna erros 400 com o endpoint de outro fornecedor?

O Claude Code assume que um modelo não reconhecido é um modelo Claude atual e envia campos como adaptive thinking e effort, que alguns endpoints rejeitam. Definir todas as variáveis ANTHROPIC_DEFAULT_*_MODEL com os nomes do fornecedor, e CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, elimina a maioria deles.

Relacionados