Anleitung

Code auf dem Mac diktieren: ein vollständiger Leitfaden für Cursor, VS Code und Claude Code

Bezeichner korrekt geschrieben. Commit-Nachrichten direkt im konventionellen Format. PR-Beschreibungen in der Stimme, in der du sie tippen würdest. Sechs ausgearbeitete Beispiele und das Tastatur-Setup, das wir täglich nutzen.

TL;DR

Dies ist der praktische Leitfaden, um Code auf dem Mac mit Loqua zu diktieren — Spracheingabe für Entwickler, die Code in Cursor, VS Code und Claude Code schreiben. Drei Dinge müssen zusammenpassen: technische Bezeichner werden erkannt, die Ausgabe wird für das Ziel formatiert, und die Latenz bleibt niedrig genug, um den Flow nicht zu unterbrechen. Loqua ist für diesen Mac-Workflow konzipiert: Code-Kommentare, Commits, PR-Beschreibungen, Terminalbefehle, Cursor-Prompts und Claude-Code-Anweisungen. Dieser Leitfaden führt durch Setup und ausgearbeitete Beispiele, ohne so zu tun, als wäre Sprache der beste Weg, jede Zeile Code zu schreiben.

Loqua ist ein kontextbewusstes Spracheingabe-Tool für Mac, das erkennt, ob du in einer IDE, einem Terminal, einer PR-Beschreibung oder einem Chat-Panel bist, und die Ausgabe entsprechend anpasst. Es läuft auf Apple Silicon über die Neural Engine, formatiert pro App und erkennt technisches Vokabular, ohne dass ein Wörterbuch vorher geladen werden muss.

Die ehrliche Version: Code zu diktieren ist eine andere Fähigkeit als Prosa zu diktieren. In der ersten Stunde wirst du langsamer sein. In der zweiten Stunde wirst du längere Kommentare und bessere Commit-Nachrichten schreiben, weil die Sprachform keine Tastenanschlag-Steuer hat. Wir nutzen das seit Monaten täglich — hier ist das Setup.

Setup in 90 Sekunden

Fünf Schritte, keiner davon überraschend, wenn du schon einmal eine Mac-App installiert hast:

  1. Lade Loqua von der Startseite herunter und ziehe es in /Applications.
  2. Erteile beim ersten Start die Mikrofon-Berechtigung und die Accessibility-Berechtigung. (Accessibility ist das, was Loqua erlaubt, deine aktive App und den ausgewählten Text zu sehen — siehe Apples Leitfaden zu Datenschutz und Sicherheit, was Accessibility hier bedeutet.)
  3. Öffne die Einstellungen von Loqua und bestätige deinen Push-to-Talk-Shortcut. Standard ist Fn + Leertaste. Wir nutzen Caps Lock, umbelegt über Karabiner-Elements, weil es erreichbar ist, ohne die Home-Row zu verlassen.
  4. Öffne einen beliebigen Texteditor — TextEdit, VS Code, Cursor, Notizen — und setze den Cursor in ein Textfeld.
  5. Halte den Shortcut. Sprich. Lass los. Text erscheint am Cursor.

Das war's. Keine Konfiguration pro App. Loqua ist systemweit auf dem Mac.

Dein erstes Code-Diktat

Öffne VS Code oder Cursor und setze deinen Cursor in eine Python-Datei, in einen Funktionskörper. Sag natürlich:

Du sagst
„add a comment saying this caches the response for fifteen minutes and on auth failure just redirect to login don't retry"
Loqua schreibt (in VS Code, Python-Datei)
# Cache response for 15 min.
# On auth failure (401): redirect to /login — do not retry.

Achte auf drei Dinge, die passiert sind: Loqua hat erkannt, dass du im Code bist (Ausgabe als Kommentar, nicht als Prosa); es hat die expliziten Werte formatiert („fifteen minutes" → „15 min"; den standardmäßigen 401-Statuscode abgeleitet); und es hat die zweite Klausel zu einer strukturierten Direktive verdichtet. Nichts davon erforderte Konfiguration — die multimodale Kontext-Engine hat die Dateiendung und den angrenzenden Code gelesen, um zu entscheiden.

Sprach-Patterns, die im Code funktionieren

