Cursor krok po kroku: pierwsza godzina z edytorem AI

👁 117 przeczytań

Cursor najłatwiej poznać nie na pustym pliku, tylko na prawdziwym projekcie, na którym zadasz mu pytanie, dostaniesz odpowiedź i zobaczysz pierwszą zmianę w kodzie. Oficjalny quickstart Cursora proponuje dokładnie taką ścieżkę i to na niej opieram ten samouczek, uzupełniając go o to, co warto ustawić od pierwszego dnia.

Krok 1. Instalacja i pierwszy folder

Pobierasz Cursor ze strony producenta, otwierasz aplikację i logujesz się. Cursor wyrósł z VS Code, więc przy pierwszym uruchomieniu możesz przenieść swoje rozszerzenia i ustawienia, co oszczędza godzinę konfigurowania. Potem otwierasz folder z projektem, najlepiej takim, który znasz, bo wtedy łatwiej ocenisz, czy odpowiedzi mają sens.

// chwilowo wyprzedane - wraca w kolejnej dostawiebrak w magazynie

Cursor Pro - 12 miesięcyKod, którym włączasz Cursor Pro na 12 miesięcy na własnym koncie.kinetyka.pl - mój sklep z rocznymi dostępami do narzędzi AI

440 zł-49%zamiast 864 zł36,67 zł / mies.Powiadom mnie o dostawie →

Krok 2. Poproś, żeby wyjaśnił projekt

Otwierasz panel Agenta skrótem Cmd + I (na Windowsie Ctrl + I) i zaczynasz od pytania, które proponuje sam quickstart: poproś o wyjaśnienie projektu, wskazanie głównych punktów wejścia, kluczowych modułów i tego, co warto przeczytać przed wprowadzaniem zmian.

To najlepsze pierwsze polecenie z możliwych, bo od razu widać, jak Cursor rozumie cały projekt, a nie pojedynczy plik. Przy cudzym kodzie oszczędza godziny czytania.

Krok 3. Mała, bezpieczna zmiana

Drugie polecenie z quickstartu: poproś o trzy małe, bezpieczne usprawnienia, z wyjaśnieniem kompromisów, i o to, żeby Cursor poczekał, aż wybierzesz jedno. Potem wskazujesz jedno i prosisz o wdrożenie.

Ta kolejność ma sens. Zamiast pozwolić agentowi zmieniać wszystko naraz, najpierw widzisz propozycje, potem decydujesz. Przy pierwszych dniach pracy z AI w kodzie to najważniejszy nawyk.

Krok 4. Przejrzyj zmiany i uruchom testy

Cursor pokazuje zmiany w formie porównania: co było, co jest. Quickstart radzi przejrzeć tę różnicę i poprosić Cursor o uruchomienie kontroli, których projekt już używa: testów, sprawdzania typów, lintera albo lokalnej kompilacji. Zmiana, której nie przeszły testy, nie jest gotowa, nawet jeśli wygląda dobrze.

Krok 5. Plan Mode przy większych zadaniach

Do większych zmian służy Plan Mode, który włączasz w polu Agenta skrótem Shift + Tab. Cursor najpierw przegląda pliki, zadaje pytania doprecyzowujące, przygotowuje plan wdrożenia i czeka na Twoją zgodę. Dopiero potem zaczyna pisać kod.

To różnica między „zrób mi logowanie” a rozmową o tym, jak logowanie ma działać, zanim powstanie pierwsza linijka.

Plan Mode przydaje się też wtedy, gdy nie jesteś pewien, jak ugryźć zadanie. Pytania doprecyzowujące, które zadaje Cursor, często pokazują rzeczy, o których nie pomyślałeś: co ma się stać przy błędzie, jak zachować zgodność ze starymi danymi, gdzie jeszcze trzeba wprowadzić zmianę. Lepiej odpowiedzieć na nie przed pisaniem kodu niż po.

Dwa narzędzia na co dzień

Poza Agentem są dwie rzeczy, z których korzystasz setki razy dziennie:

• Tab, czyli podpowiedzi w trakcie pisania. Cursor proponuje dokończenie linii albo całego fragmentu, a Ty akceptujesz klawiszem Tab.
• Cmd + K (Ctrl + K), czyli edycja zaznaczonego fragmentu opisem. Zaznaczasz funkcję i piszesz, co ma się zmienić.

Pięć poleceń na pierwszy tydzień

Najtrudniejsze w nowym narzędziu jest to, że nie wiadomo, o co je prosić. Oto polecenia, które warto przećwiczyć na własnym projekcie w pierwszych dniach, od najprostszego:

• „Wyjaśnij, co robi ta funkcja i gdzie jest wywoływana.” Zaznaczasz funkcję i pytasz w panelu Agenta. Uczysz się, jak Cursor czyta kontekst.
• „Dodaj obsługę pustej listy i napisz do tego test.” Mała zmiana z testem, idealna do nauki przeglądania porównania zmian.
• „Znajdź miejsca, w których ten sam kod powtarza się w kilku plikach.” Pokazuje, jak Cursor patrzy na cały projekt naraz.
• „Przygotuj plan dodania eksportu do CSV. Nie pisz jeszcze kodu.” Ćwiczenie z Plan Mode i z tym, jak czytać plan, zanim się go zatwierdzi.
• „Uruchom testy i wyjaśnij, dlaczego ten test nie przechodzi.” Nauka diagnozy przed poprawką.

Po tygodniu takich ćwiczeń wiesz już, jak duże zadanie można bezpiecznie oddać agentowi, a przy którym lepiej rozbić je na kilka mniejszych. Ta intuicja jest cenniejsza niż jakikolwiek skrót klawiszowy.

Jak czytać porównanie zmian

Porównanie pokazuje linie usunięte i dodane. Przy każdej zmianie agenta warto zadać sobie trzy pytania: czy zmiana dotyczy tylko tego, o co prosiłem, czy nie usunęła niczego, co było potrzebne, i czy rozumiem każdą dodaną linię. Jeśli na ostatnie pytanie odpowiedź brzmi „nie”, poproś Cursor o wyjaśnienie, zanim zaakceptujesz zmianę. Kod, którego nie rozumiesz, będziesz naprawiać w najgorszym możliwym momencie.

Czego unikać na początku

• Ogromnych poleceń na start, typu „przepisz cały projekt na inny framework”.
• Akceptowania zmian bez czytania, bo agent potrafi pewnie zrobić coś innego, niż chciałeś.
• Pracy bez systemu kontroli wersji. Git to Twoja siatka bezpieczeństwa przy każdej zmianie agenta.

Więcej o samym edytorze przeczytasz w przewodniku po Cursorze, a o planach i limitach w tekście Ile kosztuje Cursor. Roczny plan Pro sprzedaję taniej niż w oficjalnym cenniku w sklepie kinetyka.pl. Przy aktywacji Cursor prosi o podpięcie karty.