Instalacja i konfiguracja platformy

Spędziłeś lata dopracowując swoją konfigurację VS Code — skróty klawiszowe, rozszerzenia, motywy, snippety. Ostatnią rzeczą, jakiej chcesz, jest zaczynanie od zera w nowym edytorze. Dobra wiadomość: Cursor to fork VS Code. Twoja pamięć mięśniowa, rozszerzenia i ustawienia przenoszą się w około dwie minuty. Zła wiadomość: instalacja wciąż ma kilka pułapek specyficznych dla platform, które mogą zmarnować godzinę, jeśli natkniesz się na nie nieprzygotowany.

Co osiągniesz

• Cursor zainstalowany i działający na twojej platformie bez ostrzeżeń bezpieczeństwa ani problemów z uprawnieniami
• Wszystkie ustawienia, rozszerzenia i skróty klawiszowe z VS Code zaimportowane automatycznie
• Polecenie powłoki cursor działające z każdego terminala
• Zweryfikowana instalacja, gdzie czat AI odpowiada na polecenia i rozpoczęło się indeksowanie bazy kodu

Instalacja platformy

macOS

Opcja 1: Homebrew (zalecana)

brew install --cask cursor

To automatycznie obsługuje podpisywanie kodu i flagi kwarantanny.

Opcja 2: Bezpośrednie pobranie

1. Pobierz ze strony cursor.com/download
2. Otwórz plik .dmg
3. Przeciągnij Cursor do Aplikacji

Naprawianie ostrzeżeń bezpieczeństwa

Jeśli macOS pokazuje “Cursor is damaged and can’t be opened”:

xattr -cr /Applications/Cursor.app

Jeśli widzisz “Cursor cannot be opened because the developer cannot be verified”:

1. Otwórz Ustawienia systemowe, a następnie Prywatność i bezpieczeństwo
2. Przewiń do sekcji “Bezpieczeństwo” i kliknij Otwórz mimo to
3. Wprowadź hasło, gdy zostaniesz o to poproszony

Windows

Opcja 1: winget (zalecana)

winget install Anysphere.Cursor

Opcja 2: Bezpośredni instalator

1. Pobierz ze strony cursor.com/download
2. Uruchom Cursor-Setup.exe
3. Postępuj zgodnie z instrukcjami instalatora — Cursor instaluje się w %LOCALAPPDATA%\Programs\cursor

Dodawanie do PATH

Otwórz Cursor, naciśnij Ctrl+Shift+P i uruchom Install ‘cursor’ command in PATH. Następnie zrestartuj terminal.

Windows Defender

Jeśli instalacja zawiesza się lub Cursor jest wolny przy pierwszym uruchomieniu, dodaj wykluczenie:

1. Otwórz Windows Security
2. Przejdź do Virus and Threat Protection, a następnie Manage Settings
3. W sekcji Wykluczenia dodaj folder instalacji Cursor

Linux

Instalacja AppImage

# Pobierz AppImage
curl -L https://cursor.com/download/linux-x64 -o cursor.AppImage
chmod +x cursor.AppImage

# Zainstaluj libfuse2 jeśli potrzeba (wymagane dla AppImage)
# Ubuntu/Debian:
sudo apt install libfuse2
# Fedora:
sudo dnf install fuse
# Arch:
sudo pacman -S fuse2

# Przenieś do trwałej lokalizacji
sudo mv cursor.AppImage /opt/cursor.AppImage
sudo ln -s /opt/cursor.AppImage /usr/local/bin/cursor

Tworzenie wpisu na pulpicie

cat > ~/.local/share/applications/cursor.desktop << 'EOF'
[Desktop Entry]
Name=Cursor
Exec=/opt/cursor.AppImage --no-sandbox %F
Terminal=false
Type=Application
Icon=cursor
StartupWMClass=Cursor
Categories=Development;IDE;
EOF

Problemy z GPU

Jeśli widzisz glitche renderowania lub puste okno:

cursor --disable-gpu

Migracja z VS Code

Cursor może zaimportować wszystko z VS Code w jednym kroku. To najszybsza droga do poczucia się jak w domu.

1. Otwórz ustawienia Cursor

   Naciśnij Cmd+Shift+J (macOS) lub Ctrl+Shift+J (Windows/Linux).

2. Przejdź do General, a następnie Account

   Poszukaj sekcji importu z VS Code.

3. Kliknij “Import from VS Code”

   Cursor wykrywa i importuje:

   • Wszystkie zainstalowane rozszerzenia
   • Ustawienia użytkownika (settings.json)
   • Skróty klawiszowe (keybindings.json)
   • Snippety
   • Wybór motywu

4. Zrestartuj Cursor

   Import wchodzi w życie po restarcie.

Ręczny fallback migracji

Jeśli automatyczny import zawiedzie (rzadkie, ale zdarza się przy niestandardowych instalacjach VS Code):

macOS / Linux

# Kopiuj ustawienia
cp ~/.config/Code/User/settings.json ~/.config/Cursor/User/
cp ~/.config/Code/User/keybindings.json ~/.config/Cursor/User/
cp -r ~/.config/Code/User/snippets ~/.config/Cursor/User/

