Rozwiązywanie problemów

Niniejszy przewodnik przedstawia procedury diagnostyczne i rozwiązania typowych problemów ze środowiskiem uruchomieniowym, integracjami oraz uprawnieniami systemowymi. Jeśli poniższe kroki nie rozwiążą problemu, wygeneruj paczkę diagnostyczną.

Środowisko kontenerowe i cykl życia sesji

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

Wymogi konfiguracyjne organizacji (requiredMinimumVersion lub requiredMaximumVersion) wykluczają stałą, przetestowaną wersję Claude Code, z której korzysta Speedwave. Skonsultuj się z administratorem w celu weryfikacji dozwolonych wersji.

Ostrzeżenie w logach: “WARNING: image has Claude Code X but the pinned version is Y”

Przerwane budowanie obrazu doprowadziło do rozbieżności wersji w kontenerze ze stanem zdefiniowanym w manifestach. Wykonaj polecenie speedwave update w terminalu lub zrestartuj projekt w aplikacji Desktop, aby przeprowadzić czystą przebudowę.

Środowisko Git worktree utworzone przez Claude jest uszkodzone na hoście

Ponieważ Speedwave montuje projekt pod ścieżką /workspace, worktree utworzone w kontenerze odwołuje się do ścieżek kontenerowych. Uruchom polecenie git worktree prune na Twoim komputerze (hoście), aby wyczyścić osierocone referencje.

Wykonanie narzędzia jest zablokowane przez polityki lokalne

Sprawdź plik .claude/settings.json w repozytorium. Claude Code bezwzględnie przestrzega zdefiniowanych reguł deny, nawet w trybie pomijania monitów o uprawnienia.

Kontener Claude kończy działanie z kodem 137 podczas pracy z subagentami

Kod błędu 137 oznacza zakończenie procesu z powodu braku pamięci (Out of Memory), gdy równoległa praca wielu subagentów przekracza przydzielony limit 6 GiB RAM. Zmniejsz liczbę równoległych agentów lub skróć kontekst rozmowy. Sprawdź w logach aplikacji Desktop wpis killing a LIVE worker, aby odróżnić restart zainicjowany przez aplikację od błędu OOM jądra systemu.

Błędy I/O lub zawieszanie budowy obrazów w środowiskach VDI lub wirtualnych

Zagnieżdżona wirtualizacja w środowiskach VDI lub hiperwizorach VMware/VirtualBox może spowalniać rozpakowywanie pakietów. Narzędzie speedwave check ostrzega o tym wcześniej. Przydziel maszynie wirtualnej więcej pamięci RAM lub upewnij się, że wirtualizacja zagnieżdżona (VT-x/AMD-V) jest aktywna w ustawieniach procesora.

Katalog projektu w OneDrive, Dropbox lub Google Drive nie otwiera się

Systemy operacyjne mogą blokować montowanie folderów synchronizowanych z chmurą. W systemie macOS nadaj uprawnienia w menu Ustawienia systemowe -> Prywatność i bezpieczeństwo -> Pliki i foldery. Zaleca się pracę w standardowych katalogach lokalnych, aby uniknąć konfliktów blokad plików.

Maszyna wirtualna Lima nie uruchamia się (macOS)

Objaw	Rozwiązanie
`limactl not found`	Zainstaluj narzędzie Lima poleceniem `brew install lima` lub pobierz z lima-vm.io. Wymagana jest wersja 0.11.0 lub nowsza z obsługą vzNAT.
Maszyna wirtualna zablokowana w stanie `Stopping`	Wykonaj w terminalu: `limactl stop --force <vm> && limactl start <vm>`.
Nie znaleziono maszyny wirtualnej	Uruchom ponownie wstępny kreator konfiguracji w aplikacji Desktop.
Wydłużony pierwszy start po aktualizacji	Zjawisko naturalne podczas pobierania i rozpakowywania archiwów środowiska wirtualnego.

”Container engine did not answer the image check”

Maszyna wirtualna nie odpowiedziała podczas weryfikacji obrazów kontenerów, przez co proces wstrzymał decyzję o ich ewentualnej przebudowie. Kliknij przycisk Retry na banerze. Jeśli komunikat pojawi się ponownie, zamknij Speedwave z zasobnika systemowego i uruchom aplikację powtórnie.

Restart projektu kończy się komunikatem “compose up did not finish within 180s”

