Przejdź do głównej zawartości

Sterowanie głosem w pracy z agentami

Sterowanie głosem w pracy z agentami polega na mówieniu promptów zamiast ich wpisywania. Claude Code zamienia mowę na tekst promptu poleceniem /voice (wymagane logowanie claude.ai), Codex CLI prowadzi rozmowę głosową, GitHub Copilot CLI przełącza dyktowanie skrótem Ctrl+Space, a dyktowanie systemowe obsłuży każde inne narzędzie. Transkrypcję i tak trzeba sprawdzić, zanim stanie się decyzją.

Ta strona jest dla programisty, który więcej czasu spędza na tłumaczeniu agentowi, o co chodzi, niż na przeglądaniu jego kodu, oraz dla tech leada, który musi zdecydować, czy mikrofony wchodzą do konfiguracji zespołu. Siedzisz od 40 minut w sesji /grill-with-docs o rozliczaniu za stanowisko. Pytanie 17 brzmi: co się dzieje ze stanowiskiem usuniętym w połowie okresu rozliczeniowego? Uczciwa odpowiedź ma trzy warunki i jeden wyjątek. Wpisujesz „proporcjonalnie”. Agent uzupełnia resztę własną rekomendacją. Trzy dni później logika zwrotów jest błędna dokładnie w tym miejscu, które wyjaśniłbyś, gdyby pisanie było tańsze.

  • Tabelę decyzyjną opcji głosowych dla każdego agenta i tego, co każda z nich wysyła i dokąd.
  • Działającą konfigurację Claude Code: /voice tap, trwałe ustawienie, właściwy język dyktowania i przemapowany klawisz.
  • Pełny workflow na poziomie frameworka: odpowiadasz na wywiad grill-me głosem, a potem zamieniasz te odpowiedzi w odczyt kontrolny, kryteria akceptacji i czerwone testy, które sprawdzisz bez odsłuchiwania nagrania.
  • Trzy prompty do skopiowania, dzięki którym agent radzi sobie z błędami transkrypcji zamiast zgadywać.
  • Checklistę dla zespołu, pułapki i typowe awarie wraz z naprawą.

Zacznij od agenta, którego już używasz. Wbudowane opcje różnią się rodzajem: Claude Code i Copilot CLI zamieniają mowę na tekst promptu, a Codex CLI prowadzi rozmowę głosową.

AgentWbudowany głosCo robiWymagaSprawdzone w
Claude Code (CLI, agent view, rozszerzenie VS Code)/voice, /voice hold, /voice tap, /voice offTranskrypcja na żywo do promptu; mowę i pisanie można mieszaćlogowanie claude.ai, lokalny mikrofon, WSLg przy pracy w WSLdokumentacja dyktowania Claude Code, 2026-09-26
Codex CLI/voice, /voice settings, /voice mute, /voice stop, F8Rozmowa głosowa; Codex słucha i odpowiada na głosmacOS, kompilacja Windows oparta na MSVC albo Linuksa oparta na glibcplik wykonywalny codex-cli 0.157.1 i informacje o wydaniach 0.155.0 oraz 0.156.0
GitHub Copilot CLICtrl+Space, /voice devicesPrzełącza dyktowanie; /voice devices wybiera i zapamiętuje mikrofonśrodowisko głosowe, które CLI samo pobierachangelog github/copilot-cli 1.0.71 i 1.0.81
CursorGłos w Agencie (tylko źródła wtórne, zob. zakładka Cursor)Mowa do promptu Agentaniesprawdzone na potrzeby tej stronyniesprawdzone: cursor.com niedostępny 2026-09-26
Aider/voice, potem EnterNagrywa, transkrybuje i wysyła; dojrzały, ale wydania zwalniają (ostatnie na PyPI 2026-02-12)opcjonalne zależności głosowe Aiderausage/voice.md w repozytorium Aidera i PyPI aider-chat, 2026-09-26
Dowolne narzędzieDyktowanie w macOS, pisanie głosowe w Windows (Win+H)Wpisuje tekst w aktywne oknowsparcie systemudostawca systemu

