Gids · AI-agent met Claude Code

Een eigen Claude-agent in tmux, browser en Telegram.

Een Claude Code-sessie die blijft draaien in een tmux-sessie op je eigen machine, bereikbaar via een webterminal in de browser en optioneel via Telegram of Discord (channels, research preview). Dit is een eerste versie van de gids: de basis staat, een aantal punten laten we bewust open om samen uit te werken.

Plan een gesprek Bekijk de stappen

Het idee

Eén langlopende sessie, meerdere ingangen

Claude Code draait als gewone sessie in een terminal. Door die in tmux te starten blijft ze leven na het sluiten van je laptop of SSH-verbinding. Via een webterminal open je dezelfde sessie in de browser, en met een channel stuur je er berichten naartoe vanop je gsm.

Hou er rekening mee dat dit een opzet voor eigen, interne agents is. Welke vormen van automatisering de abonnementsvoorwaarden toelaten, moet je zelf nagaan (zie hieronder).

  • tmux: de sessie blijft draaien en je kan er elk moment in en uit
  • Browser: een webterminal bovenop tmux, achter HTTPS en een login
  • Telegram of Discord: berichten sturen naar de lopende sessie via een channel-plugin
  • Jouw abonnement of API-key voor de modelaanroepen

Onze AI-agents →

Stappen

Opzet in vijf stappen

  1. 01

    1. Claude Code installeren en inloggen

    Installeer Claude Code op een machine die aan blijft (server, mini-pc of VPS) en log eenmalig in met je abonnement via 'claude'. Controleer de versie met 'claude --version' en update met 'claude update'. Staat ANTHROPIC_API_KEY ingesteld, dan gaat die voor op je abonnement: 'unset ANTHROPIC_API_KEY' om terug te vallen op de login.

  2. 02

    2. Sessie in tmux starten

    Start 'tmux new -s agent', ga naar de projectmap en start 'claude'. Loskoppelen doe je met Ctrl-b en dan d, terugkeren met 'tmux attach -t agent'. Beperk de map en de rechten van de gebruiker waaronder dit draait.

  3. 03

    3. Browsertoegang

    Zet een webterminal bovenop tmux, bijvoorbeeld ttyd, en laat die tonen wat in 'tmux attach -t agent' staat. Zet er altijd HTTPS en een login voor (reverse proxy, VPN of Tailscale), want wie erin kan, kan opdrachten laten uitvoeren op de machine. Dit is onze suggestie, niet iets uit de Claude Code-documentatie.

  4. 04

    4. Channel koppelen (Telegram of Discord)

    Maak een bot (BotFather voor Telegram, Developer Portal voor Discord, met Message Content Intent aan). Installeer in Claude Code de plugin: '/plugin install telegram@claude-plugins-official' (Bun is vereist). Stel de token in met '/telegram:configure <token>' en start de sessie opnieuw met 'claude --channels plugin:telegram@claude-plugins-official'. Voor Discord zijn de namen analoog.

  5. 05

    5. Pairing en toegangscontrole

    Stuur de bot een bericht, je krijgt een pairingcode. Keur ze goed met '/telegram:access pair <code>' en zet daarna '/telegram:access policy allowlist'. Onbekende afzenders worden genegeerd. Voeg enkel mensen toe die je vertrouwt: wie via het kanaal antwoordt, kan ook acties laten goedkeuren.

Let op

Wat je moet weten voor je het aanzet

Rechten en goedkeuringen

Bij een permission-prompt pauzeert de sessie tot iemand antwoordt, tenzij het kanaal permission relay ondersteunt. Alle toestemmingen overslaan kan, maar is risicovol: doe dat enkel in een geïsoleerde omgeving.

Research preview

Channels zijn nog in preview. De flag '--channels' staat niet in 'claude --help' en syntaxis of protocol kan veranderen. Controleer de officiële channels-pagina van Claude Code.

Sessie moet open blijven

Berichten komen enkel aan terwijl de sessie draait. Daarom tmux. Op Amazon Bedrock, Google Cloud en Microsoft Foundry zijn channels niet beschikbaar.

Abonnement en voorwaarden

De documentatie staat channels toe met een claude.ai-login of API-key. Of een 24/7-agent op een abonnement binnen de gebruiksvoorwaarden valt, hebben wij niet kunnen vaststellen: lees de voorwaarden of vraag het Anthropic. Voor commerciële of klantgerichte agents is een API-key de veiligere weg.

Geheimen en data

Hou tokens in een .env of secrets-manager, nooit in de repo. Geef de agent enkel toegang tot wat nodig is.

Opvolging

Log wat de agent doet. Een agent die niemand opvolgt, loopt vroeg of laat vast of doet iets onverwachts.

Nog open

Waar we samen kunnen aanvullen

Deze gids is een basis. Onderstaande punten werken we graag uit, afhankelijk van wat jullie nodig hebben.

Open

Webterminal en beveiliging

Welke webterminal, welke authenticatie (SSO, VPN, Tailscale), en hoe sluit je alles netjes af?

  • Keuze van tooling
  • HTTPS en toegang
  • Logging
Open

Stabiel draaien

Automatisch herstarten (systemd), herstel na een crash, tokenverloop en updates van Claude Code.

  • Systemd-service
  • Monitoring
  • Back-ups
Open

Van hobby naar bedrijfsagent

Een agent met eigen taken, tools en koppelingen aan Odoo of je bedrijfsdata, mét goedkeuringsstappen.

  • Odoo- en ERP-koppeling
  • Menselijke goedkeuring
  • API-key en kostenbeheer
Onze AI-agents →

Veelgestelde vragen

Vragen over deze opzet

Moet ik tmux gebruiken?

Niet verplicht, maar het is een eenvoudige manier om een sessie te laten leven nadat je afmeldt. Alternatieven zijn screen of een service die een terminal beheert.

Werkt dit met een abonnement of een API-key?

Volgens de documentatie werken beide. Een API-key in je omgeving heeft voorrang op je abonnementslogin. Controleer in je eigen versie wat werkt.

Is het veilig om dit open op internet te zetten?

Nee, niet zonder bescherming. Zet de webterminal achter HTTPS en een sterke login of VPN, en beperk de rechten van de gebruiker.

Kunnen jullie dit voor ons opzetten?

Ja. Van een eenvoudige opzet tot een volledige bedrijfsagent met koppelingen, rechten en opvolging.

Zelf aan de slag, of liever samen?

Wil je dit uitbreiden of zelf laten opzetten? Laat ons weten wat de agent moet doen, dan denken we mee over de beste opzet.

Plan een gesprek AI-agents voor je bedrijf