Como rodar o DeepSeek Harness com npx e abrir o Web UI no navegador
Rodar o DeepSeek Harness com npx é o caminho mais curto pra ver a ferramenta de pé: com o Node.js instalado, você chama npx @deepseek-ai/dsh web e o harness serve o Web UI em http://127.0.0.1:3080 por padrão. Localmente, a CLI carrega a árvore do Loader, imprime dsh web: opening the default browser no terminal e só então abre o navegador padrão. Se não quiser essa abertura automática, use --no-open. A chave da API entra depois, dentro do Web UI, em Settings > Models, no card DeepSeek. Lembre que o projeto está em developer preview, então espere breaking changes
Um comando só, zero instalação global, e o Web UI do DeepSeek Harness abrindo sozinho no seu navegador
Fala aí, beleza? O DeepSeek Harness (a CLI se chama dsh) é o harness de agente open source da DeepSeek AI, e a sacada dele é a arquitetura: TUDO ali é plugin
Modelos, ferramentas, skills, sessões, sandboxes, armazenamento, loops, agendamento e até a própria UI entram como plugin, tudo construído em cima do framework Cordis
Se você já mexeu com um gerenciador de pacotes que monta o app por composição, a ideia é bem parecida: o núcleo é pequeno e o resto pluga em volta
Antes de seguir, um aviso honesto: o projeto foi lançado como developer preview v0.1 em 13 de agosto de 2026, e o próprio repositório oficial avisa que vão existir mudanças que quebram compatibilidade
Ou seja: dá pra brincar hoje, mas não apoie nada crítico nele ainda 🙂
Formação Claude Code
Domine Claude Code do absoluto zero até o avançado
- 120 aulas
- 4 projetos
- 9h 45min
O que você precisa antes de rodar o comando
A lista é curta, e é essa a graça
- Node.js instalado, na faixa que o repositório declara no
package.jsonda raiz:^22.19.0 || >=24.0.0 - npx, que já vem junto com o Node, então na prática você não instala nada a mais
E só
Não existe instalador nem binário desktop oficial do DeepSeek Harness
A distribuição é o pacote npm @deepseek-ai/dsh ou o código-fonte no GitHub, com o código licenciado sob MIT
A versão mais recente publicada do pacote no npm é a 0.1.1-rc.2, o que já te diz bastante sobre o estágio do projeto: rc quer dizer release candidate, e isso combina com o developer preview
Passo a passo para abrir o Web UI do DeepSeek Harness
Bora ver na prática? São seis passos, e o segundo já coloca a interface na tela
- Confira a versão do Node antes de qualquer coisa
node -vO número que aparecer precisa cair dentro de ^22.19.0 || >=24.0.0
O erro comum deste passo: pular a conferência porque "tenho Node instalado" e depois brigar com falha de execução que não tem nada a ver com o harness
- Rode o comando oficial pra subir o Web UI
npx @deepseek-ai/dsh webNa primeira execução, o npx precisa baixar o pacote antes de executar, então não estranhe a demora inicial
Depois disso o dsh carrega a árvore completa do Loader, e é aí que mora a paciência: ele só entrega o controle pro navegador DEPOIS que essa árvore estabiliza
Quando estiver pronto, a CLI imprime no terminal a mensagem literal:
dsh web: opening the default browserE então abre o navegador padrão na URL canônica
O erro comum deste passo: achar que travou e matar o processo no meio do carregamento
- Abra o endereço na mão, se preferir
O subcomando web serve o Web UI em http://127.0.0.1:3080 por padrão
http://127.0.0.1:3080É o mesmo lugar que a abertura automática te leva, só que no seu tempo
- Use
--no-openquando não quiser navegador nenhum
npx @deepseek-ai/dsh web --no-openEssa flag sobe o servidor sem abrir o navegador, e é ela que salva sua vida em ambiente sem interface gráfica
O erro comum deste passo: rodar o comando padrão dentro de um container ou de uma sessão remota e ficar esperando uma janela que nunca vai aparecer
- Configure a chave da API dentro do próprio Web UI
A chave do provedor não vai no comando: ela é configurada na interface, em Settings > Models, no card do DeepSeek, que expõe um único campo de API key
E se liga nisso: o campo é write-only
Depois de salvar, a página recebe apenas um descritor redigido, nunca o segredo literal de volta
O erro comum deste passo: voltar na tela, ver o valor mascarado e achar que a chave não salvou, colando tudo de novo
- Saiba onde a chave foi parar
A chave salva fica gravada em $DSH_HOME/.credentials.yaml, e o arquivo de settings guarda só a referência à credencial, não o segredo
A ordem em que as credenciais de provedor são resolvidas é esta:
- ambiente herdado
$DSH_HOME/.credentials.yaml- o
.envdo diretório onde o comando foi chamado - e por fim
$DSH_HOME/.env
Tome cuidado com essa ordem: uma variável já exportada no seu shell ganha de tudo que estiver salvo no arquivo de credenciais, e isso explica muito "mas eu salvei a chave certa!"
Problemas comuns ao subir o dsh web (e como resolver)
O navegador não abriu sozinho:
Sintoma: o comando roda, o terminal fica cuspindo coisa, e nada aparece na tela
Causa: em execução local o dsh abre o navegador padrão só depois que a árvore completa do Loader estabiliza, e antes disso ele simplesmente não entregou o controle pra ninguém
Solução: aguarde a mensagem dsh web: opening the default browser no terminal, ou vá direto em http://127.0.0.1:3080 no navegador
Node fora da faixa exigida:
Sintoma: o comando nem chega perto de servir a interface
Causa: o repositório declara ^22.19.0 || >=24.0.0, e sua máquina pode estar com um Node mais antigo herdado de outro projeto
Solução: confira com node -v e ajuste antes de tentar de novo
O comportamento mudou de uma versão pra outra:
Sintoma: o passo que funcionou semana passada não funciona hoje
Causa: developer preview iterando rápido, com aviso explícito de breaking changes no README
Solução: relê o README
Como prevenir os três: fixe a versão do Node que você usa no projeto e releia o README a cada atualização do pacote
É chato? é
Mas é MUITO menos chato que debugar por uma hora uma mudança que estava documentada o tempo todo
Quando usar npx e quando rodar a partir do código-fonte
Existem dois caminhos oficiais, e eles servem a objetivos diferentes
| Situação | Caminho | Comando |
|---|---|---|
| Testar rápido, sem instalação global | npx | npx @deepseek-ai/dsh web |
| Mexer no código do harness | clone do repositório | pnpm run build e depois pnpm dsh web |
| Servidor remoto, container ou máquina sem interface gráfica | npx com a flag | npx @deepseek-ai/dsh web --no-open |
O caminho do npx é o do curioso: você quer ver a interface de pé, entender o fluxo e decidir se vale seu tempo
Já o caminho do código-fonte é pra quem vai colocar a mão na arquitetura de plugins
Ali você clona o projeto deepseek-ai/deepseek-harness, roda pnpm run build antes, e depois pnpm dsh web usa os artefatos já construídos sem reconstruir tudo de novo
E se você estiver usando o harness pra gerar código de verdade, vale combinar com um segundo par de olhos: dá pra revisar o código gerado com o Claude Code antes de abrir o PR, em vez de confiar no modo 100% vibe coder
A lógica de interface no navegador aqui é a mesma de rodar tarefas sem abrir o terminal no Codex: o terminal vira só o ponto de partida, e o trabalho acontece na tela
Próximo passo depois de abrir o Web UI
Recapitulando: o caminho mais curto é um comando só
npx @deepseek-ai/dsh web, esperar a árvore do Loader carregar, ver a mensagem dsh web: opening the default browser no terminal e cair em http://127.0.0.1:3080
Se o navegador não for bem-vindo naquele ambiente, --no-open resolve
O próximo passo natural é salvar sua API key em Settings > Models, no card do DeepSeek, e começar a explorar a arquitetura de plugins, que é o que realmente diferencia esse harness dos outros
E mantenha o repositório no radar antes de apoiar qualquer coisa crítica em cima dele: developer preview com breaking changes anunciadas é exatamente o que o nome diz…
até o próximo post! 😀
Perguntas frequentes
Preciso instalar o dsh globalmente pra usar o Web UI?
Não. O comando npx @deepseek-ai/dsh web já baixa e roda o pacote na hora, sem instalação global. Isso porque não existe instalador nem binário desktop oficial: a distribuição é só o pacote npm @deepseek-ai/dsh ou o código-fonte no GitHub.
Qual porta o Web UI do DeepSeek Harness usa por padrão?
O subcomando web serve a interface em http://127.0.0.1:3080 por padrão. É o mesmo endereço que a abertura automática do navegador leva você, então dá pra digitar na mão se preferir.
Como faço pra rodar o dsh web sem abrir o navegador automaticamente?
Use a flag –no-open: npx @deepseek-ai/dsh web –no-open. Ela sobe o servidor sem abrir o navegador, o que é essencial em container ou sessão remota sem interface gráfica.
Onde fica salva a chave de API do DeepSeek no Harness?
Depois de cadastrada em Settings > Models, no card do DeepSeek dentro do Web UI, a chave é gravada em $DSH_HOME/.credentials.yaml. O arquivo de settings guarda só a referência à credencial, nunca o segredo em texto puro.
Qual versão do Node é exigida pelo DeepSeek Harness?
O package.json da raiz do repositório declara a faixa ^22.19.0 || >=24.0.0. Vale conferir com node -v antes de rodar o npx, pra não confundir erro de versão com bug do harness.
O DeepSeek Harness já é estável pra uso em produção?
Ainda não. O projeto foi lançado como developer preview v0.1 em 13 de agosto de 2026, e o próprio README avisa que vão existir mudanças que quebram compatibilidade. Dá pra testar e brincar, mas não é indicado apoiar nada crítico nele por enquanto.
Matheus Battisti
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 27min
Blog | Mais populares
DeepSeek V4 Pro: o que é e quando compensa usar em vez do V4 Flash?
DeepSeek V4 Pro tem 1,6 tri de parâmetros e janela de 1 milhão de tokens. Entenda o preço, o desempenho e quando vale mais a pena que o V4 Flash.
Como rodar o DeepSeek V4 no Ollama: o passo a passo e o que checar antes de tentar
Rodar o DeepSeek V4 no Ollama hoje é via tag cloud: veja como fazer login, baixar a tag e usar via CLI ou API local, e quando vale ir de GGUF offline.
DeepSeek V4 Pro Max: o que é e como escolher entre as variantes da família V4
DeepSeek V4 Pro Max não é um modelo separado: é o modo de raciocínio máximo do V4-Pro. Veja como funciona e como escolher entre as variantes.
