DeepSeek Harness ou Claude Code: qual a diferença entre um harness de plugins e um agente de terminal?

Fala aí, beleza? A DeepSeek soltou o próprio harness de agente no GitHub, e a primeira pergunta que apareceu na timeline foi a óbvia: isso substitui o Claude Code?

Calma que a resposta é mais interessante que um sim ou não

O DeepSeek Harness (o comando é dsh) foi publicado no repositório oficial deepseek-ai/deepseek-harness em 13 de agosto de 2026, sob licença MIT, e está em developer preview v0.1

Do outro lado tem o Claude Code, que já é aquele agente de terminal que muita gente usa todo santo dia

A comparação aqui é de FORMATO: como cada um roda e como cada um é estendido 🙂

O que é o DeepSeek Harness (dsh) e em que estágio ele está

O dsh é um harness de agente de código aberto publicado pela DeepSeek AI

A licença é MIT (Copyright (c) 2026 DeepSeek), então o código está lá pra ler, forkar e mexer

Agora o aviso que o próprio projeto dá, e que eu acho honesto demais pra ignorar: o README diz que o harness está em developer preview e iterando rápido, com a frase em caixa alta de que HAVERÁ mudanças que quebram compatibilidade

Ou seja: preview não é ferramenta de produção

Se tu montar teu fluxo de trabalho crítico em cima de uma v0.1 que avisa que vai quebrar, o problema não vai ser surpresa, vai ser escolha

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 114 aulas
• 4 projetos
• 9h 18min

Conhecer formação

O que significa "tudo é um plugin"?

A arquitetura do dsh é um micro-kernel apoiado no framework Cordis

Traduzindo pra prática: o miolo é pequeno e quase tudo entra por fora, como plugin

Entram como plugin os model adapters, o tool registry, a sandbox, o estado de sessão, o event dispatcher, as skills, o agendamento, o loop e até a própria interface

Se tu conhece um sistema de extensões de editor, a lógica é bem parecida: o programa base é o esqueleto, e o que tu pluga define o que ele sabe fazer

A parte mais fora da curva é a interface entrar nessa lista também

A interface sendo plugin quer dizer que ela é peça trocável, não lei

Como rodar o dsh:

Tem o caminho rápido, pelo npm, que instala o pacote @deepseek-ai/dsh e te dá o comando dsh:

npm install -g @deepseek-ai/dsh
dsh web

O dsh web sobe uma Web UI local em http://127.0.0.1:3080 e abre o navegador padrão

E tem o caminho pelo código-fonte, pra quem quer ler e mexer no projeto:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Repara que o segundo caminho usa pnpm

O erro comum aqui é rodar pnpm install sem ter o pnpm instalado e achar que o projeto está quebrado, quando na real falta a ferramenta na máquina

DeepSeek Harness x Claude Code: comparação ponto a ponto

Lendo a tabela pelo eixo de execução:

O dsh nasce apontando pra uma Web UI local: tu roda um comando e ele abre uma interface no teu próprio navegador, na tua máquina

O Claude Code nasce no terminal, com extensão pro VS Code, e ganhou também o Claude Code on the web, onde a sessão roda em sandbox isolado na infra da Anthropic, com restrições de rede e de sistema de arquivos e proxy seguro pro Git

São dois entendimentos diferentes de "onde o agente mora"

Lendo a tabela pelo eixo de extensão:

No dsh, estender é plugar: dsh plugin add, e até a interface é peça do mesmo mecanismo

No Claude Code, estender é /plugin dentro da própria ferramenta, com marketplaces adicionados por /plugin marketplace add, e skills que são pastas com SKILL.md no teu diretório pessoal ou dentro do projeto

Essa diferença das skills é sutil e MUITO prática: skill de projeto mora em .claude/skills/, então ela vai junto do repositório

Quando cada um faz mais sentido no seu dia a dia

Se o teu incômodo é ficar preso a um provedor de modelo, o dsh conversa direto com esse problema: provedor ali é configuração num arquivo, o settings.yaml dentro do $DSH_HOME, e o catálogo cobre Anthropic, OpenAI, Bedrock, Vertex e Azure, além de qualquer endpoint compatível com OpenAI

Se o teu incômodo é querer uma interface do teu jeito, também: a interface sendo plugin, montar a tua é uma possibilidade real da arquitetura, não uma gambiarra

Agora, se o que tu quer é um agente de terminal estabelecido, com plugins vindos de marketplace reunindo slash commands, subagents, servidores MCP e hooks, o Claude Code já entrega isso hoje

E tem o lado do time: skills versionadas dentro do projeto são exatamente o que ajuda a padronizar o agente entre vários devs do mesmo repositório, porque a regra viaja junto do código e não fica na cabeça de cada um

Quem quiser ver até onde esse mecanismo de skills vai, vale olhar o Superpowers do Claude Code e o jeito que ele muda a rotina do agente

E dá pra usar os dois juntos?

Dá, e isso é o detalhe mais engraçado da história 😀

Existe um plugin oficial, o @deepseek-ai/dsh-subagent-claude-code, citado no README do projeto ao lado do @deepseek-ai/dsh-subagent-codex

