Konfiguracja i ustawienia Cursor

Zainstalowałeś Cursor, otworzyłeś projekt, wpisałeś prompt i otrzymałeś przeciętne sugestie. Spróbowałeś trybu agenta, pytał o pozwolenie na każde polecenie terminala i poddałeś się po piątym oknie dialogowym z potwierdzeniem. AI wydaje się powolne, sugestie wydają się generyczne i zastanawiasz się, o co tyle szumu. Problem nie tkwi w Cursor. Problem polega na tym, że Cursor prosto po wyjęciu z pudełka jest skonfigurowany dla maksymalnego bezpieczeństwa, nie maksymalnej produktywności. Te 15 wskazówek to naprawia.

Co z tego wyniesiesz

• Instalację Cursor, która importuje twój istniejący przepływ pracy VS Code bez utraty choćby jednego skrótu klawiszowego
• Auto-Run skonfigurowany z bezpieczną listą dozwolonych poleceń (Command Allowlist), która pozwala agentowi uruchamiać testy i buildy bez pytania
• Wybór modelu dostosowany do właściwego kompromisu koszt-jakość dla różnych typów zadań
• Zasady projektu, które sprawiają, że kod generowany przez AI pasuje do konwencji twojego zespołu za pierwszym razem
• Ustawienia indeksowania i wydajności, które utrzymują Cursor responsywnym na dużych bazach kodu

Instalacja i migracja

Wskazówka 1: Instaluj przez menedżera pakietów dla bezbolesnych aktualizacji

Nie pobieraj .dmg lub .exe ze strony internetowej. Użyj menedżera pakietów, aby aktualizacje były pojedynczym poleceniem zamiast manualnego cyklu pobierz-i-zastąp.

macOS

brew install --cask cursor
# Aktualizacje: brew upgrade --cask cursor

Windows

winget install Anysphere.Cursor
# Aktualizacje: winget upgrade Anysphere.Cursor

Linux

# Pobierz AppImage z cursor.com
chmod +x Cursor-*.AppImage
# Dla Ubuntu/Debian wymagany jest FUSE:
sudo apt install libfuse2

Wskazówka 2: Zaimportuj ustawienia VS Code w jednym kroku

Cursor jest forkiem VS Code, co oznacza, że twoje rozszerzenia, skróty klawiszowe, ustawienia i snippety przenoszą się bezpośrednio. Przy pierwszym uruchomieniu Cursor oferuje kreatora importu. Jeśli go pominąłeś:

1. Otwórz paletę poleceń: Cmd+Shift+P (macOS) lub Ctrl+Shift+P (Windows/Linux)
2. Wpisz “Import VS Code Settings”
3. Wybierz wszystkie kategorie (rozszerzenia, skróty klawiszowe, ustawienia, snippety)
4. Uruchom ponownie Cursor

Twoja pamięć mięśniowa pozostaje nienaruszona. Jedyne nowe skróty, których musisz się nauczyć, to Tab (zaakceptuj sugestię), Cmd+K (edycja inline) i Cmd+I (panel agenta).

Wskazówka 3: Zainstaluj polecenie powłoki cursor

Bez tego nie możesz otwierać projektów z terminala — a przepływy pracy oparte na terminalu to ogromna część efektywnego używania Cursor.

# Z palety poleceń (Cmd+Shift+P):
# "Install 'cursor' command in PATH"

# Teraz możesz:
cursor .                    # Otwórz bieżący katalog
cursor src/api/routes.ts    # Otwórz konkretny plik
cursor -g src/app.ts:42     # Przeskocz do linii 42
cursor --diff file1 file2   # Porównaj dwa pliki
cursor -a ../shared-lib     # Dodaj folder do bieżącego obszaru roboczego

Szybkie przełączanie projektów z terminala

# Dodaj do ~/.zshrc lub ~/.bashrc dla natychmiastowego przełączania projektów:
alias c="cursor"
alias cn="cursor -n"  # Wymuś nowe okno
alias cr="cursor -r"  # Użyj ponownie bieżącego okna

Odblokuj autonomiczne przepływy pracy

Wskazówka 4: Zrozum, dlaczego Auto-Run zmienia wszystko

Domyślnie agent Cursor pyta o pozwolenie przed uruchomieniem jakiegokolwiek polecenia terminala. Ma to sens dla bezpieczeństwa, ale niszczy autonomiczny przepływ pracy, który czyni tryb agenta potężnym. Każde npm test, każde tsc, każde mkdir wywołuje okno dialogowe z potwierdzeniem. Kończysz pilnując agenta zamiast pozwolić mu pracować.

