HAN Datalab

← Terug naar tools

Handleiding · OpenRouter

Taalmodellen gebruiken in VS Code met Kilo Code

Heb je via het Datalab toegang gekregen tot onze OpenRouter-organisatie? Dan maak je zelf een API key aan (een geheime code waarmee een programma namens jou toegang krijgt) en gebruik je daarmee taalmodellen in VS Code, via de extensie Kilo Code. Gebruik met een key van de organisatie gaat van het gezamenlijke tegoed van de organisatie af. Daarnaast kun je in OpenRouter zelf chatten met modellen, ze vergelijken en het verbruik volgen. Kom je een onbekende term tegen? Onderaan deze pagina staat een lijst met begrippen.

• Uitnodiging voor de OpenRouter-organisatie van het Datalab
• Een laptop met Windows of macOS
• Ongeveer tien minuten

Deel 1 · Een API key maken in OpenRouter

1. Accepteer de uitnodiging

   Je krijgt van het Datalab een uitnodiging voor de organisatie. Open de uitnodiging en log in bij OpenRouter, of maak een account aan. Geen uitnodiging ontvangen? Neem contact met ons op.

2. Kies de organisatie

   Gebruik de organisatiewisselaar bovenaan OpenRouter en kies de organisatie van het Datalab. In de organisatie gebeurt alles, ook het maken van API keys, namens de organisatie.

   Let op: in je persoonlijke account werk je met je eigen tegoed. Maak de key daarom altijd aan terwijl de organisatie gekozen is.

3. Maak een API key

   Open de pagina met API keys, maak een nieuwe key en geef hem een herkenbare naam, bijvoorbeeld Voornaam – Kilo Code. Stel ook een creditlimiet in; OpenRouter raadt dat voor elke key aan, zodat een gelekte key nooit het hele tegoed kan opmaken. Kopieer de key meteen en bewaar hem op een veilige plek, zoals een wachtwoordmanager.

   Naar de API keys in OpenRouter ↗

   Behandel je key als een wachtwoord. Deel hem niet en zet hem niet in code, documenten, chats of Git. Is hij toch uitgelekt? Verwijder de key in OpenRouter en maak een nieuwe. Ontdekt OpenRouter zelf dat je key is uitgelekt, dan krijg je daarover een e-mail. Als lid zie en beheer je alleen de keys die je zelf hebt gemaakt.

Deel 2 · VS Code en Kilo Code installeren

4. Installeer VS Code

   Windows

   Download de User Installer. Microsoft raadt deze aan, omdat je er geen beheerdersrechten voor nodig hebt. Voer daarna het gedownloade bestand VSCodeUserSetup-…exe uit.

   Officiële handleiding voor Windows ↗

   macOS

   Download VS Code voor macOS en open het gedownloade .dmg-bestand. Sleep Visual Studio Code.app naar de map Applications en start VS Code daarvandaan. Werkt op Macs met Apple silicon en met Intel.

   Officiële handleiding voor macOS ↗

   VS Code downloaden ↗

   Heb je VS Code al? Kilo Code vraagt versie 1.105.1 of nieuwer. VS Code werkt zichzelf standaard automatisch bij.

5. Installeer de extensie Kilo Code

   Open in VS Code de weergave Extensions:

   • WindowsCtrl+Shift+X
   • macOSShift+Cmd+X (⇧⌘X)

   Zoek op Kilo Code en kies Kilo Code: AI Coding Agent, Copilot, and Autocomplete van de geverifieerde uitgever Kilo Code. Klik op het pijltje naast Install en kies Install Pre-Release Version.

   Waarom pre-release? Volgens Kilo staat de huidige versie van de extensie in het pre-releasekanaal van de Marketplace. Die versie is stabiel en aanbevolen voor alle gebruikers.

   Daarna verschijnt het Kilo Code-icoon in de Activity Bar, de balk met iconen aan de zijkant van VS Code.

   Kilo Code in de Marketplace ↗Installatiehandleiding van Kilo ↗

