DeepSeek Harness vs Claude Code vs Omnigent: qual usar

DeepSeek Harness vs Claude Code vs Omnigent: de qual precisa

DeepSeek Harness, Claude Code e Omnigent são todos chamados agent harnesses, mas resolvem partes diferentes do problema. DeepSeek Harness é um runtime de plugins com uma interface web no qual você fornece o modelo. Claude Code é um programa de terminal da Anthropic que executa modelos da Anthropic. Omnigent é um orquestrador da Databricks que controla outros harnesses, incluindo o Claude Code, em vez de implementar o seu próprio ciclo de agente. Nenhum deles substitui diretamente os outros. A pergunta relevante é qual camada está em falta.

As diferenças reais estão na arquitetura, no acoplamento ao modelo, na interface, na maturidade e na licença. Todas as versões e datas abaixo foram verificadas em 18 August 2026. Dois dos três avançam suficientemente depressa para que você deva voltar a verificar as informações antes de escolher um.

O que é o DeepSeek Harness e qual é a vantagem do modelo de plugins?

A DeepSeek publicou o DeepSeek Harness, ou dsh, em github.com/deepseek-ai/deepseek-harness em agosto de 2026. A descrição do repositório resume todo o design em quatro palavras: tudo é um plugin. O adaptador do modelo, o registo de ferramentas, o log da sessão, o sandbox e o próprio ciclo do agente são todos plugins, carregados por um runtime baseado em Cordis. A adoção foi invulgarmente rápida, e o repositório ultrapassou 150,000 stars poucos dias depois da publicação (verificado em 18 August 2026).

O DeepSeek Harness está atualmente em developer preview e continua a evoluir rapidamente. HAVERÁ ALTERAÇÕES INCOMPATÍVEIS.

Este é o aviso do próprio README e é a frase mais importante nesta comparação. Qualquer implementação criada hoje com base na API (interface de programação de aplicações) de plugins deverá ser reescrita.

Inicie-o com npx, que requer Node.js instalado:

npx @deepseek-ai/dsh web

O comando apresenta o respetivo URL. Por predefinição, a interface web é servida em http://127.0.0.1:3080. A compilação a partir do código-fonte usa pnpm:

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

dsh web é uma abreviatura de dsh --profile web. Um perfil é um diretório dentro de $DSH_HOME/profiles/, e o launcher inicia o perfil cujo nome indicar. Isto é relevante porque também existe um perfil headless: dsh --profile headless "job" executa uma sessão persistida, apresenta o resultado e termina. Este é o formato adequado para um cron job ou uma etapa de build. Os flags do launcher, como --profile e --patch, têm de vir antes dos argumentos da própria aplicação, porque o launcher deixa de os processar depois de transferir o controlo. Um flag como --port pertence ao perfil iniciado, não ao launcher, por isso a posição é importante. Os plugins são geridos encaminhando argumentos para o pnpm, como em dsh plugin --profile web add <package>.

O que é o Claude Code e por que é um programa de terminal?

O Claude Code é o agente CLI (interface de linha de comandos) da Anthropic. O produto não inclui uma interface web. Ele é executado no terminal, no diretório em que deve trabalhar, por isso adapta-se bem a uma sessão de servidor. A instalação requer um comando no macOS, Linux e WSL:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Uma instalação funcional apresenta uma versão e o nome do produto, por exemplo 2.1.211 (Claude Code). Se esse comando falhar, claude doctor apresenta diagnósticos somente de leitura da instalação e das definições, sem iniciar uma sessão. Também existe um pacote npm, npm install -g @anthropic-ai/claude-code, que, a partir da v2.1.198, requer Node.js 22 ou posterior. Ele instala o mesmo binário nativo, por isso o claude instalado não usa o Node.js durante a execução. A Anthropic também publica repositórios apt, dnf e apk assinados para Debian, Ubuntu, Fedora, RHEL e Alpine. Esta é a melhor opção num servidor que gere com gestão de configuração, porque as atualizações passam a ser recebidas pelo fluxo normal de atualização.

O Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console. O plano gratuito do Claude.ai não inclui acesso. Decidir entre uma subscrição Claude e a faturação da API altera muito mais o valor pago do que qualquer definição interna da ferramenta.

O que é o Omnigent e o que um meta-harness orquestra?

A Databricks anunciou o Omnigent em junho de 2026 e lançou-o sob a licença Apache 2.0. O projeto define-se como um meta-harness. Não implementa um ciclo de agente. Controla os que já existem: Claude, Codex, Cursor, OpenCode, Hermes, Pi e o SDK (software development kit) de agentes da OpenAI. Vários deles aparecem duas vezes na lista de harnesses: uma vez numa forma que comunica com o SDK do fornecedor e outra numa forma nativa que encapsula o programa de terminal real do fornecedor.