Auto-Run (funkcja, którą społeczność wciąż nazywa “trybem YOLO”) usuwa te przerwy dla poleceń, którym ufasz. Agent może teraz pisać kod, uruchamiać testy, widzieć niepowodzenia, naprawiać kod i ponownie uruchamiać testy — wszystko bez klikania przez ciebie “Zezwól”.

Wskazówka 5: Skonfiguruj Auto-Run z bezpieczną listą dozwolonych poleceń

Przejdź do Ustawienia -> Cursor Settings -> Agents -> Auto-Run. Masz trzy tryby Auto-Run:

• Run in Sandbox (macOS/Linux): polecenia uruchamiają się automatycznie wewnątrz sandboxa, który ogranicza dostęp do systemu plików i sieci. To najbezpieczniejszy domyślny złoty środek — agent pozostaje odblokowany, ale złe polecenie nie może tknąć reszty twojej maszyny.
• Ask Every Time: każde narzędzie i polecenie wymaga zatwierdzenia. To opcja domyślna i ta wolna.
• Run Everything: agent uruchamia wszystkie narzędzia i polecenia bez pytania. Połącz to z wąską listą dozwolonych poleceń (Command Allowlist) i przełącznikami ochrony poniżej.

Następnie ukształtuj granice za pomocą listy dozwolonych poleceń (Command Allowlist) (polecenia uruchamiane automatycznie poza sandboxem). Dodaj polecenia, którym ufasz:

Zestaw startowy listy dozwolonych poleceń Auto-Run

vitest, jest, pytest, npm test, pnpm test, npm run build, pnpm build, tsc, eslint, prettier, biome, mkdir, touch, cp, git status, git diff

Pozostaw destrukcyjne i nieodwracalne polecenia poza listą dozwolonych, aby zawsze wymagały zatwierdzenia: rm -rf, sudo, git push, git commit, npm publish oraz każdy skrypt deploy. Cursor udostępnia też na tym samym ekranie przełączniki File-Deletion Protection, Dotfile Protection i External-File Protection — trzymaj je włączone, aby agent nie mógł usuwać plików ani edytować .gitignore/plików poza obszarem roboczym bez pytania.

Daje ci to agenta, który może iterować nad kodem autonomicznie, zachowując destrukcyjne operacje za bramką ręcznego zatwierdzania.

Wskazówka 6: Skonfiguruj wielokorzeniowe obszary robocze dla projektów full-stack

Jeśli twój projekt obejmuje wiele repozytoriów (frontend, backend, wspólne typy), otwórz je jako pojedynczy obszar roboczy, aby agent mógł edytować wszystkie z nich.

// myproject.code-workspace
{
  "folders": [
    { "path": "frontend", "name": "Frontend (Next.js)" },
    { "path": "backend", "name": "Backend (Express)" },
    { "path": "shared", "name": "Shared Types" }
  ]
}

Otwórz go za pomocą cursor myproject.code-workspace. Teraz, gdy powiesz agentowi “dodaj nowy endpoint API i zaktualizuj frontend, aby go wywołał”, może edytować pliki w obu repozytoriach w ramach jednej konwersacji.

Wybór modelu

Wskazówka 7: Wybierz właściwy model dla właściwego zadania

Cursor pozwala przełączać modele na konwersację. Używaj tego strategicznie zamiast domyślnie wybierać najdroższą opcję.

Typ zadania	Rekomendowany model	Dlaczego
Najtrudniejsze refaktoryzacje, budowanie od zera, długotrwałe zadania	Claude Fable 5	Model o najwyższych możliwościach Anthropic; przewyższa Opus 4.8 przy złożonej pracy wieloplikowej ($10/$50 za 1M tokenów — zob. porównanie modeli)
Złożona architektura, trudne błędy	Claude Opus 4.8	Silne rozumowanie agentowe, dobra dokładność w zadaniach wieloetapowych przy połowie kosztu Fable 5
Codzienne kodowanie, implementacja funkcji	Claude Sonnet 4.6	Silna wydajność przy niższym koszcie, szybkie odpowiedzi
Analiza dużego kontekstu (10k+ linii)	Gemini 3.1 Pro	Okno kontekstowe 1M tokenów
Szybkie iteracje, proste edycje	GPT-5.5	Szybkie odpowiedzi, dobre do szybkiego prototypowania

Przełączaj modele w trakcie sesji używając wyboru modelu w lewym dolnym rogu panelu agenta.

Wskazówka 8: Używaj trybu Max tylko gdy kontekst tego wymaga

Tryb Max daje rozszerzone okna kontekstowe, ale szybciej wyczerpuje twój limit. Włączaj go ręcznie (nie automatycznie) i używaj dla:

• Analizowania plików powyżej 5000 linii
• Refaktoryzacji międzyrepozytorium, gdzie agent musi utrzymać wiele dużych plików w kontekście
• Zrozumienia złożonych łańcuchów zależności w monorepo