Deel 3 · Je key koppelen in Kilo Code

6. Koppel OpenRouter

   Eerste keer? Kilo toont dan een welkomstscherm: Welcome to Kilo – Choose how you want to work. Kies een werkwijze; je kunt dit later aanpassen bij Settings. Inloggen bij Kilo is niet nodig: je gebruikt je eigen OpenRouter-key.

   1. Klik op het Kilo Code-icoon in de Activity Bar.
   2. Klik bovenaan het Kilo Code-paneel op het tandwiel (Settings).
   3. Open het tabblad Providers en kies OpenRouter onder Popular providers. Je kunt ook zoeken via Search providers.
   4. Het venster Connect OpenRouter opent. Vraagt Kilo om een inlogmethode, kies dan API key.
   5. Plak je key in het veld OpenRouter API key: Ctrl+V op Windows, Cmd+V op macOS. Klik op Connect.

   Je ziet de melding OpenRouter connected. OpenRouter staat nu onder Connected providers. Wil je later een andere key gebruiken, kies dan Change API key.

   Kilo Code in het Nederlands? Dan heten de knoppen onder meer Instellingen, Populaire providers, Providers zoeken, Verbind OpenRouter, OpenRouter API-sleutel en Verbinden.

7. Kies een model en test

   Klik in het Kilo Code-paneel op de modelkiezer onder het invoerveld. Die toont de naam van het huidige model. Zoek via Search models een model van OpenRouter en kies het. Stel daarna een eenvoudige vraag, bijvoorbeeld Leg uit wat dit bestand doet. Krijg je antwoord, dan werkt alles.

   Modellen en prijzen bekijken ↗

   Zie je “You need to sign in to use this model”? Dan is er een model gekozen dat een Kilo-account vraagt. Kies een model van OpenRouter.

Deel 4 · Meer uit OpenRouter halen

OpenRouter is meer dan een API key voor Kilo Code. In de browser kun je modellen uitproberen, vergelijken en het verbruik bekijken. Controleer eerst met de organisatiewisselaar bovenaan dat de organisatie van het Datalab gekozen is.

Begrippen

Korte uitleg van de termen in deze handleiding.

Taalmodel (model)

Een AI-systeem dat tekst begrijpt en schrijft, zoals GPT, Claude of Gemini. OpenRouter geeft toegang tot honderden modellen.

OpenRouter

Een dienst die veel taalmodellen van verschillende makers via één account en één API key aanbiedt.

Organisatie

Een gedeeld OpenRouter-account van het Datalab met een gezamenlijk tegoed. Leden maken hun eigen API key aan.

API key

Een lange geheime code waarmee een programma namens jou toegang krijgt tot OpenRouter. Behandel hem als een wachtwoord.

Tegoed (credits)

Het geld op het account van de organisatie. Elk verzoek aan een model gaat ervan af.

Creditlimiet

Het maximum dat één API key mag uitgeven. Daarna weigert OpenRouter verzoeken met die key.

Token

Een stukje tekst van ongeveer vier letters. Modellen rekenen kosten per token, voor je vraag én het antwoord.

Contextlengte

Hoeveel tokens een model in één keer kan verwerken: je vraag, bijgevoegde bestanden en het antwoord samen.

Benchmark

Een vaste test waarmee modellen met elkaar worden vergeleken, bijvoorbeeld op programmeren of redeneren.

VS Code

Visual Studio Code: een gratis programma van Microsoft om code te schrijven.

Extensie

Een uitbreiding die je in VS Code installeert om er functies aan toe te voegen.

Kilo Code

Een extensie die een AI-assistent in VS Code zet. Die kan code uitleggen, schrijven en aanpassen.

Marketplace

De winkel met extensies voor VS Code. Pre-release is daar een aparte uitgavelijn, niet per se onstabiel.

Activity Bar

De verticale balk met iconen aan de zijkant van VS Code.

Provider

