TIPS 88 · DETTATURA

Diktieren in Claude Code: sprechen statt tippen, und die Transkription frisst deine Limits nicht

Claude Code hat eine eingebaute Diktierfunktion: Leertaste gedrückt halten, sprechen, und die Wörter erscheinen im Prompt. Wie du sie einschaltest, wie du deine Sprache einstellst, wie du einen falschen Satz verwirfst, und drei Sätze, die du sofort diktieren kannst.

Was es ist und warum es zählt

Du schreibst Claude Code zehnmal pro Stunde, und jedes Mal kürzt du. Der Kontext in deinem Kopf wird zu einer Zeile, weil alles abzutippen dauert. Dann macht Claude das Falsche, und du musst es noch mal erklären.

Die Diktierfunktion steckt schon in Claude Code. Du schaltest sie mit /voice ein, sprichst, und die Wörter erscheinen im Prompt, während du sie sagst. Du kannst mischen: einen Satz sprechen, einen Dateinamen tippen.

Und in der Dokumentation von Anthropic steht es klar: Die Transkription verbraucht keine Nachrichten und keine Tokens und zählt nicht zu den Limits in /usage. Der Prompt, den du abschickst, verbraucht wie immer Tokens, als hättest du ihn getippt. Das ist für alle, die den Tag in Claude Code verbringen und mit weniger Aufwand mehr Kontext geben wollen.

1. Was du brauchst und wohin deine Stimme geht

Bevor du sie ausprobierst, prüf diese drei Dinge:

  • Ein Claude.ai-Konto, mit dem du in Claude Code angemeldet bist. Mit einem Anthropic-API-Schlüssel, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry gibt es das Diktieren nicht.
  • Ein Mikrofon an dem Rechner, auf dem Claude Code läuft. In Cloud-Sitzungen und über SSH funktioniert es nicht.
  • Unter Windows in WSL brauchst du WSLg; ohne starte Claude Code direkt unter Windows.

Vorher wissen: Das Audio bleibt nicht auf deinem Rechner. Es geht an die Server von Anthropic, die es transkribieren; lokal wird nichts verarbeitet. Wie sie mit den Daten umgehen, erklärt die Claude-Code-Dokumentation.

2. Mit /voice einschalten und wählen, wie du sprichst

Schreib im Chat von Claude Code:

Die Nachricht
/voice

Es läuft ein Mikrofontest; auf dem Mac fragt das System beim ersten Mal nach der Berechtigung für dein Terminal: erlaub sie. Dann liest du Voice mode enabled (hold) und am Ende Dictation language: en. Das en ist Englisch: Das stellst du in Schritt 3 um.

Zwei Modi: halten oder tippen

  • Halten (hold), der Standard: Leertaste gedrückt halten, sprechen, loslassen. Nach kurzem Aufwärmen steht unten listening…, und es wird aufgenommen. Wenn du loslässt, landet der Text im Prompt und wartet auf dein Enter.
  • Tippen (tap): Bei leerem Prompt tippst du die Leertaste an und es startet, noch mal tippen und es stoppt, ohne Aufwärmen. Hat der Text mindestens drei Wörter, geht er von selbst raus, damit ein versehentliches Tippen kein einzelnes Wort verschickt. Es stoppt auch nach 15 Sekunden Stille oder insgesamt 2 Minuten.

Um den Modus zu wählen oder sie auszuschalten (die Wahl bleibt auch für spätere Sitzungen):

Die Nachricht
/voice hold
Die Nachricht
/voice tap
Die Nachricht
/voice off

Oder in ~/.claude/settings.json (stehen schon andere Einstellungen drin, füg nur den voice-Block hinzu, mit Komma). Das ist Halten mit automatischem Senden beim Loslassen, sofern der Text mindestens drei Wörter hat. Ohne autoSubmit, das nur beim Halten gilt, wartet er auf dein Enter. Für Tippen schreib "tap" statt "hold".

Die Datei
{
  "voice": {
    "enabled": true,
    "mode": "hold",
    "autoSubmit": true
  }
}

Mein Rat: Halten ohne automatisches Senden, bis du der Transkription vertraust.

3. Stell deine Sprache ein und wisse, was sich ändert

Standardmäßig versteht die Diktierfunktion Englisch: Sprichst du Deutsch, ohne etwas zu ändern, kommt verstümmelter Text heraus. Deutsch gehört zu den unterstützten Sprachen. Du stellst es über /config ein oder in ~/.claude/settings.json:

Die Datei
{
  "language": "german"
}

Der Sprachcode geht auch, also "de". Schreibst du eine Sprache, die nicht auf der Liste steht, warnt dich /voice und diktiert auf Englisch.

Achtung: Es ist dieselbe Einstellung, die die Sprache der Antworten festlegt. Ab dann antwortet dir Claude auf Deutsch, und auch die automatischen Sitzungstitel sind auf Deutsch.

4. Sprechen, tippen, verwerfen

Die Wörter erscheinen, während du sprichst, abgeblendet, bis die Transkription fertig ist. Der Text landet dort, wo der Cursor steht: einen halben Satz tippen, Leertaste halten, den Rest sagen. Halt noch mal, um ein weiteres Stück anzuhängen.

Sie ist für Leute gemacht, die programmieren: Sie erkennt Wörter wie regex, OAuth, JSON und localhost und nutzt den Namen deines Projekts und deines Git-Branches von selbst als Hinweis. Mein Weg: Die Überlegung spreche ich, die genauen Dateipfade tippe ich.