Dla wszystkiego innego standardowy kontekst jest wystarczający i znacznie tańszy.

Zasady projektu

Wskazówka 9: Utwórz zasadę projektu (lub AGENTS.md) dla każdego projektu

To jest pojedyncza konfiguracja o najwyższym ROI, którą możesz wykonać. Zasada, która mówi AI o twoim stosie technologicznym, konwencjach i ograniczeniach, powstrzymuje je przed zgadywaniem — i zgadywaniem źle wystarczająco często, aby być irytującym. Obecny mechanizm Cursor to zasady projektu (Project Rules) w .cursor/rules/*.mdc. Dla pojedynczego, prostego zestawu instrukcji lżejszą alternatywą jest zwykły AGENTS.md w katalogu głównym projektu.

Utwórz .cursor/rules/project.mdc z alwaysApply: true, aby ładował się w każdej sesji:

Gotowy .cursor/rules/project.mdc dla projektu TypeScript web (skopiuj i wklej)

---
description: Project-wide stack and conventions
alwaysApply: true
---

This project is a TypeScript web application using Next.js App Router with React Server Components.

Tech stack:
- Next.js 15 with App Router
- TypeScript in strict mode
- Tailwind CSS for styling
- Drizzle ORM with PostgreSQL
- Vitest for testing
- pnpm as package manager

Code conventions:
- Use named exports, not default exports
- Prefer functional components with hooks
- Use server components by default, add "use client" only when client state is needed
- Error handling: always use try-catch for async operations with typed error responses
- Use zod for all input validation

When running commands, use pnpm instead of npm.
When searching the codebase, do at least 3 semantic searches and 3 grep searches.
Do not modify package.json dependencies directly -- ask first.

`.cursorrules` to rozwiązanie przestarzałe

Stary plik .cursorrules w katalogu głównym wciąż działa, ale dokumentacja Cursor wyraźnie oznacza go jako przestarzały i stwierdza, że “zostanie wycofany”. Jeśli go masz, przenieś jego zawartość do zasady .cursor/rules/*.mdc (lub AGENTS.md) — nie zakładaj na nim nowego projektu.

Wskazówka 10: Podziel zasady na skoncentrowane pliki dla większych projektów

Dla projektów z więcej niż kilkoma konwencjami podziel swoje zasady na skoncentrowane pliki .mdc zamiast jednej gigantycznej zasady:

mkdir -p .cursor/rules

Utwórz oddzielne pliki dla różnych kwestii:

• .cursor/rules/architecture.mdc — Granice warstw, zasady zależności, organizacja plików
• .cursor/rules/testing.mdc — Framework testowy, oczekiwania pokrycia, konwencje plików testowych
• .cursor/rules/api-conventions.mdc — Wzorce żądanie/odpowiedź, formaty błędów, wymagania uwierzytelniania
• .cursor/rules/styling.mdc — Wzorce komponentów, konwencje CSS, wymagania dostępności

Trzymaj każdą zasadę poniżej ~500 linii i odwołuj się do kanonicznych plików (@service-template.ts) zamiast wklejać kod, aby zasady pozostawały krótkie i nie traciły aktualności.

Wskazówka 11: Automatycznie dołączaj zasady przez frontmatter globs

Aby zastosować zasadę automatycznie, gdy dotykasz pasujących plików, ustaw typ zasady na “Apply to Specific Files” — co zapisuje listę globs we frontmatterze zasady. Nie ma config.json; dopasowywanie plików żyje wewnątrz każdej zasady .mdc. AI otrzymuje wtedy różne instrukcje podczas edytowania plików testowych versus plików komponentów versus tras API:

---
description: Testing conventions
globs:
  - "**/*.test.ts"
  - "**/*.test.tsx"
alwaysApply: false
---

- Use vitest with descriptive test names
- Cover happy path, edge cases, and error cases
- Mock external services, never hit the network in unit tests

Gdy plik pasujący do tych globów znajduje się w zakresie, Cursor dołącza tę zasadę automatycznie. Zapisuj globs jako listę YAML, jak pokazano — skrót z rozwijaniem nawiasów klamrowych w stylu **/*.test.{ts,tsx} może po cichu nie dopasować, więc wypisz każdy wzorzec w osobnej linii.

Indeksowanie i wydajność

Wskazówka 12: Skonfiguruj wykluczenia plików przed pierwszym indeksowaniem

Cursor indeksuje twoją bazę kodu dla wyszukiwania semantycznego. Bez wykluczeń marnuje czas i pamięć indeksując node_modules, artefakty buildów i wygenerowane pliki.

Dodaj do ustawień obszaru roboczego:

{
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/build": true,
    "**/.next": true,
    "**/coverage": true,
    "**/*.min.js": true,
    "**/package-lock.json": true,
    "**/pnpm-lock.yaml": true
  }
}

