Claude Code is een van de krachtigste AI-aangedreven coding-assistenten van vandaag, maar het vanuit een lokaal consolevenster gebruiken heeft echte beperkingen: je bent gebonden aan de machine waar het geïnstalleerd is, je kunt het niet vanaf je telefoon benaderen, en er is geen eenvoudige manier om een sessie met een collega te delen.
sgcClaudeCodeRemote lost dat allemaal op. Het is een lichtgewicht Windows-server die Claude Code in een webgebaseerde terminal verpakt, zodat je vanuit elke browser kunt verbinden — op je desktop, laptop, tablet of telefoon. Onder de motorkap gebruikt het de pseudo-console-API Windows ConPTY voor een echte terminalsessie, en sgcWebSockets om de terminal-I/O in realtime naar de browser te streamen.
Dit artikel behandelt de functies, configuratieopties en voordelen ten opzichte van het direct draaien van Claude Code vanuit de console.
Waarom Claude Code op afstand gebruiken?
sgcClaudeCodeRemote pakt de meest voorkomende frictiepunten aan waar ontwikkelaars tegenaan lopen bij het werken met Claude Code op de console.
|
Toegang vanaf elk apparaat Open een browser op je telefoon, tablet of laptop en verbind met Claude Code dat draait op je ontwikkelmachine. Geen Node.js, geen CLI-installatie — alleen een URL. |
Samenwerkingsessies Meerdere ontwikkelaars kunnen zich aansluiten bij dezelfde benoemde sessie en de output van Claude in realtime zien. Ingebouwd pair programming — geen schermdeel-tools nodig. |
Standaard veilig Wachtwoord-authenticatie met brute-force-bescherming, configureerbare timeouts, IP-blokkering en optionele TLS 1.3-encryptie voor implementaties die richting internet zijn gericht. |
Mobielvriendelijke terminal
De webinterface is ontworpen om op mobiele apparaten te werken. Een touch-geoptimaliseerde toetsenbalk onderaan het scherm biedt de speciale toetsen die Claude Code nodig heeft maar die op mobiele toetsenborden ontbreken:
| Knop | Functie |
|---|---|
| Esc | De huidige bewerking annuleren of terug |
| Tab | Suggesties en autocomplete accepteren |
| Intro | Invoer bevestigen (Enter-toets) |
| Ctrl | Sticky modifier — tik één keer, daarna een letter voor combinaties zoals Ctrl+C (interrupt) |
| ↑ ↓ ← → | Navigeer door commandogeschiedenis en menu's |
De toolbar gebruikt pointerdown-events voor directe respons op touchscreens en voorkomt focus stealing zodat de terminal actief blijft. De viewport past zich aan de mobiele browser-chrome aan via dynamische viewport-units (dvh), zodat de toolbar altijd zichtbaar is zonder te scrollen.
Benoemde sessies
Elke verbinding kan een sessienaam opgeven (bijv. “backend-refactor”, “devops”, “testing”). Sessies blijven bestaan zolang de server draait, zodat je later opnieuw verbinding kunt maken met dezelfde Claude Code-instantie.
- Multi-client-sessies. Meerdere browsers kunnen tegelijkertijd dezelfde sessie joinen — iedereen ziet dezelfde terminal-output en kan in dezelfde console typen.
- Sessiegeschiedenis. De browser onthoudt je 10 meest recente sessies in localStorage, met een dropdown om snel opnieuw verbinding te maken.
- Sessie-indicator. De naam van de actieve sessie wordt na authenticatie in de headerbalk weergegeven.
Authenticatie en beveiliging
sgcClaudeCodeRemote bevat standaard meerdere beschermingslagen:
|
Wachtwoord-authenticatie Eén gedeeld wachtwoord beschermt de toegang. Geen gebruikersnaam vereist — alleen het wachtwoord. Het login-formulier schakelt browser-credential-autocomplete uit om onbedoelde opslag te voorkomen. |
Brute-force-bescherming Na 5 mislukte pogingen vanaf hetzelfde IP wordt dat adres 5 minuten geblokkeerd. Geblokkeerde IP's worden op verbindingsniveau geweigerd voordat er verdere verwerking plaatsvindt. |
|
Authenticatie-timeout Clients moeten authenticeren binnen een configureerbaar venster (standaard 15 seconden). Inactieve verbindingen die geen credentials sturen, worden automatisch losgekoppeld. |
TLS 1.3-encryptie Voor internet-facing deployments schakel je TLS in met een certificaat- en key-bestand. Al het verkeer tussen browser en server wordt end-to-end versleuteld. |
Sla permission-prompts over. Een checkbox op het login-scherm (standaard aangevinkt) start Claude Code met de vlag --dangerously-skip-permissions. Dit is essentieel voor remote sessies waarbij je geen permission-dialogen op de server-console kunt bedienen.
sgcClaudeCodeRemote vs. Console Claude Code
Een side-by-side-vergelijking van Claude Code lokaal draaien versus via sgcClaudeCodeRemote.
| Functie | Console | sgcClaudeCodeRemote |
|---|---|---|
| Toegang vanaf elk apparaat | Nee | Ja |
| Mobiel-/tablet-ondersteuning | Nee | Ja (touch-toolbar) |
| Meerdere gebruikers in dezelfde sessie | Nee | Ja |
| Benoemde persistente sessies | Nee | Ja |
| Wachtwoord-bescherming | Nee | Ja (brute-force-blokkering) |
| TLS-encryptie | N/B | TLS 1.3 |
| Vereiste client-software | Node.js + CLI | Alleen een browser |
| Pair programming | Externe tools | Ingebouwd |
| Realtime latentie-weergave | Nee | Ja |
| Client-platforms | Alleen dezelfde machine | Windows, macOS, Linux, Android, iOS |
Aan de slag
Download sgcClaudeCodeRemote en start het vanaf de commandline met een wachtwoord:
sgcClaudeCodeRemote.exe --password MySecretPasswordOpen daarna je browser en ga naar http://your-server-ip:8765/. Voer het wachtwoord in, kies een sessienaam en je bent binnen.
Voorbeelden
Aangepaste poort met hogere verbindingslimiet:
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20Met TLS-encryptie voor veilige toegang via het internet:
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassCommandline-opties
| Optie | Beschrijving | Standaard |
|---|---|---|
--port |
Luisterpoort van de server | 8765 |
--password |
Toegangswachtwoord (verplicht als authenticatie aan staat) | — |
--command |
Commando dat in de terminal moet worden uitgevoerd | claude |
--cols / --rows |
Initiële terminal-afmetingen | 120 × 40 |
--max-conn |
Maximaal aantal gelijktijdige verbindingen | 10 |
--timeout |
Authenticatie-timeout in seconden | 15 |
--no-auth |
Authenticatie volledig uitschakelen | — |
--tls |
TLS 1.3-encryptie inschakelen | — |
--tls-cert / --tls-key |
Certificaat- en private-key-PEM-bestanden | — |
--tls-password |
Wachtwoord voor de private key (indien versleuteld) | — |
--tls-port |
TLS-luisterpoort | Hetzelfde als --port |
Use-cases
- Werk vanaf je telefoon. Bekijk code, stel Claude vragen of voer commando's uit waar je ook bent — op de bank, in de trein of in een coffeeshop.
- Teamsamenwerking. Meerdere ontwikkelaars maken verbinding met dezelfde sessie en werken realtime met Claude. Geen scherm delen nodig.
- Headless build-servers. Draai Claude Code op een krachtige remote machine en benader het via een thin client of een omgeving zonder terminal.
- Demo's en presentaties. Deel een sessie-URL met je publiek. Iedereen ziet dezelfde live-terminal en volgt mee.
- Veilige remote-toegang. Schakel TLS in, stel een sterk wachtwoord in en gebruik Claude Code veilig via het internet vanaf elke locatie.
Hoe het werkt
sgcClaudeCodeRemote is een Delphi-console-toepassing die op drie kerntechnologieën is gebouwd:
|
Windows ConPTY De pseudo-console-API van Windows 10 maakt een echte terminal-sessie met volledige ondersteuning voor VT100/ANSI-sequenties. Claude Code draait in deze console precies zoals in een normaal terminalvenster. |
sgcWebSockets De sgcWebSockets-bibliotheek verzorgt alle WebSocket-communicatie, HTTP-serving en optionele TLS-encryptie. Binaire frames bevatten de terminal-output; JSON-tekstframes worden gebruikt voor authenticatie en controle-berichten. |
xterm.js De browser rendert de terminal met xterm.js, inclusief de fit-addon (auto-resize naar het venster) en de web-links-addon (klikbare URL's). Het donkere thema past bij de stijl van Claude Code. |
Systeemvereisten. De server vereist Windows 10 versie 1809 of nieuwer (voor ConPTY-ondersteuning) en Claude Code geïnstalleerd op de host-machine. Clients hebben alleen een moderne webbrowser nodig.
Functies van de webinterface
De single-page web-UI is direct in het executable ingebed — geen externe bestanden om uit te rollen. Het bevat onder andere:
- Status-indicator. Kleurgecodeerde badge (groen = verbonden, rood = losgekoppeld, blauw = login vereist, oranje = bezig met verbinden) met een pulsanimatie.
- Realtime-latentie. Geeft de round-trip-latentie in milliseconden weer, geüpdatet bij elk frame.
- Terminal-afmetingen. Toont het huidige aantal kolommen × rijen en update dynamisch bij resize.
- Fit-knop. Past de terminal direct aan zodat hij het browservenster vult.
- Kopiëren & plakken. Volledige clipboard-ondersteuning — Ctrl+C kopieert geselecteerde tekst, Ctrl+V plakt in de terminal.
- Auto-reconnect. Als de verbinding wegvalt, probeert de client automatisch na 3 seconden opnieuw verbinding te maken.
- Scrollback van 10.000 regels. Scroll omhoog om eerdere Claude Code-output te bekijken zonder dat er historie verloren gaat.
sgcClaudeCodeRemote is gebouwd met sgcWebSockets — hoogwaardige WebSocket-componenten voor Delphi en .NET.