DeepSeek Harness: o que foi lançado e como instalar

O DeepSeek Harness (DSH) é o harness de agentes de código da DeepSeek para V4-Pro e V4-Flash. Ele foi lançado no npm como @deepseek-ai/dsh em 13 de agosto de 2026, no mesmo dia em que o V4-Pro entrou em disponibilidade geral. A instalação leva quatro passos, usa uma chave padrão da API DeepSeek e vem acompanhada de um sistema de plugins. Mas há uma armadilha importante: desde maio, o PyPI hospeda um pacote Python sem relação chamado deepseek-harness, que também disponibiliza o comando dsh. Não se trata da mesma ferramenta.

O que é o DeepSeek Harness (DSH)

Um harness de agente de código cuida da seleção de contexto, do tratamento de erros de ferramentas, do replanejamento e da detecção de conclusão ao redor do modelo. Mesmo com o modelo fixo, os resultados de benchmark mudam conforme a configuração do harness. É por isso que a DeepSeek divulga essas configurações junto das avaliações de agentes, em vez de apresentar apenas números brutos do modelo.

Há exemplos conhecidos: o Claude Code é um harness para os modelos Claude da Anthropic; o Cursor reúne vários provedores em um IDE; e o GitHub Copilot funciona como harness para modelos da OpenAI dentro do VS Code. O agente é o resultado da combinação entre modelo e harness: um sistema capaz de editar arquivos, executar comandos e chamar APIs, não apenas responder a prompts isolados. O DSH cumpre esse papel para V4-Pro e V4-Flash.

O DSH é o harness oficial da DeepSeek, criado para V4-Pro e V4-Flash da mesma forma que o Claude Code foi feito para Sonnet e Opus. O registro de mudanças da beta do V4-Flash, em 31 de julho, foi a primeira menção pública ao produto: os benchmarks de agentes haviam usado o “DeepSeek Harness minimal mode (to be released soon)”, com effort=max, top_p=0.95 e temperature=1.0.

O “minimal mode” é uma configuração enxuta, com esforço de raciocínio máximo e parâmetros de amostragem fixos. A ideia é tornar os benchmarks de agentes reproduzíveis, sem ajuste específico para cada teste. O produto completo — incluindo o sistema de plugins citado em relatos da beta — vai além do executor usado para gerar as pontuações publicadas.

Tanto o V4-Pro quanto o V4-Flash oferecem janela de contexto de 1 milhão de tokens e três níveis de esforço de raciocínio: low para tarefas simples, high para o trabalho usual de agentes e max para tarefas complexas (changelog oficial, entrada de 13 de agosto).

Como instalar o @deepseek-ai/dsh

É necessário ter Node.js 18 ou superior, o mesmo requisito mínimo indicado pela DeepSeek em seu guia oficial de integração com Claude Code.

1. Verifique a versão do Node: node --version (é necessário 18 ou superior; no macOS, use brew install node se ele não estiver instalado).
2. Faça a instalação global: npm install -g @deepseek-ai/dsh.
3. Defina sua chave: export DEEPSEEK_API_KEY=<your key>, obtida na plataforma DeepSeek.
4. Execute: cd /path/to/my-project && dsh.

Erros de permissão do npm em instalações globais são comuns no macOS. A solução recomendada pelo npm é configurar um prefixo global gravável pelo usuário (npm config set prefix ~/.npm-global). Usar sudo funciona, mas pode causar conflitos de propriedade em atualizações futuras dos pacotes.

Não há preço separado anunciado para o software do harness. Já a API dos modelos muda de preço em 16 de agosto, às 16:00 UTC: a família V4 passa a adotar tarifas de pico e fora de pico, sendo que o período fora de pico custa metade do valor de pico (changelog oficial).

Benchmarks do V4-Pro GA: onde o harness entra

Estes são os números oficiais publicados pela DeepSeek em sua entrada de changelog de 13 de agosto. Todos foram produzidos com a configuração de harness descrita acima:

O V4-Pro supera o Flash por 0.5 a 8.3 pontos nesses benchmarks. As maiores diferenças aparecem em DeepSWE (+8.3) e NL2Repo (+7.3). O destaque é o 87.9 no Terminal Bench 2.1. Uma reprodução independente com harness público no r/LocalLLaMA colocou o Flash 0731 em 82.7 após 445 execuções, confirmando a alegação da DeepSeek dentro da margem de variação de configuração. DSBench-FullStack e DSBench-Hard são conjuntos de avaliação internos, portanto essas duas linhas trazem medições da própria DeepSeek.

Todos os benchmarks publicados foram executados com esforço max. Para uso em produção, a orientação da DeepSeek é usar low em tarefas simples, high no trabalho normal de agentes e max em tarefas complexas.

@deepseek-ai/dsh ou pip install deepseek-harness?

Os dois pacotes têm nomes quase idênticos e foram lançados com meses de diferença. Não há relação entre eles.

O projeto no PyPI é uma biblioteca adaptadora de protocolo, e não um agente de código. O autor documentou 16 comportamentos da API V4 em mais de 270 testes e os codificou como um contrato de 10 regras, distribuído em quatro formatos: biblioteca Python, CLI dsh, servidor MCP e uma Anthropic Skill. Três descobertas podem causar problemas para quem desenvolve sobre o V4:

• Loops de ferramentas com múltiplos turnos retornam HTTP 400 se reasoning_content não for preservado nas mensagens do assistente — reproduzido 3/3 nos dois modelos.
• O endpoint /beta remapeia silenciosamente v4-pro para deepseek-reasoner.
• Acertos de cache surgem em blocos de 256 tokens após um prefixo de 1,024 tokens; um loop de cinco turnos chegou ao equilíbrio de 95%, reduzindo o custo efetivo de entrada em cerca de 50x.