In Kilo Code: de dienst die de modellen levert, zoals OpenRouter.

Git

Software om versies van code bij te houden en te delen. Zet er nooit een API key in.

Officiële documentatie

OpenRouter

• Organisaties beheren ↗
• API keys en authenticatie ↗
• Veelgestelde vragen ↗

VS Code

• Installeren op Windows ↗
• Installeren op macOS ↗
• Extensies installeren ↗

Kilo Code

• Installatie ↗
• OpenRouter gebruiken in Kilo Code ↗
• Alle documentatie ↗

Gecontroleerd op 25 september 2026 met Kilo Code 7.7.12. Schermen en knopnamen kunnen in nieuwere versies veranderen.

← Terug naar tools

Handleiding · SURF Research Cloud

Rekenkracht in de cloud met SURF Research Cloud

Met SURF Research Cloud start je een eigen rekenomgeving, een workspace, met CPU of GPU. Die gebruik je voor data-analyse, machine learning en simulaties. Deze handleiding helpt docenten, onderzoekers, studenten en externe projectpartners op weg. Toegang krijg je altijd op uitnodiging, via SURF Research Access Management (SRAM). Eén regel geldt altijd: zet je workspace uit als je hem niet gebruikt, want hij verbruikt credits van het gedeelde budget zolang hij draait. Kom je een onbekende term tegen? Onderaan deze pagina staat een lijst met begrippen.

• Uitnodiging voor een HAN-collaboration
• HAN-account of eduID
• Authenticator-app voor sommige workspaces

Deel 1 · Toegang krijgen

1. Vraag toegang aan

   Vraag toegang aan bij de beheerder van jouw Datalab-project of lectoraat, of via het formulier van het Datalab. Ben je een externe partner? Vraag dan je contactpersoon bij de HAN om je uit te nodigen.

   Toegang aanvragen bij het Datalab ↗

2. Accepteer de uitnodiging

   Je krijgt een uitnodiging per e-mail voor een collaboration: de projectgroep waarin je samenwerkt en rekenbudget krijgt.

   Met een HAN-account

   1. Klik in de e-mail op Join this collaboration en daarna op Log in to accept the invite.
   2. Zoek in het zoekvak je instelling: HAN University of Applied Sciences, of in het Nederlands Hogeschool van Arnhem en Nijmegen. Log in met je HAN-account.

   Zonder HAN-account (eduID)

   1. Nog geen eduID? Ga naar eduid.nl, kies eduID aanmaken en volg de stappen met je eigen (werk)e-mailadres.
   2. Klik in de uitnodiging op Join this collaboration en Log in to accept the invite, zoek eduID en log in.

   Naar eduID ↗

   Klik daarna op Proceed to SURF Research Access Management. Gebruik je SRAM voor het eerst, dan accepteer je de gebruiksvoorwaarden (Acceptable Use Policy). Soms vraagt een collaboration je ook de voorwaarden van een gekoppelde dienst te accepteren.

   Tweestapsverificatie is verplicht. SRAM vraagt iedereen om een tweede factor. Log je in met eduID, dan stel je die in de eduID-app in. Vraagt SRAM om een TOTP-code (een code van zes cijfers uit een authenticator-app op je telefoon), registreer die dan met een app zoals FreeOTP, Google Authenticator of Microsoft Authenticator.

3. Log in op het portaal

   Ga naar het Research Cloud-portaal en log in met dezelfde instelling of eduID als bij de uitnodiging.

   Naar portal.live.surfresearchcloud.nl ↗

Deel 2 · Een workspace starten

