# 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ą](/pl/docs/guides/logs-and-diagnostics/).

## 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](https://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_.
**Caution:** Mail i Notes korzystają z usługi TCC `AppleEvents`, a nie z `Mail` czy `Notes`: TCC prowadzi Apple Events pod jedną nazwą usługi dla danej pary nadawca-cel, więc `tccutil reset Mail` zeruje niewłaściwy wpis.

### 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](https://github.com/speednet-software/speedwave/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](/pl/docs/security/securitycheck/).