Konfiguracja i ustawienia: Wskazówki 1-15

Właściwa konfiguracja środowiska Cursor to fundament wszystkiego, co nastąpi dalej. Te 15 wskazówek obejmuje najlepsze praktyki instalacji, kluczowe ustawienia i optymalizacje konfiguracji, które często przegapiają nawet doświadczeni programiści.

Podstawy instalacji

Wskazówka 1: Najlepsze praktyki instalacji dla konkretnych platform

Wybierz właściwą metodę instalacji dla swojego systemu operacyjnego, aby zapewnić płynne aktualizacje i integrację systemową.

# Preferowane: Instaluj przez Homebrew dla łatwych aktualizacji
brew install --cask cursor

# Alternatywa: Pobierz .dmg z cursor.com
# Po instalacji dodaj do PATH:
# Paleta poleceń → "Install 'cursor' command in PATH"

# Opcja 1: Windows Package Manager
winget install Anysphere.Cursor

# Opcja 2: Pobierz installer z cursor.com
# Cursor instaluje się domyślnie do AppData

# Pobierz AppImage z cursor.com
chmod +x Cursor-*.AppImage

# Dla Ubuntu/Debian, zainstaluj FUSE jeśli potrzeba:
sudo apt install libfuse2

# Utwórz wpis desktop dla launchera aplikacji
./Cursor-*.AppImage --appimage-desktop-integration

Wskazówka 2: Bezproblemowy import ustawień VS Code

Jeśli migrujesz z VS Code, importuj ustawienia, aby zachować swój przepływ pracy:

Otwórz paletę poleceń Cursor (Ctrl+Shift+P)
Wyszukaj “Import VS Code Settings”
Wybierz które ustawienia importować:
- Rozszerzenia
- Skróty klawiszowe
- Ustawienia
- Snippety
Uruchom ponownie Cursor, aby zastosować zmiany

Wskazówka 3: Zainstaluj polecenia shell dla integracji z terminalem

Włącz polecenia cursor i code dla bezproblemowego przepływu pracy w terminalu:

# Z palety poleceń (Ctrl+Shift+P):
# 1. "Install 'cursor' command in PATH"
# 2. "Install 'code' command in PATH"

# Teraz możesz:
cursor .                    # Otwórz bieżący katalog
cursor myfile.js           # Otwórz konkretny plik
cursor -n                  # Wymuś nowe okno
cursor -r folder/          # Użyj ponownie istniejącego okna
cursor -w file.txt         # Czekaj na zamknięcie pliku
cursor -g file.js:42       # Przejdź do linii 42
cursor --diff file1 file2  # Porównaj pliki
cursor -a folder           # Dodaj folder do workspace

Kluczowa konfiguracja

Wskazówka 4: Włącz tryb prywatności dla wrażliwych projektów

Skonfiguruj ustawienia prywatności przed pracą nad zastrzeżonym kodem:

// W ustawieniach Cursor (Ctrl+Shift+J)
{
  "cursor.privacy.mode": "enabled",
  "cursor.privacy.shareCodeWithAnthropicCheck": false,
  "cursor.privacy.shareLogsCheck": false
}

Gdy tryb prywatności jest włączony:

Żaden kod nie jest przechowywany ani używany do treningu
Całe przetwarzanie odbywa się w czasie rzeczywistym
Logi nie są zachowywane

Wskazówka 5: Skonfiguruj tryb YOLO dla automatycznego testowania

Tryb YOLO umożliwia Cursor automatyczne uruchamianie poleceń, kluczowe dla programowania kierowanego testami:

Otwórz ustawienia (Ctrl+Shift+J)
Przejdź do Features → YOLO Mode
Włącz tryb YOLO

Skonfiguruj dozwolone polecenia:

Prompt: "wszelkiego rodzaju testy są zawsze dozwolone jak vitest, npm test, nr test, itp. także podstawowe polecenia build jak build, tsc, itp. tworzenie plików i katalogów (jak touch, mkdir, itp) jest też zawsze ok"