Du musst keine neue Syntax lernen. Du musst lernen, welche Formulierungen die sauberste Ausgabe erzeugen. Die Patterns unten sind das, worauf wir nach Monaten täglicher Nutzung konvergiert sind.

  • Name + Format-Hinweis: sag „function name fetch user profile", um fetchUserProfile zu erhalten; „function name underscore fetch user profile" für fetch_user_profile. Die Sprachkonvention der aktiven Datei ist die Voreinstellung.
  • Typ-Spec per Beschreibung: sag „async function that takes a user id and returns a promise of user", um die vollständige Signatur zu bekommen; Loqua leitet die Typen aus dem Kontext ab.
  • Kommentar-Absicht zuerst: sag „add a comment saying X", um einen Kommentar in der Syntax der Datei zu erhalten; wenn du nur X sagst, entsteht in einer Code-Datei meist ebenfalls ein Kommentar, aber das explizite Framing vermeidet Mehrdeutigkeit.
  • Commit-Nachricht: sag, was sich geändert hat: in einem Commit-Kontext (Source-Control-Panel, Terminal git commit) erzeugt Loqua Nachrichten im konventionellen Format, ohne dass du den Präfix nennen musst.
  • PR-Beschreibung: beginne mit dem Warum: Loqua liest das PR-Template, falls vorhanden, und formt sich danach.
  • Pausiere für einen strukturellen Wechsel: eine halbe Sekunde Pause wird in Prosa als Absatzumbruch und in Code-Blöcken als logischer Schrittumbruch gelesen.

Sechs ausgearbeitete Beispiele

Jedes Beispiel unten ist echt — was wir tatsächlich gesagt haben und was Loqua geschrieben hat. Die Stimme ist deine; die Ausgabe ist Loquas:

Du sagst (in Cursor, Refactor-Anfrage)
„move the rate limiter into its own middleware file and update the imports"
Loqua schreibt (als Cursor-Prompt)
Refactor: extract the rate-limiter logic into a new middleware/rateLimit.ts module. Update imports across handlers. Preserve current behavior; no API changes.
Du sagst (nach dem Stagen der Änderungen)
„this fixes the race condition in session cleanup when two logout requests hit at the same time added a mutex on the session store also added a regression test"
Loqua schreibt (als git-Commit-Nachricht)
fix(auth): handle concurrent session cleanup race condition

Two simultaneous /logout requests could both attempt to invalidate the same token. Added mutex lock on the session store write path. Tests: auth_test.go — TestConcurrentLogout
Du sagst (im PR-Beschreibungsfeld)
„this PR adds support for partial responses on the search endpoint clients can request specific fields and get back a smaller payload covered by tests and the changelog is updated"
Loqua schreibt (in GitHub-PR)
## Summary
Adds field-selection support to the search endpoint. Clients can request a subset of fields and receive a smaller payload.

## Changes
- Search endpoint accepts a fields query param
- Response serializer respects field selection
- Tests cover selection, omission, and invalid-field handling
- CHANGELOG.md updated

## Test plan
- [ ] Unit tests pass
- [ ] Manual smoke against staging
Du sagst (im Terminal)
„use ripgrep to find all usages of the old auth client in the api folder excluding tests"
Loqua schreibt (im Terminal)
rg "OldAuthClient" api/ --glob '!**/*_test.go'
Du sagst (beim Schreiben einer SQL-Abfrage in DBeaver)
„select user id email and last login from users where last login is more than 90 days ago and account status equals active"
Loqua schreibt (in DBeaver)
SELECT user_id, email, last_login
FROM users
WHERE last_login < NOW() - INTERVAL '90 days'
  AND account_status = 'active';
Du sagst (beim Schreiben einer Regex)
„regex for matching email addresses but allowing plus signs in the local part"
Loqua schreibt (in VS Code, JavaScript-Datei)
const emailWithPlus = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;

Wie der IDE-Kontext die Ausgabe formt

Loqua weiß nicht nur, dass du in VS Code oder Cursor bist. Es kennt den Dateityp, die aktive Auswahl, den umgebenden Code und (sofern du es erlaubst) das offene Chat-Panel. Dieselbe Sprachformulierung erzeugt je nach diesen Hinweisen eine andere Ausgabe:

KontextAusgabeform
Innerhalb eines Funktionskörpers, Python-DateiCode oder Inline-Kommentar, passend zur Sprache der Datei
In einem Docstring oder Kommentar am DateianfangProsa, formatiert als Docstring
Im Commit-Nachricht-Feld der QuellcodeverwaltungConventional-Commit-Format
In einer PR-Beschreibung auf GitHubStrukturiertes PR-Template (Summary / Changes / Test plan)
Im Chat-Panel von CursorPrompt-förmige Anweisung mit Kontext
In der Terminal-Oberfläche von Claude CodeDirekte Anweisung, oft mit Dateipfaden, wenn der Kontext klar ist

Du musst Loqua nichts davon mitteilen. Es liest die aktive App und den Text um den Cursor und entscheidet. Wenn die Form falsch ist, wiederhole die Formulierung mit explizitem Framing (z.B. „add a comment saying..." oder „the commit message is...") und es passt sich an.

Für die tiefere Bildschirmkontext-Mechanik hinter der Bezeichner-Erhaltung siehe einen Listener bauen, der sieht, was du siehst.

Mehrsprachige Bezeichner und Code-Switching

Eine echte Situation, die uns begegnete: ein auf Mandarin benanntes Feature-Flag in einer Codebasis, mitten im Satz in einer englischen Commit-Nachricht diktiert. Loqua bewältigt dies ohne Modus-Wechsel — siehe unseren Leitfaden zu Sprache + KI-Coding für mehr zu EN+中-Patterns. Die Kurzfassung:

Du sagst
„add a fallback when 用户画像 service is down so the page still renders with the default state"
Loqua schreibt (in VS Code, Code-Kommentar)
// Fallback: if the 用户画像 service is down, render the page with the default state.