Ele trata o Claude Code como subagente do harness, e a instalação segue o padrão do README, com o --profile vindo antes do add:

dsh plugin --profile <name> add @deepseek-ai/dsh-subagent-claude-code

Ou seja: a pergunta "qual dos dois" tem uma terceira resposta possível, que é "um dentro do outro"

Só não esquece do aviso: developer preview v0.1 com quebra de compatibilidade anunciada não combina com trabalho crítico

O que aprendi montando um projeto inteiro com esse tipo de combo

O teste que eu gravei foi trocando o modelo por baixo do agente de terminal, e isso encosta no mesmo assunto: agente é uma coisa, modelo é outra

No vídeo eu mostro a configuração pra usar o DeepSeek como modelo padrão dentro do Claude Code, feita num settings.json, com um modelo principal e outro secundário pras tarefas mais simples e pros subagents

Eu prefiro deixar essa troca por projeto, e não fixa pra sempre

Deixei o painel de consumo da plataforma aberto na tela o tempo todo, pra acompanhar o gasto em tempo real

Coloquei 2 dólares de crédito na conta pra fazer os testes

Uma execução anterior tinha custado 3 centavos de dólar, e isso já me deu o tom da brincadeira

Aí pedi num prompt só um SaaS gerador de slogans: quatro páginas, autenticação, integração com banco de dados e integração com IA

Aprovei o plano, deixei rodar, e depois testei criação de conta e login no navegador

Custo: algo em torno de 11 a 12 centavos de dólar

Detalhe importante pra não te enganar: esse número fica um pouco mascarado, porque a própria aplicação gerada também consumia a mesma chave de API nos testes

O projeto não ficou espetacular, mas ficou funcional de ponta a ponta, o que já era o objetivo

Um ponto que me chamou atenção: o agente usou as ferramentas dele normalmente mesmo rodando com um modelo de uma empresa diferente da que fez o agente

Antes de trocar de agente, pedi pro modelo gerar um arquivo de documentação na raiz do projeto, com visão geral, stack, estrutura de pastas, banco, autenticação, como rodar, convenções e regras

Essa parte é a que eu mais defendo: documentação atualizada é o que faz o próximo agente retomar o trabalho sem quebrar nada

Depois levei o mesmo projeto pra um segundo agente de terminal, o OpenCode, que roda sem interface gráfica

Pedi pra ele ler o projeto e explicar como funcionava, e ele respondeu certinho, usando o arquivo de documentação e os arquivos do repositório

Na sequência pedi quatro funcionalidades de uma vez (modo escuro, favoritar slogans, copiar pra área de transferência e exportar histórico em CSV), indicando a biblioteca de componentes e pedindo pra atualizar a documentação junto

Até enfileirei uma segunda mensagem pedindo pra subir o projeto quando terminasse, porque dá pra deixar instrução na fila

O consumo acumulado no painel nessa altura estava em 15 centavos de dólar

E olha a diferença prática entre os dois agentes que ficou clara ali: no Claude Code a troca de modelo passou por configuração de projeto, porque o agente já tem modelos próprios, enquanto no outro a conexão ficou salva pra próxima sessão e a escolha do modelo passou pelo comando de models, já que ele não tem modelo base

Se liga no que essa experiência prova e no que ela NÃO prova: ela mostra custo observado e fluxo de trabalho

Ela não diz nada sobre qual dos dois harnesses escreve código melhor

Veja o combo funcionando na prática

No vídeo abaixo eu monto o combo do começo ao fim e deixo o painel de consumo aparecendo na tela enquanto o projeto nasce, então dá pra ver o gasto subindo junto com as features

Veredito: qual dos dois vale o seu tempo agora

Vou separar por perfil, que é mais honesto que um vencedor único

Se o teu objetivo é trabalho diário e previsibilidade, o agente de terminal estabelecido é a escolha sem drama: claude instalado por npm, /plugin pra estender, skills em .claude/skills/ viajando junto do repositório

Se o teu objetivo é experimentar arquitetura de plugins, trocar provedor de modelo por arquivo de configuração ou contribuir com um projeto de código aberto, o dsh é um convite bem grande, com a licença MIT e o repositório abertos

Mas aceita o combinado: developer preview v0.1, com o próprio README avisando em caixa alta que vai quebrar compatibilidade

E não trata isso como escolha excludente, porque o plugin de subagente existe justamente pra colocar um dentro do outro

Conclusão

A diferença real entre DeepSeek Harness e Claude Code, hoje, não é qual escreve código melhor

É onde o agente roda e como ele é estendido: Web UI local subida por comando e tudo entrando como plugin de um lado, terminal (mais VS Code e sessões em sandbox na web) com plugins de marketplace e skills em pastas do outro

Próximo passo prático, e verificável: se tu já usa Claude Code, abre o /plugin e dá uma olhada nas skills em .claude/skills/ antes de sair procurando ferramenta nova

Se tu quer conhecer o dsh, sobe a Web UI local com dsh web e lê o README oficial no repositório deepseek-ai/deepseek-harness antes de levar isso pra qualquer coisa séria

Tome cuidado com preview, beleza? Curiosidade sim, produção ainda não

Segue acompanhando o Hora de Codar que esse assunto vai render, até o próximo post! 😀