DeepSeek Harness vs Claude Code: Qual o Agente de Código Ideal para Sua Stack?

O DeepSeek Harness (dsh) foi lançado em 13 de agosto de 2026, e sua abordagem chamou atenção imediatamente. A manchete de lançamento do VentureBeat o descreveu como um “rival de código aberto do Claude Code”, lançado junto com o DeepSeek V4-Pro na API. Em 20 de agosto, o repositório tinha aproximadamente 169 mil estrelas.

Experimente o Apidog hoje

Mas estrelas no GitHub não respondem à pergunta prática: vale mais a pena executar um agente de código com DeepSeek Harness ou Claude Code?

As ferramentas adotam estratégias diferentes:

• O dsh é uma prévia para desenvolvedores, open source sob licença MIT, baseada em um kernel de plug-ins e uma interface web local.
• O Claude Code é um produto proprietário e maduro, com habilidades, hooks, MCP nativo, subagentes e várias interfaces.

Este guia compara licenciamento, interface, modelos, custos, extensibilidade, permissões e MCP — sem benchmarks inventados. Se você ainda não conhece o dsh, leia primeiro o que é o DeepSeek Harness e como ele funciona.

💡 Ambos os agentes escrevem código para APIs e dependem da qualidade da especificação fornecida. O Apidog ajuda a manter essa especificação testada e atualizada, independentemente do agente escolhido.

Comparação rápida

Dimensão	DeepSeek Harness (dsh)	Claude Code
Licença	MIT, código-fonte no GitHub	Proprietária; termos comerciais da Anthropic
Idade	Lançado em 13 de agosto de 2026; prévia para desenvolvedores	Produto maduro e geralmente disponível
Estabilidade	README alerta sobre mudanças que quebram compatibilidade	Canais de lançamento estáveis e configurações versionadas
Interface	UI web local em 127.0.0.1:3080, CLI e modo headless	Terminal, VS Code, JetBrains, desktop, web e mobile
Modelos	DeepSeek, Anthropic, OpenAI, Bedrock, Vertex, Azure e endpoints compatíveis com OpenAI	Apenas modelos Claude, diretos ou via provedores de nuvem
Preço	Harness gratuito; cobrança por token da API conectada	Claude Pro/Max ou faturamento por uso de API
Extensibilidade	Arquitetura baseada em plug-ins Cordis	Plug-ins, habilidades, hooks, subagentes e SDK de Agente
Permissões	Aprovações conforme a política ativa	Seis modos e regras granulares de permissão/negação
MCP	Plug-in da comunidade	Nativo e de primeira classe

Código aberto vs. proprietário

O DeepSeek Harness usa licença MIT e rastreia dependências de terceiros em THIRD_PARTY_NOTICES.md.

Na prática, isso permite:

1. Inspecionar o loop do agente.
2. Fazer fork do projeto.
3. Corrigir ou adaptar comportamentos.
4. Incorporar o harness em produtos comerciais.
5. Auditar o que a ferramenta envia pela rede.

Isso é relevante para equipes com exigências de conformidade, ambientes regulados ou ferramentas internas que não podem depender exclusivamente de um fornecedor.

O Claude Code segue o modelo oposto. O repositório público da Anthropic inclui o aviso:

© Anthropic PBC. Todos os direitos reservados.

Você recebe um produto, documentação e suporte, mas não pode auditar ou alterar o código-fonte do agente.

Quando isso importa?

Escolha o dsh se sua equipe precisa de:

• Auditabilidade de código.
• Capacidade de fork.
• Controle da infraestrutura.
• Menor dependência de fornecedor.

Mas considere o risco: licença MIT garante direitos de uso, não manutenção contínua. O dsh ainda é um projeto muito recente.

Interface: UI web local vs. múltiplos ambientes

O fluxo inicial do dsh é:

npx @deepseek-ai/dsh web

Esse comando inicia uma interface web local em:

http://127.0.0.1:3080

