Clasp gebruiken om Apps Script lokaal te ontwikkelen tilt je workflow naar een professioneel niveau. In plaats van in de browsereditor werk je in je eigen editor zoals VS Code, gebruik je git voor versiebeheer en automatiseer je je deploys. In dit artikel leer je clasp installeren, een project koppelen en je code synchroniseren met Apps Script.
Wat is clasp
Clasp staat voor Command Line Apps Script Projects. Het is de officiele tool van Google waarmee je Apps Script-projecten lokaal beheert. Je schrijft code op je eigen machine, beheert die met git en stuurt hem met een commando naar Apps Script. Andersom haal je bestaande projecten lokaal op.
Sinds clasp 3 heb je Node.js 20.0.0 of hoger nodig. Controleer je versie met node -v voordat je begint. De meest recente versie ten tijde van schrijven (juni 2026) is clasp 3.3.
Installeer alleen het officiele pakket
Clasp installeer je via npm met npm install -g @google/clasp. Controleer voor de installatie altijd dat het pakket de officiele Google-scope @google/clasp heeft en niet een typosquat-variant. Bekijk de pagina op npmjs.com en de download-aantallen voordat je installeert, en draai daarna npm audit.
Clasp installeren en inloggen
Je hebt Node.js (versie 20 of hoger) en npm nodig. Daarna installeer je clasp globaal en log je in:
npm install -g @google/clasp
clasp login
clasp login opent je browser voor authenticatie met je Google-account. Daarna kun je projecten beheren. Je moet ook de Apps Script API aanzetten in je accountinstellingen op script.google.com/home/usersettings.
Apps Script API aanzetten
Clasp werkt alleen als de Apps Script API ingeschakeld is voor je account. Ga naar script.google.com/home/usersettings en zet de schakelaar aan. Zie developers.google.com/apps-script/guides/clasp voor de volledige installatiehandleiding.
Een bestaand project klonen
Heb je al een project in de browser, dan haal je het lokaal op met clasp clone en het script-id:
clasp clone "jouw-script-id"
Dit downloadt alle .gs-bestanden (lokaal als .js) plus een appsscript.json met de projectinstellingen. Nu kun je in je eigen editor werken.
Kloon alleen vertrouwde scripts met een actuele clasp
In clasp-versies ouder dan 3.2.0 zat een path traversal-lek (CVE-2026-4092). Bij het klonen of pullen van een kwaadaardig script konden bestanden buiten je projectmap worden geschreven. Werk daarom altijd met clasp 3.2.0 of hoger en kloon nooit een script-id dat je niet vertrouwt. Update met npm update -g @google/clasp en controleer je versie met clasp --version.
Pushen en pullen
De kern van de workflow zijn twee commando's. clasp push stuurt je lokale wijzigingen naar Apps Script, clasp pull haalt wijzigingen op die je in de browser maakte:
clasp push # stuurt lokale code naar Apps Script
clasp pull # haalt remote code lokaal op
clasp push --watch # pusht automatisch bij elke opslag
Werk met de watch-modus tijdens ontwikkelen
Gebruik clasp push --watch tijdens het ontwikkelen. Dan synchroniseert clasp je code automatisch naar Apps Script telkens wanneer je een bestand opslaat, zodat je direct in de browser kunt testen zonder steeds handmatig te pushen.
TypeScript met clasp 3
Belangrijk om te weten: vanaf clasp 3 transpileert clasp je TypeScript niet meer zelf. In oudere versies kon je rechtstreeks .ts-bestanden pushen, maar dat is vervallen. Wil je TypeScript gebruiken, dan zet je je code eerst om met een bundler zoals Rollup, esbuild of Vite, en push je het resultaat met clasp. Google biedt hiervoor de starter google/aside, en er zijn community-templates voor Vite en Rollup. Deze aanpak geeft betere ondersteuning voor moderne TypeScript, ESM-modules en npm-pakketten.
Git en versiebeheer
De grootste winst van clasp is dat je git kunt gebruiken. Je commit je code, werkt met branches en houdt een geschiedenis bij, net als bij elk ander softwareproject:
Clasp met git opzetten
- Kloon je project met
clasp clonein een lege map. - Voer
git inituit en maak een eerste commit van de opgehaalde code. - Voeg een
.gitignoretoe en sluit gevoelige bestanden uit. - Werk in je editor, commit logische wijzigingen en push met
clasp push. - Maak voor grotere wijzigingen een branch en merge die na review.
Houd geheimen uit je repository
Zet nooit geheimen zoals API-sleutels in je code en commit ze niet naar git. Het .clasp.json-bestand bevat je script-id en hoort meestal wel in git, maar gebruik voor secrets de PropertiesService in Apps Script zelf. Voeg lokale config met gevoelige waarden toe aan .gitignore.
Volgende stap
Met clasp werk je professioneel aan grotere projecten. Combineer het met een doordachte deploy-strategie, zie deployen als webapp of add-on, en pas de richtlijnen toe uit best practices.
Heb ik clasp nodig om Apps Script te gebruiken?
Nee. De browsereditor volstaat voor de meeste taken. Clasp is handig zodra je git wilt gebruiken, in je eigen editor wilt werken of deploys wilt automatiseren.
Kan ik TypeScript gebruiken met clasp?
Ja, maar sinds clasp 3 transpileert clasp TypeScript niet meer zelf. Je zet je .ts-code eerst om met een bundler zoals Rollup, esbuild of Vite en pusht daarna het resultaat met clasp push.
Welke Node.js-versie heb ik nodig?
Clasp 3 vereist Node.js 20.0.0 of hoger. Controleer je versie met node -v en werk indien nodig bij voordat je clasp installeert.
Werkt clasp samen met de browsereditor?
Ja. Wijzigingen die je in de browser maakt haal je op met clasp pull. Werk niet tegelijk op beide plekken aan hetzelfde bestand om conflicten te voorkomen.
Hoe deploy ik vanaf de command line?
Met clasp deploy maak je een nieuwe implementatie. Zo automatiseer je deploys als onderdeel van een pijplijn.
Is clasp veilig om mee te klonen?
Gebruik altijd clasp 3.2.0 of hoger. Oudere versies hadden een path traversal-lek (CVE-2026-4092) bij het klonen of pullen van kwaadaardige scripts. Kloon bovendien alleen script-ids die je vertrouwt.