Use o DeepSeek no Claude Code: configuração da API Anthropic
Aponte o Claude Code para o endpoint do DeepSeek compatível com Anthropic — um bloco de variáveis de ambiente mapeia Opus, Sonnet e Haiku para deepseek-v4-pro ou flash, e cada requisição é cobrada pelos preços da API do DeepSeek.
A versão curta
- O DeepSeek expõe um endpoint compatível com Anthropic, então o Claude Code fala direto com ele — sem ferramenta de proxy.
- A troca inteira é um bloco de ambiente: ANTHROPIC_BASE_URL mais ANTHROPIC_AUTH_TOKEN e os mapeamentos por modelo.
- Mapeie os modelos alias com intenção: os slots de Opus e Sonnet para o deepseek-v4-pro, os de Haiku e subagentes para o deepseek-v4-flash.
- A cobrança passa para a API de pagamento por uso do DeepSeek — a sessão de demonstração do vídeo construiu e testou um app completo por centavos, com o gasto acompanhado no painel da plataforma.
DeepSeek v4 Pro on Claude Code - Full Setup Tutorial
Canal: Prince does AI8:08
Use Claude Code with ANY AI Model GPT, Gemini, DeepSeek
Canal: AyyazTech17:00
Anthropic-compatible API — official DeepSeek documentation
Documentação: api-docs.deepseek.com
Os screenshots vêm do walkthrough de configuração do Prince does AI — uma gravação de tela cheia e limpa. A comparação com o router segue o tour de qualquer modelo do AyyazTech, e os fatos do endpoint vêm da documentação da própria API do DeepSeek.
Os frames pertencem aos respectivos criadores e são creditados aqui com deep links para os momentos exatos; o texto é nosso.
De npm install a um app rodando no DeepSeek
Parte 1 · Instale e configure
- 1
Instale o Claude Code e verifique
Instale a CLI com npm e rode claude --version — o walkthrough mostra um 2.1.89 estampado. O único pré-requisito é o Node.js, e a mesma instalação funciona no macOS, Linux e Windows.
O cheque de versão confirmando o Claude Code 2.1.89 instalado.Ver em 0:46 - 2
Consiga uma chave de API do DeepSeek
Entre em platform.deepseek.com, recarregue um valor pequeno na página Billing, abra API keys na barra lateral e crie uma chave nova. Copie na hora — a plataforma só mostra uma vez.
O console da plataforma do DeepSeek com API keys na barra lateral.Ver em 0:49 - 3
Ajuste o bloco de variáveis de ambiente
No PowerShell, ponha ANTHROPIC_BASE_URL no endpoint Anthropic do DeepSeek e ANTHROPIC_AUTH_TOKEN na sua chave, depois mapeie os slots de modelo: ANTHROPIC_MODEL e os padrões de OPUS e SONNET para deepseek-v4-pro, o padrão de HAIKU e CLAUDE_CODE_SUBAGENT_MODEL para deepseek-v4-flash. Cole o bloco inteiro de uma vez e dê enter.
O bloco de ambiente: endpoint, token e mapeamentos de modelo.Ver em 1:35
Parte 2 · Decole no DeepSeek
- 4
Inicie o Claude Code
Digite claude na mesma janela do PowerShell e aceite o aviso de confiança da pasta. Variáveis definidas com o prefixo env só vivem naquela janela — relançar depois significa colar o bloco de novo, a menos que você o persista no seu perfil.
Iniciando o Claude Code pela janela do PowerShell já configurada.Ver em 2:05 - 5
Confirme o selo de cobrança por API
A tela de boas-vindas mostra um selo de API Usage Billing em vez do nome de um plano — esse é o sinal de que o endpoint do DeepSeek está vivo. A linha do modelo pode exibir Opus com contexto 1M: é o nome mapeado; quem responde é o deepseek-v4-pro.
A tela de boas-vindas mostrando Opus 4.6 com API Usage Billing.Ver em 2:25 - 6
Rode seu primeiro prompt
O walkthrough inicia com as permissões puladas para uma demonstração sem interrupções; sem essa flag, o Claude Code pergunta antes de cada edição como sempre. Comece com uma pergunta de raciocínio para checar a tubulação.
Início com permissões puladas para a sessão de demonstração.Ver em 2:50 - 7
Faça o teste de sanidade das respostas
A demonstração faz uma pequena pergunta de lógica — vou a pé ou de carro até o lava rápido — e recebe a resposta certa com o raciocínio anexado. Dez segundos aqui poupam dez minutos de depuração depois.
O teste do lava rápido respondido corretamente via DeepSeek.Ver em 3:18
Parte 3 · Deixe-o provar do que é capaz
- 8
Dê a ele um build de verdade
Peça algo substancial — a demonstração pede um app Electron impressionante e deixa o modelo planejar primeiro. O fluxo de planejar e depois construir funciona igual no DeepSeek: aprove o plano e veja os passos sendo marcados.
O modelo planejando o ClipMaster, um gerenciador de área de transferência.Ver em 4:22 - 9
Deixe terminar e abra o app
O Claude Code levanta o esqueleto, escreve o código e inicia o resultado — o ClipMaster da demonstração monitora a área de transferência, mantém histórico e registra atalhos globais. Tudo o que se espera de um ciclo planejar-aprovar-construir.
O app ClipMaster pronto com sua lista de recursos.Ver em 5:25 - 10
Teste o resultado como usuário
Copie algumas coisas em qualquer lugar do seu sistema e veja aparecer no histórico do app gerado. Testar vale mais que confiar — a demonstração copia de um segundo monitor para provar que a captura é real.
Itens copiados pousando no histórico ao vivo do ClipMaster.Ver em 5:55 - 11
Confira quanto custou
De volta à plataforma do DeepSeek, a página Usage mostra requisições, tokens e gastos da sessão. A manchete do criador: cerca de dois milhões de tokens por oito centavos. Seus números caem no mesmo painel quase em tempo real.
O painel de uso depois da sessão completa de construção e testes.Ver em 7:00
Endpoint direto ou claude-code-router?
Há dois caminhos para rodar o Claude Code no DeepSeek. Este guia usa o endpoint direto compatível com Anthropic; a ferramenta router é o outro caminho.
- 1Endpoint direto, este guia: zero ferramentas extras — só variáveis de ambiente, e o Claude Code fala direto com o api.deepseek.com.
- 2claude-code-router: um proxy local que soma troca de modelo no meio da sessão e roteamento multi-fornecedor, ao custo de instalar e configurar mais um serviço.
- 3Escolha o direto quando o DeepSeek é seu cavalinho diário; escolha o router quando você malabareza vários fornecedores ou troca de modelo por tarefa.
- 4Nos dois casos a experiência do Claude Code é a mesma — planos, ferramentas e permissões se comportam igual; só a cobrança e o modelo por trás do alias mudam.
Nosso tutorial do Claude Code router percorre o caminho do proxy passo a passo, incluindo a própria configuração dele para o DeepSeek.
Quando o setup se comporta mal
Quase toda falha aqui é uma variável de ambiente ou uma janela velha. Percorra esta lista antes de mexer em qualquer outra coisa.
- 1Ainda cobra pelo seu plano do Claude: a tela de boas-vindas mostra um nome de plano em vez de API Usage Billing — o bloco de env foi definido em outra janela de terminal. Rode de novo onde você lança o claude.
- 2Erros de autenticação: o token foi colado com aspas ou espaços, ou a chave está sem saldo. Crie uma chave nova, recarregue e defina o ANTHROPIC_AUTH_TOKEN de novo.
- 3Erros de modelo citando uso de ferramentas: snapshots antigos do DeepSeek lidavam mal com algumas chamadas de ferramenta — mantenha deepseek-v4-pro nos slots principais e flash para subagentes, como no passo 3.
- 4Parece que outro modelo responde: lembre do alias. A UI diz Opus ou Sonnet enquanto seus mapeamentos decidem o modelo real — confira o ANTHROPIC_MODEL primeiro, não o rótulo.
- 5A configuração se perde entre sessões: variáveis de ambiente do PowerShell morrem com a janela. Persista o bloco no seu perfil de shell, ou embrulhe num script pequeno que você roda antes de codar.
Para voltar à cobrança do Anthropic, limpe as variáveis — remove-env ANTHROPIC_BASE_URL e companhia na mesma janela — e reinicie o Claude Code.