Um agente é um ficheiro YAML, sendo YAML um formato de configuração em texto simples:

name: my_agent
prompt: You are a helpful data analyst.

executor:
  harness: claude-sdk

tools:
  word_count:
    type: function
    callable: mypackage.mymodule.word_count
  docs:
    type: mcp
    url: https://example.com/mcp
  researcher:
    type: agent
    prompt: Search for relevant information.

A linha executor.harness é o objetivo central do projeto. Altere claude-sdk para codex e o mesmo prompt, com as mesmas ferramentas, será executado noutro fornecedor. Uma ferramenta pode ser uma função Python, um servidor MCP (model context protocol) ou outro agente. Este último caso é a forma de expressar trabalho multiagente: um subagente é simplesmente uma ferramenta. Se ainda não decidiu onde devem ficar as skills, os servidores MCP e os ficheiros de regras, vale a pena ler primeiro a diferença entre skills de agentes, MCP e ficheiros de regras, porque o Omnigent herda os elementos suportados pelo harness subjacente.

O exemplo incluído torna a ideia concreta. Polly é um orquestrador de programação que não escreve código. Planeia, delega o trabalho a subagentes de programação em worktrees Git paralelas e encaminha depois cada diff para um revisor que usa o modelo de outro fornecedor.

Instale-o com o script publicado:

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh

Também pode instalá-lo manualmente, mas precisa de Python 3.12 ou posterior:

uv tool install omnigent
omnigent setup
omnigent start

pip install "omnigent" também funciona, e os extras são selecionados da forma habitual com uv tool install "omnigent[databricks,modal]". omnigent setup recolhe as credenciais e os valores predefinidos. omnigent start inicia o servidor, regista a máquina como host e disponibiliza uma interface web em http://localhost:6767. omnigent server status e omnigent stop são os outros dois comandos que usará diariamente. Um omnigent sem argumentos abre uma sessão interativa sem iniciar o servidor.

A lista de dependências é mais extensa do que o instalador de uma linha sugere: Python 3.12 ou posterior, git, Node.js 22 LTS (long term support) ou posterior com npm e pnpm, tmux para os wrappers de terminal nativos e bubblewrap (bwrap) para a sandbox Linux. Isto é uma consequência direta do design. O Omnigent tem de instalar e supervisionar os CLIs dos fornecedores, pelo que é software Python cuja função é executar software Node.js.

Quem fornece o modelo e quem paga por ele?

Este é o eixo com maiores consequências práticas, e as três respostas são realmente diferentes.

O DeepSeek Harness funciona no modelo bring-your-own. O catálogo de provedores incluído abrange Anthropic, OpenAI, Bedrock, Vertex, Azure e Codex. Uma entrada de provedor personalizado recebe um ID de provedor em minúsculas, um nome de apresentação, um URL base, um protocolo de API, uma credencial e pelo menos um modelo. É assim que o pode apontar para um gateway da empresa ou para um servidor autoalojado. As chaves são gravadas em $DSH_HOME/.credentials.yaml, e $DSH_HOME/settings.yaml guarda apenas uma referência para essas chaves. Assim, o ficheiro de definições pode ser partilhado com segurança, mas o ficheiro de credenciais não. Uma entrada de gateway também pode indicar uma variável de ambiente, com uma linha como apiKeyEnv: GATEWAY_API_KEY. Apesar do nome do projeto, nada o obriga a utilizar os próprios modelos da DeepSeek.

O Claude Code está associado por conceção a um único fornecedor. Inicia sessão com uma conta paga ou define ANTHROPIC_API_KEY. Nesse caso, o Claude Code pede-lhe uma única vez para aprovar essa chave, em vez de abrir um browser. Este segundo método funciona num servidor headless. As organizações que já compram capacidade noutro local podem encaminhar os pedidos através do Amazon Bedrock, do Google Cloud's Agent Platform ou do Microsoft Foundry.

O Omnigent precisa do que o harness subjacente exigir, recolhido por omnigent setup. Aceita chaves de API, subscrições CLI existentes, gateways compatíveis com OpenAI ou Anthropic e workspaces do Databricks. Esse é o custo real de um meta-harness: uma máquina acaba por guardar as credenciais de todos os fornecedores. Leia como manter os segredos fora do alcance de um agente de IA antes de colocar essa máquina em qualquer ponto próximo da Internet pública.

Qual é o grau de maturidade de cada um em agosto de 2026?

O Claude Code está disponível de forma geral desde 2025 e encontra-se na série 2.1.x em agosto de 2026. Faz atualizações automáticas em segundo plano, oferece os canais de lançamento latest e stable, publica manifestos de lançamento assinados com GPG e documenta uma minimumVersion para organizações que precisam de definir uma versão mínima. Este é o perfil de um produto que já é usado em produção.