Fehlerbehebung

  • Bezeichner kommt falsch heraus: wiederhole die Sprachformulierung mit dem Bezeichner in normalem Englisch (z.B. „fetch user profile" statt jeden Buchstaben einzeln auszusprechen). Loquas Named Entity Recognition ist auf natürliche Äußerung trainiert, nicht auf Buchstabieren.
  • Ausgabe ist Prosa, wenn du Code wolltest: sag „add a comment saying..." oder „as code:..." als explizites Framing. Die Cursorposition disambiguiert in der Regel, aber ein Frame hilft.
  • Falsche Sprachkonvention (camelCase vs snake_case): Loqua folgt der Sprachvoreinstellung der Datei. Zum Überschreiben sag „camel case" oder „snake case" inline.
  • Sprache wird nicht erkannt: prüfe das Menüleisten-Symbol — grau bedeutet, dass die Mikrofon-Berechtigung fehlt; rot bedeutet, es hört zu; grün ist idle. Die Mikrofon-Berechtigung findest du in Systemeinstellungen → Datenschutz und Sicherheit → Mikrofon.
  • Shortcut-Konflikt: wenn Fn + Leertaste mit Spotlight oder einer anderen App kollidiert, ändere den Shortcut unter Einstellungen → Shortcut. Viele von uns nutzen Caps Lock, umbelegt über Karabiner — Caps Lock ist ansonsten verschwendete Fläche.

Was wir tatsächlich täglich nutzen

Das ist der Teil, der mehr zählt als Feature-Listen. So sieht unser täglicher Workflow aus:

  • Code-Kommentare — fast immer Sprache. Die Sprachform ist länger, erklärender, und das Team liest sie häufiger.
  • Commit-Nachrichten — Sprache mit einem schnellen Edit-Durchlauf. Der Body-Inhalt ist voller, weil die Tastenanschlag-Steuer wegfällt.
  • PR-Beschreibungen — Sprache, oft diktiert während man noch auf das Diff schaut. Die Struktur kommt richtig heraus, weil Loqua das GitHub-Template sieht.
  • Cursor- / Claude-Code-Prompts — Sprache für alles außer sehr kurzen „fix this"-Prompts. Lange Refactor-Beschreibungen sind dort, wo Sprache sich rechnet.
  • Slack- / Discord-Engineering-Threads — Sprache. Schneller, durchdachter.
  • Bezeichner und Code-Bodies — gemischt. Trivialer Code (CRUD, Glue) ist sprachfreundlich; komplexer algorithmischer Code ist meist schneller zu tippen, weil die Struktur die Arbeit ist.

Die Rechnung lautet: etwa 4-fache Geschwindigkeit beim Schreiben von Prosa-im-Code (Kommentare, Docs, Nachrichten, Prompts) und etwa Tipp-Parität beim reinen Code. Die Summe über einen Arbeitstag ist erheblich — und die kognitive Last sinkt, weil du aufhörst, zwischen Denk-Modus und Tipp-Modus zu wechseln.

Wenn du die tiefere Architektur dahinter willst, siehe unsere Notiz zum Drei-Modell-Spracheingabe-Stack. Wenn du das Pattern speziell auf KI-Coding-Tools ausweiten willst, siehe Spracheingabe für KI-Coding.

Eine letzte Anmerkung für Entwickler, die diesen Workflow evaluieren: wenn du im Web suchst, wie man Code auf dem Mac diktiert, hören die meisten Ergebnisse bei „nutze Apples eingebautes Diktat" auf. Das ist ein guter Startpunkt, aber es ist rein Audio — es kennt deine IDE, deine Bezeichner oder deine strukturellen Konventionen nicht. Loquas Anspruch ist die nächste Ebene darüber: Spracheingabe für Entwickler, die eine Ausgabe wollen, die bereits zum Ziel passt.

Häufig gestellte Fragen

Funktioniert Loqua speziell in Cursor?
Ja. Loqua behandelt Cursor als erstklassige IDE — es erkennt das Chat-Panel, den Dateikontext und den Auswahlstatus und passt die Ausgabe entsprechend an. Prompts landen im Chat-Panel; Code landet im Editor; Kommentare bleiben in der Sprache der aktiven Datei.
Kann ich Loqua mit Claude Code verwenden?
Ja. Claude Code wird als terminalbasiertes Entwicklungswerkzeug erkannt; Loqua erzeugt direkte Anweisungen und Dateipfade in einer Form, die Claude Code versteht. Für lange Refactor-Erzählungen oder Spec-Entwürfe ist Spracheingabe besonders effizient.
Was, wenn meine Variablennamen Chinesisch und Englisch mischen?
Loqua bewältigt Code-Switching mitten im Satz ohne Modus-Umschalter. Wenn du „add a check for the 用户画像 service" sagst, entsteht ein Kommentar oder Bezeichner mit dem chinesischen Begriff inline, wobei die Originalzeichen erhalten bleiben.
Wie diktiere ich Symbole wie Klammern, runde Klammern, Gleichheitszeichen?
In der Regel musst du das nicht. Loqua leitet die Struktur aus dem Kontext ab — wenn du „function name fetch user with id and return a user" sagst, entsteht die vollständige Signatur mit runden Klammern, Typen und geschweiften Klammern. Für explizite Symboleingabe (selten) sage „open paren" / „close paren" / „equals sign" usw.
Wie geht Loqua mit langen Sprachsitzungen um?
Es gibt keine Obergrenze pro Äußerung. Halte den Shortcut, sprich so lange du willst, lass los. Streaming-Ausgabe erscheint, während du sprichst — TTFT liegt unter 200ms, sodass die ersten Wörter schon erscheinen, während du noch mitten im Satz bist.
Gibt es eine Einarbeitungszeit?
Etwa eine Stunde für IDE-Arbeit. Die größte Umstellung ist zu lernen, welche Formulierungen die sauberste Ausgabe erzeugen (siehe Abschnitt Patterns oben). Danach ist es schneller als Tippen für Prosa-im-Code-Arbeit, und die IDE-Kontextwahrnehmung trifft die meisten Formatierungsentscheidungen für dich.

Probiere Loqua heute aus

Kostenlos zum Start. Mac-nativ. Gebaut von Algorithmus-Forschern, die es täglich nutzen.

Für Mac laden

Verwandte Artikel

Anleitung
Spracheingabe für KI-Coding: Cursor und Claude Code per Sprach-Prompt ohne Tippen
Produktivität
Voice-Produktivitäts-Stack: 9 Tools, die wir wirklich nutzen, um zu schreiben, zu shippen und zu denken
Anleitung
Mac-Meeting-Notizen per Sprache: von der Stimme zum Erledigt mit Notizen und Action Items
Technik
Omni-modale Spracheingabe: multimodales Verstehen, MoE und Streaming-Textausgabe