Rozwiązywanie problemów

Znajdź na liście swój objaw i sięgnij po pasujące rozwiązanie. Jeśli to nie pomoże, pobierz ZIP z diagnostyką.

Sesje i kontenery

Czat kończy się od razu komunikatem “session ended unexpectedly”

Wartości requiredMinimumVersion/requiredMaximumVersion ustawione w twojej organizacji wykluczają przypiętą wersję Claude Code, na której działa Speedwave. Dowiedz się u administratora, które wersje są dozwolone.

W logach pojawia się “WARNING: image has Claude Code X but the pinned version is Y”

Przerwana przebudowa sprawiła, że obraz claude rozjechał się z oczekiwaną wersją. Uruchom speedwave update albo zrestartuj projekt z poziomu Desktop.

Worktree założony przez Claude wygląda na hoście na uszkodzony

Kontener montuje twój projekt pod /workspace, więc worktree, który Claude zakłada w środku, zapisuje ścieżki nieistniejące na hoście. Uruchom tam git worktree prune.

Wywołanie narzędzia jest zablokowane i to nie wina Speedwave

Sprawdź .claude/settings.json, zanim zrzucisz winę na Speedwave. Claude Code egzekwuje swoje reguły deny nawet w trybie bypass-permissions.

Kontener claude kończy pracę z kodem 137 przy uruchomieniach wieloagentowych

Kod 137 zwykle oznacza, że proces został ubity z braku pamięci (OOM): przy szerokim rozgałęzieniu agentów łatwo przekroczyć stały budżet 6 GiB. Uruchamiaj mniej agentów naraz albo skróć rozmowę. Najpierw sprawdź w logu Desktop wiersz killing a LIVE worker: jeśli tam jest, to restart procesu po stronie hosta, a nie ubicie przez OOM.

Przebudowa obrazu zawiesza się albo kończy błędami I/O w firmowym VDI albo maszynie wirtualnej VMware/VirtualBox

Zagnieżdżona wirtualizacja potrafi zatrzymać rozpakowywanie pakietów w trakcie przebudowy. speedwave check ostrzega o tym z wyprzedzeniem, a nieudana przebudowa ponawia próbę. Jeśli to nie pomaga, dodaj maszynie wirtualnej więcej pamięci RAM albo włącz zagnieżdżone VT-x w hiperwizorze hosta.

Katalog projektu wewnątrz OneDrive, Dropbox lub Google Drive nie chce się otworzyć

macOS potrafi blokować dostęp do folderów synchronizowanych z chmurą. Kiedy zobaczysz komunikat Cloud storage permission required, otwórz System Settings > Privacy & Security > Files and Folders, włącz Speedwave i kliknij Retry. Postaw na katalog lokalny: ciągłe zmiany wnoszone przez synchronizację z chmurą mogą uszkodzić montowanie workspace.

Maszyna Lima nie chce wystartować (macOS)

Objaw	Rozwiązanie
`limactl not found`	Zainstaluj z lima-vm.io albo poleceniem `brew install lima`. Speedwave wymaga wersji 0.11.0 lub nowszej, ze względu na vzNAT i gvproxy.
Utknęło w stanie `Stopping`	`limactl stop --force <vm> && limactl start <vm>`
Nie znaleziono maszyny wirtualnej	Uruchom ponownie kreatora konfiguracji w Speedwave.app.
Wolny pierwszy start po aktualizacji Lima	To normalne: trwa pobieranie archiwum z narzędziami kontenerowymi.

Speedwave.exe nie chce się ponownie zainstalować, albo zgłasza “Error opening file for writing” Windows

Osierocone procesy node.exe potrafią blokować instalator w wersji 0.11 i starszych (od 0.12 same po sobie sprzątają). Zamknij Speedwave z zasobnika systemowego, zakończ pozostałe procesy node.exe w Menedżerze zadań i zainstaluj program ponownie.

Łączność integracji

Narzędzia SharePoint zawodzą z komunikatem “cannot reach oauth worker”

Worker oauth po stronie hosta zmienił port loopback, często po restarcie wymuszonym przez watchdoga, a kontener SharePoint nadal celuje w stary. Zrestartuj projekt z poziomu Desktop, żeby to naprawić.

Uprawnienia integracji systemowych (macOS TCC)

Integracja jest wyłączona z banerem po aktualizacji

Każdy pomocnik ma teraz osobny identyfikator, więc zgoda udzielona wcześniej przestała obowiązywać. Kliknij przełącznik raz i wybierz Allow: to jednorazowa migracja.

Uprawnienie zostało wcześniej odrzucone

Gdy raz klikniesz Don’t Allow, macOS 14 usuwa przycisk do ręcznego przywrócenia uprawnienia. Przełącznik wyświetli ci w zamian polecenie tccutil reset.

Integracja	Usługa TCC	Identyfikator
Calendar	`Calendar`	`pl.speedwave.desktop.calendar`
Reminders	`Reminders`	`pl.speedwave.desktop.reminders`
Mail	`AppleEvents`	`pl.speedwave.desktop.mail`
Notes	`AppleEvents`	`pl.speedwave.desktop.notes`

Uruchom pokazane polecenie, a potem kliknij przełącznik ponownie i wybierz Allow.

Okno zgody nigdy się nie pojawia

Komunikat “silently rejected” oznacza, że macOS odrzucił żądanie bez okna, zwykle przez uszkodzoną instalację. Usuń wpisy TCC wymienione niżej, zainstaluj program ponownie z GitHub Releases, a potem spróbuj ponownie:

tccutil reset Calendar calendar-cli
tccutil reset Reminders reminders-cli
tccutil reset Calendar pl.speedwave.desktop.calendar
tccutil reset Reminders pl.speedwave.desktop.reminders

Mail lub Notes zgłasza, że aplikacja nie jest uruchomiona macOS

Mail i Notes sterują aplikacją hosta przez Apple Events, więc gdy nie jest ona otwarta, macOS zgłasza “not found” zamiast błędu uprawnień. Otwórz ją i kliknij przełącznik ponownie.

Jeśli żaden z tych przypadków nie pasuje do tego, co widzisz, zajrzyj też do SecurityCheck.