Claude Code ist der Coding-Agent von Anthropic für das Terminal. Mit installiertem Timesheet-Plugin startet und stoppt er den Timer, hält gerade erledigte Arbeit fest und beantwortet Fragen dazu, wohin Ihre Stunden geflossen sind, ohne dass Sie das Fenster wechseln.

Was Sie fragen können

„Starte den Timer für das API-Projekt“
„Stoppe den Timer und füge eine Notiz hinzu: Login-Bug behoben“
„Woran habe ich gestern gearbeitet?“
„Buche 2 Stunden auf das Mobile-App-Projekt für Montag“
„Exportiere den letzten Monat als Excel und schicke ihn an meine Buchhaltung“

Voraussetzungen

Ein Timesheet Pro-Abonnement oder höher. Siehe Abonnements und Preise.
Ein Timesheet API-Schlüssel, erstellt in der Web-App unter Integrationen > API-Schlüssel.
Node.js 18 oder höher.

Plugin installieren

Führen Sie diese beiden Befehle in einer Claude-Code-Sitzung aus:

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

Das Plugin bringt einen Skill mit, der jede Befehlsgruppe von @timesheet/cli dokumentiert. Claude Code kennt damit die genauen Flags und Abläufe, statt zu raten.

Installieren Sie anschließend die CLI, die das Plugin steuert, und melden Sie sich einmalig an:

npm install -g @timesheet/cli
timesheet auth login

timesheet auth login nutzt OAuth 2.1 mit PKCE und öffnet den Browser. Für Automatisierung und CI setzen Sie stattdessen einen API-Schlüssel:

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

Oder per MCP verbinden

Wenn Claude Code lieber typisierte Tools aufrufen soll statt Shell-Befehle, tragen Sie den Timesheet MCP-Server in ~/.claude/settings.json ein:

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

Beide Wege führen zum selben Konto. Das Plugin passt zu Shell-Workflows und skriptbarer Ausgabe, der MCP-Server zu Assistenten, die strukturierte Tool-Aufrufe bevorzugen.

Skill ohne Plugin nutzen

Die CLI liefert dieselbe Skill-Datei mit, sodass jeder Agent sie laden kann, der Skills unterstützt:

timesheet skill path      # zuerst prüfen, wohin geschrieben würde
timesheet skill install   # in das Skills-Verzeichnis des Agenten schreiben

Gut zu wissen

Jeder Lesebefehl akzeptiert --json, die Ausgabe bleibt also maschinenlesbar. Beim Weiterleiten an einen anderen Befehl wird automatisch auf TSV umgestellt.
Exit-Code 3 bedeutet, dass sich die Sitzung neu anmelden muss.
Ihr API-Schlüssel gewährt vollen Zugriff auf Ihr Konto. Checken Sie ihn niemals in die Versionsverwaltung ein. Zum Entziehen löschen Sie den Schlüssel unter Integrationen > API-Schlüssel.

Claude Code Integration