Coderen met API-sleutels
Met een Coderen API-sleutel kun je programmeertools gebruiken die werken met een OpenAI-compatible API. De tool stuurt verzoeken naar AI-School. AI-School controleert de sleutel, het budget, de geldigheidsperiode en de toegestane modellen.
Daarna verwerkt AI-School de aanvraag via de technische koppeling van de omgeving.
Wat heb je nodig?
Je hebt drie gegevens nodig:
| Gegeven | Waar vind je dit? |
|---|---|
| API-sleutel | Je krijgt deze van een beheerder of docent |
| Endpoint | https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| Modelnaam | Bijvoorbeeld gpt-5.4-mini, gpt-5.4 of gpt-5.5 |
De API-sleutel begint met ais.. Behandel deze sleutel als een wachtwoord.
Welk model kies je?
Voor de meeste leerlingen is GPT-5.4 mini de beste start. Dit model is goedkoper en geschikt voor programmeerhulp tijdens de les.
Voor docenten of gevorderde leerlingen kan GPT-5.4 of GPT-5.5 beter passen, bijvoorbeeld bij grotere projecten of complexere code.
Welke tool kies je?
AI-School adviseert twee tools:
| Tool | Aanbevolen voor | Waarom |
|---|---|---|
| Aider | Leerlingen en klassikaal coderen | Werkt expliciet, overzichtelijk en minder agentic |
| OpenCode | Docenten en gevorderde gebruikers | Agentic CLI-tool met ook een desktopapplicatie |
Aider voor leerlingen
Aider werkt als een pair-programming tool in de terminal. De gebruiker vraagt om hulp, ziet wijzigingen en blijft relatief dicht bij de code. Dat past goed bij leren programmeren: de leerling krijgt ondersteuning, maar blijft zelf betrokken bij wat er gebeurt.
Zie ook de officiële Aider-documentatie.
OpenCode voor gevorderd gebruik
OpenCode is meer agentic. De tool kan zelfstandig stappen uitvoeren, bestanden bewerken en taken verder uitwerken. Dat is krachtig, maar vraagt ook meer begrip van code, git en lokale ontwikkelomgevingen.
Zie ook de officiële OpenCode-documentatie.
Veilig omgaan met sleutels
Deel je API-sleutel niet publiek en zet hem niet in code die je deelt.
Gebruik bij voorkeur:
- omgevingsvariabelen
- een lokale
.envdie niet wordt meegestuurd naar git - de ingebouwde configuratie van de tool
Voor OpenCode kun je bijvoorbeeld een .env in de projectmap gebruiken:
AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel
Zorg dat de tool deze .env ook daadwerkelijk laadt. In PowerShell kun je de variabele ook tijdelijk voor de huidige terminal zetten:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"
Plaats API-sleutels nooit in een publieke repository, Teams-chat, gedeeld document of screenshot.
Als de sleutel niet werkt
Controleer dan:
- of Coderen is aangezet voor de omgeving
- of je sleutel nog actief is
- of het budget niet op is
- of de sleutel binnen de ingestelde geldigheidsperiode valt
- of je een toegestaan model gebruikt
- of het endpoint correct is ingesteld
- of de tool de API-sleutel als
Authorization: Bearer ...meestuurt - of de tool geen provider-specifieke parameters meestuurt die AI-School Coderen niet ondersteunt
Vraag bij twijfel een beheerder of docent om de sleutel te controleren.