Lista dozwolonych: npm, pnpm, yarn, bun, deno, node, tsc, vitest, jest, pytest
Lista zabronionych: rm -rf, sudo, ssh, curl, wget

Wskazówka 6: Skonfiguruj workspace multi-root

Dla mikroserwisów lub monorepo, skonfiguruj workspace multi-root:

# Metoda 1: Dodawaj foldery stopniowo
cursor /path/to/frontend
# Następnie: File → Add Folder to Workspace → Wybierz folder backend

# Metoda 2: Utwórz plik workspace
# Zapisz jako: myproject.code-workspace
{
  "folders": [
    { "path": "frontend" },
    { "path": "backend" },
    { "path": "shared" }
  ],
  "settings": {
    "cursor.workspace.searchExclude": {
      "**/node_modules": true,
      "**/dist": true
    }
  }
}

Konfiguracja modeli

Wskazówka 7: Strategiczny wybór modeli

Konfiguruj modele na podstawie złożoności zadań:

// Ustawienia Cursor → Models
{
  "cursor.models.default": "claude-4-sonnet",
  "cursor.models.codeCompletion": "cursor-small",
  "cursor.models.chat": {
    "simple": "claude-4-sonnet",
    "complex": "claude-4.1-opus",
    "reasoning": "o3-mini"
  }
}

Strategia wyboru modelu:

Sonnet 4: Domyślny koń roboczy dla większości zadań kodowania
Opus 4: Złożone decyzje architektoniczne (5x koszt)
o3: Skomplikowane debugowanie i rozwiązywanie problemów
Gemini 2.5 Pro: Duże okna kontekstu (2M tokenów)

Wskazówka 8: Strategicznie włącz tryb Max

Tryb Max zapewnia rozszerzone okna kontekstu, ale zwiększa koszty:

{
  "cursor.maxMode.enabled": true,
  "cursor.maxMode.trigger": "manual", // Nie włączaj automatycznie
  "cursor.maxMode.warningThreshold": 500000 // Ostrzeż przy 500k tokenów
}

Używaj trybu Max do:

Analizowania plików powyżej 10,000 linii
Refaktoryzacji między repozytoriami
Zrozumienia złożonych relacji architektonicznych

Optymalizacja wydajności

Wskazówka 9: Skonfiguruj limity pamięci i wydajności

Optymalizuj Cursor dla dużych baz kodu:

{
  "cursor.performance.memoryLimit": "8GB",
  "cursor.performance.cacheSize": "2GB",
  "cursor.performance.garbageCollection": "aggressive",
  "cursor.performance.maxFiles": 50000,
  "cursor.performance.fileWatcher.pollInterval": "auto"
}

Wskazówka 10: Skonfiguruj inteligentne wykluczenia plików

Popraw wydajność indeksowania wykluczając niepotrzebne pliki:

{
  "cursor.workspace.searchExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true,
    "**/build/**": true,
    "**/.git/**": true,
    "**/coverage/**": true,
    "**/*.log": true
  },
  "cursor.workspace.indexExclude": {
    "**/vendor/**": true,
    "**/public/assets/**": true,
    "**/tmp/**": true
  }
}

Konfiguracja zasad projektu

Wskazówka 11: Utwórz kompleksowe zasady projektu

Skonfiguruj katalog .cursor/rules/ dla konsekwentnego zachowania AI:

# Utwórz strukturę zasad
mkdir -p .cursor/rules
touch .cursor/rules/style-guide.md
touch .cursor/rules/architecture.md
touch .cursor/rules/testing.md

Przykład style-guide.md:

# Przewodnik stylu projektu

## Standardy kodu
- Używaj TypeScript z włączonym trybem strict
- Preferuj komponenty funkcyjne z hookami
- Używaj nazwanych eksportów zamiast domyślnych
- Maksymalna długość linii: 100 znaków
- Używaj camelCase dla zmiennych, PascalCase dla komponentów

## Obsługa błędów
- Zawsze używaj try-catch dla operacji async
- Loguj błędy z kontekstem
- Zwracaj zrozumiałe komunikaty błędów użytkownikom

