Claude Code-integratie

Claude Code is de codeeragent van Anthropic voor de terminal. Met de Timesheet-plug-in erbij kan hij timers starten en stoppen, net afgerond werk vastleggen en vragen beantwoorden over waar je uren heen zijn gegaan, zonder dat je van venster wisselt.

Wat je kunt vragen

• "Start de timer voor het API-project"
• "Stop de timer en voeg een notitie toe: inlogbug opgelost"
• "Waar heb ik gisteren aan gewerkt?"
• "Registreer 2 uur op het project mobiele app voor maandag"
• "Exporteer vorige maand naar Excel en stuur het naar mijn boekhouder"

Voordat je begint

• Een Timesheet Pro-abonnement of hoger. Bekijk de abonnementen en prijzen.
• Een Timesheet API-sleutel, die je aanmaakt in de webapp onder Integraties > API-sleutels.
• Node.js 18 of hoger.

De plug-in installeren

Voer deze twee commando's uit binnen een sessie van Claude Code:

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

In de plug-in zit een skill die elke commandogroep van @timesheet/cli beschrijft, zodat Claude Code de precieze vlaggen en werkwijzen kent in plaats van te gokken.

Installeer daarna de CLI die de plug-in aanstuurt en log één keer in:

npm install -g @timesheet/cli
timesheet auth login

timesheet auth login gebruikt OAuth 2.1 met PKCE en opent je browser. Voor automatisering en CI stel je in plaats daarvan een API-sleutel in:

export TIMESHEET_API_KEY=ts_your.apikey
timesheet auth status --json

Of koppelen via MCP

Laat je Claude Code liever getypeerde tools aanroepen dan shell-commando's uitvoeren, voeg dan de MCP-server van Timesheet toe aan ~/.claude/settings.json:

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Beide routes komen bij hetzelfde account uit. De plug-in past bij werken in de shell en bij scriptbare uitvoer, de MCP-server bij assistenten die liever gestructureerde tools aanroepen.

De skill zonder de plug-in gebruiken

De CLI levert hetzelfde skill-bestand mee, dus elke agent met skill-ondersteuning kan het laden:

timesheet skill path      # kijk waar het geschreven zou worden
timesheet skill install   # schrijf het naar de skills-map van de agent

Goed om te weten

• Elk leescommando accepteert --json, zodat de uitvoer machineleesbaar blijft. Stuur je het door naar een ander commando, dan schakelt het automatisch over op TSV.
• Afsluitcode 3 betekent dat de sessie opnieuw moet inloggen.
• Je API-sleutel geeft volledige toegang tot je account. Zet hem nooit in versiebeheer. Wil je de toegang intrekken, verwijder dan de sleutel onder Integraties > API-sleutels.