DeepSeek V4 + Claude Code | Configuração da integração, adequação ao workflow e capability layer

Perceba como o DeepSeek V4 se integra em workflows com Claude Code, onde a integração funciona bem, onde falha e porque é que a maioria das equipas continua a precisar de uma capability layer.

Resposta rápida

Se quer usar o DeepSeek V4 com o 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 em falta. Esta combinação faz sentido quando quer desempenho de coding com menor custo através do DeepSeek V4, mas continua a precisar que o seu agente pesquise na web em direto, gere imagens ou vídeo, armazene ficheiros e publique resultados.

O DeepSeek V4 consegue raciocinar. O Claude Code consegue operar. Mas à maioria das equipas continua a faltar a camada que transforma essa combinação num agente para o mundo real.

Essa camada em falta não é “mais prompting”, nem outro conjunto de integrações avulsas. É a capability layer: o runtime que dá ao seu agente aquilo que uma shell de coding não traz por defeito — pesquisa web em direto, geração de imagem, vídeo, armazenamento e publishing.

É aí que o AnyCap entra. O DeepSeek V4 trata do raciocínio do modelo. O Claude Code trata do loop do agente dentro do seu repositório. O AnyCap acrescenta o capability runtime que estas duas peças ainda não têm.

Este guia mostra como montar a stack de forma limpa: encaminhe o Claude Code através do DeepSeek V4 e depois adicione o AnyCap para que o agente consiga fazer mais do que apenas ler ficheiros e executar comandos.

Porque é que DeepSeek V4 + Claude Code é uma stack convincente

O DeepSeek V4 é apelativo por uma razão simples: desempenho de coding ao nível da fronteira por um custo drasticamente inferior. Oferece uma janela de contexto ampla, benchmarks fortes de coding agentic e opções flexíveis de implementação através de fornecedores alojados ou self-hosting.

O Claude Code continua a ser uma das shells mais fortes para trabalho autónomo de coding. Consegue inspecionar o seu repositório, planear alterações, editar ficheiros, correr testes e iterar. Por outras palavras, dá ao modelo um loop de execução disciplinado.

Mas isso continua sem tornar a stack completa.

Se pedir a esta configuração para pesquisar uma página de um concorrente em direto, gerar um visual de lançamento, armazenar artefactos para revisão ou publicar um relatório finalizado, depara-se de imediato com a mesma limitação: o modelo consegue raciocinar sobre a tarefa, e o Claude Code consegue orquestrar passos, mas nenhum dos dois é o capability runtime.

É por isso que a arquitetura mais rigorosa 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 media, pesquisa, armazenamento e publishing

O que funciona bem — e o que falha

O que funciona bem:

encaminhamento 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 falha sem uma capability layer:

tarefas de pesquisa em direto que exigem pesquisa web e crawling
workflows de media que exigem geração de imagem ou vídeo
tarefas de entrega de artefactos que exigem armazenamento, partilha ou publishing

Essa é a razão prática pela qual esta stack precisa de AnyCap, e não apenas de uma rota de modelo mais uma shell.

Pré-requisitos

Antes de começar, confirme que tem:

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

Passo 1: encaminhar o Claude Code através do DeepSeek V4

O Claude Code usa por defeito modelos alojados pela Anthropic. Para usar o DeepSeek V4 para raciocínio, encaminhe o Claude Code através de um fornecedor 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 uma predefinição mais barata e rápida:

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

Após o arranque, verifique a rota ativa dentro da sessão:

> What model are you running on?

Passo 2: adicionar a capability layer em falta com AnyCap

Este é o passo que a maioria dos artigos deixa pouco claro.

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

Há duas partes:

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

Instalar a CLI

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

Autenticar uma vez

anycap login

Adicionar a skill ao Claude Code

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

Agora a sua stack tem a capability layer que faltava.

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

pesquisar na web em direto
gerar imagens
gerar vídeo
enviar artefactos para armazenamento na cloud
publicar outputs finalizados

A distinção importante é esta:

DeepSeek V4 decide o que fazer
Claude Code gere o workflow do agente
AnyCap CLI executa capacidades do mundo real
AnyCap skill ensina o agente a invocar essas capacidades de forma eficaz

Passo 3: configurar o contexto do projeto

O Claude Code lê CLAUDE.md no início de cada sessão. Use-o para tornar 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

Isto evita um modo de 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.

Passo 4: executar 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

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

Sem a capability layer, o seu agente pára em “escrevi o código”.

Com a capability layer, consegue concluir a pesquisa, gerar media de apoio, armazenar outputs e entregar um resultado publicado.

Otimização de custo: Flash vs Pro

Use o nível do modelo com base na profundidade do 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 ficheiros, debugging mais difícil, decisões de arquitetura

Um padrão prático é:

usar Flash por defeito para trabalho de rotina
mudar para Pro para passagens de raciocínio mais profundas
manter o AnyCap como capability layer fixa, independentemente do nível de modelo escolhido

Assim, não precisa de reconstruir a sua stack de capacidades sempre que muda de modelo.

Em que é que esta stack é realmente boa

1. Trabalho de agente em grandes codebases com menor custo

O DeepSeek V4 trata do raciocínio. O Claude Code trata do loop ao nível do repositório. Obtém forte desempenho de coding sem pagar preços de modelo premium em todas as sessões.

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

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

Se o seu workflow exige pesquisa, media, entrega de ficheiros ou publishing, o capability runtime é a peça em falta.

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

Continua a poder usar MCP quando faz sentido, especialmente para ferramentas internas e sistemas proprietários. Mas, para capacidades transversais comuns, o modelo mental mais limpo não é “adicionar mais um servidor”. É “adicionar uma vez a runtime layer em falta”.

FAQ

Neste setup, o AnyCap é apenas mais um servidor MCP?

Não. A descrição mais rigorosa é que o AnyCap é o capability runtime. O Claude Code pode aprender a usá-lo através de uma skill, e o MCP pode continuar a fazer parte da arquitetura de ferramentas envolvente, mas o valor do produto está na camada unificada de execução — não num conjunto solto de configurações de servidor desligadas entre si.

Porque não usar apenas o DeepSeek V4 com alguns scripts?

Porque os scripts não resolvem o problema de coordenação. Continua a precisar de uma forma consistente para o agente pesquisar, gerar media, armazenar outputs e publicar resultados. O runtime dá ao agente essa superfície numa única interface coerente.

Ainda preciso de MCP?

Por vezes, sim. O MCP continua útil para bases de dados internas, APIs proprietárias e ferramentas específicas da equipa. Mas o MCP é a camada de protocolo. Não é a mesma coisa que o capability runtime mais amplo que o seu agente usa no trabalho quotidiano de produção.

Qual é o maior erro que as equipas cometem com esta stack?

Tratar o Claude Code como se já incluísse a capability layer completa. Não inclui. O Claude Code é a shell. O DeepSeek V4 é o modelo. Se quer um agente para o mundo real, continua a precisar do runtime.

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