Wskazówka 13: Priorytetyzuj podstawowe pliki źródłowe do indeksowania

Powiedz Cursor, które pliki są najważniejsze, strukturyzując swój obszar roboczy tak, aby kod źródłowy był widoczny. Jeśli masz monorepo, otwórz konkretne pakiety, nad którymi pracujesz, zamiast katalogu głównego:

# Zamiast tego:
cursor ~/projects/big-monorepo

# Zrób to:
cursor ~/projects/big-monorepo/packages/web ~/projects/big-monorepo/packages/api

Sprawdź status indeksowania w Ustawienia > Indexing and Docs. Zdrowy projekt indeksuje się w 1-5 minut. Jeśli trwa to dłużej niż 15, twoje wykluczenia są zbyt luźne.

Wskazówka 14: Włącz tryb prywatności dla zastrzeżonego kodu

Jeśli pracujesz nad kodem, który nie może opuścić twojej maszyny, włącz tryb prywatności przed otwarciem projektu:

Ustawienia > Privacy > Enable Privacy Mode

Z włączonym trybem prywatności:

• Żaden kod nie jest przechowywany ani używany do trenowania modeli
• Przetwarzanie odbywa się w czasie rzeczywistym bez retencji
• Logi nie są wysyłane na serwery Cursor

Jest to twardy wymóg dla wielu zespołów korporacyjnych i powinien być skonfigurowany przed otwarciem jakiegokolwiek zastrzeżonego kodu.

Wskazówka 15: Ustaw globalne zasady użytkownika dla osobistych preferencji

Globalne zasady użytkownika stosują się we wszystkich projektach. Używaj ich dla osobistych preferencji, które nie są specyficzne dla projektu:

Ustawienia > Cursor Settings > Rules > User Rules

Globalne zasady użytkownika (skopiuj i wklej)

Prefer functional code over imperative where possible.
Use async/await instead of .then() chains.
When writing TypeScript, use strict types -- avoid 'any'.
For network requests, use fetch instead of axios.
Always handle errors explicitly, never silently swallow them.
When I ask you to fix something, explain what was wrong before showing the fix.

Te zasady znajdują się na poziomie IDE i różnią się dla każdego programisty, więc nie powinny zastępować zasad na poziomie projektu dla konwencji zespołowych. Myśl o nich jako o twoich osobistych preferencjach kodowania, które stosują się niezależnie od tego, który projekt otworzysz.

Kiedy to nie działa

Auto-Run uruchamia destrukcyjne polecenie: Dlatego trzymasz destrukcyjne polecenia poza listą dozwolonych (a Run Everything w parze z przełącznikami ochrony). Jeśli przypadkowo zatwierdzisz coś niebezpiecznego, użyj Cmd+Z w terminalu lub git checkout ., aby przywrócić pliki. Dla dodatkowego bezpieczeństwa preferuj Run in Sandbox i zawsze commituj przed rozpoczęciem dużej sesji z agentem.

Indeksowanie jest zatrzymane lub ekstremalnie wolne: Zazwyczaj spowodowane brakującym wzorcem wykluczenia. Sprawdź, czy Cursor próbuje indeksować node_modules, duże pliki binarne lub wygenerowany kod. Wyczyść cache indeksu przez Ustawienia > Advanced > Clear Index Cache i ponownie indeksuj z właściwymi wykluczeniami.

AI ignoruje twoje zasady: Zasada projektu dołącza się automatycznie tylko wtedy, gdy jej typ jest ustawiony poprawnie — alwaysApply: true dla każdej sesji albo pasująca lista globs dla “Apply to Specific Files”. Sprawdź, czy plik .mdc znajduje się w .cursor/rules/, nie jest pusty i ma prawidłowy frontmatter. Zweryfikuj też, że jesteś w trybie agenta — tryb Ask czasami ignoruje zasady projektu. (Jeśli wciąż używasz przestarzałego pliku .cursorrules, przenieś go do .cursor/rules/.)

Odpowiedzi modelu są wolne lub timeout: Przełącz się na szybszy model (Sonnet 4.6 zamiast Opus 4.8) dla rutynowych zadań. Jeśli wszystkie modele są wolne, sprawdź swoje połączenie sieciowe i stronę statusu Cursor.

Co dalej

Gdy twoje środowisko jest właściwie skonfigurowane, przejdź do Podstawowych funkcji (Wskazówki 16-30), aby nauczyć się skrótów i wzorców nawigacji, które przyspieszają codzienne kodowanie. Konfiguracja, którą właśnie ukończyłeś, to fundament, który czyni każdą kolejną wskazówkę bardziej efektywną.