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
| Fornecedor | ANTHROPIC_BASE_URL | Observações |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic | Guia oficial. Nomes claude-opus* vão para o V4 Pro, todo o resto para o V4 Flash |
| Ollama (local) | http://localhost:11434 | Integração oficial a partir do Ollama 0.14; ollama launch claude faz a configuração |
| Kimi (Moonshot) | https://api.moonshot.ai/anthropic | Guia oficial; kimi-k2.7-code precisa do thinking ativado |
| Z.ai GLM | https://api.z.ai/api/anthropic | Guia oficial |
| Alibaba Coding Plan | https://coding-intl.dashscope.aliyuncs.com/apps/anthropic | Guia oficial; os endpoints de pague pelo uso são por região |
| OpenRouter | https://openrouter.ai/api | Só é garantido com a Anthropic como provedor upstream; defina ANTHROPIC_API_KEY como string vazia |
| LM Studio (local) | http://localhost:1234 | Pá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
claudeEsses 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 claudeIsso 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.5O 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_controlda 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=1remove 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_KEYesquecida, um login salvo ou valores antigos deenvemsettings.jsonpodem sobrescrever a configuração; o/statusmostra 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 oharnessoharness -m deepseek/deepseek-v4-flashDepois, no meio da sessão, use /model anthropic/claude-sonnet-5 na etapa que precisar dele, e volte em seguida.
Fontes
- Anthropic: gateways de LLM e variáveis de ambiente
- DeepSeek: Claude Code e compatibilidade com a API da Anthropic
- Ollama: Claude Code e compatibilidade com a Anthropic
- Kimi: Claude Code, Z.ai: Claude Code, Alibaba Model Studio: Claude Code
- OpenRouter: Claude Code, LM Studio: Claude Code
- Verificado em 2026-09-25. Os fornecedores mudam esses endpoints; as páginas deles são a referência.
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.