4. Start de wizard

   Klik op het dashboard op CREATE NEW, in de meest linkse tegel. Daarna doorloop je deze stappen:

   1. Collaboration: kies het project waaraan je werkt.
   2. Wallet: kies het rekenbudget. Heb je maar één wallet, dan wordt die automatisch gekozen en slaat de wizard deze stap over.
   3. Catalog item: kies een kant-en-klare omgeving, bijvoorbeeld Jupyter (voor Python), RStudio (voor R), Ubuntu (Linux) of Windows. Je kunt zoeken.
   4. Dataset: alleen als je collaboration datasets heeft; anders slaat de wizard deze stap over.
   5. Cloudprovider, besturingssysteem en grootte: kies het aantal CPU's, het geheugen en eventueel een GPU (een extra snelle, maar duurdere rekenkaart voor machine learning).
   6. Opslag en netwerk: koppel hier een bestaand opslagvolume, als je dat hebt.
   7. Naam en einddatum: geef de workspace een naam en kies hoe lang hij mag bestaan.

   Controleer het overzicht en verstuur de wizard.

   Kies niet zwaarder dan nodig. Het budget is gedeeld: een grotere workspace of een GPU verbruikt sneller credits.

5. Wacht tot de workspace draait

   Je gaat terug naar het dashboard. Onder Workspaces verandert de status van creating in running zodra de workspace klaar is.

   Let op de einddatum. Op de einddatum wordt de workspace automatisch verwijderd. Je krijgt drie dagen van tevoren een e-mail. De einddatum kun je later nog aanpassen.

Deel 3 · Inloggen op je workspace

6. Open de workspace in je browser

   Zoek je workspace op het dashboard en klik op Access. De workspace opent in een nieuw tabblad. Hoe je daar inlogt, hangt af van de workspace:

   Inloggen met SRAM

   Kies je instelling of eduID en volg de stappen op het scherm. Dit geldt onder meer voor Jupyter-workspaces en voor nieuwere Ubuntu Desktop- en Windows-workspaces.

   Desktop-workspaces kun je ook openen met een Remote Desktop-app, zoals Windows App op Windows en macOS. Vul het IP-adres van de workspace in en volg de aanmelding op het scherm.

   Inloggen met TOTP

   Voor bijvoorbeeld RStudio. Je gebruikersnaam staat op het tabblad Profile in het portaal. Het wachtwoord is een TOTP-code: zes cijfers uit een authenticator-app op je telefoon, die elke 30 seconden veranderen.

   TOTP instellen: open in het portaal het tabblad Profile, klik op de drie puntjes rechtsboven op je profielkaart en kies Reset Time based password. Scan de QR-code met een authenticator-app, zoals Google Authenticator of Authy.

7. Of verbind via SSH

   Alleen nodig als je op de commandoregel wilt werken, het venster waarin je opdrachten typt. SSH is een beveiligde verbinding naar je workspace. Inloggen gaat zonder wachtwoord, met een sleutelpaar: een publieke sleutel die je uploadt en een privésleutel die op je eigen computer blijft.

   Windows

   Open PowerShell en typ ssh-keygen. Druk op Enter om de standaardinstellingen te gebruiken, of kies een wachtwoordzin. Dit werkt vanaf Windows 10.

   macOS

   Open Terminal en typ ssh-keygen. Druk op Enter om de standaardinstellingen te gebruiken, of kies een wachtwoordzin.

   1. Ga naar sram.surf.nl, klik rechtsboven op Login en log in.
   2. Klik op het pijltje naast je naam, kies Profile en upload bij SSH je publieke sleutel. Die staat in de map .ssh in je gebruikersmap en eindigt op .pub. Klik op Update.
   3. Wacht tot vijf minuten en verbind met ssh gebruikersnaam@ip-adres. Je gebruikersnaam staat op het tabblad Profile in het portaal; het IP-adres staat op de tegel van je workspace op het dashboard.

   Deel nooit je privésleutel. Upload alleen het bestand dat eindigt op .pub.

   Naar SRAM ↗

8. Klaar voor nu? Zet de workspace uit

   Doe dit elke keer als je stopt met werken. Open op het dashboard het menu met de drie puntjes op de tegel van je workspace en kies Pause. Een draaiende workspace verbruikt credits, ook 's nachts en in het weekend, ook als je niets doet. Met Resume ga je later verder waar je gebleven was.

   Is je project of analyse helemaal afgerond? Kies dan Delete. Zet eerst alles wat je wilt bewaren op Research Drive of een opslagvolume, want de schijf van de workspace wordt daarbij gewist.

