---
title: "ay errors"
source: "https://ayoune.com/de/docs/cli/befehls-referenz/auth-config/ay-errors"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "de"
retrieved: "2026-08-27T21:23:18.936Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay errors`

Dokumentation der CLI-Exit-Codes — direkt im Terminal ablesbar. Hilfreich für Shell-Scripts, CI-Logs und AI-Agenten, die Non-Zero-Exit interpretieren müssen.

## Subcommands

### `ay errors` / `ay errors list`

Listet alle dokumentierten Exit-Codes.

```bash
ay errors
ay errors list
```

### `ay errors explain <code>`

Detail-View mit Bedeutung und Recovery-Hinweis.

```bash
ay errors explain 2
ay errors explain 4
```

## Exit-Code-Tabelle

| Code | Name | Bedeutung |
|---|---|---|
| `0` | EXIT_SUCCESS | Befehl erfolgreich |
| `1` | EXIT_GENERAL_ERROR | Allgemeiner Fehler — `--debug` für Details |
| `2` | EXIT_MISUSE | Ungültige Verwendung — `ay <cmd> --help` |
| `4` | EXIT_AUTH_REQUIRED | Token fehlt/abgelaufen — `ay login` |
| `5` | EXIT_PERMISSION_DENIED | Recht fehlt — Admin fragen, [access](wiki:cli/auth-config/access) prüfen |
| `78` | EXIT_CONFIG_ERROR | Config invalid — `~/.config/ayoune/config.json` prüfen, [doctor](wiki:cli/misc/doctor) |

## Beispiele

```bash
# In CI-Pipeline
if ay export run consumers --format csv; then
  echo "Export ok"
elif [ $? -eq 5 ]; then
  echo "Permission denied — check rights"
elif [ $? -eq 4 ]; then
  ay login
fi

# Erklärung in der Shell
ay errors explain 5
```

## Siehe auch

- [doctor](wiki:cli/misc/doctor) — Environment-Health
- [access](wiki:cli/auth-config/access) — Berechtigungen prüfen

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com