# Szybki start Cursora: od instalacji do pierwszej zweryfikowanej funkcji

URL: https://developertoolkit.ai/pl/cursor-ide/quick-start/
Description: Szybki start Cursora: instalacja, polecenie verify, tryby uruchamiania, reguły, MCP i Plan Mode, a potem funkcja dowiedziona testami, nie czytaniem diffu.

Szybki start Cursora to dziesięć krótkich przewodników, łącznie około dwóch godzin, które prowadzą programistę od świeżej instalacji do pierwszej funkcji potwierdzonej dowodami. Ścieżka ustawia jedno polecenie weryfikujące, tryb uruchamiania, reguły projektu i MCP, a potem buduje funkcję z kryteriów akceptacji w Plan Mode. O tym, kiedy praca jest skończona, decydują testy, a nie czytanie kodu linijka po linijce.

Ten przegląd jest dla **programisty**, który konfiguruje Cursora na prawdziwym repozytorium, i dla **tech leada**, który commituje wynik dla całego zespołu. W pierwszej sesji agent często zmienia kilka plików, oznajmia, że skończył, a czy to prawda, mogą powiedzieć tylko twoje testy i kontrole.

**Co sprawdziliśmy na tej stronie**

Dotyczy linii Cursora 3.x; aktualnym wydaniem na 2026-10-12 jest Cursor 3.24 (2026-10-09, notatki o wydaniach Cursora). Dokumentacja Cursora wymienia cztery tryby agenta (Agent, Ask, Plan i Debug) oraz trzy tryby uruchamiania (Auto-review, Allowlist i Run Everything), a Cursor nie wskazuje jednego modelu domyślnego; wszystko sprawdzone 2026-10-12. Pozostałe nazwy funkcji pochodzą z dokumentacji Cursora pobranej 28 sierpnia 2026 r. Każde wycofanie zmian działa na samym gicie.

## Co daje ci szybki start Cursora

- Skrypt `verify` (sprawdzanie typów, linter, testy), który wywołują agent, hook i CI.
- Tryb uruchamiania, w którym ten skrypt działa bez pytania, a `git push` wymaga zgody, oraz `.cursorignore`, przez który agent nie odczyta sekretów.
- Reguły projektu w gicie, dzięki którym agent każdej osoby w zespole trzyma się tych samych konwencji.
- Jedną funkcję zmergowaną z dowodami: kryteriami, testem dla każdego kryterium, zieloną bramką i diffem o przewidywalnym zakresie.

## W jakiej kolejności skonfigurować Cursora?

Kroki 1–8 wykonaj po kolei; po 9 i 10 sięgnij, gdy będą potrzebne.

| # | Przewodnik | Czas | Gotowe, gdy |
| - | ---------- | ---- | ----------- |
| 1 | [Zainstaluj Cursora](/pl/cursor-ide/quick-start/installation-setup/) | 10 min | Cursor otwiera twoje repozytorium, a agent odpowiada na czacie |
| 2 | [Skonfiguruj bramkę dla agenta](/pl/cursor-ide/quick-start/essential-configuration/) | 15 min | Agent uruchamia `npm run verify` bez pytania o zgodę i nie może odczytać `.env` |
| 3 | [Wybierz model](/pl/cursor-ide/quick-start/model-selection/) | 10 min | Wiesz, jaki model działa, i zmieniasz go tylko na podstawie dowodów |
| 4 | [Napisz reguły projektu](/pl/cursor-ide/quick-start/project-rules/) | 10 min | Zapytany, które reguły obowiązują, agent wymienia twoje |
| 5 | [Zaplanuj pracę z PRD](/pl/cursor-ide/quick-start/prd-workflow/) | 15 min | Zatwierdziłeś kryteria akceptacji planu w Plan Mode |
| 6 | [Podłącz serwery MCP](/pl/cursor-ide/quick-start/mcp-setup/) | 10 min | Agent wywołuje jedno narzędzie z jednego serwera MCP |
| 7 | [Zarządzaj kontekstem](/pl/cursor-ide/quick-start/context-management/) | 10 min | Agent korzysta z twojego wzorcowego przykładu |
| 8 | [Zbuduj pierwszą funkcję](/pl/cursor-ide/quick-start/first-feature/) | 20 min | Każde kryterium ma test, który nie przechodzi, gdy kod jest zepsuty |
| 9 | [Naprawiaj błędy agenta](/pl/cursor-ide/quick-start/error-handling/) | 10 min | Masz za sobą jedno celowe wycofanie zmiany agenta |
| 10 | [Pracuj z gitem i zespołem](/pl/cursor-ide/quick-start/collaboration/) | 15 min | Twój pull request zawiera podsumowanie dowodów |

Krok 2 celowo idzie wcześnie: każda kolejna warstwa odwołuje się do polecenia weryfikującego. Zacznij od jednego mocnego modelu domyślnego (Cursor nie wskazuje jednego modelu domyślnego, sprawdzone 2026-10-12) i zmieniaj go dopiero wtedy, gdy twoje testy pokażą, że praca jest niewystarczająca; aktualne nazwy i ceny zawiera [przegląd modeli](/pl/ecosystem/models/).

## Jak sprawdzić, że konfiguracja Cursora działa?

Najpierw zacommituj czysty stan wyjściowy, żeby każdą niezacommitowaną zmianę agenta cofało `git restore .`, a nowe pliki `git clean -nd` (przegląd listy) i `git clean -fd` (usunięcie); `git stash -u` zachowa całość. Potem sam uruchom bramkę w terminalu, w katalogu głównym repozytorium:

```bash
git status --short     # empty: nothing uncommitted before the agent starts
npm run verify         # your type check, lint and tests; must exit 0 on main
```

Czerwone `verify` najpierw napraw albo zapisz, inaczej agent „naprawi” błędy, których nie spowodował. Następnie wklej to do czatu agenta w Cursorze:

**Prompt do skopiowania: audyt świeżej konfiguracji Cursora**

```text
Audit this Cursor setup before I start real work. Do not edit any file.
1. List every project rule that applies to this repository and quote the
   line in each that names a build, test, lint or type-check command.
2. Run `npm run verify` once and report the exit code and the first error
   line of any failing check.
3. Tell me whether you needed my approval to run it.
4. List the MCP servers and tools you can call.
5. Try to read .env and report exactly what happened.
Finish with `git status --short`, which must be empty.
```

Konfiguracja jest w porządku, gdy `verify` uruchomiło się bez pytania, odczyt `.env` został odrzucony, cytowane reguły są twoje, a `git status --short` jest puste.

## Jak zaufać pierwszej funkcji bez czytania każdej linijki?

Agent dowodzi swojej pracy, a ty sprawdzasz dowody. Zapisz kryteria akceptacji, zanim powstanie jakikolwiek kod, wklej je do Plan Mode i zatwierdź plan. Buduj po jednym kroku na prompt, z commitem po każdym, a [hook Cursora](/pl/cursor-ide/quick-start/essential-configuration/), który ponownie uruchamia `verify`, gdy agent kończy pracę, odsyła mu błędy.

Zatwierdzasz kryteria, tabelę „kryterium → test” i zakres zmian z `git diff --stat`; CI ponownie uruchamia `verify` na pull requeście. [Zbuduj pierwszą funkcję](/pl/cursor-ide/quick-start/first-feature/) prowadzi przez ten proces, a [dowody zamiast diffów](/pl/ladder/evidence-not-diffs/) wyjaśnia, dlaczego to się skaluje.

**Prompt do skopiowania: podsumowanie dowodów do pierwszego pull requesta**

```text
Write the evidence summary for this branch's pull request. Do not change code.
- Each acceptance criterion mapped to its test, and whether that test
  failed when you broke the behaviour.
- The final pass/fail line of each check in `npm run verify`.
- `git diff --stat main...HEAD`, with a reason for every file outside
  the feature and its tests.
- Anything no test covers that a reviewer must check by hand.
```

## Co psuje się w pierwszej konfiguracji Cursora?

| Objaw | Prawdopodobna przyczyna | Co zrobić |
| ----- | ----------------------- | --------- |
| Agent pyta o zgodę przed każdym uruchomieniem testów | Tryb uruchamiania nadal pyta o to polecenie | Ustaw tryb uruchamiania, w którym `npm run verify` działa bez zgody ([podstawowa konfiguracja](/pl/cursor-ide/quick-start/essential-configuration/)) |
| Agent ignoruje twoje konwencje | Brak reguły albo się nie ładuje | Popraw według [reguł projektu](/pl/cursor-ide/quick-start/project-rules/) |
| Agent pisze nowy helper zamiast twojego | Nigdy nie zobaczył twojego | Wskaż przez `@` jeden wzorcowy plik ([zarządzanie kontekstem](/pl/cursor-ide/quick-start/context-management/)) |
| Testy przechodzą, ale funkcja nie działa | Testy mockują zepsutą część | Testuj przez prawdziwy punkt wejścia ([pierwsza funkcja](/pl/cursor-ide/quick-start/first-feature/)) |
| Agent „naprawia” test, zmieniając go | Nic tego nie zabraniało | Sprawdź `git diff --stat main...HEAD -- '*.test.*' '*.spec.*'` dla zacommitowanych kroków (bez `main...HEAD` dla niezacommitowanych zmian), cofnij zmiany i zabroń tego w regule |
| Jeden prompt zepsuł wiele plików | Krok był za duży | `git restore .`, potem przejrzyj nowe pliki przez `git clean -nd` i usuń je `git clean -fd` (albo `git reset --hard <ostatni dobry commit>` dla zacommitowanych kroków), potem poproś o mniejszy krok ([naprawianie błędów](/pl/cursor-ide/quick-start/error-handling/)) |
| Tutorial mówi o „YOLO mode”, „Auto-Run”, `.cursorrules` albo Background Agents | Powstał przed zmianami nazw w Cursorze | Używaj Run modes (Auto-review, Allowlist, Run Everything), Rules lub AGENTS.md i Cloud Agents |

## Dokąd dalej po szybkim starcie Cursora

Szerszą ścieżkę opisują [ścieżka programisty](/pl/start/developer/) i [przegląd Cursora](/pl/cursor-ide/); dla innych agentów są szybkie starty [Claude Code](/pl/claude-code/quick-start/) i [Codeksa](/pl/codex/quick-start/).

- [Podstawowa konfiguracja](/pl/cursor-ide/quick-start/essential-configuration/) — Polecenie verify, tryb uruchamiania, reguły, hook i wykluczenie sekretów
- [Zbuduj pierwszą funkcję](/pl/cursor-ide/quick-start/first-feature/) — Kryteria akceptacji, Plan Mode, małe kroki i dowód, że działa
- [Wzorce testowania w Cursorze](/pl/cursor-ide/test/testing-patterns/) — Testy na tyle mocne, by zastąpić czytanie kodu linijka po linijce
