Instalacja i konfiguracja

Ten przewodnik zainstaluje i skonfiguruje Cursor z twoimi preferencjami w zaledwie 10 minut. Pokryjemy instalację specyficzną dla platformy, migrację VS Code i podstawowe ustawienia pierwszego uruchomienia.

Szybka instalacja według platformy

macOS

Opcja 1: Bezpośrednie pobieranie (zalecane)

# Pobierz z cursor.com
curl -L https://cursor.com/download/mac -o cursor.dmg

# Zamontuj i zainstaluj
hdiutil attach cursor.dmg
cp -R /Volumes/Cursor/Cursor.app /Applications/
hdiutil detach /Volumes/Cursor

Opcja 2: Homebrew

brew install --cask cursor

Bezpieczeństwo pierwszego uruchomienia

Gdy pierwszy raz otwierasz Cursor, macOS może pokazać prompt bezpieczeństwa:

1. Otwórz Ustawienia systemu → Prywatność i bezpieczeństwo
2. Kliknij “Otwórz mimo to” obok wiadomości Cursor
3. Wprowadź hasło gdy zostaniesz poproszony

Windows

Opcja 1: Bezpośredni instalator

1. Pobierz z cursor.com/download/win
2. Uruchom Cursor-Setup.exe
3. Podążaj za kreatorem instalacji
4. Cursor instaluje się do %APPDATA%\Local\Programs\cursor

Opcja 2: Menedżer pakietów

# Używając winget
winget install Anysphere.Cursor

# Lub używając Chocolatey
choco install cursor

Dodaj do PATH (opcjonalne)

Aby używać komendy cursor w terminalu:

1. Otwórz Cursor
2. Naciśnij Ctrl+Shift+P
3. Uruchom: “Install ‘cursor’ command in PATH”

Linux

Instalacja AppImage

# Pobierz odpowiednią wersję
curl -L https://cursor.com/download/linux-x64 -o cursor.AppImage

# Uczyń wykonywalnym
chmod +x cursor.AppImage

# Zainstaluj libfuse2 jeśli potrzeba (Ubuntu/Debian)
sudo apt install libfuse2

# Uruchom bezpośrednio lub zainstaluj systemowo
./cursor.AppImage

# Opcjonalnie: Instalacja systemowa
sudo mv cursor.AppImage /opt/
sudo ln -s /opt/cursor.AppImage /usr/local/bin/cursor

Utwórz wpis Desktop

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

Migracja VS Code (2 minuty)

Wskazówka

Jeśli przechodzisz z VS Code, Cursor może zaimportować wszystkie twoje ustawienia, rozszerzenia i kombinacje klawiszy jednym kliknięciem.

Automatyczny import

1. Otwórz ustawienia Cursor Naciśnij Cmd/Ctrl + Shift + J lub przejdź do Ustawień

2. Przejdź do Ogólne → Konto Poszukaj sekcji VS Code

3. Kliknij “Import from VS Code” Cursor automatycznie wykryje i zaimportuje:

   • Wszystkie zainstalowane rozszerzenia
   • Ustawienia użytkownika i preferencje
   • Skróty klawiszowe
   • Snippety i zadania
   • Wybory motywów

4. Restart Cursor Zmiany wchodzą w życie po restarcie

Ręczna migracja (jeśli potrzeba)

Jeśli automatyczny import zawiedzie, możesz ręcznie skopiować ustawienia:

macOS/Linux

# Skopiuj ustawienia VS Code do Cursor
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

# Skopiuj ustawienia VS Code do Cursor
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

Instalacja komendy shell

Włącz komendy cursor i code do użycia w terminalu:

1. Otwórz paletę komend: Cmd/Ctrl + P
2. Wpisz “Install” aby filtrować komendy
3. Wybierz Install 'cursor' command in PATH
4. Powtórz dla Install 'code' command in PATH

Teraz możesz otwierać projekty z terminala:

cursor ./moj-projekt
code ./inny-projekt  # Także działa dla kompatybilności z VS Code

Konfiguracja pierwszego uruchomienia

1. Konfiguracja trybu prywatności

Krytyczne dla enterprise

Włącz tryb prywatności aby upewnić się że twój kod nigdy nie jest używany do treningu i nie jest przechowywany poza sesją.

1. Otwórz ustawienia: Cmd/Ctrl + Shift + J
2. Przejdź do Ogólne → Prywatność
3. Włącz Tryb prywatności
4. Sprawdź czy status pokazuje: “Tryb prywatności włączony: kod nie będzie przechowywany”

