Spracherfassung

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Anforderungen

​

Spracherfassung aktivieren

/voice
Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

​

Halten zum Aufnehmen

> refactor the auth middleware to ▮
  # hold Space, speak "use the new token validation helper"
> refactor the auth middleware to use the new token validation helper▮

​

Tippen zum Aufnehmen und Senden

​

Ändern Sie die Erfassungssprache

{
  "language": "japanese"
}

​

Binden Sie die Erfassungstaste neu

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

​

Fehlerbehebung

• Voice mode requires a Claude.ai account: Sie sind mit einem API-Schlüssel oder einem Drittanbieter authentifiziert. Führen Sie /login aus, um sich mit einem Claude.ai-Konto anzumelden.
• Microphone access is denied: Gewähren Sie Ihrem Terminal in den Systemeinstellungen Mikrofonberechtigung. Unter macOS gehen Sie zu Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon und aktivieren Sie Ihre Terminal-App, führen Sie dann /voice erneut aus. Unter Windows gehen Sie zu Einstellungen → Datenschutz & Sicherheit → Mikrofon und aktivieren Sie den Mikrofonzugriff für Desktop-Apps, führen Sie dann /voice erneut aus. Wenn Ihr Terminal nicht in den macOS-Einstellungen aufgeführt ist, siehe Terminal nicht in macOS-Mikrofoneinstellungen aufgeführt.
• No audio recording tool found unter Linux: Das native Audiomodul konnte nicht geladen werden und kein Fallback ist installiert. Installieren Sie SoX mit dem im Fehlermeldung angezeigten Befehl, z. B. sudo apt-get install sox.
• Voice mode could not find a working audio recorder in WSL: WSLg leitet Audio über PulseAudio statt über ein ALSA-Gerät weiter, daher muss das PulseAudio-Backend von SoX explizit installiert werden. Führen Sie sudo apt install sox libsox-fmt-pulse aus. Die Installation von sox allein zieht das ALSA-Backend mit sich, das unter WSL nicht aufnehmen kann, da es kein /dev/snd-Gerät gibt.
• Voice input is failing repeatedly and has been paused: Die Spracherfassung ist mehrmals hintereinander fehlgeschlagen und hat versucht, neue Sitzungen zu stoppen, bis eine erfolgreich ist. Dies bedeutet normalerweise, dass das Mikrofon oder der Audiostapel auf diesem Host keinen Audio erfassen kann, z. B. ein Server ohne Kopfhörer, eine Remote-Shell ohne Audio-Durchleitung oder eine verweigerte Mikrofonberechtigung. Bestätigen Sie ein funktionierendes Eingabegerät, beheben Sie die zugrunde liegende Ursache aus den obigen Einträgen und lösen Sie dann die Spracherfassung erneut aus.
• Nichts passiert, wenn Sie Space im Halten-Modus halten: Beobachten Sie die Eingabeaufforderung, während Sie halten. Wenn sich Leerzeichen weiter ansammeln, ist die Spracherfassung wahrscheinlich aus; führen Sie /voice hold aus, um sie zu aktivieren. Wenn nur ein oder zwei Leerzeichen erscheinen und dann nichts, ist die Spracherfassung an, aber die Halten-Erkennung wird nicht ausgelöst. Die Halten-Erkennung erfordert, dass Ihr Terminal Tastenwiederholungsereignisse sendet, daher kann es eine gehaltene Taste nicht erkennen, wenn die Tastenwiederholung auf Betriebssystemebene deaktiviert ist. Wechseln Sie mit /voice tap zum Tippen-Modus, um die Tastenwiederholungsanforderung zu vermeiden.
• Das Tippen auf Space gibt ein Leerzeichen ein, anstatt im Tippen-Modus aufzunehmen: Das erste Tippen startet die Aufnahme nur, wenn die Eingabeaufforderung leer ist. Löschen Sie zuerst die Eingabe, oder überprüfen Sie, dass Sie im Tippen-Modus sind, indem Sie /voice tap ausführen.
• No audio detected from microphone: Die Aufnahme wurde gestartet, aber es wurde Stille erfasst. Bestätigen Sie, dass das richtige Eingabegerät als Systemstandard eingestellt ist und dass sein Eingabepegel nicht stummgeschaltet oder nahe Null ist. Unter Windows öffnen Sie Einstellungen → System → Sound → Eingabe und wählen Sie Ihr Mikrofon aus. Unter macOS öffnen Sie Systemeinstellungen → Sound → Eingabe.
• No speech detected: Audio erreichte den Transkriptionsdienst, aber es wurden keine Wörter erkannt. Sprechen Sie näher zum Mikrofon, reduzieren Sie Hintergrundgeräusche und bestätigen Sie, dass Ihre Erfassungssprache der Sprache entspricht, die Sie sprechen.
• Transkription ist verzerrt oder in der falschen Sprache: Die Erfassung wird standardmäßig auf Englisch eingestellt. Wenn Sie in einer anderen Sprache erfassen, legen Sie sie zuerst in /config fest. Siehe Ändern Sie die Erfassungssprache.

​

Terminal nicht in macOS-Mikrofoneinstellungen aufgeführt

​

Siehe auch

• Tastaturkürzel anpassen: Binden Sie voice:pushToTalk und andere CLI-Tastaturaktionen neu
• Einstellungen konfigurieren: Vollständige Referenz für voice, language und andere Einstellungsschlüssel
• Interaktiver Modus: Tastaturkürzel, Eingabemodi und Sitzungssteuerungen
• Befehle: Referenz für /voice, /config und alle anderen Befehle