Guia de configuração do DeepSeek Harness
O modelo é o cérebro; o harness é tudo o que envolve ele — contexto, ferramentas, plugins, servidores MCP, permissões, memória. O DeepSeek Harness se instala em cerca de cinco minutos e roda em qualquer modelo que você apontar: GLM, Ollama, até Claude. Este passo a passo acompanha uma instalação real quadro a quadro.
TL;DR — o que você vai instalar
- O modelo é o cérebro. O harness é tudo ao redor: contexto, ferramentas, plugins, servidores MCP, permissões, memória. O DeepSeek Harness entrega tudo isso com cada decisão ainda em aberto.
- A instalação leva cerca de cinco minutos: um comando no terminal, e um painel web local abre automaticamente.
- Você não precisa usar a API do DeepSeek. Conecte GLM, um nível gratuito do Gemini, um modelo Ollama local — ou até sua chave Anthropic para rodar Claude dentro do harness.
- Toda execução é rastreável até o payload de cada chamada de ferramenta, e você pode matar uma tarefa em pleno voo e retomá-la com o contexto intacto.
DeepSeek Harness Setup: A Free Claude Code You Own In 10 Minutes
Vídeo de:Sharbel A.13 min
As capturas de tela deste guia vêm do vídeo acima; os direitos autorais pertencem ao criador, creditado aqui e linkado no carimbo de tempo de cada etapa. As etapas escritas são nossas.
Começo rápido: instalado em cerca de cinco minutos
- 1
Abra o site e pegue o comando de instalação
O site do DeepSeek Harness exibe com orgulho o princípio de design: “Everything is a plugin”. Pelos botões da página inicial, abra o repositório no GitHub e copie o comando de instalação de uma linha.
A página inicial do projeto linka tanto o repositório no GitHub quanto a documentação para desenvolvedores.Assistir a partir de 1:58 - 2
Rode a instalação no seu terminal
Cole o comando e deixe rodar — cerca de cinco minutos. No fim, o terminal imprime a URL local do painel (http://127.0.0.1:3880) e abre o navegador automaticamente. Adicione --no-open se preferir abrir você mesmo.
Instalação concluída — o painel roda localmente na porta 3880.Assistir a partir de 2:37 - 3
Pule o pedido de chave de API por enquanto
A primeira execução pede uma chave de API oficial do DeepSeek. Você não precisa dela: clique em “Configure later” e adicione no próximo passo o provider que você usa de verdade.
O diálogo da primeira execução — “Configure later” pula o provider oficial.Assistir a partir de 2:55
Conecte qualquer modelo que quiser
- 4
Adicione seu primeiro provider de modelo
Vá em Settings → Models → Add provider. No vídeo, o autor conecta uma assinatura GLM (listada como Zai), mas o mesmo diálogo aceita DeepSeek, OpenAI, Anthropic, Bedrock, Vertex e mais.
Dois providers ativos — o modelo é um plugin, não um cadeado.Assistir a partir de 3:15 - 5
Ou conecte um modelo local com Ollama
“Add a custom provider” pede um ID de provider, um nome de exibição, uma URL base e um protocolo de API (openai-completions funciona com o Ollama). Pesos locais são o único caminho grátis de verdade sem teto — todos os níveis gratuitos hospedados têm limites.
Formulário de provider personalizado — aponte para a URL base do seu Ollama e crie.Assistir a partir de 3:42
Tudo é plugin
- 6
Explore o painel de plugins
Settings → Plugins lista cada capacidade do harness — comandos, comandos de UI, loops de feedback —, cada uma alternável individualmente entre Default e Enabled. Até a barra lateral é um plugin.
A lista de plugins — tudo o que você vê pode ser desligado.Assistir a partir de 5:32 - 7
Ligue o creator mode
Creator mode é um preset que carrega automaticamente as ferramentas de desenvolvimento de plugins, para o agente construir plugins para você em vez de só usá-los.
O creator mode pré-carrega as ferramentas de desenvolvimento de plugins.Assistir a partir de 6:00 - 8
Peça seu primeiro plugin em linguagem simples
O plugin do vídeo: “Add a plugin that fires a desktop notification when a run finishes, and puts the token count and what it cost me into the notification”. Mande como uma mensagem normal de chat.
Uma frase serve de especificação — o agente escreve e instala o plugin.Assistir a partir de 6:08 - 9
Veja o plugin disparar na próxima execução
Quando a execução termina, a notificação aparece com a contagem de tokens e o custo. No vídeo, a primeira versão tinha texto preto sobre preto ilegível — uma mensagem de follow-up arrumou as cores, e o plugin continuou funcionando.
Execução concluída — o agente confirma a notificação, estatísticas incluídas.Assistir a partir de 9:26
Trajectory: veja cada chamada e retome qualquer execução
- 10
Abra a aba Trajectory e leia tudo
Toda execução guarda uma trajectory completa: o prompt de sistema exato, o contexto injetado palavra por palavra, quais skills carregaram e por quê, cada chamada de ferramenta com payload, resultado e tempo. Não é um resumo — é o log real.
Turnos codificados por cores mais cada chamada de ferramenta com payload e resultado.Assistir a partir de 7:46 - 11
Mate uma execução no meio da tarefa — e retome
Nada é gravado em pedra, então nada precisa reiniciar. Mate uma execução no meio do caminho e retome: a trajectory mostra a consulta de workspace que restaura o mesmo contexto, preferências do usuário e estado das ferramentas. O README avisa sobre mudanças que quebram compatibilidade (é uma prévia para desenvolvedores) — esta é a rede de segurança.
Ao retomar, o mesmo contexto que a execução morta tinha volta ao lugar.Assistir a partir de 8:02