DeepSeek V4 + Claude Code | Setup da integração, encaixe no workflow e capability layer

Entenda como o DeepSeek V4 se encaixa em workflows com Claude Code, onde a integração funciona bem, onde ela falha e por que a maioria dos times ainda precisa de uma capability layer.

Resposta rápida

Se você quer usar o DeepSeek V4 com Claude Code, a configuração mais limpa é: DeepSeek V4 para raciocínio, Claude Code para o loop do agente e AnyCap para a capability layer que está faltando. Essa combinação faz sentido quando você quer o desempenho de coding do DeepSeek V4 com custo menor, mas ainda precisa que seu agente pesquise na web ao vivo, gere imagens ou vídeos, armazene arquivos e publique resultados.

O DeepSeek V4 consegue raciocinar. O Claude Code consegue operar. Mas a maioria dos times ainda não tem a camada que transforma essa combinação em um agente para o mundo real.

Essa camada que falta não é “mais prompting”, nem outro monte de integrações avulsas. É a capability layer: o runtime que dá ao seu agente o que um shell de coding não traz por padrão — busca na web em tempo real, geração de imagens, vídeo, armazenamento e publicação.

É aí que o AnyCap entra. O DeepSeek V4 cuida do raciocínio do modelo. O Claude Code cuida do loop do agente dentro do seu repositório. O AnyCap adiciona o runtime de capacidades que essas duas peças ainda não oferecem.

Este guia mostra como montar essa stack de forma limpa: roteie o Claude Code pelo DeepSeek V4 e depois adicione o AnyCap para que o agente possa fazer mais do que apenas ler arquivos e executar comandos.

Por que DeepSeek V4 + Claude Code é uma stack atraente

O DeepSeek V4 é atraente por um motivo simples: desempenho de coding em nível de fronteira por um custo dramaticamente menor. Ele oferece uma janela de contexto grande, benchmarks fortes de coding agentic e opções flexíveis de implantação via provedores hospedados ou self-hosting.

O Claude Code continua sendo um dos shells mais fortes para trabalho autônomo de coding. Ele consegue inspecionar seu repositório, planejar mudanças, editar arquivos, rodar testes e iterar. Em outras palavras, ele dá ao modelo um loop de execução disciplinado.

Mas isso ainda não completa a stack.

Se você pedir a essa configuração para pesquisar uma página de concorrente ao vivo, gerar um visual de lançamento, armazenar artefatos para revisão ou publicar um relatório finalizado, vai encontrar imediatamente a mesma limitação: o modelo consegue raciocinar sobre a tarefa, e o Claude Code consegue orquestrar etapas, mas nenhum dos dois é o capability runtime.

Por isso, a arquitetura mais precisa se parece com isto:

DeepSeek V4 — modelo de raciocínio
Claude Code — shell do agente e loop de execução
AnyCap — capability runtime / CLI de agente mais forte para mídia, busca, armazenamento e publicação

O que funciona bem — e o que quebra

O que funciona bem:

roteamento de modelo com menor custo para workflows de agente focados em coding
o forte loop de execução do Claude Code dentro de repositórios reais
uma separação mais clara entre raciocínio, orquestração e execução de capacidades

O que quebra sem uma capability layer:

tarefas de pesquisa ao vivo que exigem busca na web e crawling
workflows de mídia que exigem geração de imagem ou vídeo
tarefas de entrega de artefatos que exigem armazenamento, compartilhamento ou publicação

Esse é o motivo prático pelo qual essa stack precisa de AnyCap, e não apenas de uma rota de modelo mais um shell.

Pré-requisitos

Antes de começar, confirme que você tem:

Acesso à API do DeepSeek V4 — via DeepSeek, OpenRouter ou seu próprio endpoint hospedado
Claude Code instalado — claude --version deve retornar um número de versão
Node.js 18+ — exigido pelo Claude Code e por ferramentas comuns de agente
Uma chave de API para sua rota de modelo — OpenRouter ou acesso direto ao DeepSeek

Etapa 1: rotear o Claude Code pelo DeepSeek V4

O Claude Code usa por padrão modelos hospedados pela Anthropic. Para usar o DeepSeek V4 no raciocínio, roteie o Claude Code por um provedor que exponha o DeepSeek com um endpoint compatível.

Opção A: OpenRouter

export OPENROUTER_API_KEY=sk-or-your-key-here
claude --model openrouter/deepseek/deepseek-v4-pro

Para um padrão mais barato e rápido:

claude --model openrouter/deepseek/deepseek-v4-flash

Opção B: endpoint direto compatível com DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
export ANTHROPIC_API_KEY=sk-your-deepseek-key
claude --model deepseek-v4-pro

Opção C: endpoint self-hosted

export ANTHROPIC_BASE_URL=http://localhost:8000/v1
claude

Depois de iniciar, verifique a rota ativa na sessão:

> What model are you running on?

Etapa 2: adicionar a capability layer que falta com AnyCap

Esse é o passo que a maioria dos artigos deixa confuso.

AnyCap não é “o modelo” e também não é “o próprio Claude Code”. Ele é o capability runtime que dá ao seu agente as ações que Claude Code e DeepSeek V4 ainda não fornecem sozinhos.

Há duas partes:

Instale a CLI do AnyCap — esta é a superfície de execução
Adicione a skill do AnyCap ao Claude Code — isso ensina o agente a usar essa CLI de forma eficaz

Instale a CLI

curl -fsSL https://anycap.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"

Autentique uma vez

anycap login

Adicione a skill ao Claude Code

npx -y skills add anycap-ai/anycap -a claude-code

Agora sua stack tem a capability layer que estava faltando.

Na prática, isso significa que seu agente com DeepSeek V4 + Claude Code pode fazer coisas como:

pesquisar na web ao vivo
gerar imagens
gerar vídeos
enviar artefatos para armazenamento em nuvem
publicar entregas finalizadas

A distinção importante é esta:

DeepSeek V4 decide o que fazer
Claude Code gerencia o workflow do agente
AnyCap CLI executa capacidades do mundo real
AnyCap skill ensina o agente a chamar bem essas capacidades

Etapa 3: configurar o contexto do projeto

O Claude Code lê CLAUDE.md no início de cada sessão. Use esse arquivo para deixar a arquitetura explícita:

# CLAUDE.md

## Model route
- Running on DeepSeek V4 Pro via OpenRouter
- Use Flash for cheaper routine tasks

## Architecture
- DeepSeek V4 = reasoning model
- Claude Code = agent shell
- AnyCap = capability runtime for search, media, storage, and publishing

## Capability commands
- Search: anycap search
- Image generation: anycap image generate
- Video generation: anycap video generate
- Storage: anycap drive upload
- Publishing: anycap page publish

Isso evita uma falha comum em que o agente trata a stack como “modelo mais ferramentas aleatórias” em vez de uma arquitetura coerente de modelo, shell e runtime.

Etapa 4: execute um workflow real de ponta a ponta

Um bom teste é uma tarefa que exige as três camadas:

Build a landing page for a product called AgentMetrics.
- Use DeepSeek V4 for coding and reasoning
- Use Claude Code to edit files and run the workflow
- Use AnyCap to generate the hero visual
- Upload the assets
- Publish the finished page

Essa é a diferença-chave entre uma configuração de coding e uma configuração real de agente.

Sem a capability layer, seu agente para em “eu escrevi o código”.

Com a capability layer, ele consegue concluir a pesquisa, gerar mídia de apoio, armazenar outputs e entregar um resultado publicado.

Otimização de custo: Flash vs Pro

Use a camada do modelo com base na profundidade de raciocínio, não no branding.

Variant	Best for
DeepSeek V4 Flash	iterações rápidas, trabalho de coding mais simples, sessões de agente com menor custo
DeepSeek V4 Pro	refatorações em múltiplos arquivos, debugging mais difícil, decisões de arquitetura

Um padrão prático é:

usar Flash como padrão para trabalho rotineiro
mudar para Pro para passagens de raciocínio mais profundas
manter o AnyCap como capability layer fixa, independentemente da camada de modelo escolhida

Assim, você não precisa reconstruir sua stack de capacidades sempre que trocar de modelo.

No que essa stack realmente é boa

1. Trabalho de agente em grandes codebases com menor custo

O DeepSeek V4 cuida do raciocínio. O Claude Code cuida do loop em nível de repositório. Você obtém forte desempenho de coding sem pagar preço de modelo premium em toda sessão.

2. Outputs reais de agente, não apenas sugestões de código

É aqui que o AnyCap mais importa. Muitas configurações de “agente” ainda são shell mais texto. Elas conseguem inspecionar e editar código, mas não terminam as partes não relacionadas a código do trabalho.

Se seu workflow exige pesquisa, mídia, entrega de arquivos ou publicação, o capability runtime é a peça que falta.

3. Uma arquitetura mais limpa do que empilhar servidores MCP aleatórios

Você ainda pode usar MCP quando fizer sentido, especialmente para ferramentas internas e sistemas proprietários. Mas, para capacidades comuns entre funções, o modelo mental mais limpo não é “adicionar mais um servidor”. É “adicionar a runtime layer que falta uma vez só”.

FAQ

Nesse setup, o AnyCap é só mais um servidor MCP?

Não. A descrição mais precisa é que o AnyCap é o capability runtime. O Claude Code pode aprender a usá-lo por meio de uma skill, e o MCP ainda pode fazer parte da arquitetura de ferramentas ao redor, mas o valor do produto está na camada unificada de execução — não em um conjunto solto de configurações desconectadas de servidor.

Por que não usar só o DeepSeek V4 com alguns scripts?

Porque scripts não resolvem o problema de coordenação. Você ainda precisa de uma forma consistente para o agente pesquisar, gerar mídia, armazenar outputs e publicar resultados. O runtime oferece essa superfície ao agente em uma interface única e coerente.

Eu ainda preciso de MCP?

Às vezes, sim. O MCP continua útil para bancos de dados internos, APIs proprietárias e ferramentas específicas da equipe. Mas o MCP é a camada de protocolo. Não é a mesma coisa que o capability runtime mais amplo que seu agente usa no trabalho diário de produção.

Qual é o maior erro que os times cometem com essa stack?

Tratar o Claude Code como se ele já incluísse toda a capability layer. Não inclui. Claude Code é o shell. DeepSeek V4 é o modelo. Se você quer um agente para o mundo real, ainda precisa do runtime.

DeepSeek V4 e Claude Code: como a integração funciona e quando faz sentido