Deel 4 · Kosten en levenscyclus

Een workspace verbruikt credits zolang hij draait. Alleen de eigenaar van een workspace, of een workspace-beheerder, kan hem pauzeren, hervatten of verwijderen, of de einddatum aanpassen. Je vindt deze acties in het menu met de drie puntjes op de tegel van je workspace.

Deel 5 · Data en opslag

Begrippen

Korte uitleg van de termen in deze handleiding.

Workspace

Je eigen computer in de cloud. Je kiest zelf hoe zwaar hij is en welke software erop staat.

Collaboration

De projectgroep in SRAM waarin je samenwerkt. Toegang en budget zijn aan een collaboration gekoppeld.

Wallet

Het rekenbudget van je collaboration, uitgedrukt in credits.

Credits

De rekeneenheid van SURF. Een draaiende workspace verbruikt credits per uur; opslag per maand.

SRAM

SURF Research Access Management: het systeem waarmee SURF regelt wie toegang heeft tot welke collaboration.

eduID

Een gratis persoonlijk account van SURF voor wie geen account bij een onderwijsinstelling heeft.

Tweestapsverificatie

Inloggen met twee bewijzen: je wachtwoord én iets op je telefoon, zoals een code of een app.

TOTP

Een code van zes cijfers uit een authenticator-app op je telefoon, die elke 30 seconden verandert. Op SURF is dit soms je wachtwoord.

Authenticator-app

Een app die TOTP-codes maakt, zoals Google Authenticator, Microsoft Authenticator of FreeOTP.

Catalog item

Een kant-en-klare inrichting voor je workspace, met bijvoorbeeld Jupyter, RStudio, Ubuntu of Windows.

Jupyter

Een werkomgeving in je browser voor Python-code, veel gebruikt bij data science en machine learning.

RStudio

Een werkomgeving in je browser voor de programmeertaal R, veel gebruikt voor statistiek.

Ubuntu

Een versie van Linux. Als “Desktop” met een bureaublad, als “Server” alleen met een commandoregel.

CPU en GPU

De rekenkracht van een workspace. Een GPU is een extra snelle rekenkaart voor machine learning, en duurder.

Commandoregel

Een venster waarin je opdrachten typt in plaats van klikt: PowerShell op Windows, Terminal op macOS.

SSH

Een beveiligde verbinding naar de commandoregel van je workspace, met een sleutelpaar in plaats van een wachtwoord.

Sleutelpaar

Twee bestanden die bij elkaar horen: een publieke sleutel (.pub) die je mag delen en een privésleutel die je geheim houdt.

Remote Desktop

Software waarmee je het bureaublad van een andere computer op je eigen scherm bedient.

Opslagvolume

Een aparte schijf die je aan een workspace koppelt. De data blijft bestaan als je de workspace verwijdert.

Research Drive

De opslagdienst van SURF om onderzoeksdata te bewaren en te delen, vergelijkbaar met OneDrive.

SANE

Secure ANalysis Environment: een afgeschermde omgeving van SURF voor gevoelige data, zonder internet en klembord.

RCCS-contract

Een manier waarop een instelling SURF-diensten afneemt. Bij zo’n wallet kost opslag ook tijdens een pauze credits.

Officiële documentatie

Toegang

• Inloggen met een uitnodiging ↗
• eduID ↗
• Inloggen op je workspace ↗

Workspaces

• Een workspace starten ↗
• Pauzeren, hervatten en verwijderen ↗
• Toegang via SSH ↗
• Toegang via TOTP ↗

Data

• Research Drive koppelen ↗
• Opslagvolumes ↗
• Kennisbank SURF Research Cloud ↗

Gecontroleerd op 25 september 2026 met de kennisbank van SURF. Schermen en knopnamen kunnen veranderen.