🚀 Cursor Integreren met CodingPlanX Aangepaste Modellen
Introductie: Cursor is een door AI aangedreven code-editor die zeer geliefd is bij ontwikkelaars, met krachtige ingebouwde Large Language Model (LLM) mogelijkheden. Vanwege netwerkbeperkingen, kostenbeheersing (gebruik van externe proxy API's of goedkopere modellen zoals DeepSeek), of de behoefte aan implementatie op bedrijfsintranetten, moeten we echter vaak een aangepaste API-URL en API Key configureren.
Deze tutorial leidt u stap voor stap door hoe u deze configuratie eenvoudig kunt voltooien.
📋 Vereisten
Voordat u begint, moet u ervoor zorgen dat u de volgende informatie bij de hand heeft:
- Geïnstalleerde Cursor: Zorg ervoor dat uw Cursor is bijgewerkt naar de nieuwste versie.
- API Key: bijv.
sk-xxxxxxxxxxxxxxxxxxxxxxxx. - Base URL: Uw aangepaste API-proxyadres.
- Opmerking: Het moet meestal eindigen op
/v1, bijvoorbeeldhttps://api.codingplanx.ai/v1.
- Opmerking: Het moet meestal eindigen op
- Modelnaam: De standaardnaam van het model dat u wilt gebruiken (bijv.
gpt-4o,claude-3-5-sonnet,deepseek-chat, enz.).
⚙️ Gedetailleerde Configuratiestappen
Stap 1: Open Cursor Instellingen
- Start de Cursor-editor.
- Klik op het Tandwielpictogram ⚙️ in de rechterbovenhoek, of gebruik de sneltoets om de instellingen te openen:
- Windows / Linux:
Ctrl+, - macOS:
Cmd+,
- Windows / Linux:
Stap 2: Ga naar de Modellen Configuratiepagina
Zoek en klik in de linkernavigatiebalk van het instellingenpaneel op het tabblad Models.
Stap 3: Configureer de API Key
- Scroll naar beneden op de Models pagina om de sectie
OpenAI API Keyte vinden. - Plak uw aangepaste API Key in het invoervak.
- Klik op de knop
Verify(Verifiëren) aan de rechterkant. (Als de verificatie op dit punt mislukt, maak u geen zorgen, aangezien we de URL nog niet hebben geconfigureerd). - ⚠️ Belangrijke Opmerking: Zorg ervoor dat de officiële
Cursor Taben andere betaalde abonnement-schakelaars hierboven in de juiste staat staan (als u een gratis externe API gebruikt, wordt aanbevolen om de officiële modelschakelaars uit te schakelen).
Stap 4: Configureer de Base URL (Standaard Eindpunt overschrijven)
Dit is de meest cruciale stap, omdat het bepaalt waarnaar uw verzoeken worden verzonden:
- Zoek onder het
OpenAI API Keyinvoervak naar de optieOverride OpenAI Base URL. - Vouw deze optie uit en voer uw aangepaste interfaceadres in het vak in.
💡 Voorbeeldformaat:
- CodingplanX AI:
https://api.codingplanx.ai/v1
- CodingplanX AI:
- Na het invullen moet u op de Enter-toets drukken om de instellingen op te slaan.
Stap 5: Aangepaste Modelnamen Toevoegen (Optioneel maar Aanbevolen)
Als het model dat u gebruikt niet in de standaardlijst van Cursor staat (bijv. deepseek-coder), moet u het handmatig toevoegen:
- Scroll naar de bovenkant van de Models pagina en zoek de sectie
Model Names. - Klik op
+ Add Model. - Typ uw modelnaam nauwkeurig in (bijv.
deepseek-chat) en druk op Enter om te bevestigen. - Zet de schakelaar aan naast het model dat u zojuist heeft toegevoegd, en het wordt aanbevolen om andere modellen die u niet gebruikt uit te schakelen om te voorkomen dat u de verkeerde selecteert.
✅ Testen en Verificatie
Na configuratie moeten we testen of het werkt:
- Keer terug naar de codebewerkingsinterface.
- Druk op
Ctrl + L(Windows) ofCmd + L(macOS) om het Chatvenster aan de rechterkant te openen. - Klik onderaan het chatvenster op de momenteel weergegeven modelnaam en schakel over naar het model dat u zojuist heeft geconfigureerd (bijv.
gpt-4oofdeepseek-chat). - Stuur een eenvoudige begroeting, bijvoorbeeld:
"Wie ben je? Vertel me alsjeblieft je modelversie." - Als de AI normaal en snel antwoordt, gefeliciteerd, de configuratie is succesvol! 🎉
❓ FAQ & Probleemoplossing
| Symptoom | Mogelijke Oorzaak | Oplossing |
|---|---|---|
| Verbinding Time-out / 404 Niet Gevonden | Formaatfout Base URL. | Controleer of de URL het achtervoegsel /v1 mist, of dat /chat/completions per ongeluk is toegevoegd. Het juiste formaat moet https://xxx.com/v1 zijn. |
| Model niet gevonden | De opgevraagde modelnaam wordt niet ondersteund door uw API-kanaal. | Controleer of de in Cursor geselecteerde modelnaam exact overeenkomt met de naam die wordt ondersteund door uw API-provider (hoofdlettergevoelig). |
| Authenticatie mislukt | Onjuiste API Key of onvoldoende saldo. | Controleer of de Key volledig is gekopieerd (zonder extra spaties), en ga naar het dashboard van de API-provider om uw accountsaldo te controleren. |
| Kan Cursor Tab (Autocomplete) niet gebruiken | Cursor's inline code-aanvulling (Copilot) gebruikt een onafhankelijk model. | Externe API's kunnen alleen Chat en Cmd+K functies overnemen. Cursor Tab aanvulling is doorgaans nog steeds afhankelijk van officiële Cursor-diensten of vereist speciale configuratie die FIM-modellen ondersteunt. |
📝 Conclusie: Het beheersen van aangepaste API-configuratie verlaagt niet alleen de kosten van het gebruik van AI-ondersteund programmeren aanzienlijk, maar stelt u ook in staat om vrij te schakelen tussen verschillende geavanceerde LLM's. Als je deze tutorial nuttig vond, deel hem dan gerust met je ontwikkelaarsvrienden!