Falscher Satz? Esc

Drück Esc oder Strg+C während der Aufnahme oder solange der Satz noch verarbeitet wird: Das Mikrofon geht aus, die Transkription wird verworfen, und der Prompt ist wieder wie vorher. Bei diesem Drücken unterbricht Esc Claude nicht, und Strg+C beendet Claude Code nicht.

5. Ändere die Taste, wenn dich die Leertaste stört

Beim Halten hat die Leertaste das Aufwärmen, und wo sie etwas anderes macht (im Transkript-Viewer, in vim außerhalb von INSERT), diktiert sie nicht. Eine Kombination wie Option+K auf dem Mac, Alt+K anderswo, startet beim ersten Druck und funktioniert auch dort. Du änderst das in ~/.claude/keybindings.json:

Die Datei
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "meta+k": "voice:pushToTalk",
        "space": null
      }
    }
  ]
}

meta ist Option auf dem Mac und Alt anderswo. Die neue Taste ersetzt die Leertaste, für Halten und Tippen, und Claude Code liest die Datei ohne Neustart ein. Beim Halten nimm keinen einzelnen Buchstaben wie v: Während des Aufwärmens landet er im Prompt.

6. Drei Sätze, die du sofort diktierst

Beim Sprechen gibst du mehr Kontext, als du tippen würdest. Öffne Claude Code in deinem Projekt, schalte das Diktieren ein und sag einen dieser Sätze, mit deinen Angaben statt der Teile in [ ].

Satz 1 · bevor du den Code anfasst
Bevor du irgendetwas änderst, lies das Projekt und erklär mir, wie [die Abo-Zahlung] funktioniert: in welcher Datei sie startet, wo sie durchläuft und wo sie kaputtgehen könnte. Dann stell mir drei Fragen zu dem, was dir nicht klar ist.
Satz 2 · ein Bug, erzählt wie einem Kollegen
Es gibt einen Bug: Wenn [sich ein neuer Nutzer registriert und vom Willkommensbildschirm zurückgeht], [bleibt die App weiß]. Ich hätte erwartet, [auf der Startseite zu landen]. Finde die Ursache, erklär sie mir in zwei Sätzen und schlag die kleinste Korrektur vor. Fass den Code nicht an, bis ich ok sage.
Satz 3 · der Abschluss der Sitzung
Für heute sind wir fertig. Fass zusammen, was wir in dieser Sitzung geändert haben, was noch offen ist und was du morgen als Erstes machen würdest, und schreib es in höchstens fünf Zeilen in [NOTIZEN.md].

Häufige Fehler

  • Auf Deutsch diktieren, ohne die Sprache einzustellen: Der Text kommt verstümmelt heraus, weil das Diktieren standardmäßig Englisch ist.
  • Unknown command: /voice. Du bist nicht mit einem Claude.ai-Konto angemeldet, oder etwas hat Vorrang: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, ein apiKeyHelper oder ein anderer Anbieter. Entfern es, starte Claude Code neu und führ /login aus.
  • Microphone access is denied auf dem Mac: Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon, dein Terminal einschalten und /voice erneut ausführen. Steht es nicht in der Liste: tccutil reset Microphone com.apple.Terminal (iTerm2: com.googlecode.iterm2), dann das Terminal mit Cmd+Q beenden und neu öffnen. Nie ohne Kennung: Das nimmt allen Apps das Mikrofon weg.
  • Es über SSH oder in einer Cloud-Sitzung probieren: Das Mikrofon muss an dem Rechner sein, auf dem Claude Code läuft.
  • Leertaste halten und nur Leerzeichen sehen. Häufen sie sich, ist das Diktieren aus: /voice hold. Erscheinen ein oder zwei und sonst nichts, ist die Tastenwiederholung aus: /voice tap.

Checkliste

  • Ich bin in Claude Code mit einem Claude.ai-Konto angemeldet, nicht mit einem API-Schlüssel
  • /voice antwortet Voice mode enabled, und das Terminal hat die Mikrofonberechtigung
  • Ich habe Halten oder Tippen gewählt und weiß, ob der Prompt von selbst rausgeht
  • Ich habe Deutsch eingestellt und weiß, dass Claude mir jetzt auf Deutsch antwortet
  • Ich habe einen Satz mit Esc verworfen, und der Prompt war wieder wie vorher
  • Ich habe einen der drei Sätze in meinem Projekt diktiert

Häufige Fragen

Frisst das Diktieren meine Limits?

Die Transkription nicht: Sie verbraucht keine Nachrichten und keine Tokens und zählt nicht zu den Limits in /usage. Der Prompt, den du abschickst, schon, als hättest du ihn getippt.

Funktioniert es auch in VS Code?

Ja, in der Claude-Code-Erweiterung für VS Code, mit demselben Claude.ai-Konto. Nicht in Remote-Sitzungen (SSH, Dev Containers, Codespaces): Das Mikrofon ist an deinem Rechner, die Erweiterung läuft woanders.

Wie lange kann ich am Stück sprechen?

Die Dokumentation nennt nur fürs Tippen und für die VS-Code-Erweiterung ein Limit: Die Aufnahme stoppt nach 15 Sekunden Stille oder insgesamt 2 Minuten. Fürs Halten nennt sie keins.

← Alle Anleitungen