---
title: "Rozwiązywanie problemów | Kalka docs"
description: "Rozwiązania problemów z ostrzeżeniami przy pierwszym uruchomieniu na macOS i Windowsie, Linuksem, aktualizacjami, portem MCP, automatycznym zapisem w przeglądarce oraz sposób zgłaszania błędów."
url: https://kalka.design/pl/docs/troubleshooting
language: pl
---

## macOS nie chce otworzyć Kalki

Wersje beta nie są jeszcze podpisane certyfikatem Apple Developer, więc macOS blokuje pierwsze uruchomienie.

- Otwórz Kalkę raz i pozwól macOS jej odmówić.

- Otwórz **Ustawienia systemowe › Prywatność i ochrona**.

- Przewiń w dół do komunikatu o Kalce i kliknij **Otwórz mimo to**.

- Potwierdź hasłem lub Touch ID. Kalka się otworzy, a macOS nie zapyta ponownie dla tej wersji.

**„Aplikacja Kalka jest uszkodzona i nie można jej otworzyć”?** Pobrany plik trafił do kwarantanny; Kalka nie jest uszkodzona.

Usuń znacznik kwarantanny w Terminalu, a potem otwórz ją ponownie:

```
xattr -dr com.apple.quarantine /Applications/Kalka.app
```

## Windows SmartScreen blokuje instalator

SmartScreen ostrzega przed instalatorami, których rzadko widział, a wersje beta nie są jeszcze podpisane. W niebieskim oknie „System Windows ochronił ten komputer” kliknij **Więcej informacji**, a potem **Uruchom mimo to**.

## Linux

Kalka jest dostępna jako AppImage. Jeśli nie uruchamia się po dwukrotnym kliknięciu, najpierw nadaj jej prawo wykonywania:

```
chmod +x Kalka-*.AppImage
```

Na Windowsie i Linuksie menu Kalki jest wewnątrz okna, a nie na systemowym pasku menu.

## Aktualizacje nie instalują się na macOS

Niepodpisana Kalka nie może sama się zastąpić na macOS. Okno **Uaktualnienie oprogramowania** o tym informuje i proponuje **Pobierz**: zainstaluj nowy plik `.dmg` w miejsce starej Kalki w folderze Programy. Twoje dokumenty i ustawienia zostają.

## Agenci nie mogą połączyć się z Kalką

Serwer MCP działa wewnątrz aplikacji na komputer, na porcie 7600. Żeby agenci mogli się z nim połączyć, Kalka musi być otwarta.

- **„Port 7600 jest używany przez inny program”** w **Ustawienia › MCP**: port zajmuje inny program, często pozostawiony serwer deweloperski Kalki albo druga kopia Kalki. Zamknij go, a potem uruchom serwer ponownie w Ustawieniach.

- **„Serwer MCP nie odpowiedział na czas”** albo **„jest nieosiągalny”**: sprawdź, czy Kalka jest otwarta, a potem uruchom agenta ponownie, żeby połączył się jeszcze raz.

- **„Serwer MCP odrzucił połączenie lokalne”**: uruchom Kalkę ponownie; wystawi nowy lokalny token.

Jak podłączyć każdego agenta, opisuje strona [MCP i ACP](https://kalka.design/pl/docs/mcp).

## Automatyczny zapis prosi o zgodę w przeglądarce

W Chrome i Edge strona internetowa może zapisać plik na dysku tylko za twoją zgodą. Gdy włączasz automatyczny zapis dla pliku otwartego z dysku, przeglądarka zapyta raz. Jeśli odmówisz, Kalka nie będzie mogła zapisywać automatycznie i powie ci o tym. Przeglądarki bez dostępu do plików, takie jak Safari i Firefox, przy każdym zapisie pobierają kopię.

## Wersje nie działają

Panel Historia wymaga aplikacji na komputer, dokumentu zapisanego na twoim komputerze i zainstalowanego Gita. Na macOS zainstaluj Gita poleceniem `xcode-select --install`; na Windowsie ze strony [git-scm.com](https://git-scm.com). Żeby publikować wersje online, twój komputer musi już móc wysyłać zmiany do tego repozytorium przez Gita.

## Za dużo ruchu

W **Ustawienia › Ogólne**, w sekcji Wygląd, opcja **Animacje** może podążać za systemowym ustawieniem ograniczenia ruchu albo wyłączyć animacje. **Ogranicz animacje agentów** pokazuje nowe warstwy agenta od razu, zamiast pozwalać im pojawiać się blok po bloku.

_Ustawienia, karta Ogólne: język, motyw, animacje, Ogranicz animacje agentów, twoje imię i odzyskiwanie po awarii_

Ustawienia › Ogólne, z opcjami Animacje, Ogranicz animacje agentów i odzyskiwaniem po awarii.

## Odzyskiwanie utraconej pracy

Jeśli Kalka zamknęła się przed zapisem, otwórz ją ponownie: zaproponuje przywrócenie niezapisanych dokumentów. Zobacz [Pliki i wersje](https://kalka.design/pl/docs/files-versions).

## Zgłaszanie błędu

Otwórz zgłoszenie na [github.com/leyscore/kalka/issues](https://github.com/leyscore/kalka/issues). Jeśli Kalka nie może się uruchomić, jej ekran błędu ma link **Report a problem**, który otwiera zgłoszenie z już wpisaną wersją i systemem. Opisz swoje kroki, oczekiwany wynik i to, co się stało; plik lub zrzut ekranu bardzo pomaga.
