# Wie lasse ich Claude Code Audio und Video transkribieren?

> Fügen Sie den KolWrite-MCP-Server mit einem einzigen claude mcp add-Befehl hinzu oder installieren Sie den Skill kolwrite-transcribe. Claude Code lädt dann Ihre Datei hoch, startet den Job, wartet und schreibt Transkript, Untertitel oder Übersetzung in Ihr Projekt. Abgerechnet wird sekundengenau von Ihren KolWrite-Credits.

Zuletzt aktualisiert: 2026-11-21 · HTML: https://console.kolwrite.com/de/agents/claude-code

## Was Sie einmal tun

Legen Sie das Konto und den Schlüssel selbst auf [console.kolwrite.com](https://console.kolwrite.com/auth?lang=de) an: registrieren, Credits aufladen, API Keys öffnen und einen Schlüssel erstellen. Das kann ein Agent nicht für Sie erledigen.

Tragen Sie den Schlüssel in die Profildatei Ihrer Shell ein (`~/.zshrc`, `~/.bashrc`), damit jede Agenten-Sitzung ihn lesen kann, und öffnen Sie ein neues Terminal:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

Die Tools lesen den Schlüssel nur aus dieser Variablen. Fügen Sie ihn nicht in einen Chat ein und committen Sie ihn nicht in ein Repository.

## MCP-Server hinzufügen

Führen Sie den Befehl in einem Terminal aus, in dem `KOLWRITE_API_KEY` gesetzt ist. Mit `--scope user` steht der Server in jedem Projekt zur Verfügung:

```bash
claude mcp add --transport stdio --env KOLWRITE_API_KEY="$KOLWRITE_API_KEY" kolwrite -- npx -y https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz
```

Der Server stellt dem Agenten sechs Tools bereit: `transcribe_file`, `transcribe_url`, `upload_file`, `get_job`, `list_models`, `list_languages`. Er läuft auf Ihrem Rechner mit Node.js ab Version 18 und wird von https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz geladen (SHA-256 `0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca`).

Prüfen Sie ihn mit `claude mcp list` oder mit `/mcp` in einer Sitzung.

## Oder den Skill installieren

Der Skill ist ein Ordner mit einer SKILL.md und dem Ein-Datei-Client. Claude Code lädt ihn aus `~/.claude/skills` (alle Projekte) oder `.claude/skills` (ein Projekt) und nutzt ihn, wenn Sie eine Transkription anfordern:

```bash
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip && rm kolwrite-transcribe.zip
```

Der Text des Skills steht in [SKILL.md](https://console.kolwrite.com/skills/kolwrite-transcribe/SKILL.md). Nutzen Sie entweder den MCP-Server oder den Skill, beides zusammen ist nicht nötig.

## Beispielanfragen

Drei Anfragen, die Sie Claude Code stellen können:

```text
Transkribiere ~/Downloads/interview.m4a mit KolWrite und speichere den Text als interview.txt im selben Ordner.

Erstelle englische SRT-Untertitel für talk.mp4 mit KolWrite, ein Untertitel pro Satz.

Wer hat in team-call.mp3 was gesagt? Transkribiere die Datei mit Sprechererkennung und dem Modell oracle und liste dann die Aufgaben jedes Sprechers auf.
```

Claude Code braucht die Datei auf Ihrem Rechner oder einen direkten Link auf eine Mediendatei. Bei Videos über etwa 100 MiB extrahiert Claude Code zuerst die Tonspur mit ffmpeg.

## Was es kostet

| Aufgabe | Modell | Kosten |
| --- | --- | --- |
| Ein 30-minütiges Interview als reiner Text | `base` | 0,24 US$ |
| Eine einstündige Besprechung mit Sprechererkennung | `oracle` | 1,56 US$ |
| Ein einstündiger Vortrag auf Hebräisch mit englischen Untertiteln | `oracle` | 1,44 US$ |
| Eine Stunde verrauschtes Audio mit sich überlagernden Stimmen | `oracle_max` | 3,60 US$ |

Abgerechnet wird sekundengenau nach Audiolänge von Ihren Credits, ohne Mindestbetrag. Die Sprechererkennung kostet 0,10 Credits pro Audiostunde extra. Der MCP-Server und kolwrite.py verwenden `base`, solange nicht Sie oder der Agent ein anderes Modell nennen, und `oracle_mini` beim Übersetzen. Alle Preise: [/de/models](https://console.kolwrite.com/de/models).

## Was der Agent nicht tun darf

- Sie im Chat nach dem Schlüssel fragen, ihn ausgeben oder in eine Datei, einen Befehl oder einen Commit schreiben.
- Dieselbe Transkription nach einem Timeout oder Netzwerkfehler erneut starten. Jeder Start ist ein neuer, kostenpflichtiger Job; stattdessen soll er den bestehenden Job abfragen oder bei Ihnen nachfragen.
- Zeitstempel selbst eintippen. Um nach Zeit zu schneiden oder zu zitieren, nimmt er die Segmentnummern aus dem Transkript und berechnet die Zeiten im Code aus den Wortzeiten.
- Die Adresse eines YouTube-Videos oder einer anderen Webseite als Medium senden. Benötigt wird die Mediendatei selbst.
- Lange Aufnahmen (über eine Stunde) transkribieren, ohne Ihnen vorher die erwarteten Kosten zu nennen.

## Fragen und Antworten

### Braucht Claude Code den MCP-Server, oder kann es die API selbst aufrufen?

Es kann die REST-API selbst mit curl oder Python aufrufen, wenn Sie die Regel aus [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md) in `CLAUDE.md` eintragen. Der MCP-Server oder der Skill erspart ihm, jedes Mal den Upload- und Abfragecode neu zu schreiben.

### Wohin wird die Audiodatei gesendet?

Die Datei wird zu KolWrite hochgeladen und in der Cloud transkribiert, gemäß den [Nutzungsbedingungen und der Datenschutzerklärung von KolWrite](https://www.kolwrite.com/tos_pp.html). Der MCP-Server behält keine Kopie.

## Verwandte Seiten

- [Codex](https://console.kolwrite.com/de/agents/codex)
- [Jeder Agent: kolwrite.py und der Skill](https://console.kolwrite.com/de/agents/any-agent)
- [Videos mit KI-Agenten schneiden](https://console.kolwrite.com/de/guides/video-editing-with-ai)
- [Transkriptions-Tool für KI-Agenten](https://console.kolwrite.com/de/guides/transcription-tool-for-ai-agents)
- [API-Dokumentation](https://console.kolwrite.com/de/public_api_docs)

---
API-Schlüssel holen: https://console.kolwrite.com/auth?lang=de · API-Dokumentation: https://console.kolwrite.com/de/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
