---
title: Verbinde deinen Assistenten mit bexio
description: Offene Rechnungen nachschlagen, Kontakte finden, Offerten vorbereiten, direkt im Chat. Dein Assistent arbeitet mit deinem bexio, du gibst frei.
kategorie: Buchhaltung
typ: Anbindung
aufwand: ca. 30 Minuten
systeme: [bexio]
repo: https://github.com/wir-drei-digital/bexio-cli
release: https://github.com/wir-drei-digital/bexio-cli/releases/latest
operationen: 310
trifft_auf: [bexio]
order: 1
date: 2026-08-22
---

## Was das bringt

> «Wie viele Rechnungen sind noch offen?»

Bis jetzt heisst das: bexio öffnen, klicken, suchen. Mit dieser Anbindung fragst du deinen Assistenten.

Er liest Kontakte, Rechnungen, Offerten, Aufträge und Projekte direkt aus deinem bexio. Und er bereitet Neues vor: eine Offerte als Entwurf, ein Kontakt nach einem Termin. Angelegt wird erst, wenn du freigibst.

## Voraussetzungen

- Ein Assistent mit Zugriff auf Dateien und Programme, zum Beispiel Claude Code, Codex oder opencode. Ein normaler Browser-Chat reicht nicht.
- Ein bexio-Konto. Zum Erstellen des Zugangs brauchst du Administratorrechte.

## Anleitung für deinen Assistenten

### Schritt 1: ICM-Ordner und Router ergänzen

Prüfe zuerst, ob du in einem ICM mit einem Router `CONTEXT.md` arbeitest. Falls ja:

1. Lies den Router und prüfe, welche nummerierten Workflow-Ordner bereits bestehen.
2. Wähle die nächste freie zweistellige Nummer. Lege die Anbindung direkt im ICM als `0X_bexio/` an, zum Beispiel `06_bexio/`. Ersetze `0X` durch die gewählte Nummer. Lege sie nicht unter `workflows/bexio/` ab.
3. Erstelle im neuen Ordner eine `CONTEXT.md` mit den Regeln unten.
4. Ergänze im Haupt-Router `CONTEXT.md` eine verlinkte Zeile für typische bexio-Aufgaben. Verwende darin den tatsächlichen Ordnernamen, zum Beispiel:

```markdown
| **bexio**: Rechnungen, Offerten oder Kontakte nachschlagen | [`06_bexio/`](06_bexio/CONTEXT.md) | in Einrichtung |
```

Arbeitest du nicht in einem ICM, frag den Nutzer, wo die Regeln der Anbindung liegen sollen. Bau nicht ungefragt eine ICM-Struktur auf.

Die `CONTEXT.md` der Anbindung beginnt so:

```markdown
# Workflow: bexio-Anbindung

Zweck: (mit dem Nutzer ausfüllen: wofür vor allem? Rechnungen, Offerten, Kontakte?)

## Regeln

- Lesen ist erlaubt. Anlegen und Ändern nur nach Freigabe im Chat.
- Der API-Zugang liegt in der lokalen Konfiguration des CLI, nie im Chat, nie in Git.
- Beträge und Kundendaten stammen aus bexio oder vom Nutzer, nie geschätzt.
- Versand-Operationen (z. B. Rechnung verschicken) nur nach ausdrücklicher Freigabe.
```

Frag den Nutzer nach dem Zweck und lass ihn die Regeln bestätigen, bevor du den Zugang einrichtest.

### Schritt 2: CLI installieren

Lade von https://github.com/wir-drei-digital/bexio-cli/releases/latest das Binary für sein System (macOS und Linux als `.tar.gz` für amd64 und arm64, Windows als `.zip`). Prüfe den Download gegen `checksums.txt`, entpacke das Archiv und lege `bexio` in den PATH.

Alternative, falls eine Go-Toolchain da ist: `go install github.com/wir-drei-digital/bexio-cli/cmd/bexio@latest`

Prüfe die Installation mit `bexio --version`.

### Schritt 3: Zugang wählen

Frag den Nutzer, welcher Zugang passt:

- **Personal Access Token** - in bexio erstellt und 60 Tage gültig. Gut für einen zeitlich begrenzten Test.
- **OAuth** - verlangt eine App-Registrierung auf https://developer.bexio.com. Das CLI erneuert den Zugriff mit dem Refresh-Token, solange bexio diesen Zugang nicht widerruft. Die nötigen Redirect-URLs stehen im README des CLI.

Wichtig: Der Nutzer tippt sein Token nie in den Chat. `bexio init` fragt es direkt im Terminal ab und speichert es lokal mit 0600-Rechten.

### Schritt 4: bexio init ausführen

Lass den Nutzer `bexio init` im Terminal ausführen. Der Wizard sammelt den Zugang ein und prüft ihn gleich mit einem einzigen Lese-Aufruf.

Beim Personal Access Token: notiere das Ablaufdatum (heute plus 60 Tage) in der `CONTEXT.md`. Zeig es bei späteren Prüfungen der Anbindung an, sobald weniger als sieben Tage bleiben.

### Schritt 5: Verifikation

Mach einen Lese-Aufruf und zeig dem Nutzer das Ergebnis:

```sh
bexio contacts list --limit 10
```

Alle verfügbaren Operationen findest du mit `bexio commands --json`. Kommt eine Liste zurück, steht die Anbindung. Trag in der `CONTEXT.md` das Einrichtungsdatum nach. Arbeitest du in einem ICM, setz den Status der bexio-Zeile im Haupt-Router auf `aktiv`.

## Was du danach kannst

- «Zeig mir die offenen Rechnungen.»
- «Leg eine Offerte für Muster AG an: drei Positionen, ich diktiere.» Der Assistent baut den Entwurf, du gibst frei.
- «Welche Kontakte haben wir seit Juni neu erfasst?»

## Wichtig zu wissen

- Das Personal Access Token läuft nach 60 Tagen ab und muss dann neu erstellt werden. Mit OAuth musst du nicht alle 60 Tage ein neues Personal Access Token anlegen. Der OAuth-Zugang kann trotzdem widerrufen werden oder aus anderen Gründen ausfallen.
- Versand-Operationen verweigert das CLI ohne `--force`. Das ist Absicht: verschicken bleibt ein bewusster Entscheid.
- Dein Assistent macht Fehler wie ein neuer Mitarbeiter. Darum gilt: anlegen ja, aber du gibst frei.