O Omnigent é público desde junho de 2026, ainda está na série 0.x e o respetivo README descreve-o como alpha. Espere alterações contínuas tanto na lista de harnesses como no esquema YAML. É utilizável, mas ainda não é estável.

O DeepSeek Harness é, por uma margem ampla, o mais recente. Foi publicado em agosto de 2026, poucos dias antes de esta comparação ser escrita, e o próprio README promete alterações incompatíveis. Um número muito elevado de stars mostra que muitas pessoas estão a acompanhá-lo. Não mostra se a API de plugins já está estabilizada.

Que licença cada um utiliza?

O DeepSeek Harness está sob a licença MIT, com as licenças de terceiros indicadas em THIRD_PARTY_NOTICES.md. O Omnigent está sob a licença Apache 2.0. O Claude Code não é open source: é um produto comercial da Anthropic, e a sua execução requer uma conta paga ou acesso à API com faturação. Se o requisito for poder ler e corrigir todas as linhas de código, o Claude Code fica excluído antes de qualquer comparação de funcionalidades. Se o requisito for que a ferramenta continue a funcionar no próximo mês sem intervenção, esse requisito aponta na direção oposta.

O que é necessário para executar cada um num VPS?

O Claude Code é o mais simples dos três. Instale-o, inicie sessão e execute-o dentro do tmux para que a sessão sobreviva a uma ligação SSH (secure shell) interrompida. A Anthropic documenta 4 GB de RAM (random access memory) ou mais e um processador x64 ou ARM64, em Ubuntu 20.04 ou posterior, Debian 10 ou posterior, ou Alpine 3.19 ou posterior. No Alpine, também é necessário instalar primeiro bash, curl, libgcc, libstdc++ e ripgrep, porque o comando de instalação falha com um erro not found sem esses componentes. Executar o Claude Code num VPS dentro do tmux explica detalhadamente a gestão da sessão.

O DeepSeek Harness precisa de Node.js e de um browser apontado para a respetiva interface web. O README pede Node.js sem indicar uma versão mínima, por isso Node 22 LTS é a escolha segura, já que é a versão usada pelo ecossistema envolvente. Não publique a porta 3080. Mantenha o servidor em 127.0.0.1 e encaminhe a porta a partir do seu portátil:

ssh -N -L 3080:127.0.0.1:3080 you@your-vps

Depois, abra http://127.0.0.1:3080 localmente. Instalar completamente o DeepSeek Harness num VPS explica a organização dos perfis e os comandos dos plugins.

O Omnigent é o mais pesado, porque instala e supervisiona CLIs de terceiros. Requer Python 3.12, Node.js 22, npm, pnpm, tmux e bubblewrap no mesmo sistema, além de transferir cada CLI de fornecedor que ativar. Encaminhe a respetiva porta da mesma forma:

ssh -N -L 6767:127.0.0.1:6767 you@your-vps

Para um servidor utilizado por várias pessoas, o método suportado é a implementação Docker em deploy/, que ativa contas multiutilizador por predefinição. O mesmo comportamento está disponível num servidor iniciado manualmente através da definição de OMNIGENT_AUTH_ENABLED=1, e o início de sessão OIDC (OpenID Connect) funciona com Google, GitHub, Okta e Microsoft. Guia do harness multiagente Omnigent explica os fornecedores de sandbox, que começam a ser relevantes assim que os agentes escrevem no disco.

Por que a interface web fica vazia no endereço IP público do servidor?

Ambos os harnesses web escutam no loopback por padrão. A alteração mais óbvia é associá-los a 0.0.0.0 e abrir a porta. Isso causa dois problemas distintos. O primeiro é de segurança: nenhum dos dois fornece autenticação no modo local padrão. Portanto, uma porta aberta equivale a um shell aberto no seu VPS. O segundo é uma regra do navegador que costuma causar confusão. crypto.randomUUID() só é definido num contexto seguro, isto é, HTTPS (hypertext transfer protocol secure), localhost ou 127.0.0.1. Se carregar a mesma interface através de um endereço simples, como http://203.0.113.10:3080, a consola do navegador apresenta:

TypeError: crypto.randomUUID is not a function

A página é então apresentada parcialmente ou não é apresentada, porque a criação da sessão falha antes de qualquer elemento poder ser desenhado. Não há uma falha no servidor, e os logs mostram um pedido normal. A origem não é considerada confiável pelo navegador. Por isso, uma função de que o frontend depende nunca foi definida. Um túnel SSH resolve o problema sem certificado, porque 127.0.0.1 conta como um contexto seguro. Um reverse proxy com um certificado TLS (transport layer security) válido também resolve o problema. Nesse caso, terá de adicionar a autenticação por conta própria.

