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

# `ay switch` (Alias: `sw`)

Wechselt den aktiven Customer-Context der CLI-Session. Bei Multi-Tenant-Zugehörigkeit unverzichtbar.

## Subcommands

| Subcommand | Zweck |
|---|---|
| (ohne) | Interaktiver Picker (Tabelle mit Slug, Name, Role) |
| `customer <slug\|id>` | Direkter Wechsel |
| `back` | Zurück auf vorherigen Context |
| `current` | Aktiven Context zeigen |
| `list` | Alle verfügbaren Tenants |

## Beispiele

```bash
ay switch                            # → Terminal-Picker
ay switch customer tolinax           # Direkt in Tolinax-Scope
ay switch customer platform          # Platform-Operator-Scope (Superuser only)
ay switch back                       # Zum Vor-Context zurück
```

## Context-Persistenz

Der gewählte Context wird in `~/.aYOUne/storage/activeContext.json` abgelegt und gilt für alle nachfolgenden Commands derselben Shell — und für neue Shells desselben Users.

Override für einen einzelnen Call ohne persistenten Wechsel:

```bash
ay list consumers --customer anderer-tenant
```

## Platform-Scope

```bash
ay switch customer platform
```

Erfordert das `restrictApiSuperUser`-Recht. Im Platform-Scope siehst du cross-tenant Admin-Collections (Registry, Infra-Config, Diagnostik). Nach Abschluss unbedingt zurück:

```bash
ay switch back
```

## Siehe auch

- [Konzept: Customer-Context](wiki:cli/concepts/customer-context)
- [whoami](wiki:cli/auth-config/whoami)

---

## 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