Voice Coding mit Claude Code: Prompts sprechen

TL;DR: Claude Code läuft im Terminal und erwartet detaillierte natürlichsprachliche Prompts. Diese Prompts zu tippen ist langsam. Sprachdiktieren ermöglicht es Ihnen, Claude Code reichhaltigeren Kontext in einem Bruchteil der Zeit zu geben, was zu besserer Ausgabe und weniger Iterationen führt.

Das Claude-Code-Prompt-Problem

Claude Code ist eines der leistungsstärksten KI-Coding-Tools auf dem Markt. Es kann Ihre gesamte Codebase lesen, mehrere Dateien bearbeiten, Tests ausführen und komplexe mehrstufige Aufgaben erledigen. Aber es gibt einen Haken: Die Qualität ist direkt proportional zur Qualität Ihrer Prompts.

Und Claude Code läuft im Terminal, wo das Tippen langer, detaillierter Prompts besonders mühsam ist. Es gibt keinen Rich-Text-Editor, keine einfache Möglichkeit, die Mitte eines Absatzes zu bearbeiten, kein Autocomplete für natürliche Sprache. Nur Sie, ein blinkender Cursor und die Versuchung, es kurz zu halten.

Also schreiben Entwickler Prompts wie:

> fix the auth bug

Obwohl sie eigentlich schreiben sollten:

> The authentication middleware in src/middleware/auth.ts is returning 401
> for users with valid refresh tokens when their access token has expired.
> The issue is in the verifyToken function around line 45 - it checks the
> access token expiry but doesn't fall through to check the refresh token.
> Fix this by adding refresh token validation before returning 401, and
> add a test case for this scenario in auth.test.ts.

Der zweite Prompt erspart Claude Code das Raten. Er produziert den richtigen Fix beim ersten Versuch. Aber wer will das alles in ein Terminal tippen?

Die Lösung: Sprache + Claude Code

Der Workflow ist folgender: Sie lassen Claude Code in Ihrem Terminal wie gewohnt laufen. Wenn Sie Anweisungen geben müssen, tippen Sie nicht, sondern drücken Ihren Sprach-Shortcut, sprechen 15-30 Sekunden natürlich, und Ihr detaillierter Prompt erscheint im Terminal, bereit zum Absenden.

Einrichtung: Murmur + Claude Code

1. Murmur installieren, falls noch nicht geschehen
2. Öffnen Sie Ihr Terminal (PowerShell, Windows Terminal, CMD oder einen anderen Terminal-Emulator)
3. Starten Sie Claude Code wie gewohnt
4. Wenn Claude Code auf Eingabe wartet, drücken Sie Strg+Leertaste (Murmurs Standard-Shortcut)
5. Sprechen Sie Ihren Prompt natürlich
6. Murmur transkribiert und fügt den Text an Ihrer Cursorposition ein
7. Drücken Sie Enter, um den Prompt an Claude Code zu senden

Das war's. Murmur nutzt KI-gestützte Transkription, die technische Begriffe, Dateipfade und Befehlsnamen korrekt verarbeitet.

Echte Beispiele: Diktiert vs. Getippt

Hier sind echte Prompts aus meinem täglichen Workflow, die vergleichen, was ich getippt hätte und was ich tatsächlich per Sprache gesagt habe.

Beispiel 1: Bugfix

Was ich getippt hätte:

fix the login redirect issue

Was ich gesagt habe (transkribiert von Murmur):

The login page redirects to /dashboard after successful authentication
but it should redirect to the URL the user originally tried to access.
The return URL is stored in the query parameter called 'next' on the
login page URL. Update the login handler in pages/login.tsx to read
this parameter and redirect there after auth, falling back to /dashboard
if no next parameter exists. Also make sure to validate the next URL
to prevent open redirect attacks.

Zeit zum Tippen der ersten Version: 5 Sekunden. Zeit zum Sprechen der zweiten Version: 18 Sekunden. Zeitersparnis durch Iterationen, weil Claude Code es beim ersten Versuch richtig gemacht hat: mehrere Minuten.

Beispiel 2: Neues Feature

Was ich getippt hätte:

add rate limiting to the API

Was ich gesagt habe:

Add rate limiting to the Express API. Use the express-rate-limit package.
Apply a global limit of 100 requests per minute per IP address. For the
authentication endpoints in routes/auth.ts, apply a stricter limit of
10 requests per minute to prevent brute force attacks. Store the rate
limit counters in Redis using our existing Redis client from lib/redis.ts.
Return a 429 status with a JSON error message that includes a retryAfter
field in seconds. Add the rate limiter as middleware in app.ts before
the route handlers.

Beispiel 3: Refactoring

Was ich getippt hätte:

refactor the user service to use the repository pattern

Was ich gesagt habe:

Refactor the UserService in services/user.ts to use the repository
pattern. Create a UserRepository interface in repositories/types.ts
with methods for findById, findByEmail, create, update, and delete.
Implement it in repositories/prisma/user.ts using our existing Prisma
client. Update UserService to accept the repository through constructor
injection instead of importing Prisma directly. This will make the
service testable without a database. Update the dependency injection
setup in di/container.ts to wire everything together. Do not change
any of the controller code, just the service layer.

Tipps für klares Sprechen technischer Prompts

Dateien und Pfade explizit benennen

Claude Code hat Zugriff auf Ihre Projektstruktur, aber spezifische Pfade beseitigen Mehrdeutigkeit.

Sagen Sie: „Update the authentication middleware in src/middleware/auth.ts" statt „update the auth middleware."

Sagen Sie: „The Prisma schema in prisma/schema.prisma" statt „the database schema."

Die Architektur beschreiben

Wenn Sie Änderungen über mehrere Dateien hinweg anfordern, beschreiben Sie die Architektur in einfachem Deutsch oder Englisch:

„Ich möchte eine Caching-Schicht hinzufügen. Erstelle ein CacheService-Interface, implementiere es mit Redis, injiziere es in den UserService und ProductService und füge Cache-Invalidierung bei Schreiboperationen hinzu."

Das würden Sie nie alles tippen. Aber es zu sagen dauert zehn Sekunden.

„Nicht"-Einschränkungen verwenden

Sagen Sie explizit, was Claude Code vermeiden soll. Das ist beim Sprechen einfach, aber beim Tippen mühsam:

„Refaktorisiere die Fehlerbehandlung, aber ändere nicht das Fehler-Response-Format, weil das Frontend von der aktuellen Struktur abhängt. Entferne auch keine der bestehenden Fehlercodes, füge nur die neuen hinzu."

Muster in Ihrer Codebase referenzieren

Claude Code kann Ihren Code lesen, also referenzieren Sie bestehende Muster:

„Erstelle einen neuen API-Endpoint für Orders nach exakt dem gleichen Muster wie den Products-Endpoint in routes/products.ts. Gleiche Middleware-Kette, gleiche Fehlerbehandlung, gleiches Response-Format. Tausche einfach Products gegen Orders und verwende den OrderService."

Laut denken

Anders als beim Tippen können Sie beim Sprechen ein Problem in Echtzeit durchdenken:

„Okay, also das Problem ist, dass diese WebSocket-Verbindung nach 30 Sekunden Inaktivität abbricht. Ich denke, wir brauchen einen Heartbeat-Mechanismus. Lass mich überlegen... ja, füge ein Ping/Pong-System hinzu, bei dem der Server alle 15 Sekunden einen Ping sendet und der Client mit einem Pong antwortet. Wenn der Server innerhalb von 5 Sekunden keinen Pong empfängt, schließe die Verbindung und lass die Auto-Reconnect-Logik des Clients das übernehmen. Die Reconnect-Logik ist bereits in lib/websocket.ts, also brauchen wir nur die serverseitige Ping-Funktion."

Claude Code ist ausgezeichnet darin, die umsetzbare Absicht aus dieser Art von natürlichem Denken zu extrahieren.

Warum Sprache KI-Agenten mehr Kontext gibt

Es gibt einen psychologischen Grund, warum Sprache bessere Prompts produziert: Sprechen hat weniger Reibung als Tippen.

Beim Tippen hat jedes Wort Kosten. Sie editieren sich unbewusst selbst und kürzen Details, die „zu lang zum Tippen" erscheinen. Das Ergebnis sind knappe, mehrdeutige Prompts.