Qual é o mais adequado para si?

Escolha Claude Code se pretende um agente de programação que já funciona hoje, aceita pagar à Anthropic e já trabalha no terminal. É o único dos três que é um produto comercial concluído, e não uma versão de pré-visualização.

Escolha DeepSeek Harness se o modelo de plugins for o principal requisito: pretende substituir o adaptador do modelo, a sandbox ou o ciclo do agente, e aceita que a interface usada pela sua integração possa mudar. O catálogo de fornecedores inclui Anthropic e OpenAI, pelo que escolhê-lo é apostar no runtime, e não nos modelos da DeepSeek.

Escolha Omnigent se já executa mais de uma CLI de agentes e o seu problema real for a coordenação: políticas, sandboxing, revisão pelo modelo de outro fornecedor e uma sessão partilhada que outras pessoas possam acompanhar. Esta ferramenta acrescenta uma camada à sua stack. Uma camada de que não precisa também é uma camada que pode falhar. Se o seu problema de coordenação for menor do que isso, duas sessões do Claude Code no mesmo sistema podem enviar mensagens entre si sem um orquestrador intermédio.

Se ainda estiver a elaborar uma lista de opções, o agente de programação Mimo Code AI pertence à mesma categoria de agentes de terminal que o Claude Code, e vale a pena ler sobre a execução de agentes de programação numa VM descartável qualquer que seja a sua escolha, porque nenhum destes três torna um rm -rf descuidado seguro por si só. Nenhum dos três decide também o tamanho do diff proposto pelo agente. Essa é uma questão ao nível do prompt. Por isso, vale a pena adicionar uma skill que incentive o agente a fazer a alteração mais pequena que funcione ao harness que escolher.

FAQ

Preciso de um plano Anthropic pago para usar o Claude Code?

Sim. O Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console, e o plano gratuito do Claude.ai não inclui acesso. Num VPS sem interface gráfica, defina ANTHROPIC_API_KEY antes da primeira execução. O Claude Code pede então uma vez a aprovação dessa chave, em vez de tentar abrir um browser. As organizações que tenham capacidade disponível noutro local podem encaminhá-lo para Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

O DeepSeek Harness pode executar modelos Claude ou OpenAI?

Sim. O catálogo de fornecedores instalado inclui Anthropic, OpenAI, Bedrock, Vertex, Azure e Codex. Adicione uma chave por fornecedor em Settings e depois em Models. Tudo o que estiver fora do catálogo deve ser adicionado como fornecedor personalizado. Esse fornecedor requer um id em minúsculas, um URL base, um protocolo de API, uma credencial e pelo menos um modelo. As chaves são armazenadas em $DSH_HOME/.credentials.yaml, enquanto $DSH_HOME/settings.yaml contém apenas uma referência. Faça uma cópia de segurança separada do ficheiro de credenciais e mantenha-o fora do controlo de versões.

O Omnigent substitui o Claude Code?

Não. O Omnigent executa o Claude Code. A lista de harnesses inclui Claude, Codex, Cursor, OpenCode, Hermes e Pi. Um agente seleciona um deles com uma única linha harness: no seu ficheiro YAML. Continua a ter de instalar e autenticar a CLI subjacente manualmente. O Omnigent acrescenta orquestração, políticas e sandboxing sobre essa CLI. Por isso, as dependências adicionais só compensam quando executa mais de um agente ou utiliza mais de um fornecedor.

Por que a interface Web do DeepSeek Harness fica em branco no endereço IP público do meu servidor?

Porque uma origem HTTP simples não é um contexto seguro, crypto.randomUUID() não está definido nesse endereço e a consola do browser apresenta TypeError: crypto.randomUUID is not a function. A criação da sessão falha. Por isso, a página é apresentada apenas parcialmente ou não é apresentada, embora os logs do servidor pareçam normais. Encaminhe a porta por SSH com ssh -N -L 3080:127.0.0.1:3080 you@your-vps e abra http://127.0.0.1:3080, porque o loopback é considerado um contexto seguro. Também pode usar um reverse proxy com um certificado TLS válido. Nesse caso, terá de adicionar a autenticação manualmente.

De quanta RAM um VPS precisa para estes harnesses?

A Anthropic documenta 4 GB ou mais para o Claude Code. Nem o DeepSeek Harness nem o Omnigent publicam um valor. Meça em vez de fazer uma estimativa. Nos três casos, o modelo é executado remotamente. O próprio harness gere processos e ficheiros, mas não executa a inferência. O que realmente determina o tamanho do servidor é o trabalho que o agente executa nele, como uma compilação e uma suite de testes. O Omnigent requer mais recursos, porque Python, Node.js, tmux e cada CLI de fornecedor ativada são executados na mesma máquina.