Para evitar que o navegador seja aberto automaticamente:

npx @deepseek-ai/dsh web --no-open

A interface trabalha sobre o diretório do projeto em que o dsh foi iniciado.

Além da UI web, o README da CLI documenta perfis nomeados:

dsh --profile <name>

Os perfis ficam em:

$DSH_HOME/profiles/<name>

Também há suporte a execução headless para automação, scripts e pipelines. O comando abaixo usa o perfil web:

dsh web

E o gerenciamento de plug-ins pode ser feito com:

dsh plugin

O Claude Code oferece uma cobertura maior de interfaces. Segundo a documentação oficial, ele funciona em:

• Terminal.
• VS Code.
• JetBrains.
• Aplicativo desktop.
• Navegador em claude.ai/code.
• Mobile.

Para automação, a execução headless é direta:

claude -p "implemente testes para este módulo"

Esse formato se encaixa em CI, cron jobs e scripts shell.

Decisão prática

Use o dsh se você trabalha principalmente em uma máquina e quer uma UI local simples.

Use o Claude Code se seu fluxo alterna entre IDE, terminal, CI, navegador e dispositivos móveis.

Liberdade de modelo

Essa é a maior diferença arquitetural entre as ferramentas.

O dsh é agnóstico a modelos. A documentação de provedores inclui catálogos para:

• Anthropic
• OpenAI
• Amazon Bedrock
• Google Vertex AI
• Azure

Ele também aceita endpoints compatíveis com OpenAI configurados em:

$DSH_HOME/settings.yaml

Uma configuração típica exige:

apiKeyEnv: MINHA_API_KEY
api: openai-completions
baseURL: https://api.exemplo.com/v1
models:
  - meu-modelo

As credenciais ficam separadas em:

.credentials.yaml

Isso permite compartilhar o arquivo de configuração sem expor chaves de API.

Com essa arquitetura, o dsh pode usar modelos DeepSeek, APIs de outros provedores ou modelos locais expostos por servidores compatíveis com OpenAI. Veja o passo a passo em como executar qualquer modelo no DeepSeek Harness.

O Claude Code executa apenas modelos Claude. A inferência pode passar por Bedrock, Vertex ou Foundry, mas o modelo continua sendo Claude.

Decisão prática

Escolha o dsh se você precisa alternar modelos, reduzir lock-in ou testar provedores locais.

Escolha o Claude Code se você prefere uma integração otimizada entre o harness e os modelos Claude.

Preço: pagamento por token vs. assinatura

O DeepSeek Harness é gratuito. O custo está na inferência da API conectada.

Se você usar a API da DeepSeek, pagará as taxas por token da DeepSeek. O DeepSeek V4-Pro foi lançado no mesmo período do dsh com preços superiores aos de seus predecessores, segundo a cobertura do VentureBeat.

Para usar a API V4-Pro, consulte como usar a API DeepSeek V4-Pro-0813.

O modelo de custo do dsh é simples:

Custo total = tokens consumidos × preço do provedor

Isso favorece uso leve ou esporádico, mas sessões agênticas longas podem consumir muitos tokens sem um teto fixo.

O Claude Code geralmente usa:

• Claude Pro: US$ 20/mês.
• Claude Max: US$ 100 ou US$ 200/mês.
• API com cobrança por uso, via Claude Console.

A assinatura torna o gasto mais previsível, embora existam limites de uso. A Anthropic aumentou os limites semanais em 50% em julho de 2026, conforme detalhado em nossa cobertura do aumento dos limites semanais do Claude Code.

Regra prática

• Uso ocasional: pagamento por token costuma ser mais vantajoso.
• Uso diário intenso: assinatura pode oferecer maior previsibilidade.
• Necessidade de múltiplos provedores: dsh oferece mais flexibilidade.

Maturidade: prévia vs. produto estabelecido

O DeepSeek Harness é explicitamente uma prévia para desenvolvedores. Seu README alerta:

HAVERÁ MUDANÇAS QUE QUEBRARÃO A COMPATIBILIDADE.

Trate isso como um requisito operacional. Configurações, plug-ins e fluxos automatizados podem exigir ajustes em versões futuras.

Antes de adotar dsh em produção, faça o seguinte:

1. Versione arquivos de configuração no Git.
2. Fixe versões de plug-ins quando possível.
3. Execute o dsh em um ambiente isolado.
4. Documente como recriar seus perfis.
5. Mantenha testes de regressão fora do agente.

O Claude Code está em uso desde o início de 2025 e possui um ecossistema mais consolidado:

• Memória de projeto via CLAUDE.md.
• Memória automática.
• Habilidades reutilizáveis.
• Hooks para executar comandos shell.
• Subagentes.
• SDK de Agente.
• Integração com GitHub Actions e GitLab CI/CD.
• Rotinas agendadas.

A comparação com outro concorrente maduro em Claude Code vs Codex CLI também mostra como a maturidade do ecossistema influencia a escolha.

Extensibilidade: kernel de plug-ins vs. pontos de extensão

No dsh, plug-ins não são um recurso adicional: são a base da arquitetura.

O projeto usa o Cordis, um kernel de plug-ins descrito no artigo “A Programming Paradigm for Spatiotemporal Composability”. Componentes como adaptadores de modelo, ferramentas, logs de sessão e o loop do agente podem ser substituídos.

Isso permite alterar profundamente o comportamento do agente, por exemplo:

• Substituir o adaptador de modelo.
• Adicionar ferramentas internas.
• Criar um roteador de contexto.
• Personalizar a estratégia de repetição de chamadas de ferramentas.
• Alterar o loop de execução do agente.

Projetos da comunidade podem ser encontrados pelo tópico:

dsh-plugin

No Claude Code, a extensão ocorre por interfaces definidas:

• Plug-ins.
• Habilidades.
• Hooks.
• Servidores MCP.
• Subagentes.

Você pode customizar o comportamento sem modificar o loop central da Anthropic.

Decisão prática

Use dsh se você precisa modificar o motor do agente.

Use Claude Code se precisa de extensões estáveis em pontos conhecidos, com menor risco de quebra após atualizações.

Permissões

Agentes capazes de editar arquivos e executar comandos precisam de controles claros.

No dsh, a interface web solicita aprovação para operações que exigem autorização segundo a política de permissões ativa. A documentação pública ainda não detalha completamente os níveis de política e suas semânticas.

No Claude Code, o sistema de permissões define seis modos:

default
acceptEdits
plan
auto
dontAsk
bypassPermissions

Além disso, ele oferece:

• Regras granulares de permissão e negação.
• Restrições por diretório de trabalho.
• Políticas gerenciadas para organizações.
• Controle por ferramenta e comando.

Exemplos práticos:

• Use plan quando quiser que o agente explore e proponha mudanças sem editar arquivos.
• Use acceptEdits para revisar alterações antes de aceitá-las.
• Use auto quando quiser reduzir prompts usando classificação em segundo plano.
• Reserve bypassPermissions para ambientes em sandbox, como contêineres isolados.

Para bases de código reguladas, equipes grandes ou CI autônomo, o Claude Code tem controles mais documentados atualmente.

MCP: nativo vs. plug-in da comunidade

O Model Context Protocol (MCP) permite que agentes acessem sistemas externos, como:

• Bancos de dados.
• Rastreadores de tickets.
• Documentação interna.
• Especificações de API.
• Ferramentas de teste.

O Claude Code suporta MCP nativamente. As ferramentas MCP participam das mesmas regras de permissão usadas pelo restante do agente.

No dsh, MCP não faz parte do núcleo atualmente. O suporte vem do plug-in comunitário:

dsh-mcp-manager

Esse plug-in adiciona suporte para:

• Servidores MCP HTTP remotos.
• Servidores MCP locais via stdio.
• OAuth.
• Tokens estáticos.
• Configuração por projeto.
• Ferramentas registradas no formato:

mcp__<name>__*

Ele funciona, mas não é um componente oficial do núcleo do dsh e pode ser afetado pela instabilidade da prévia.

Como usar Apidog com os dois agentes

Para desenvolvimento de APIs, o ponto mais importante é garantir que o agente trabalhe contra o contrato real da API.

O Apidog MCP Server pode expor a especificação da sua API para o agente. Assim, ele pode gerar clientes, handlers e testes com base nos endpoints e schemas reais, em vez de inventar nomes de campos.

Fluxo recomendado:

1. Mantenha a especificação OpenAPI atualizada no Apidog.
2. Conecte o Apidog MCP Server ao Claude Code ou ao dsh.
3. Peça ao agente para consultar a especificação antes de gerar código.
4. Execute testes de regressão com Apidog CLI no CI.
5. Bloqueie merges quando os testes de contrato falharem.

No Claude Code, a conexão MCP é nativa.

No dsh, ela passa pelo dsh-mcp-manager.

Você pode baixar o Apidog e executar seu servidor MCP no mesmo projeto em que os agentes trabalham.

Qual você deve escolher?

Não existe um vencedor absoluto. A decisão depende do seu nível de tolerância a mudanças, da necessidade de controle e do ambiente em que o agente será usado.

Escolha o DeepSeek Harness se:

• Você precisa inspecionar, auditar ou fazer fork do código.
• A licença MIT é um requisito.
• Você quer usar modelos DeepSeek, modelos locais ou outros provedores compatíveis.
• Você quer alterar o loop ou a arquitetura do agente.
• Você aceita mudanças incompatíveis e manutenção adicional.

Para começar:

npx @deepseek-ai/dsh web

Escolha o Claude Code se:

• Você precisa de um produto mais consolidado.
• Seu fluxo exige terminal, IDE, CI, desktop, web e mobile.
• Você precisa de controles de permissão detalhados.
• MCP nativo é importante.
• Sua equipe prefere custos previsíveis por assinatura.
• Você já decidiu trabalhar com modelos Claude.

Estratégia pragmática

Você não precisa escolher imediatamente.

Teste o dsh em projetos experimentais e use Claude Code em fluxos críticos. Em ambos os casos, mantenha a camada de API protegida com o Apidog: uma especificação testada, disponível via MCP e validada por execuções de regressão com CLI após mudanças geradas pelo agente.

FAQ

O DeepSeek Harness é realmente open source, ao contrário do Claude Code?

Sim. O dsh usa licença MIT e disponibiliza o código-fonte no GitHub, incluindo o loop do agente e o kernel de plug-ins. O repositório público do Claude Code usa aviso de todos os direitos reservados sob os Termos Comerciais da Anthropic e não fornece código-fonte para fork.

O DeepSeek Harness pode usar modelos Claude?

Sim. O dsh oferece provedores de catálogo para Anthropic, OpenAI, Bedrock, Vertex e Azure, além de endpoints compatíveis com OpenAI configurados em settings.yaml.

O inverso não é verdadeiro: Claude Code executa apenas modelos Claude, diretamente ou por Bedrock, Vertex e Foundry.

O DeepSeek Harness é estável para trabalho diário?

Ele é uma prévia para desenvolvedores, e o README alerta sobre mudanças que quebram compatibilidade. É utilizável para trabalho real, mas espere mudanças em configurações e plug-ins.

Para fluxos que não podem ser reconstruídos com frequência, Claude Code é a alternativa mais segura atualmente.

Ambos os agentes funcionam com Apidog?

Sim. O servidor MCP do Apidog expõe sua especificação de API para agentes compatíveis com MCP:

• Nativamente no Claude Code.
• No dsh via dsh-mcp-manager.

O Apidog CLI também pode executar testes de regressão em pipelines usados pelos dois agentes. Veja a configuração em usando o Apidog CLI no DeepSeek Harness.