Os dois pacotes disponibilizam um comando dsh, que é a principal origem da confusão. Se você instalou com pip, tem a biblioteca adaptadora. Se instalou com npm, sob o escopo @deepseek-ai, tem o harness.

Como usar o DeepSeek V4 como agente de código sem o DSH

Se você quer um agente de código baseado em DeepSeek enquanto a documentação do DSH não se estabiliza, o guia oficial de integração da DeepSeek apresenta três caminhos compatíveis:

A configuração do Claude Code mapeia os modelos DeepSeek para os slots do Claude Code:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Há uma particularidade nesse mapeamento: pedidos para claude-sonnet são resolvidos para Flash, e não para Pro. A documentação da DeepSeek direciona o Pro ao slot Opus e o Flash ao Haiku. As três ferramentas são documentadas como integrações de terceiros, cuja eficácia e segurança não são garantidas pela DeepSeek. Para uma comparação mais ampla, veja nossa comparação de LLMs para agentes de código e o guia da API do V4-Pro GA.

Perguntas frequentes

O @deepseek-ai/dsh é o DeepSeek Harness oficial?

O escopo @deepseek-ai no npm corresponde à organização da DeepSeek no GitHub, e a data de lançamento coincide com a janela prometida no changelog de 31 de julho. Postagens da comunidade confirmam que a instalação funciona. O changelog da DeepSeek de 13 de agosto documenta o GA do V4-Pro, mas não cita o harness; além disso, o npm bloqueia a verificação automatizada da página do pacote.

Qual é a diferença entre o DSH e o deepseek-harness do PyPI?

São produtos distintos, mantidos por pessoas diferentes. O @deepseek-ai/dsh é o harness de agente de código no npm, lançado em 13 de agosto. Já pip install deepseek-harness instala uma biblioteca Python independente de adaptação de protocolo, criada por Henry Zhang (MIT, 9 de maio), para lidar com particularidades da API V4. Ambos disponibilizam um comando dsh.

Preciso de uma chave da API DeepSeek para usar o DSH?

Sim. O harness opera V4-Pro e V4-Flash por meio da API DeepSeek, portanto o uso é cobrado por token. O pacote npm é instalado gratuitamente; o custo vem do consumo da API. Os preços da família V4 passam a ter tarifas de pico e fora de pico em 16 de agosto, às 16:00 UTC, sendo o período fora de pico cobrado pela metade do valor de pico.

Como o DSH se compara ao Claude Code?

O Claude Code é um agente maduro e documentado para programação no terminal, que já roda com DeepSeek via endpoint compatível com Anthropic. A proposta do DSH é a otimização específica para o modelo: um harness construído em torno do comportamento de protocolo do V4, em vez de apenas adaptado a ele. A divulgação da configuração de benchmark torna essa vantagem plausível, mas ela ainda não foi comprovada em uso independente enquanto a documentação e os testes da comunidade do DSH não avançam.

Qual é a diferença entre um harness de IA e um agente de IA?

O harness é a camada de infraestrutura: gerenciamento de contexto, roteamento de ferramentas e orquestração de tarefas. O agente é o sistema completo, um modelo em execução dentro de um harness e capaz de realizar ações em múltiplas etapas. Todo agente precisa de um harness, mas um mesmo harness pode atender modelos diferentes. Claude Code, Cursor, Copilot e DSH são todos harnesses; o que os torna “agentes” é o modelo que os alimenta.

Status do lançamento: o que está confirmado e o que veio da comunidade

Os fatos deste artigo se baseiam em dois níveis de evidência.

Confirmado oficialmente (changelog da API DeepSeek, com entradas datadas):

• deepseek-v4-pro entrou em GA em 13 de agosto, com suporte nativo à OpenAI Responses API e três níveis de esforço de raciocínio (changelog).
• O V4-Flash entrou em beta pública em 31 de julho, com benchmarks gerados usando “DeepSeek Harness minimal mode (to be released soon).”
• Todos os números de benchmark do V4-Pro GA e da beta do V4-Flash vêm dessas entradas de changelog.
• Os preços da família V4 passam para tarifas de pico e fora de pico em 16 de agosto, às 16:00 UTC.
• O guia de integração do Claude Code, OpenCode e OpenClaw é documentação oficial.

Relatado pela comunidade (posts no Reddit e capturas de tela reproduzidas):

• O @deepseek-ai/dsh pode ser instalado e funciona. u/Testx01 publicou o link do pacote às 12:56 UTC em 13 de agosto; u/Available_Yam_6267 apareceu poucos minutos depois. O escopo npm @deepseek-ai corresponde à organização da DeepSeek no GitHub.
• A página do pacote no npm bloqueia buscas automatizadas, portanto os metadados de versão, licença e mantenedor seguem sem confirmação via registro.

“Deepseek harness is out on npm :)” — u/Testx01, r/DeepSeek, 13 de agosto

• Uma mensagem interna da beta reproduzida descreve um grupo beta de 369 membros que enviou uma compilação interna final em 11 de agosto e orientou desenvolvedores de plugins a marcar repositórios com #dsh antes da beta pública de 13 de agosto. Após o lançamento, os plugins poderiam ser transferidos para contas individuais.
• Relatos da comunidade citaram a imprensa de tecnologia chinesa em maio, dizendo que a DeepSeek estava montando uma equipe dedicada ao harness e recrutando para cargos de produto em Agent Harness.

Trate as alegações sobre recursos, CLI e plugins do DSH como confirmadas pela comunidade até que a DeepSeek publique documentação formal em seu próprio site.