Come usare le API di Claude e GPT in DeepSeek Harness

Per usare le API di Claude e GPT in DeepSeek Harness, aggiungi un provider personalizzato su OpenAI Chat Completions con il Base URL https://api.omniakey.com/v1 e assegna a ogni modello un limite di output di 128.000 token e i suoi livelli di ragionamento. Non mettere Claude nel provider integrato di DeepSeek: quel provider invia un'impostazione thinking che Claude rifiuta, quindi ogni richiesta restituisce 400.

Abbiamo provato questa configurazione il 28 ottobre 2026 in DeepSeek Harness 0.2.1-rc.3. Su un solo provider, Claude Opus 5.5, Claude Sonnet 5.5, GPT-6.1 Sol e GPT-6.1 Terra hanno usato gli strumenti di Harness per esaminare un piccolo progetto e hanno risposto correttamente. OmniaKey vende l'accesso API a tutti e quattro i modelli, e i test sono passati da lì.

In breve

• Tieni Claude fuori dal provider integrato di DeepSeek. Chiede sempre il thinking in un formato che Claude rifiuta, e il suo protocollo non si può cambiare.
• Aggiungi un provider personalizzato: protocollo OpenAI Chat Completions, Base URL https://api.omniakey.com/v1. Claude e GPT-6.1 girano entrambi su di esso.
• Nelle opzioni di ogni modello, imposta il limite di output a 128.000 e attiva i livelli di ragionamento (Reasoning levels). Un modello aggiunto a mano parte senza nessuno dei due.
• Punta il modello predefinito sul nuovo provider, poi prova in una sessione nuova.

Perché Claude restituisce 400 in DeepSeek Harness?

Il provider integrato di DeepSeek costruisce ogni richiesta nel formato DeepSeek, e Claude non accetta più l'impostazione thinking di quel formato.

A meno che l'effort sia off, il provider invia thinking: {type: "enabled"} senza budget di token. Chiede anche 256.000 token di output se la voce del modello non imposta un limite più basso. Il protocollo è fisso: Harness rifiuta un campo protocollo su questo provider con "protocol is not configurable".

La guida alla migrazione di Anthropic (consultata il 28 ottobre 2026) spiega perché fallisce. Da Claude Opus 4.7 in poi Claude accetta il thinking solo in modalità adattiva, quindi enabled restituisce 400. I modelli più vecchi come Claude Haiku 4.5 accettano ancora enabled, ma solo con budget_tokens, che questo provider non invia mai.

Quindi ogni modello Claude fallisce lì. Quando abbiamo messo Claude Opus 5.5 nel provider integrato, Harness ha mostrato un errore che inizia con Invalid request for the selected model. claude-opus-5-5 requires adaptive thinking. Correggere solo il thinking non basta: Claude Opus 5.5 si ferma a 128.000 token di output, quindi il valore predefinito di 256.000 sarebbe il prossimo 400.

Come aggiungo il provider OmniaKey?

Aggiungilo in Settings. In Harness 0.2.1-rc.3 il modulo ha tutti i campi che servono. È la tua prima volta con Harness? Installalo prima con la guida all'installazione di DeepSeek Harness.

1. Fai clic su More in basso a sinistra, apri Settings e vai su Models. Fai clic su Add model provider e scegli Custom model API.
2. Compila il provider:
   • Provider ID: omniakey
   • Display name: OmniaKey
   • Base URL: https://api.omniakey.com/v1
   • API protocol: OpenAI Chat Completions
   • API key: la tua chiave OmniaKey
3. In Models, fai clic su Add model una volta per ogni ID modello nella tabella qui sotto.
4. Apri le opzioni di ogni modello con la freccia a fine riga e inserisci i valori della tabella.
5. Fai clic su Create provider.

«da low a max» indica cinque livelli: low, medium, high, xhigh e max. Il valore API di ogni livello è la stessa parola, tranne il livello off di Terra, che invia none. Metti la spunta anche su Immagine (Image) in Input types: tutti e quattro i modelli leggono le immagini e, senza quella spunta, Harness rifiuta le immagini che incolli.

Usa OpenAI Chat Completions per tutti e quattro i modelli; è il protocollo che abbiamo provato. Claude non ha un livello off: Claude Opus 5.5 pensa sempre, e OmniaKey restituisce 400 quando Opus 5.5 riceve none. GPT-6.1 Sol parte da low e non accetta none nemmeno lui. Terra lo accetta, quindi il suo livello off salta il ragionamento.