Każda wbudowana opcja z tabeli przesyła dźwięk do dostawcy. Dokumentacja Claude Code mówi: „Audio is not processed locally”. Changelog Copilot CLI nie mówi, gdzie działa transkrypcja, więc dopóki tego nie potwierdzisz, zakładaj chmurę.

Popularność na 2026-09-26: żaden dostawca nie publikuje liczb użycia funkcji głosowych, a liczby instalacji nie ma, bo funkcja jest częścią samego agenta (dossier narzędzi agentowych tej strony nie znalazło żadnej publicznej metryki). Datować da się za to wydania: changelog Claude Code wymienia 20 języków dyktowania od wersji 2.1.69 (opublikowanej w npm 2026-03-04), Copilot CLI dodał dyktowanie pod Ctrl+Space w 1.0.81 (2026-08-27), a Codex 0.156.0 (2026-09-22) włączył rozmowy głosowe domyślnie.

Tryb tap pasuje do długich odpowiedzi: stukasz raz, mówisz tyle, ile trzeba, i stukasz ponownie, żeby wysłać. W przeciwieństwie do trybu hold nie potrzebuje rozgrzewki opartej na powtarzaniu klawisza, która zawodzi w terminalach z wyłączonym powtarzaniem.

  1. Sprawdź, czy jesteś zalogowany kontem claude.ai. Uruchom /status w Claude Code. Jeśli metodą logowania jest klucz API, Bedrock, Agent Platform w Google Cloud albo Microsoft Foundry, dyktowanie jest niedostępne; uruchom /login i zaloguj się przez claude.ai.

  2. Włącz dyktowanie w trybie tap:

    /voice tap

    Po włączeniu Claude Code sprawdza mikrofon. Na macOS pierwsze uruchomienie wywołuje systemowe pytanie o uprawnienie dla aplikacji terminala.

  3. Przy pustym prompcie stuknij Space. W stopce pojawi się ● REC · tap to send. Mów, a potem stuknij Space jeszcze raz. Claude Code wstawia transkrypcję i wysyła ją, jeśli ma co najmniej trzy słowa, więc przypadkowe stuknięcie nigdy nie wyśle pojedynczego słowa. Nagrywanie kończy się też po 15 sekundach ciszy albo po dwóch minutach łącznie. Esc lub Ctrl+C odrzuca nagranie i przywraca poprzednią treść promptu.

  4. Żeby dyktować po polsku (albo w innym z 20 obsługiwanych języków), ustaw language w /config lub w ~/.claude/settings.json. To samo ustawienie sprawia, że Claude odpowiada i nazywa sesje w tym języku:

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

    /voice zapisuje obiekt voice za ciebie i ustawienie przetrwa między sesjami. W trybie hold dodaj "autoSubmit": true, żeby wysyłać po puszczeniu klawisza; bez tego naciskasz Enter sam.

  5. Opcjonalnie: zabierz dyktowanie ze Space. Przypisz akcję voice:pushToTalk do innego klawisza w ~/.claude/keybindings.json; nowy klawisz zastępuje Space (linia "space": null tylko to jawnie zapisuje). Kombinacja z modyfikatorem, np. meta+k, zaczyna nagrywanie od pierwszego naciśnięcia w obu trybach, bez rozgrzewki:

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

W trakcie mówienia słowa pojawiają się w prompcie przygaszone, a po sfinalizowaniu transkrypcji stają się pełne. Claude Code podaje nazwę projektu i gałęzi git jako podpowiedzi dla rozpoznawania mowy i jest dostrojony do terminów takich jak OAuth, JSON czy localhost. Nazw twoich tabel i funkcji na tej liście nie ma i dlatego workflow poniżej je sprawdza.

Według dokumentacji Claude Code transkrypcja nie zużywa wiadomości ani tokenów Claude’a i nie wlicza się do limitów w /usage. Koszt kontekstu jest taki sam jak dla wpisanego promptu tej samej długości, a dwuminutowa odpowiedź na głos potrafi dodać kilkaset słów.

Głos w Codeksie, Cursorze, Copilot CLI i innych narzędziach

Dział zatytułowany „Głos w Codeksie, Cursorze, Copilot CLI i innych narzędziach”

