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:
- Lade Loqua von der Startseite herunter und ziehe es in
/Applications. - 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.)
- Öffne die Einstellungen von Loqua und bestätige deinen Push-to-Talk-Shortcut. Standard ist
Fn + Leertaste. Wir nutzenCaps Lock, umbelegt über Karabiner-Elements, weil es erreichbar ist, ohne die Home-Row zu verlassen. - Öffne einen beliebigen Texteditor — TextEdit, VS Code, Cursor, Notizen — und setze den Cursor in ein Textfeld.
- 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:
# 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", umfetchUserProfilezu erhalten; „function name underscorefetch user profile" fürfetch_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:
middleware/rateLimit.ts module. Update imports across handlers. Preserve current behavior; no API changes.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
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
rg "OldAuthClient" api/ --glob '!**/*_test.go'SELECT user_id, email, last_loginFROM usersWHERE last_login < NOW() - INTERVAL '90 days' AND account_status = 'active';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:
| Kontext | Ausgabeform |
|---|---|
| Innerhalb eines Funktionskörpers, Python-Datei | Code oder Inline-Kommentar, passend zur Sprache der Datei |
| In einem Docstring oder Kommentar am Dateianfang | Prosa, formatiert als Docstring |
| Im Commit-Nachricht-Feld der Quellcodeverwaltung | Conventional-Commit-Format |
| In einer PR-Beschreibung auf GitHub | Strukturiertes PR-Template (Summary / Changes / Test plan) |
| Im Chat-Panel von Cursor | Prompt-förmige Anweisung mit Kontext |
| In der Terminal-Oberfläche von Claude Code | Direkte 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:
// 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 + Leertastemit Spotlight oder einer anderen App kollidiert, ändere den Shortcut unter Einstellungen → Shortcut. Viele von uns nutzenCaps 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
Probiere Loqua heute aus
Kostenlos zum Start. Mac-nativ. Gebaut von Algorithmus-Forschern, die es täglich nutzen.
Für Mac laden