> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ElevenLabs CLI

## Überblick

Mit der ElevenLabs CLI greifen Sie über Ihr Terminal auf Ihre ElevenLabs-Agenten zu und erhalten neue Möglichkeiten für deren Verwaltung:

* Speichern Sie Agenten als Code in Ihrem Versionskontrollsystem
* Richten Sie eine CI/CD-Integration ein, um Ihre Agenten automatisch bereitzustellen
* Geben Sie Ihrem Coding-Agent Zugriff auf Ihre Sprachagenten und deren Verwaltung

> **Direkt zum Code?**
>
> Den [vollständigen Quellcode finden Sie auf GitHub und können dazu beitragen](https://github.com/elevenlabs/cli).

> **Keine Installation erforderlich**
>
> Wenn Sie mit Claude oder einem anderen MCP-Client arbeiten, bietet der [gehostete MCP- Server](/docs/de/eleven-agents/operate/hosted-mcp) Tools zur Agentenverwaltung ohne lokale
> Installation. Verwenden Sie die CLI für Agenten in der Versionskontrolle; für die
> konversationelle Verwaltung nutzen Sie den gehosteten MCP-Server.

## Installation

Homebrew (macOS) und Scoop (Windows) sind die empfohlenen Installationsmethoden und stellen eine eigenständige Binärdatei bereit.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Arbeiten Sie mit einem KI-Coding-Assistenten? Führen Sie in Ihrem Projekt `elevenlabs generate-skills` aus, um für jede Befehlsgruppe eine
> `SKILL.md` in `skills/` zu schreiben. So kennt Ihr Assistent den gesamten Funktionsumfang der CLI,
> ohne dass Sie Dokumentation einfügen müssen. Mit `--output-dir` können Sie sie an einem anderen Ort ablegen. Dies liest die eigene
> eingebettete API-Definition der CLI, benötigt also keinen API-Schlüssel und funktioniert offline — und bleibt mit
> der von Ihnen installierten CLI-Version synchron.

Nach der Installation ist der Befehl `elevenlabs` global in Ihrem Terminal verfügbar.

## Schnellstart

### Neues Projekt initialisieren

```bash
elevenlabs agents init
```

Dadurch wird die Projektstruktur mit Konfigurationsverzeichnissen und Registrierungsdateien erstellt.

### Bei ElevenLabs anmelden

```bash
elevenlabs auth login
```

Dadurch wird ein Browserfenster geöffnet, um sich über OAuth anzumelden. Die CLI überprüft die Anmeldedaten und speichert sie sicher.

### Ersten Agenten erstellen

```bash
elevenlabs agents add "My Assistant" --template assistant
```

Dadurch wird eine neue Agentenkonfiguration mit der Assistant-Vorlage erstellt.

### Auf die ElevenLabs-Plattform übertragen

```bash
elevenlabs agents push
```

Dadurch wird Ihre lokale Agentenkonfiguration auf die ElevenLabs-Plattform hochgeladen.

## Projektstruktur

Die CLI erstellt ein strukturiertes Projektverzeichnis:

```
your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files
```

## Authentifizierung

`elevenlabs auth login` speichert Anmeldedaten im Schlüsselbund Ihres Betriebssystems — im Schlüsselbund unter macOS,
im Anmeldeinformations-Manager unter Windows und im Secret Service unter Linux. Wenn kein Schlüsselbund verfügbar ist, greift die
CLI auf `~/.config/elevenlabs/auth-keyring.json` mit den Berechtigungen `0600` zurück. Führen Sie
`elevenlabs auth status` aus, um die verwendete Quelle anzuzeigen, und `elevenlabs auth logout`, um den
gespeicherten Eintrag zu entfernen.

Für CI setzen Sie `ELEVENLABS_API_KEY` in der Umgebung oder einer `.env`-Datei, statt sich anzumelden.

### Befehle zur Authentifizierung

**`Login`**

```bash title="Login"
elevenlabs auth login
```

**`Logout`**

```bash title="Logout"
elevenlabs auth logout
```

## Agentenverwaltung

### Agenten erstellen

Erstellen Sie Agenten mit vorgefertigten Vorlagen:

```bash
elevenlabs agents add "Agent Name" [options]
```

**Optionen:**

* `--template <type>`: Wählen Sie aus verfügbaren Vorlagen (Standard: default)
* `--skip-upload`: Lokal erstellen, ohne auf die Plattform hochzuladen

**Beispiel:**

```bash
elevenlabs agents add "Customer Support Bot" --template customer-service
```

### Vorlagen

Die CLI bietet sechs vorgefertigte Vorlagen für häufige Anwendungsfälle:

#### default

Vollständige Konfiguration mit allen verfügbaren Feldern, sinnvollen Standardeinstellungen, umfassender Sprach-/Textunterstützung, Widget-Anpassung und Bewertungskriterien.

#### minimal

Nur wesentliche Felder, einschließlich grundlegender Prompt-, Sprach-, TTS- und Konversationseinstellungen.

#### voice-only

Optimiert für Sprachinteraktionen mit deaktivierter Texteingabe und erweiterten Spracheinstellungen.

#### text-only

Textorientierte Konversationen mit deaktivierten Sprachfunktionen.

#### customer-service

Professionelle, empathische Prompts, niedrige Temperatur (0.1), Dauer von 30 Minuten und Bewertungskriterien.

#### assistant

KI-Assistent für allgemeine Zwecke mit ausgewogener Kreativität (Temperatur 0.3) und vielseitiger Sprach-/Textunterstützung.

### Vorlagenbefehle

**`List available templates`**

```bash title="List available templates"
elevenlabs agents templates list
```

**`Show template configuration`**

```bash title="Show template configuration"
elevenlabs agents templates show <template>
```

### Synchronisierung

Halten Sie Ihre lokalen Konfigurationen mit der ElevenLabs-Plattform synchron:

**`Push all agents`**

```bash title="Push all agents"
elevenlabs agents push
```

**`Preview changes (dry run)`**

```bash title="Preview changes (dry run)"
elevenlabs agents push --dry-run
```

### Status und Überwachung

**`Check agent status`**

```bash title="Check agent status"
elevenlabs agents status
```

### Import und Export

**`Import existing agents`**

```bash title="Import existing agents"
elevenlabs agents pull
```

**`Import specific agent`**

```bash title="Import specific agent"
elevenlabs agents pull --agent <agent_id>
```

**`Update agents`**

```bash title="Update agents"
elevenlabs agents pull --update
```

**`List all agents`**

```bash title="List all agents"
elevenlabs agents list
```

> **Note**
>
> Standardmäßig überspringt `elevenlabs agents pull` Agenten, die bereits lokal vorhanden sind. Verwenden Sie das Flag `--update`,
> um lokale Konfigurationen mit Remote-Änderungen zu überschreiben, die im Browser oder über die API vorgenommen wurden.

## Toolverwaltung

Die CLI unterstützt zwei Tool-Typen, um die Funktionen von Agenten zu erweitern:

### Webhook-Tools

HTTP-API-Integrationen mit Authentifizierung und Timeout-Konfiguration:

```bash
elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json
```

### Client-Tools

Direkte clientseitige Integrationen:

```bash
elevenlabs tools add "Client Function" --type "client" --config-path ./config.json
```

## Widget-Generierung

Generieren Sie HTML-Einbettungscode für die Webintegration:

```bash
elevenlabs agents widget embed <agent_id>
```

Dies gibt HTML-Code wie diesen aus:

```html
<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>
```

## Konfigurationsdateien

### Struktur der Agentenkonfiguration

Jede Agentenkonfiguration enthält:

```json
{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}
```

### CI/CD-Pipeline-Integration

```yml
# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment
```