Windows

copy %APPDATA%\Code\User\settings.json %APPDATA%\Cursor\User\
copy %APPDATA%\Code\User\keybindings.json %APPDATA%\Cursor\User\
xcopy %APPDATA%\Code\User\snippets %APPDATA%\Cursor\User\snippets /E /I

Konfiguracja polecenia powłoki

Możliwość wpisania cursor . w dowolnym terminalu jest niezbędna dla przepływów pracy z tego przewodnika.

1. Otwórz Cursor
2. Naciśnij Cmd+Shift+P (macOS) lub Ctrl+Shift+P (Windows/Linux)
3. Wpisz Install ‘cursor’ command in PATH i wybierz to polecenie
4. Opcjonalnie uruchom także Install ‘code’ command in PATH dla zgodności z VS Code
5. Zrestartuj terminal

Zweryfikuj, że działa:

cursor --version
cursor .  # Otwiera bieżący katalog w Cursor

Uwaga

Jeśli cursor nie zostanie znaleziony po instalacji, najbardziej prawdopodobną przyczyną jest nieaktualna sesja powłoki. Zamknij i otwórz ponownie terminal. Na macOS może być konieczne ręczne dodanie /Applications/Cursor.app/Contents/Resources/app/bin do PATH.

Otwórz swój projekt i rozpocznij indeksowanie

Otwórz prawdziwy projekt — nie pusty folder. Cursor potrzebuje plików do indeksowania.

cd ~/projects/twoj-prawdziwy-projekt
cursor .

Gdy Cursor się otworzy, natychmiast rozpoczyna indeksowanie twojej bazy kodu. To tworzy osadzenia semantyczne, których AI używa do znajdowania odpowiedniego kodu, gdy zadajesz pytania lub prosisz o zmiany.

Monitorowanie indeksowania

1. Otwórz ustawienia: Cmd+Shift+J / Ctrl+Shift+J
2. Przejdź do Indexing and Docs
3. Obserwuj pasek postępu — małe projekty kończą się w mniej niż minutę, duże monorepo może zająć 10-15 minut

Notatka

Nie musisz czekać na zakończenie indeksowania przed kontynuowaniem tego przewodnika. Działa w tle, a AI staje się stopniowo lepsze, gdy więcej plików zostanie zindeksowanych.

Zweryfikuj swoją instalację

Przejdź przez tę szybką listę kontrolną, aby upewnić się, że wszystko działa przed przejściem do konfiguracji:

Sprawdź	Jak	Oczekiwany rezultat
Polecenia terminala	Otwórz terminal za pomocą Ctrl+` i wpisz node --version	v18.x lub wyższa
Integracja Git	Wpisz git status w terminalu	Pokazuje status twojego repozytorium
Czat AI	Naciśnij Cmd+I / Ctrl+I i wpisz “Hello”	AI odpowiada w panelu czatu
Eksplorator plików	Sprawdź pasek boczny	Pliki twojego projektu są widoczne
Rozszerzenia	Otwórz panel Rozszerzeń (Cmd+Shift+X)	Pojawiają się twoje rozszerzenia z VS Code

Polecenie kopiuj-wklej, aby zweryfikować, że AI działa

Otwórz panel agenta za pomocą Cmd+I i wklej to:

Jak jest zorganizowany ten projekt? Daj mi krótki przegląd głównych katalogów i ich przeznaczenia.

Jeśli otrzymasz spójną odpowiedź odnosząca się do rzeczywistych plików w twoim projekcie, twoja instalacja i indeksowanie działają.

Gdy coś się zepsuje

“Cursor is damaged” na macOS: Uruchom xattr -cr /Applications/Cursor.app i spróbuj ponownie.

Rozszerzenia nie ładują się po migracji: Wyczyść pamięć podręczną rozszerzeń w ~/.config/Cursor/CachedExtensionVSIXs (macOS/Linux) lub %APPDATA%\Cursor\CachedExtensionVSIXs (Windows) i zrestartuj.

Czat AI pokazuje “Rate limit exceeded”: Jesteś na darmowym planie i wykorzystałeś dzienną alokację. Albo poczekaj na reset, albo przejdź na Cursor Pro.

Indeksowanie utknęło na 0%: Sprawdź, czy twój projekt nie jest całkowicie w wzorcach .gitignore. Cursor respektuje .cursorignore, jeśli istnieje — upewnij się, że nie wykluczyłeś przypadkowo wszystkiego.

Polecenie cursor nie znaleziono na Linuxie: AppImage nie rejestruje automatycznie poleceń powłoki. Dowiązanie symboliczne z sekcji instalacji (ln -s /opt/cursor.AppImage /usr/local/bin/cursor) to obsługuje.

Co dalej

Podstawowa konfiguracja Włącz auto-run, skonfiguruj ustawienia prywatności i ustaw tryb Max -- trzy ustawienia, które odblokują pełny potencjał Cursor.