Como usar os modelos da DeepSeek no Claude Code

Como configurar o Claude Code com a DeepSeek

1. Pegue uma chave de API da DeepSeek

   Crie uma em platform.deepseek.com, em API keys, e adicione saldo à conta; o uso é cobrado por token.

2. Instale o Claude Code, se ainda não tiver

   O guia da DeepSeek instala com npm: Node.js 18 ou mais recente, Git for Windows no Windows, depois npm install -g @anthropic-ai/claude-code e claude --version para conferir.

3. Defina as variáveis de ambiente (macOS e Linux)

   Elas apontam o Claude Code para o endpoint compatível com a Anthropic da DeepSeek, usam deepseek-flash com contexto de 1M para o modelo principal e os subagentes, e aumentam o nível de esforço e a janela de compactação automática. Coloque-as no perfil do seu shell para mantê-las.

   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
   export CLAUDE_CODE_EFFORT_LEVEL=max
   export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

4. Ou no Windows (PowerShell)

   As mesmas configurações como variáveis de ambiente do PowerShell para a sessão atual.

   $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
   $env:ANTHROPIC_AUTH_TOKEN="<your DeepSeek API Key>"
   $env:ANTHROPIC_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_EFFORT_LEVEL="max"
   $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

5. Inicie o Claude Code no seu projeto

   Entre no projeto com cd e rode claude. Todo o resto, como CLAUDE.md, skills, hooks e servidores MCP, é configurado normalmente.

Fonte: documentação da API da DeepSeek, Integrate with Claude Code

Como os nomes de modelos do Claude são mapeados para modelos da DeepSeek

Quando o Claude Code (ou o app desktop do Claude) envia um nome de modelo do Claude para o endpoint da DeepSeek, a DeepSeek faz este mapeamento. É por isso que a configuração acima define todas as variáveis de modelo como deepseek-flash: do contrário, tudo o que pedir Opus é cobrado com preços do V4 Pro.

Quanto custa

Preços da API da DeepSeek em dólares americanos por milhão de tokens em 6 de novembro de 2026. As tarifas fora do pico (fora das 01:00–04:00 e 06:00–10:00 UTC em dias úteis) são metade das de pico. A busca na web do Claude Code também funciona com a API da DeepSeek, mas cada busca adiciona tokens do modelo para resumir os resultados e é cobrada pela Search API da DeepSeek.

Usando a DeepSeek no Codex

A DeepSeek também suporta o Codex, pela Responses API. O guia oferece um script de configuração que faz backup de ~/.codex/config.toml, grava um catálogo ~/.codex/models.json com deepseek-flash e deepseek-v4-pro e adiciona um provedor DeepSeek; uma única configuração passa a valer para a CLI do Codex, o app desktop do ChatGPT e a extensão do VS Code. Leia o script antes de rodá-lo, ou siga os passos manuais do mesmo guia. O script desativa a busca na web integrada, que só está disponível com deepseek-v4-pro. Para os arquivos de instruções do próprio Codex, veja o guia do AGENTS.md no Codex.

Claude Code com DeepSeek vs DeepSeek Harness

• Claude Code com DeepSeek: você mantém a interface e os hábitos do Claude Code, incluindo CLAUDE.md, skills, hooks e plugins, e paga os preços por token da DeepSeek em vez de um plano do Claude.
• DeepSeek Harness: o app de agentes open source da própria DeepSeek, construído em torno de plugins, com app desktop e interface web; ele também pode rodar o Claude Code ou o Codex como subagentes. Veja o guia do DeepSeek Harness.
• Nos dois casos, os modelos são os mesmos deepseek-flash e deepseek-v4-pro, cobrados pela DeepSeek.
• Para voltar aos modelos da Anthropic, remova as variáveis (ou abra um shell novo sem elas) e entre no Claude Code normalmente.

Modelos baratos, trabalhando o dia todo

Rodar o Claude Code ou o DeepSeek Harness com os preços da DeepSeek torna viável manter os agentes ocupados. O Crewmark transforma essas sessões em funcionários de IA com um cargo, uma meta e um horário de trabalho, e acorda cada um com um heartbeat para pegar a próxima issue de um quadro.

1. Use a configuração que você já tem

   Um funcionário roda em uma sessão do Claude Code, do Codex, do DeepSeek Harness ou do OpenCode na sua máquina, com o seu ambiente e as suas chaves.

2. Deixe o heartbeat iniciar o trabalho

   Durante o horário de trabalho, ele acorda a cada 15, 30 ou 60 minutos na mesma conversa e pega a próxima issue; veja como tornar o Claude Code proativo.

3. Mantenha a conta sob controle

   O horário de trabalho e uma issue por vez deixam o uso previsível; veja como reduzir o uso de tokens do Claude Code.

Perguntas frequentes sobre Claude Code com DeepSeek