Użyj konfiguracji z sekcji wyżej. Dyktowanie działa też w agent view: przytrzymaj lub stuknij klawisz push-to-talk, gdy aktywne jest pole dispatch albo odpowiedź w panelu podglądu, i dyktujesz do sesji w tle. Rozszerzenie VS Code obsługuje dyktowanie z tym samym wymogiem konta claude.ai, ale nie w sesjach VS Code Remote (SSH, Dev Containers, Codespaces), bo mikrofon jest na twojej maszynie, a rozszerzenie działa na zdalnym hoście.

Dyktuj odpowiedzi w sesji grill-me: workflow krok po kroku

Dział zatytułowany „Dyktuj odpowiedzi w sesji grill-me: workflow krok po kroku”

Sesja /grill-me albo /grill-with-docs najlepiej pasuje do głosu, bo agent zadaje rundę ponumerowanych pytań, każde z rekomendowaną odpowiedzią, i czeka na twoje odpowiedzi. Twoim zadaniem jest każdą rekomendację przyjąć, odrzucić albo doprecyzować, a właśnie doprecyzowanie ludzie pomijają, kiedy muszą je wpisać. Ryzyko polega na tym, że specyfikacją staje się transkrypcja, a nie twoja intencja. Ten workflow zostawia pisanie tam, gdzie liczy się dokładność, i wstawia kontrolę między mowę a kod.

grill-with-docs jest częścią pakietu mattpocock/skills Matta Pococka. Zainstaluj go raz, przez plugin albo przez CLI skills, nie na oba sposoby: README pakietu ostrzega, że wtedy każdy skill pojawia się dwukrotnie. Sposób wywołania zależy od narzędzia.

Okno terminala
# terminal: oficjalny marketplace, niczego nie trzeba dodawać wcześniej
claude plugin install mattpocock-skills

Skille z pluginów mają przestrzeń nazw, więc wywiad zaczynasz poleceniem /mattpocock-skills:grill-with-docs. Najpierw, raz na repozytorium, uruchom /mattpocock-skills:setup-matt-pocock-skills; zapyta, gdzie trzymać słownik i ADR-y. Plugin (1.2.3, 25 skilli) dodaje około 1600 tokenów stale ładowanych opisów skilli według pomiaru z dossier frameworków tej strony z 2026-09-26; u siebie sprawdzisz to przez /context.

  1. Zacznij sesję na klawiaturze. Wpisz polecenie swojego narzędzia z zakładek wyżej, spację, a potem wklej pierwszy prompt z ramki poniżej. Polecenia, ścieżki i identyfikatory szybciej i bezpieczniej się wpisuje, niż mówi.

  2. Na każde pytanie odpowiadaj głosem. W Claude Code z /voice tap: stuknij, mów, stuknij. Agent zadaje ponumerowaną rundę pytań, więc każdą odpowiedź zaczynaj od numeru pytania, a potem trzymaj się tych samych czterech części: decyzja, powód, ograniczenie i to, co zmieniłoby twoje zdanie. „P3: proporcjonalnie do dnia, bo finanse uzgadniają rozliczenia codziennie, z wyjątkiem planów rocznych, które zachowują stanowisko do odnowienia; zmieniłbym to, gdyby Stripe nie obsługiwał dziennych korekt”.

  3. Identyfikatory wpisuj. W trybie tap drugie stuknięcie wysyła odpowiedź, więc nie da się w nim zrobić pauzy na pisanie. Gdy odpowiedź musi zawierać nazwę tabeli, kolumny, funkcji albo flagi, przełącz się na /voice hold (bez autoSubmit): przytrzymaj Space i mów, puść, wpisz nazwę, przytrzymaj ponownie, żeby mówić dalej, i naciśnij Enter, gdy odpowiedź jest gotowa. Claude Code wstawia każdą transkrypcję w miejscu kursora, więc mowa i pisanie mieszają się w jednym prompcie.

  4. Zanim cokolwiek zostanie zapisane, poproś o odczyt kontrolny. Na koniec wywiadu użyj drugiego promptu poniżej. Agent wypisze każdą decyzję razem z twoimi dosłownymi słowami i oznaczy to, co wygląda na źle usłyszane. Czytasz tę listę, a nie transkrypcję.

  5. Zamień decyzje na coś, co sprawdza maszyna. Trzecim promptem wygeneruj kryteria akceptacji i czerwone testy. W /grill-with-docs ustalone pojęcia trafiają do GLOSSARY.md, a twarde decyzje do ADR-ów; przejrzyj te zmiany przez git diff, bo przetrwają dłużej niż rozmowa. Repozytoria skonfigurowane starszą wersją skilli mogą mieć jeszcze CONTEXT.md, czyli nazwę, której skille używały przed przejściem na GLOSSARY.md (README mattpocock/skills, sprawdzone 2026-09-26); zmień jej nazwę poleceniem git mv.

  6. Zatwierdzasz artefakty, nie nagranie. Akceptujesz odczyt kontrolny, kryteria akceptacji i czerwone testy. Dalej budowa idzie jak każda zmiana prowadzona specyfikacją: dowodem są testy, które przechodzą na zielono, i nikt nie odtwarza tego, co powiedziałeś.