Beim Sprechen fließen Worte mit 150+ Wörtern pro Minute (gegenüber 60-80 bei den meisten Tippern). Die Kosten pro Wort sinken dramatisch. Sie fügen Kontext ein, den Sie sonst gekürzt hätten. Sie erwähnen Grenzfälle, die Sie übersprungen hätten. Sie erklären das „Warum" neben dem „Was."

Das ist für KI-Agenten enorm wichtig. Claude Code kann einen 500-Wort-Prompt genauso einfach verarbeiten wie einen 10-Wort-Prompt. Aber der 500-Wort-Prompt gibt ihm genug Kontext, um die Implementierung beim ersten Versuch richtig zu machen, während der 10-Wort-Prompt es zum Raten zwingt.

Die Gleichung ist einfach: Sprache beseitigt die Kosten von Kontext. Mehr Kontext bedeutet bessere KI-Ausgabe. Bessere Ausgabe bedeutet weniger Iterationen. Weniger Iterationen bedeutet schnellere Entwicklung.

Häufige Terminal-Spracheingabe-Probleme

Lange Prompts und Zeilenumbrüche

Manche Terminals gehen mit langem eingefügtem Text unterschiedlich um. Wenn Probleme mit Zeilenumbrüchen auftreten, verwenden Sie ein Terminal, das mehrzeiliges Einfügen gut handhabt (Windows Terminal funktioniert hervorragend).

Sonderzeichen in Code

Wenn Sie spezifischen Code in Ihren Prompt einbauen müssen, ist es oft besser, nur dieses Snippet zu tippen und den Rest zu sprechen. Tippen Sie zum Beispiel das Regex-Muster, dann sprechen Sie die Erklärung, was es tun soll.

Hintergrundgeräusche im Terminal

Wenn Sie in einer lauten Umgebung sind, bewältigt Murmurs Geräuschunterdrückung (angetrieben durch ChatGPTs Verarbeitung) die meisten Umgebungsgeräusche. Aber ein Richtmikrofon oder Headset liefert die besten Ergebnisse.

Eine typische Sprache + Claude Code-Sitzung

So sieht eine echte 30-Minuten-Sitzung aus:

1. Sprechen: „Schau dir die fehlgeschlagenen Tests im User-Modul an. Die Tests in tests/user.test.ts scheitern beim Create-User-Flow. Kannst du identifizieren, was sich kürzlich geändert hat und sie kaputt gemacht hat?"
2. Claude Code untersucht, identifiziert das Problem
3. Sprechen: „Okay, behebe diese Test-Failures. Der Mock für den Email-Service muss aktualisiert werden, um zum neuen EmailService-Interface zu passen, das wir letzte Woche geändert haben. Aktualisiere auch alle anderen Testdateien, die den EmailService mocken."
4. Claude Code behebt die Tests über mehrere Dateien hinweg
5. Sprechen: „Führe die gesamte Test-Suite aus und sag mir, ob noch etwas anderes fehlschlägt."
6. Alle Tests bestehen
7. Sprechen: „Super. Erstelle jetzt einen Commit mit einer aussagekräftigen Message, die die Test-Fixes zusammenfasst."

Vier Sprach-Prompts. Insgesamt fünf Minuten Sprechen. Eine komplette Debugging- und Fix-Sitzung, die mit getippten Prompts deutlich länger gedauert hätte.

Fazit

Claude Code ist am leistungsstärksten, wenn Sie ihm detaillierte, kontextreiche Prompts geben. Sprachdiktieren mit Murmur beseitigt die Reibung zwischen Ihren Gedanken und dem Terminal und lässt Sie so sprechen, wie Sie einem erfahrenen Kollegen ein Problem erklären würden.

Das Ergebnis ist nicht nur schnellere Eingabe. Es sind grundlegend bessere Prompts, die zu besserem Code, weniger Iterationen und einem effektiveren KI-Coding-Workflow führen.

Wenn Sie Claude Code regelmäßig nutzen, fügen Sie Sprache zu Ihrem Terminal-Workflow hinzu. Starten Sie mit einer Sitzung. Sie werden den Unterschied sofort spüren.