Como usar as APIs do Claude e do GPT no DeepSeek Harness

Para usar as APIs do Claude e do GPT no DeepSeek Harness, adicione um provedor personalizado em OpenAI Chat Completions com a URL base https://api.omniakey.com/v1 e dê a cada modelo um limite de saída de 128.000 tokens e seus níveis de raciocínio. Não coloque o Claude no provedor integrado da DeepSeek: esse provedor envia um ajuste de thinking que o Claude recusa, então toda requisição retorna 400.

Testamos essa configuração em 28 de outubro de 2026 no DeepSeek Harness 0.2.1-rc.3. Em um único provedor, Claude Opus 5.5, Claude Sonnet 5.5, GPT-6.1 Sol e GPT-6.1 Terra usaram as ferramentas do Harness para examinar um projeto pequeno e responderam corretamente. A OmniaKey vende acesso de API aos quatro modelos, e os testes passaram por ela.

Resposta curta

• Mantenha o Claude fora do provedor integrado da DeepSeek. Ele sempre pede thinking em um formato que o Claude recusa, e o protocolo não pode ser alterado.
• Adicione um provedor personalizado: protocolo OpenAI Chat Completions, URL base https://api.omniakey.com/v1. Claude e GPT-6.1 rodam nele.
• Nas opções de cada modelo, defina o limite de saída em 128.000 e ative os níveis de raciocínio (Reasoning levels). Um modelo adicionado à mão começa sem os dois.
• Aponte o modelo padrão para o novo provedor e teste em uma sessão nova.

Por que o Claude retorna 400 no DeepSeek Harness?

O provedor integrado da DeepSeek monta cada requisição no formato da DeepSeek, e o Claude deixou de aceitar o ajuste de thinking desse formato.

A menos que o esforço esteja definido como off, o provedor envia thinking: {type: "enabled"} sem orçamento de tokens. Ele também pede 256.000 tokens de saída se a entrada do modelo não definir um limite menor. O protocolo é fixo: o Harness recusa um campo de protocolo nesse provedor com "protocol is not configurable".

O guia de migração da Anthropic (consultado em 28 de outubro de 2026) explica por que isso falha. A partir do Claude Opus 4.7, o Claude só aceita thinking no modo adaptativo, então enabled retorna 400. Modelos mais antigos como o Claude Haiku 4.5 ainda aceitam enabled, mas só com budget_tokens, que esse provedor nunca envia.

Por isso todo modelo Claude falha ali. Quando colocamos o Claude Opus 5.5 no provedor integrado, o Harness mostrou um erro que começa com Invalid request for the selected model. claude-opus-5-5 requires adaptive thinking. Corrigir só o thinking não basta: o Claude Opus 5.5 para em 128.000 tokens de saída, então o padrão de 256.000 seria o próximo 400.

Como adiciono o provedor OmniaKey?

Adicione em Settings. No Harness 0.2.1-rc.3, o formulário tem todos os campos necessários. Primeira vez no Harness? Instale primeiro com o guia de instalação do DeepSeek Harness.

1. Clique em More no canto inferior esquerdo, abra Settings e vá para Models. Clique em Add model provider e escolha Custom model API.
2. Preencha o provedor:
   • Provider ID: omniakey
   • Display name: OmniaKey
   • Base URL: https://api.omniakey.com/v1
   • API protocol: OpenAI Chat Completions
   • API key: sua chave da OmniaKey
3. Em Models, clique em Add model uma vez para cada ID de modelo da tabela abaixo.
4. Abra as opções de cada modelo com a seta no fim da linha e preencha os valores da tabela.
5. Clique em Create provider.

“low a max” são cinco níveis: low, medium, high, xhigh e max. O valor de API de cada nível é a mesma palavra, exceto o nível off do Terra, que envia none. Marque também Imagem (Image) em Input types: os quatro modelos leem imagens e, sem essa marcação, o Harness recusa as imagens que você colar.

Use OpenAI Chat Completions para os quatro modelos; é o protocolo que testamos. O Claude não tem nível off: o Claude Opus 5.5 sempre pensa, e a OmniaKey retorna 400 quando o Opus 5.5 recebe none. O GPT-6.1 Sol começa em low e também não aceita none. O Terra aceita, então o nível off dele pula o raciocínio.

Os limites vêm dos fornecedores dos modelos. A Anthropic informa uma janela de contexto de 1.000.000 tokens para Claude Opus 5.5 e Claude Sonnet 5.5. As páginas da OpenAI trazem 1.050.000 para os dois modelos GPT-6.1; nós as conferimos em 27 de outubro de 2026 para a comparação entre Terra e Sol. Os quatro param em 128.000 tokens de saída.

Se você adicionou IDs do Claude ao provedor integrado da DeepSeek antes, apague-os lá, para não escolher a cópia quebrada por engano.

Com o provedor pronto, o Claude Opus 5.5 em esforço high executou um comando, leu um arquivo e respondeu em 12 segundos:

Por que o ajuste de esforço não faz nada?

Os níveis de raciocínio estão desligados para esse modelo. Um modelo adicionado à mão começa com eles desligados, e o Harness o trata como um modelo que não consegue raciocinar: não envia esforço, e o modelo responde com o valor padrão.

Ative-os e adicione os níveis da tabela. O menu de modelos abaixo da caixa de mensagem passa a oferecer cada um deles.

Com qual modelo uma sessão nova começa?

Com o da entrada agent-default-model no arquivo de configuração do seu perfil. No aplicativo de desktop, esse arquivo é ~/.dsh/profiles/desktop/cordis.patch.yml. Se a entrada ainda nomeia um modelo Claude no provedor da DeepSeek, toda sessão nova começa no provedor que falha. Aponte-a para o novo:

- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: omniakey
    model: claude-opus-5-5
    reasoningEffort: high

Uma instalação nova já tem essa entrada, então edite-a em vez de adicionar uma segunda. Com duas, o Harness usa a última e não avisa.

Você ainda pode trocar de modelo em cada sessão pelo menu abaixo da caixa de mensagem. Teste em uma sessão nova: o guia da DeepSeek diz que uma sessão que já enviou uma requisição mantém o modelo registrado no log.

Onde fica o arquivo de configuração?

No aplicativo de desktop, ele é ~/.dsh/profiles/desktop/cordis.patch.yml, e tudo o que você configura em Settings pode ir para lá. Este é o arquivo que testamos, com o provedor e o modelo padrão juntos. Mantenha as entradas que já existem no seu arquivo, como as configurações de interface. Se ele já tiver uma entrada llm-pi-ai, adicione o provedor omniakey sob o providers: dela em vez de criar uma segunda entrada.

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      omniakey:
        apiKeyEnv: OMNIAKEY_API_KEY
        displayName: OmniaKey
        api: openai-completions
        baseURL: https://api.omniakey.com/v1
        models:
          - id: claude-opus-5-5
            name: Claude Opus 5.5
            contextWindow: 1000000
            maxTokens: 128000
            input: [text, image]
            reasoningEfforts: { low: low, medium: medium, high: high, xhigh: xhigh, max: max }
          - id: claude-sonnet-5-5
            name: Claude Sonnet 5.5
            contextWindow: 1000000
            maxTokens: 128000
            input: [text, image]
            reasoningEfforts: { low: low, medium: medium, high: high, xhigh: xhigh, max: max }
          - id: gpt-6.1-sol
            name: GPT-6.1 Sol
            contextWindow: 1050000
            maxTokens: 128000
            input: [text, image]
            reasoningEfforts: { low: low, medium: medium, high: high, xhigh: xhigh, max: max }
          - id: gpt-6.1-terra
            name: GPT-6.1 Terra
            contextWindow: 1050000
            maxTokens: 128000
            input: [text, image]
            reasoningEfforts: { "off": none, low: low, medium: medium, high: high, xhigh: xhigh, max: max }
- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: omniakey
    model: claude-opus-5-5
    reasoningEffort: high

apiKeyEnv nomeia a chave sem guardá-la. O Harness procura a chave com esse nome, salva em Settings ou exportada no ambiente de onde o Harness inicia, então a chave em si não fica no arquivo. Salve o arquivo e abra uma sessão nova; reinicie o Harness se o provedor não aparecer.

Solução de problemas

"requires adaptive thinking"

O Claude está no provedor integrado da DeepSeek. Mova-o para o provedor OmniaKey e aponte também o modelo padrão para lá.

404 em toda requisição

Falta /v1 na URL base. Em OpenAI Chat Completions, a URL base da OmniaKey é https://api.omniakey.com/v1.

Um erro sobre max_tokens

O limite de saída passa do que o modelo permite. Os quatro modelos param em 128.000, e o provedor integrado da DeepSeek pede 256.000 por padrão.

"The current model does not support images"

Nos Input types do modelo, só Texto (Text) está marcado. Marque também Imagem (Image) nas opções dele; os quatro modelos da tabela leem imagens.

Sem níveis de esforço, ou o ajuste de esforço não muda nada

Ative os níveis de raciocínio (Reasoning levels) nas opções do modelo e adicione os níveis da tabela.

Continua falhando depois da mudança

Abra uma sessão nova, confira agent-default-model e verifique se o provedor da DeepSeek não lista nenhum ID do Claude.

Fontes consultadas

• Guia de migração da Anthropic: Claude Opus 5.5
• Esforço e thinking adaptativo da Anthropic
• Página do modelo GPT-6.1 Sol
• Página do modelo GPT-6.1 Terra
• Guia de modelos e provedores do DeepSeek Harness
• Referência do provedor dsh-llm-pi-ai
• Referência da API compatível com OpenAI da OmniaKey
• Catálogo de modelos da OmniaKey

Páginas de modelos na OmniaKey: Claude Opus 5.5, Claude Sonnet 5.5, GPT-6.1 Sol e GPT-6.1 Terra.