I limiti vengono dai fornitori. Anthropic indica una finestra di contesto di 1.000.000 token per Claude Opus 5.5 e Claude Sonnet 5.5. Le pagine di OpenAI indicano 1.050.000 per entrambi i modelli GPT-6.1; le abbiamo controllate il 27 ottobre 2026 per il confronto Terra e Sol. Tutti e quattro si fermano a 128.000 token di output.

Se in precedenza hai aggiunto ID Claude al provider integrato di DeepSeek, cancellali lì, così non scegli per errore la copia difettosa.

Con il provider pronto, Claude Opus 5.5 con effort alto ha eseguito un comando, letto un file e risposto in 12 secondi:

Perché l'impostazione di effort non fa nulla?

I livelli di ragionamento sono spenti per quel modello. Un modello aggiunto a mano parte con i livelli spenti, e Harness lo tratta come un modello che non sa ragionare: non invia effort, e il modello risponde con il suo valore predefinito.

Attivali e aggiungi i livelli della tabella. Il menu dei modelli sotto la casella del messaggio mostra allora ognuno di essi.

Con quale modello parte una sessione nuova?

Con quello nella voce agent-default-model del file di configurazione del tuo profilo. Nell'app desktop quel file è ~/.dsh/profiles/desktop/cordis.patch.yml. Se la voce nomina ancora un modello Claude nel provider DeepSeek, ogni sessione nuova parte sul provider che fallisce. Puntala sul nuovo provider:

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

Un'installazione nuova ha già questa voce, quindi modificala invece di aggiungerne una seconda. Con due voci, Harness usa l'ultima e non ti avvisa.

Puoi ancora cambiare modello in ogni sessione dal menu sotto la casella del messaggio. Prova in una sessione nuova: secondo la guida di DeepSeek, una sessione che ha già inviato una richiesta mantiene il modello registrato nel suo log.

Dove si trova il file di configurazione?

Nell'app desktop è ~/.dsh/profiles/desktop/cordis.patch.yml, e tutto ciò che imposti in Settings può finire lì. Questo è il file che abbiamo provato, con il provider e il modello predefinito insieme. Mantieni le voci già presenti nel tuo file, come le impostazioni dell'interfaccia. Se contiene già una voce llm-pi-ai, aggiungi il provider omniakey sotto il suo providers: invece di creare una seconda voce.

- 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 nomina la chiave senza contenerla. Harness cerca la chiave con quel nome, salvata in Settings o esportata nell'ambiente da cui parte Harness, così la chiave stessa non resta nel file. Salva il file e apri una sessione nuova; riavvia Harness se il provider non compare.

Risoluzione dei problemi

"requires adaptive thinking"

Claude è nel provider integrato di DeepSeek. Spostalo nel provider OmniaKey e punta lì anche il modello predefinito.

404 su ogni richiesta

Al Base URL manca /v1. Su OpenAI Chat Completions, il Base URL di OmniaKey è https://api.omniakey.com/v1.

Un errore su max_tokens

Il limite di output supera quello che il modello consente. Tutti e quattro i modelli si fermano a 128.000, e il provider integrato di DeepSeek chiede 256.000 per impostazione predefinita.

"The current model does not support images"

Negli Input types del modello è spuntato solo Testo (Text). Metti la spunta anche su Immagine (Image) nelle sue opzioni; tutti e quattro i modelli della tabella leggono le immagini.

Nessun livello di effort, o l'impostazione di effort non cambia nulla

Attiva i livelli di ragionamento (Reasoning levels) nelle opzioni del modello e aggiungi i livelli della tabella.

Fallisce ancora dopo la modifica

Apri una sessione nuova, controlla agent-default-model e assicurati che il provider DeepSeek non elenchi ID Claude.

Fonti controllate

• Guida alla migrazione di Anthropic: Claude Opus 5.5
• Effort e pensiero adattivo di Anthropic
• Pagina del modello GPT-6.1 Sol
• Pagina del modello GPT-6.1 Terra
• Guida ai modelli e ai provider di DeepSeek Harness
• Riferimento del provider dsh-llm-pi-ai
• Riferimento dell'API compatibile OpenAI di OmniaKey
• Catalogo modelli di OmniaKey

Pagine dei modelli su OmniaKey: Claude Opus 5.5, Claude Sonnet 5.5, GPT-6.1 Sol e GPT-6.1 Terra.