Skąd wiesz, że agent usłyszał to, co miałeś na myśli?

Dział zatytułowany „Skąd wiesz, że agent usłyszał to, co miałeś na myśli?”

Nie sprawdzasz transkrypcji słowo po słowie. Sprawdzasz trzy artefakty, przez które źle usłyszane słowo się nie prześlizgnie:

  • Listę z odczytu kontrolnego. Każda decyzja w jednym zdaniu obok twoich zacytowanych słów. Zły cytat to błąd transkrypcji; dobry cytat ze złą decyzją to nieporozumienie. Jedno i drugie wychodzi tutaj, zanim powstanie jakikolwiek kod.
  • Kryteria akceptacji i czerwone testy. Źle usłyszane „roczny” zamienione na „równy” staje się linią Given/When/Then, którą czytasz w kilka sekund, a test, który pada z podanego powodu, dowodzi, że kryterium da się wykonać.
  • Zmiany w GLOSSARY.md i ADR-ach z /grill-with-docs. Pojęcia w słowniku muszą odpowiadać nazwom w kodzie. Pojęcie, którego nie ma nigdzie w repozytorium, to prawie zawsze artefakt transkrypcji.

Programista, który prowadził wywiad, zatwierdza odczyt kontrolny i czerwone testy. W zespole recenzent pull requesta czyta kryteria akceptacji i ADR-y, a nie zapis rozmowy.

Dla tech leada pytania dotyczą przetwarzania danych i tego, gdzie to działa, a nie tego, czy ludziom się podoba.