## Komentarze
- Pisz JSDoc dla wszystkich funkcji publicznych
- Używaj komentarzy inline oszczędnie
- Preferuj kod samodokumentujący się

Wskazówka 12: Skonfiguruj auto-dołączanie zasad

Ustaw zasady do automatycznego stosowania na podstawie wzorców plików:

{
  "cursor.rules.autoAttach": [
    {
      "pattern": "**/*.test.{js,ts}",
      "rules": ["testing"]
    },
    {
      "pattern": "**/components/**",
      "rules": ["style-guide", "react-patterns"]
    },
    {
      "pattern": "**/api/**",
      "rules": ["api-conventions", "error-handling"]
    }
  ]
}

Indeksowanie bazy kodu

Wskazówka 13: Optymalizuj indeksowanie bazy kodu

Skonfiguruj indeksowanie dla optymalnej wydajności:

{
  "cursor.indexing.enabled": true,
  "cursor.indexing.type": "incremental",
  "cursor.indexing.updateInterval": "5m",
  "cursor.indexing.priorityPatterns": [
    "src/core/**/*",
    "src/api/**/*",
    "src/components/**/*"
  ],
  "cursor.indexing.includeProjectStructure": true
}

Monitoruj postęp indeksowania:

Sprawdź status w Settings → Indexing & Docs
Zobacz postęp w pasku statusu
Typowe czasy: 1-15 minut w zależności od rozmiaru

Wskazówka 14: Skonfiguruj cache wyszukiwania

Włącz cache wyszukiwania dla szybszych powtarzających się wyszukiwań:

{
  "cursor.search.cache.enabled": true,
  "cursor.search.cache.maxSize": "1GB",
  "cursor.search.cache.ttl": "24h",
  "cursor.search.semanticSearch": true
}

Konfiguracja środowiska

Wskazówka 15: Skonfiguruj zmienne środowiska programistycznego

Skonfiguruj środowisko dla konsekwentnej pomocy AI:

{
  "env": {
    "NODE_ENV": "development",
    "CURSOR_PROJECT_TYPE": "react-typescript",
    "CURSOR_TEST_RUNNER": "vitest"
  },
  "runtime": {
    "node": "20.x",
    "packageManager": "pnpm"
  }
}

Utwórz .env.cursor dla wrażliwych konfiguracji:

# Klucze API (nigdy nie commituj tego pliku)
ANTHROPIC_API_KEY=your_key_here
OPENAI_API_KEY=your_key_here

# Specyficzne dla projektu
DATABASE_URL=postgresql://localhost:5432/mydb
API_ENDPOINT=http://localhost:3000

Lista kontrolna weryfikacji

Po konfiguracji sprawdź swoją konfigurację:

Polecenia shell (cursor i code) działają w terminalu
Tryb prywatności jest odpowiednio skonfigurowany
Tryb YOLO jest włączony z bezpieczną listą poleceń
Modele są wybrane na podstawie twoich potrzeb
Wykluczenia plików są skonfigurowane
Zasady projektu są utworzone
Indeksowanie jest ukończone
Limity pamięci są odpowiednie dla twojej maszyny

Typowe problemy z konfiguracją

Polecenie shell nie znalezione:

# macOS/Linux: Dodaj do ~/.bashrc lub ~/.zshrc
export PATH="$PATH:/Applications/Cursor.app/Contents/Resources/app/bin"

# Windows: Uruchom jako administrator
setx PATH "%PATH%;C:\Users\%USERNAME%\AppData\Local\Programs\cursor\bin"

Indeksowanie zawieszone:

Sprawdź czy wzorce wykluczeń nie są zbyt szerokie
Uruchom ponownie Cursor
Wyczyść cache: Settings → Advanced → Clear Index Cache

Wysokie użycie pamięci:

Zmniejsz memoryLimit w ustawieniach wydajności
Zwiększ wykluczenia plików
Wyłącz nieużywane rozszerzenia

Następne kroki

Z odpowiednio skonfigurowanym środowiskiem jesteś gotowy do eksploracji Podstawowych funkcji. Te fundamentalne ustawienia będą procentować gdy będziesz skalować swoje użycie Cursor.