DeepSeek Harness: o que é, como instalar e como se compara

DeepSeek Harness em resumo

Como instalar e usar o DeepSeek Harness

1. Escolha desktop ou web

   Baixe o app de desktop em deepseek.com/en/harness para macOS (Apple silicon) ou Windows (64 bits); no macOS ele também pode instalar um comando dsh. Em qualquer máquina com Node.js, rode a interface web com npx ou compile a partir do código-fonte.

   # Rode a interface web com Node.js
   npx @deepseek-ai/dsh web
   # depois abra http://127.0.0.1:3080
   
   # Ou compile a partir do código-fonte
   git clone https://github.com/deepseek-ai/deepseek-harness.git
   cd deepseek-harness && pnpm install && pnpm run build && pnpm dsh web

2. Entre na conta ou adicione uma chave de API

   Na primeira execução, entre com sua conta da DeepSeek no navegador ou cole uma chave de API do platform.deepseek.com em Settings → Models (Configurações → Modelos). As chaves ficam salvas em ~/.dsh/.credentials.yaml ($DSH_HOME).

3. Dê instruções do projeto

   O DeepSeek Harness lê AGENTS.md ou CLAUDE.md no seu projeto (além das variantes .local.md) e um ~/.dsh/AGENTS.md global. Instruções que você já escreveu para o Claude Code ou o Codex continuam valendo; veja o guia do CLAUDE.md e o guia do AGENTS.md no Codex.

4. Defina quanto ele pode fazer

   Escolha um modo de sandbox (read-only, workspace-write ou danger-full-access) e uma política de aprovação (ask ou never). As notas de segurança da DeepSeek dizem que o harness é experimental, não passou por auditoria de segurança e o sandbox não garante isolamento, então comece em modo somente leitura no código que importa para você.

5. Rode tarefas em modo headless e adicione plugins

   Use dsh headless para tarefas avulsas em scripts, --resume ou --session-id para continuar uma sessão e dsh plugin para adicionar plugins como tarefas agendadas, subagentes ou equipes de agentes.

   # Uma tarefa, sem interface, com um modo de permissão
   dsh headless "Add tests for src/auth" --permission-mode workspace-write
   
   # Transmita os eventos como JSON, por exemplo para scripts
   dsh headless "Summarize open TODOs" --json
   
   # Adicione um plugin a um perfil
   dsh plugin --profile default add <package>

Fonte: repositório e documentação do DeepSeek Harness

Preços do DeepSeek Harness: quanto custa usar

O harness é gratuito e open source. O uso é cobrado pela API da DeepSeek nestas tarifas, em dólares americanos por milhão de tokens (api-docs.deepseek.com, 6 de novembro de 2026). As tarifas fora do pico são metade das de pico; os horários de pico são das 01:00 às 04:00 e das 06:00 às 10:00 UTC em dias úteis, exceto feriados na China. A DeepSeek não documenta nenhuma cota gratuita, então “usar de graça” na prática significa software gratuito mais o crédito de API que você tiver.

Principais recursos

• Plugins para tudo: ferramentas, modelos, interfaces e comportamentos são plugins; instale por perfil ou crie um pedindo no chat ("Creator mode", o modo criador). Os plugins da comunidade usam o tópico dsh-plugin no GitHub.
• Entre os plugins oficiais e experimentais listados pela DeepSeek estão equipes de agentes, revisão de aprovação automática, tarefas agendadas, entrada por voz, um terminal, um loop de agente e subagentes.
• Skills (pastas SKILL.md), servidores MCP e hooks, incluindo uma ponte experimental que roda os hooks existentes do Claude Code.
• Subagentes no mesmo processo ou apoiados por ACP, Codex, Claude Code ou outro Harness.
• Sessões que podem ser retomadas, compactação, modo headless com eventos JSON e um SDK para construir em cima.
• O Super-agent: um bundle separado com licença MIT, o dsh-superagent, faz o harness agir de forma proativa em um repositório do GitHub; a DeepSeek o chama de protótipo de pesquisa. Veja DeepSeek Super-Agent explicado.
• O paper que costuma ser citado junto, "A Programming Paradigm for Spatiotemporal Composability" (arXiv, agosto de 2026), descreve o Cordis, o framework por baixo, e não o harness em si.

DeepSeek Harness vs Claude Code vs Codex vs OpenCode

A DeepSeek não publica uma comparação; esta é a nossa leitura da documentação de cada ferramenta em 6 de novembro de 2026. A DeepSeek também documenta como usar seus modelos dentro do Claude Code, do Codex e do OpenCode, então dá para combinar.

Perguntas que as pessoas pesquisam

• Linux: ainda não há download de desktop para Linux; no Linux, rode a interface web com npx @deepseek-ai/dsh web ou compile a partir do código-fonte.
• VS Code: a DeepSeek não oferece extensão para o VS Code; use a interface de desktop ou web ao lado do seu editor, ou use os modelos da DeepSeek dentro de um agente de editor que a DeepSeek documenta, como o Claude Code ou o Codex.
• Ollama e modelos locais: não documentado. O harness aceita um endpoint personalizado compatível com OpenAI ou Anthropic para um servidor próprio, que é o caminho documentado para usar seus próprios modelos.
• TUI: nenhuma interface de terminal vem por padrão; um perfil personalizado ou o plugin experimental de terminal são as opções documentadas.
• Paper: veja o paper do Cordis acima; a DeepSeek pede que o harness seja citado como "DeepSeek Harness: Everything is a Plugin".

Dê ao DeepSeek Harness um emprego, não só uma tarefa

O Crewmark é compatível com o DeepSeek Harness, além do Claude Code, do Codex e do OpenCode. Ele transforma uma sessão em um funcionário de IA com um cargo, uma meta e um horário de trabalho, e a acorda com um heartbeat para pegar a próxima issue de um quadro compartilhado.

1. Escolha o DeepSeek Harness como agente

   Rode o comando de configuração no seu projeto; o funcionário roda em uma sessão do DeepSeek Harness na sua máquina, cobrada na sua conta da API da DeepSeek.

2. Dê a ele um cargo e uma meta

   Um engenheiro de software, um especialista em SEO, um profissional de growth marketing: cada um com um número para mover. Leia o que é um funcionário de IA.

3. Deixe o heartbeat iniciar o trabalho

   Durante o horário de trabalho, ele acorda a cada 15, 30 ou 60 minutos, pega a próxima issue e manda mensagem quando precisa de uma decisão. Compare abordagens em o que é um superagent.

Perguntas frequentes sobre o DeepSeek Harness