- Installatie en configuratie van Claude Desktop
- Gatewayconfiguratie van Claude Desktop
- Configuratiereferentie van Claude Desktop
Claude Desktop third-party inference vereist een Anthropic-compatible gateway. CometAPI ondersteunt Claude-modellen via de Anthropic Messages API.
Vereisten
- Claude Desktop geïnstalleerd vanaf claude.com/download
- Een Claude Desktop-build die Developer mode en Configure third-party inference bevat
- Een CometAPI-account met een actieve API-sleutel
- Toegang tot Claude-modellen in CometAPI
- Een netwerkpad dat
https://api.cometapi.comkan bereiken
Configuratie
Developer mode inschakelen
Open Claude Desktop en blijf op het aanmeldscherm. Open in het applicatiemenu Help → Troubleshooting en selecteer daarna Enable Developer Mode.Op Windows kan het menu vóór het aanmelden lastig bereikbaar zijn. Focus het e-mailveld, druk op
Tab tot het menu is geselecteerd en druk daarna op Enter.Instellingen voor third-party inference openen
Nadat developer mode is ingeschakeld, open je Developer → Configure third-party inference.Het configuratievenster wordt geopend met verschillende secties in de linkerzijbalk. Gebruik de sectie Connection voor de CometAPI-instellingen.
De gateway configureren
Voer in de sectie Connection hieronder de CometAPI-waarden in:
Houd de base URL exact zoals weergegeven. Claude Desktop vereist een HTTPS-base URL.De volgende schermafbeelding toont de sectie Connection ingevuld met CometAPI-waarden.
| Veld | Waarde |
|---|---|
| Inference provider | Gateway |
| Gateway | Anthropic-compatible |
| Gateway base URL | https://api.cometapi.com |
| Gateway API key | Je CometAPI API-sleutel, zoals <COMETAPI_KEY> |
| Gateway auth scheme | Bearer |
| Gateway extra headers | Leeg laten |

Model IDs toevoegen
Voeg in Model list deze model IDs handmatig toe:
Het eerste model in de lijst wordt het standaardmodel. Zet 
| Model ID | Aanbevolen gebruik |
|---|---|
claude-opus-4-7 | Complexe planning en agenttaken |
claude-sonnet-4-6 | Algemeen desktopgebruik |
claude-haiku-4-5-20251001 | Lichtgewicht prompts en snelle concepten |
claude-sonnet-4-6 bovenaan als je een standaardmodel voor algemeen gebruik wilt.De volgende schermafbeelding toont de modellijst met de drie Claude model IDs geconfigureerd voor CometAPI.
De configuratie lokaal toepassen
Klik op Apply locally. Claude Desktop schrijft de geselecteerde configuratie naar het lokale gebruikersprofiel en start de app opnieuw.Als de app niet opnieuw start, sluit Claude Desktop dan volledig af en open het opnieuw.
Een Cowork-sessie starten
Kies op het aanmeldscherm de optie voor Cowork on third-party inference. Open Cowork of Projects, selecteer een van de geconfigureerde Claude-modellen en verstuur een korte test-prompt.Een succesvolle reactie bevestigt dat Claude Desktop CometAPI gebruikt voor modelaanroepen.
De configuratie verifiëren
Gebruik een korte prompt waarvoor geen externe tools nodig zijn:
Problemen oplossen
Het Developer-menu verschijnt niet
Het Developer-menu verschijnt niet
Claude Desktop opent de standaard aanmeldflow
Claude Desktop opent de standaard aanmeldflow
Controleer deze punten:
- Inference provider is ingesteld op Gateway.
- Gateway base URL is
https://api.cometapi.com. - Gateway API key bevat je CometAPI API-sleutel zonder extra spaties.
- Je hebt op Apply locally geklikt en Claude Desktop volledig opnieuw gestart.
Validatie van de verbinding mislukt
Validatie van de verbinding mislukt
Controleer of de base URL begint met
https://. Claude Desktop accepteert geen gewone HTTP-gateway-URL’s.Controleer ook of je CometAPI-account toegang heeft tot Claude-modellen en of de API-sleutel niet is verwijderd of uitgeschakeld.Geconfigureerde modellen verschijnen niet
Geconfigureerde modellen verschijnen niet
Open opnieuw Developer → Configure third-party inference en controleer de invoer in Model list. Model IDs moeten exact overeenkomen met de IDs die CometAPI beschikbaar stelt.Voeg elke model ID toe als een afzonderlijke invoer. Gebruik geen aanhalingstekens, komma’s of extra spaties in de UI-velden.
Een OpenAI-compatible base URL werkt niet
Een OpenAI-compatible base URL werkt niet
Claude Desktop third-party inference verwacht voor deze flow een Anthropic-compatible gateway. Gebruik
https://api.cometapi.com en de hierboven vermelde Claude model IDs.Het tabblad Code gedraagt zich anders
Het tabblad Code gedraagt zich anders
Het tabblad Code gebruikt de Claude Code-engine binnen Claude Desktop. Sommige desktopinstellingen zijn mogelijk niet op dezelfde manier van toepassing op Code-sessies als op Cowork.Zie voor zelfstandig gebruik in de terminal de Claude Code integration guide.