Uruchamianie kontenerów przekroczyło limit trzech minut, więc Speedwave przerwał próbę, zapobiegając trwałemu zawieszeniu. Zrestartuj projekt w aplikacji Desktop. Jeśli problem się powtarza, wyeksportuj paczkę diagnostyczną i zgłoś błąd.

WSL2 nie uruchamia się lub nie odpowiada Windows

Zanim Speedwave cokolwiek uruchomi, sprawdza stan WSL2 poleceniem wsl --status, a w komunikacie błędu podaje przyczynę:

Komunikat	Rozwiązanie
`wsl.exe --status reports that WSL2 cannot start on this machine`	Włącz wirtualizację sprzętową w BIOS/UEFI oraz opcje systemowe „Podsystem Windows dla systemu Linux” i „Platforma maszyny wirtualnej”, a następnie zrestartuj komputer.
`WSL did not respond`	Wykonaj w terminalu polecenie `wsl --shutdown` lub zrestartuj system Windows, a następnie spróbuj ponownie.
Windows czeka na ponowne uruchomienie	Zrestartuj komputer przed wprowadzaniem jakichkolwiek zmian w funkcjach systemu Windows.
Niedokończona operacja serwisowa systemu Windows (`WinSxS\pending.xml`)	W wierszu polecenia uruchomionym jako administrator wykonaj `DISM /Online /Cleanup-Image /RestoreHealth`, a następnie `sfc /scannow`. Sam restart nie rozwiąże tego problemu.
Funkcja Virtual Machine Platform wygląda na wyłączoną	Włącz ją poleceniami `dism.exe` opisanymi w rozdziale Instalacja Speedwave.

Po aktualizacji do 0.19 czat używa innego modelu

W wersji 0.19 wybór modelu przeniesiono z Ustawień bezpośrednio do composera w czacie. Model wybrany w Ustawieniach przed aktualizacją nie jest automatycznie migrowany. Kliknij plakietkę modelu w composerze i wybierz go ponownie: od tej chwili wybór zostanie trwale zapisany dla projektu.

Instalator Windows zgłasza błąd “Error opening file for writing” Windows

Pozostałości procesów node.exe ze starszych wersji mogą blokować pliki w folderze instalacyjnym. Zamknij Speedwave z zasobnika, zakończ ewentualne procesy node.exe w Menedżerze zadań i uruchom instalator ponownie.

Łączność z integracjami

Narzędzia SharePoint zgłaszają błąd “cannot reach oauth worker”

Proces workera OAuth na Twojej maszynie mógł zmienić port po automatycznym wznowieniu, podczas gdy kontener posiada nieaktualną konfigurację. Zrestartowanie projektu z poziomu aplikacji Desktop aktualizuje parametry portu.

Uprawnienia systemowe macOS (TCC)

Baner informujący o wyłączonej integracji po aktualizacji

Pomocnicze pliki binarne korzystają z niezależnych identyfikatorów aplikacji. Kliknij przełącznik integracji i wybierz Allow, aby zakończyć jednorazową migrację.

Uprawnienia systemowe zostały wcześniej odrzucone

W przypadku kliknięcia Don’t Allow system macOS 14+ ukrywa ponowny monit. Należy zresetować bazę TCC w terminalu za pomocą narzędzia tccutil:

Integracja	Usługa TCC	Identyfikator aplikacji
Kalendarz	`Calendar`	`pl.speedwave.desktop.calendar`
Przypomnienia	`Reminders`	`pl.speedwave.desktop.reminders`
Poczta	`AppleEvents`	`pl.speedwave.desktop.mail`
Notatki	`AppleEvents`	`pl.speedwave.desktop.notes`

Wykonaj odpowiednie polecenie w terminalu, a następnie ponownie aktywuj przełącznik integracji:

Okno autoryzacji systemowej nie pojawia się

Komunikat o cichym odrzuceniu wskazuje na odrzucenie żądania przez system macOS. Zresetuj identyfikatory i zainstaluj ponownie najnowsze wydanie:

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

Poczta lub Notatki zgłaszają brak uruchomionej aplikacji macOS

Integracje te sterują natywnymi aplikacjami przez Apple Events. Jeśli program docelowy jest zamknięty, system zwraca status braku dostępności. Uruchom program pocztowy lub notatnik i ponów próbę.

Szczegółowy wykaz reguł walidacji kontenerów znajdziesz w rozdziale Silnik SecurityCheck i reguły walidacji.