Do sprawdzeniaDlaczego to ważneCo zrobić
Dokąd trafia dźwięk?Claude Code przesyła dźwięk do Anthropic do transkrypcji; głos w Codeksie to rozmowa na żywo z usługą OpenAITraktuj mowę jak tekst promptu w ramach polityki danych dla AI; przeczytaj stronę Claude Code o wykorzystaniu danych
Jak loguje się zespół?Dyktowanie w Claude Code wymaga logowania claude.ai; konfiguracje z kluczem API, Bedrockiem, Agent Platform i Foundry go nie użyjąJeśli standardem jest dostawca chmurowy, zaplanuj dyktowanie systemowe
Gdzie ludzie pracują?Brak dyktowania przez SSH, w sesjach w chmurze oraz w VS Code Remote, Dev Containers i CodespacesW środowiskach zdalnych używaj dyktowania systemowego na lokalnej maszynie
Czy da się to wyłączyć?Polityka administratora może wyłączyć dyktowanie w Claude Code; użytkownicy widzą wtedy Voice mode is disabled by your organization's policyZdecyduj przed wdrożeniem, a nie po pierwszej skardze
Wspólne biuraMówione prompty zawierają nazwy klientów i szczegóły incydentówSłuchawki i push-to-talk (tryb hold) w open space
ObjawPrzyczynaNaprawa
Voice mode requires a Claude.ai accountLogowanie kluczem API albo przez zewnętrznego dostawcę/login przez claude.ai albo dyktowanie systemowe
Przytrzymanie Space wpisuje spacje i nic się nie nagrywaDyktowanie jest wyłączone albo terminal nie wysyła powtórzeń klawisza/voice hold, żeby je włączyć; jeśli pojawią się jedna czy dwie spacje i koniec, przejdź na /voice tap
Stuknięcie Space w trybie tap wpisuje spacjęPierwsze stuknięcie nagrywa tylko przy pustym prompcieWyczyść prompt albo przypisz meta+k
Microphone access is deniedAplikacja terminala nie ma uprawnień do mikrofonumacOS: Ustawienia systemowe › Prywatność i ochrona › Mikrofon; Windows: zezwól aplikacjom desktopowym na dostęp do mikrofonu; uruchom /voice ponownie
Terminala brak na liście mikrofonu w macOSNieaktualny stan uprawnieńtccutil reset Microphone com.apple.Terminal (albo bundle ID twojego terminala), potem zamknij terminal (Cmd+Q) i uruchom go ponownie
Voice mode requires SoX for audio recording na LinuksieNatywny moduł audio się nie załadował, a zapasowego nagrywania brakZainstaluj SoX poleceniem podanym w komunikacie
could not find a working audio recorder in WSLSoX nie ma backendu PulseAudiosudo apt install sox libsox-fmt-pulse
Voice input is failing repeatedly and has been pausedTrzy błędy w ciągu 10 sekund, zwykle brak urządzenia nagrywającego (serwer bez monitora, zdalna powłoka)Napraw urządzenie, odczekaj 10 sekund, spróbuj ponownie
Voice stream error: WebSocket upgrade rejected with HTTP 4xxNieaktualne logowanie albo proxy lub usługa anty-botowa odpowiada zamiast serwera/login; sprawdź VPN albo proxy na trasie
Zniekształcony tekst albo zły językDomyślnym językiem dyktowania jest angielskiNajpierw ustaw language w /config
/voice w Codeksie się nie uruchamiaBrak rozpoczętej rozmowy, rozmowa poboczna albo nieobsługiwana kompilacjaWyślij pierwszą wiadomość albo wróć do głównego wątku. Nieobsługiwana kompilacja: codex-cli 0.157.1 z npm na Linuksie x64 jest skompilowany z musl (zobacz zakładkę Codex)

Gdy źle usłyszana odpowiedź już dotarła do agenta, nie spieraj się z transkrypcją w kolejnej turze. W Claude Code naciśnij dwa razy Esc przy pustym prompcie, żeby otworzyć menu cofania i przywrócić rozmowę sprzed tej odpowiedzi, albo wpisz poprawkę wprost („Correction to decision 4: the column is seat_count, not seed count”) i poproś o odczyt kontrolny jeszcze raz.

Najczęstsze pytania

Jak dyktować prompty w Claude Code?

Włącz dyktowanie poleceniem /voice i przytrzymaj spację, mówiąc, albo uruchom /voice tap: jedno stuknięcie spacji zaczyna nagrywanie, drugie wysyła. Potrzebujesz logowania kontem claude.ai i lokalnego mikrofonu; dyktowanie nie działa z kluczem API, Bedrockiem, Agent Platform w Google Cloud, Microsoft Foundry, przez SSH ani w sesjach w chmurze.

Czy mogę dyktować do Claude Code po polsku?

Tak. Dyktowanie obsługuje 20 języków, w tym polski. Korzysta z ustawienia language, które decyduje też o języku odpowiedzi Claude'a, więc ustawienie polskiego zmienia jedno i drugie.

Czy Codex CLI ma dyktowanie głosowe?

Nie jako dyktowanie do promptu. W codex-cli 0.157.1 polecenie /voice w TUI uruchamia rozmowę głosową, a nie dyktowanie do promptu; flaga in_app_dictation jest włączona, ale codex-cli 0.157.1 nie udostępnia w TUI polecenia dla tej flagi (sprawdzone 2026-09-26). /voice włącza i wyłącza rozmowę, /voice settings wybiera głos, a F8 działa jak przełącznik. Wymaga macOS, kompilacji Windows opartej na MSVC albo kompilacji Linuksa opartej na glibc.

Czy dyktowanie kosztuje tokeny?

W Claude Code nie: dokumentacja mówi, że transkrypcja nie zużywa wiadomości ani tokenów Claude'a i nie wlicza się do limitów w /usage. Prompt powstały z transkrypcji kosztuje tyle samo co wpisany ręcznie.