2. Tworzenie konta

Choć Cursor działa bez konta, rejestracja odblokowuje wszystkie funkcje AI:

1. Kliknij Zarejestruj się na ekranie powitalnym
2. Wybierz metodę uwierzytelniania:
   • Email/Hasło
   • GitHub (zalecane dla funkcji zespołowych)
   • Google
3. Wybierz swój plan:
   • Darmowy: ograniczone żądania AI
   • Pro: $20/miesiąc, 500 szybkich żądań
   • Business: $40/użytkownika/miesiąc, funkcje zespołowe

3. Początkowa konfiguracja workspace

Nowy projekt

# Utwórz katalog projektu
mkdir moj-ai-projekt && cd moj-ai-projekt

# Zainicjuj git
git init

# Otwórz w Cursor
cursor .

Istniejący projekt

# Przejdź do swojego projektu
cd sciezka/do/twojego-projektu

# Otwórz w Cursor
cursor .

# Cursor rozpocznie indeksowanie automatycznie

Indeksowanie bazy kodu

Notatka

Indeksowanie jest kluczowe dla zrozumienia AI. Zazwyczaj zajmuje 1-15 minut w zależności od rozmiaru projektu.

Gdy otwierasz projekt, Cursor automatycznie:

1. Skanuje wszystkie pliki w twoim workspace
2. Tworzy embeddingi semantyczne dla kontekstu AI
3. Buduje indeks wyszukiwania dla szybkiego pobierania
4. Monitoruje zmiany aby utrzymać indeks aktualny

Monitoruj postęp indeksowania

1. Otwórz ustawienia: Cmd/Ctrl + Shift + J
2. Przejdź do Indeksowanie i dokumentacja
3. Wyświetl postęp i statystyki

Wskaźniki indeksowania

• Pasek statusu: pokazuje “Indeksowanie…” z postępem
• Jakość AI: poprawia się gdy indeksowanie się kończy
• Precyzja wyszukiwania: staje się bardziej precyzyjna
• Trafność kontekstu: lepsze sugestie plików

Szybka wycieczka po ustawieniach

Podstawowe ustawienia do przejrzenia przed rozpoczęciem:

Motyw

Ustawienia → Motywy

Wybierz preferowany schemat kolorów

Rozmiar czcionki

Ustawienia → Edytor

Dostosuj rozmiary czcionki edytora i terminala

Autozapis

Ustawienia → Pliki

Włącz autozapis dla płynniejszych przepływów pracy AI

Formatuj przy zapisie

Ustawienia → Edytor

Auto-formatuj kod przy zapisywaniu

Zweryfikuj instalację

Uruchom tę szybką kontrolę aby upewnić się że wszystko działa:

1. Otwórz terminal w Cursor: Ctrl + `
2. Sprawdź Node.js: node --version (powinno być 18+)
3. Sprawdź Git: git --version
4. Testuj AI: naciśnij Cmd/Ctrl + K i wpisz “Cześć”

Wskazówka

Jeśli widzisz odpowiedź AI na “Cześć”, twoja instalacja jest kompletna!

Częste problemy instalacji

macOS

“Cursor jest uszkodzony i nie może być otwarty”

xattr -cr /Applications/Cursor.app

Komenda nie znaleziona: cursor

• Restart terminala po instalacji
• Ręcznie dodaj do PATH: export PATH="$PATH:/Applications/Cursor.app/Contents/Resources/app/bin"

Windows

Instalacja się zawiesza

• Tymczasowo wyłącz antywirus
• Uruchom instalator jako Administrator
• Sprawdź wykluczenia Windows Defender

Rozszerzenia się nie ładują

• Wyczyść cache rozszerzeń: %APPDATA%\Cursor\CachedExtensions
• Przeinstaluj problematyczne rozszerzenia

Linux

Błędy FUSE

# Ubuntu/Debian
sudo apt install libfuse2

# Fedora
sudo dnf install fuse

# Arch
sudo pacman -S fuse2

Problemy GPU/wyświetlania

# Uruchom z wyłączonym GPU
cursor --disable-gpu

Następne kroki

Kontynuuj do podstawowej konfiguracji

Teraz gdy Cursor jest zainstalowany, skonfigurujmy modele AI i funkcje zaawansowane.

Podstawowa konfiguracja →

Czas: 15 minut

Wskazówka

Wskazówka pro: Trzymaj Cursor otwarty podczas reszty tego przewodnika. Będziemy konfigurować ustawienia i testować funkcje praktycznie.