O DeepSeek V4 foi otimizado para o Claude Code. A CNBC noticiou isso no dia do lançamento. A documentação oficial confirma que os benchmarks de codificação agêntica do V4 são SOTA em código aberto. Mas existe uma lacuna entre "este modelo funciona com agentes" e "veja exatamente como configurá-lo." Este guia fecha essa lacuna — passo a passo, com comandos reais, abrangendo roteamento de modelos, extensão de capacidades e otimização de custos.
Por que DeepSeek V4 + Claude Code é uma combinação poderosa
O DeepSeek V4 Pro iguala o GPT-5.5 e o Claude Opus 4.7 em benchmarks de codificação agêntica a uma fração do custo: $0,28/1M tokens de entrada vs $5/1M para o GPT-5.5. Suporta uma janela de contexto de 1M tokens — suficiente para processar bases de código inteiras numa única passagem. Está licenciado sob Apache 2.0, o que significa que pode alojá-lo sem restrições de utilização. Para uma análise completa das capacidades e limitações do DeepSeek V4, consulte o nosso guia de capacidades do DeepSeek V4.
O Claude Code é o agente de codificação autónomo nativo de terminal da Anthropic. Lê o seu repositório, planeia alterações em múltiplas etapas, edita ficheiros, executa testes e itera sobre falhas. Suporta MCP (Model Context Protocol) nativamente, o que significa que pode expandi-lo com capacidades para além do código. Se é novo no Claude Code, comece com o nosso guia de instalação e a nossa comparação Claude Code vs Cursor.
A combinação é direta: o DeepSeek V4 trata do raciocínio e da geração de código. O Claude Code trata da execução do agente — lendo ficheiros, executando comandos, gerindo o Git. O AnyCap (ou servidores MCP) trata das capacidades multimodais — geração de imagens, vídeo, pesquisa na web, armazenamento, publicação.
Pré-requisitos
Antes de começar, confirme que tem:
- Acesso à API do DeepSeek V4 — via plataforma DeepSeek (api.deepseek.com), OpenRouter ou auto-alojado. Consulte o nosso guia do programador do DeepSeek V4 para opções de configuração.
- Claude Code instalado —
claude --versiondeve devolver um número de versão. Caso contrário:curl -fsSL https://claude.ai/install.sh | bash - Node.js 18+ — para o Claude Code e ferramentas baseadas em npm
- Uma chave de API ou chave do OpenRouter — para encaminhar o Claude Code pelo DeepSeek V4
Passo 1: Encaminhar o Claude Code pelo DeepSeek V4
O Claude Code utiliza por omissão os modelos Claude da Anthropic. Para utilizar o DeepSeek V4 como motor de raciocínio, é necessário encaminhar por um fornecedor de modelos que suporte tanto o protocolo de agente do Claude Code como a API do DeepSeek V4.
Opção A: OpenRouter (recomendado para configuração rápida)
O OpenRouter fornece acesso unificado via API aos modelos Anthropic e DeepSeek. Registe-se em openrouter.ai, obtenha uma chave de API e configure o Claude Code:
export OPENROUTER_API_KEY=sk-or-your-key-here
claude --model openrouter/deepseek/deepseek-v4-pro
Para a variante Flash (mais rápida e mais económica, a $0,14/1M tokens):
claude --model openrouter/deepseek/deepseek-v4-flash
Opção B: API direta do DeepSeek + endpoint personalizado
Se tiver acesso direto à API do DeepSeek, configure um endpoint personalizado. Nas definições do Claude Code ou no ambiente:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
export ANTHROPIC_API_KEY=sk-your-deepseek-key
claude --model deepseek-v4-pro
Nota: O encaminhamento direto via API pode ter diferenças de compatibilidade. Teste primeiro com um prompt simples: "Explique a arquitetura deste projeto em três frases."
Opção C: DeepSeek V4 auto-alojado
Se estiver a executar o DeepSeek V4 localmente (via llama.cpp, vLLM ou similar), aponte o Claude Code para o seu endpoint local:
export ANTHROPIC_BASE_URL=http://localhost:8000/v1
claude
O DeepSeek V4 Flash quantizado em 4 bits corre numa única GPU de consumidor. O V4 Pro requer mais VRAM, mas é viável em hardware de nível workstation.
Verificar o encaminhamento
Inicie uma sessão do Claude Code e confirme qual o modelo ativo:
> What model are you running on?
O Claude Code deve responder indicando que está a correr no DeepSeek V4 via a rota configurada.
Passo 2: Adicionar capacidades multimodais com o AnyCap
O DeepSeek V4 é um modelo apenas de texto. Não pode gerar imagens, criar vídeos, pesquisar na web, armazenar ficheiros ou publicar conteúdo. O Claude Code fornece a camada de execução do agente — lendo ficheiros, executando comandos, gerindo Git — mas também não adiciona estas capacidades.
O AnyCap preenche esta lacuna. Instale-o como uma skill MCP. Para um guia detalhado sobre as opções de configuração do MCP, consulte o nosso guia para adicionar capacidades ao Claude Code com MCP:
npx -y skills add anycap-ai/anycap -a claude-code
Autentique uma vez:
anycap login
O seu agente DeepSeek V4 + Claude Code pode agora:
| Capacidade | Comando na sessão do agente |
|---|---|
| Gerar imagens | anycap image generate "descrição" |
| Criar vídeos | anycap video generate "descrição" |
| Pesquisar na web | anycap search "consulta" |
| Armazenar ficheiros | anycap drive upload ./caminho |
| Publicar páginas | anycap page publish ./ficheiro.md |
Passo 3: Configurar o contexto do projeto
O Claude Code lê um ficheiro CLAUDE.md no início de cada sessão para contexto persistente do projeto. Crie um adaptado para a sua configuração do DeepSeek V4:
# CLAUDE.md
## Configuração do modelo
- A correr no DeepSeek V4 Pro via OpenRouter
- Janela de contexto de 1M tokens disponível
- Modelo apenas de texto — utilize o AnyCap para tarefas multimodais
## Extensões de capacidade
- Geração de imagens: anycap image generate
- Geração de vídeo: anycap video generate
- Pesquisa na web: anycap search
- Armazenamento de ficheiros: anycap drive upload
- Publicação: anycap page publish
Gere uma versão inicial com /init dentro do Claude Code e personalize depois com as secções acima. Para mais informações sobre a configuração do Claude Code, consulte o nosso guia de funcionalidades avançadas.
Passo 4: Executar um fluxo de trabalho real de ponta a ponta
Aqui está um fluxo de trabalho completo que testa todos os componentes da stack:
1. Construir uma landing page para um produto SaaS chamado "AgentMetrics"
- Backend FastAPI com um endpoint
- Frontend simples em HTML/CSS
- Utilizar o DeepSeek V4 para toda a geração de código
2. Gerar uma imagem hero para a landing page
- Utilizar anycap image generate
3. Armazenar os assets gerados
- Utilizar anycap drive upload
4. Publicar a landing page
- Utilizar anycap page publish
O seu agente — alimentado pelo DeepSeek V4 para raciocínio — constrói a landing page. Chama o AnyCap para a imagem hero. Armazena os assets no Drive. Publica o resultado. Uma sessão, três componentes a trabalhar em conjunto.
Otimização de custos: V4 Flash vs V4 Pro
O DeepSeek V4 vem em dois níveis. Escolha com base no seu fluxo de trabalho:
| Variante | Custo (entrada) | Custo (saída) | Melhor para |
|---|---|---|---|
| V4 Flash | $0,14/1M tokens | $0,56/1M tokens | Iteração rápida, refatorações simples, fluxos sensíveis ao custo |
| V4 Pro | $0,28/1M tokens | $1,12/1M tokens | Refatorações complexas de múltiplos ficheiros, raciocínio arquitetural, depuração |
Para a maioria das sessões do Claude Code, o V4 Flash é suficiente. O modelo é rápido, económico e lida bem com a maioria das tarefas de codificação. Mude para o V4 Pro quando precisar de raciocínio mais profundo — a depurar uma condição de corrida complexa, a projetar uma nova arquitetura ou a refatorar em 20+ ficheiros.
Comparação de custos com alternativas:
| Stack | Custo aproximado por sessão de codificação intensa |
|---|---|
| Claude Code + Claude Opus 4.7 | $5–15 (subscrição ou API) |
| Claude Code + GPT-5.5 | $3–10 (API por token) |
| Claude Code + DeepSeek V4 Flash | $0,50–2 (API por token) |
| Claude Code + DeepSeek V4 Pro | $1–4 (API por token) |
O DeepSeek V4 Flash a $0,14/1M tokens de entrada custa aproximadamente 1/35 do Claude Opus 4.7. Ao longo de um mês de utilização diária do agente, a diferença chega a centenas de dólares. Para uma análise completa de preços do Claude Code, consulte a nossa comparação de planos. Para uma comparação direta entre DeepSeek V4 e GPT-5.5, consulte a nossa comparação de capacidades.
Em que esta stack se destaca
Refatorações em grande escala. A janela de contexto de 1M tokens do DeepSeek V4 significa que o Claude Code pode processar um monorepo inteiro numa única passagem. Renomear uma interface em 50+ ficheiros, atualizar imports e executar o conjunto de testes acontece numa única sessão autónoma.
Fluxos de trabalho com orçamento limitado. Se quer agentes de codificação autónomos, mas o Claude Max a $100–200/mês é demasiado caro, o DeepSeek V4 Flash + Claude Code + AnyCap oferece a mesma arquitetura de agente a uma fração do custo.
Desenvolvimento auto-alojado e isolado. O DeepSeek V4 tem licença Apache 2.0. Execute-o no seu próprio hardware. Combine com o Claude Code para execução do agente. Adicione o AnyCap para capacidades que permaneçam dentro da sua infraestrutura. Nenhum dado sai do seu ambiente.
Fluxos de trabalho multimodais com orçamento. O DeepSeek V4 trata do raciocínio. O AnyCap trata de imagens, vídeo, pesquisa, armazenamento e publicação. Obtém um agente totalmente multimodal sem pagar por um modelo multimodal. Consulte o nosso guia para adicionar capacidades multimodais ao DeepSeek V4 para mais detalhes.
Perguntas frequentes
O DeepSeek V4 funciona com o Cursor em vez do Claude Code?
Sim. O mesmo padrão de encaminhamento aplica-se. No Cursor, adicione o DeepSeek V4 como fornecedor de modelo via Definições → Modelos → Adicionar Modelo Personalizado. O AnyCap é instalado da mesma forma como uma skill MCP. A shell do agente é intercambiável.
Posso utilizar o DeepSeek V4 com o OpenClaw?
Sim. A CNBC noticiou especificamente que o DeepSeek V4 foi otimizado para o OpenClaw. O padrão de configuração é semelhante: configure o endpoint do modelo no OpenClaw e instale o AnyCap para as capacidades.
O desempenho de codificação agêntica do DeepSeek V4 é realmente competitivo?
Sim. O V4 Pro pontua 81% no SWE-bench Verified, igualando o GPT-5.5 e o Claude Opus 4.7. Em benchmarks de codificação agêntica especificamente, o DeepSeek reivindica SOTA em código aberto. Relatórios de programadores reais confirmam forte desempenho, especialmente considerando a diferença de preço. Para uma análise completa de benchmarks, consulte o nosso guia do programador do DeepSeek V4.
Quais são as limitações?
O DeepSeek V4 é apenas texto — sem multimodal nativo. O protocolo de agente do Claude Code foi concebido para os modelos Anthropic, pelo que algumas funcionalidades específicas do Claude (pensamento estendido, determinados modelos de permissão) podem não se traduzir perfeitamente para o encaminhamento do DeepSeek V4. Teste o seu fluxo de trabalho específico antes de confirmar o uso da stack. Consulte o nosso guia de capacidades do DeepSeek V4 para uma visão geral abrangente do que o V4 pode e não pode fazer.
Como se compara a utilizar o Claude Opus 4.7 diretamente?
Claude Opus 4.7 + Claude Code é a experiência mais integrada — tudo é concebido para funcionar em conjunto. DeepSeek V4 + Claude Code é mais económico, mas requer configuração de encaminhamento. O compromisso é custo vs. fluidez de integração. Se o orçamento não é uma limitação, fique com o nativo. Se quer codificação agêntica de ponta a 1/35 do custo, o DeepSeek V4 é a escolha.
Artigos relacionados
- DeepSeek V4: Guia Completo do Programador — Arquitetura, benchmarks, integração de API, auto-alojamento e tudo o que precisa para integrar o DeepSeek V4.
- DeepSeek V4 vs GPT-5.5: Comparação Completa de Capacidades — Benchmarks, preços, lacuna multimodal e flexibilidade de implementação comparados lado a lado.
- Como Adicionar Capacidades Multimodais a Agentes DeepSeek V4 — Adicione geração de imagens, vídeo, pesquisa na web e armazenamento em nuvem ao seu agente DeepSeek V4 em menos de 2 minutos.
- Claude Code vs Cursor: Qual Agente de Codificação IA Vence em 2026? — Agente nativo de terminal vs. fork de IDE. Compare autonomia, gestão de contexto, preços e tarefas reais.
- Como Adicionar Capacidades de Agente ao Claude Code com MCP — Guia de configuração MCP passo a passo mais o caminho rápido de um único comando do AnyCap.
Configure o DeepSeek V4 com Claude Code:
# Encaminhar o Claude Code pelo DeepSeek V4
export OPENROUTER_API_KEY=sk-or-your-key
claude --model openrouter/deepseek/deepseek-v4-pro
# Adicionar capacidades multimodais
npx -y skills add anycap-ai/anycap -a claude-code
Instalar AnyCap · Guia de Configuração do Claude Code · Guia do Programador DeepSeek V4