Migracja z tradycyjnych IDE

Przejście z tradycyjnego IDE, takiego jak VS Code, JetBrains czy Vim, do Claude Code lub Codeksa zachowuje dotychczasowy edytor, skróty i pracę z gitem; Cursor zastępuje edytor, ale uruchamia rozszerzenia VS Code. Zmienia się jednostka pracy: programista opisuje stan docelowy i ograniczenia, agent edytuje pliki, a testy, sprawdzanie typów i przegląd dowodzą poprawności diffu przed scaleniem.

Ten przewodnik jest dla programisty, który ma lata pamięci mięśniowej w jednym edytorze. Kolega z zespołu przekazuje agentowi refaktoryzację obejmującą wiele plików i bierze się za kolejne zadanie, a ty wciąż jesteś przy trzecim pliku. Chcesz tej samej szybkości, ale bez wyrzucania konfiguracji dopracowywanej przez dekadę i bez scalania kodu, za który nie możesz ręczyć.

Co zyskasz, przechodząc na agenta AI

• Decyzję, które narzędzie pasuje do edytora, którego już używasz, i instalację, która ten edytor zostawia na miejscu.
• Jeden plik instrukcji projektu (AGENTS.md lub CLAUDE.md oraz reguły Cursora) wygenerowany z rzeczywistych konwencji twojego repozytorium.
• Trzy prompty do skopiowania na pierwszy tydzień: szkic pliku instrukcji, utrwalenie obecnego zachowania w testach i refaktoryzacja o ograniczonym zakresie, która sama raportuje dowody.
• Rutynę weryfikacji, która sprawdza każdy diff agenta bramkami zamiast czytania linia po linii.
• Listę awarii z pierwszego tygodnia i sposób wyjścia z każdej z nich.

Które narzędzie pasuje do twojego obecnego edytora?

Żadne z trzech narzędzi nie każe ci porzucać edytora pierwszego dnia. Różnią się tym, gdzie działa agent.

Używasz dziś	Najmniej bolesna ścieżka	Dlaczego
VS Code	Cursor albo Claude Code i Codex przez ich rozszerzenia do VS Code	Cursor jest zbudowany na VS Code i instaluje rozszerzenia z widoku Extensions; rozszerzenie Codex wymienia Cursora jako obsługiwane środowisko (README Codeksa od OpenAI). Rozszerzenia Claude Code i Codex wstawiają agenta do edytora, który już masz.
JetBrains (IntelliJ, PyCharm, WebStorm i inne)	Claude Code przez wtyczkę JetBrains albo dowolne z dwóch CLI w terminalu IDE	Wtyczka Anthropic uruchamia CLI Claude Code wewnątrz IDE, więc inspekcje, refaktoryzacje i debugger zostają. Codex ma też natywną integrację z JetBrains od wersji 2025.3 (źródło wtórne: Neowin); zweryfikowaną ścieżką jest CLI w terminalu.
Vim, Neovim lub Emacs	Claude Code lub Codex w podzielonym terminalu albo panelu tmux	Oba są agentami terminalowymi. Edytor się nie zmienia, a wyniki przeglądasz przez git diff, tak jak dziś.

Jeśli wciąż wybierasz główne narzędzie, najpierw przeczytaj, jak wybrać główne środowisko pracy z AI, oraz porównanie Cursora i Claude Code.

Zainstaluj agenta bez wymiany edytora

Cursor

Cursor sam jest edytorem, więc to jedyna ścieżka, która przenosi edycję do nowej aplikacji.

1. Zainstaluj Cursora według strony Instalacja i konfiguracja Cursora. Zaimportowane ustawienia traktuj jako punkt wyjścia i sprawdź je w następnym kroku.

2. Zanim porzucisz VS Code, zapisz, co w nim miałeś. W terminalu uruchom:

   code --list-extensions > vscode-extensions.txt

   Porównaj vscode-extensions.txt z tym, co oferuje widok Extensions w Cursorze, i zaplanuj zamiennik dla każdej luki.

3. Jeśli przechodzisz z JetBrains, zainstaluj rozszerzenie IntelliJ IDEA Keybindings (k--kato.intellij-idea-keybindings, licencja MIT). Przenosi skróty IntelliJ do edytorów z rodziny VS Code. Zajmuje też klawisze takie jak Ctrl+I (Implement methods), więc otwórz edytor skrótów klawiszowych i rozwiąż każdy konflikt z poleceniem AI.

4. Dodaj reguły projektu w .cursor/rules/. Format opisuje strona Reguły projektu w Cursorze.

Claude Code

Claude Code to agent terminalowy z integracjami dla VS Code i JetBrains. Dodajesz go obok edytora.

1. Zainstaluj natywnym instalatorem i uruchom w katalogu głównym repozytorium:

   curl -fsSL https://claude.ai/install.sh | bash
   cd your-repo && claude

2. Połącz go z edytorem. W VS Code zainstaluj rozszerzenie Claude Code, które pokazuje diffy w edytorze i pozwala przeglądać plan. W IDE JetBrains zainstaluj wtyczkę Claude Code, która uruchamia CLI w terminalu IDE. W sesji terminalowej /ide pokazuje połączenie i nim zarządza, a claude --ide łączy się przy starcie. Szczegóły: integracja Claude Code z IDE.

3. Użytkownicy Vima i Emacsa uruchamiają claude w podzielonym panelu i przeglądają zmiany przez git diff. W edytorze nic się nie zmienia.

4. Sprawdź wersję poleceniem claude --version. Kilka zachowań opisanych niżej, w tym czytanie AGENTS.md, trafiło najpierw na kanał wydań latest (v2.1.283 2026-09-26); 2026-10-17 stable to v2.1.292 i też je ma.

Codex

Codex obejmuje CLI, rozszerzenie IDE i zadania w chmurze. Zostajesz przy swoim edytorze i przekazujesz agentowi dobrze zdefiniowaną pracę.

1. Zainstaluj CLI i zaloguj się kontem ChatGPT:

   npm install -g @openai/codex
   cd your-repo && codex

2. Do pracy w edytorze zainstaluj rozszerzenie Codex do IDE. README OpenAI wymienia VS Code, Cursora i Windsurf (obecnie Devin Desktop) jako środowiska. W interfejsie terminalowym /ide pobiera z edytora bieżące zaznaczenie i otwarte pliki.

3. Użytkownicy JetBrains i Vima uruchamiają CLI w terminalu IDE albo w podzielonym panelu. Codex ma też natywną integrację z JetBrains od wersji 2025.3 (źródło wtórne: Neowin). Homebrew i skrypt instalacyjny opisuje strona Instalacja Codeksa.

4. Pierwsze sesje prowadź w trybie tylko do odczytu, dopóki nie poznasz, jak Codex planuje. Granicę wyznaczają profile uprawnień (beta, Codex CLI 0.138.0 lub nowszy): codex -c default_permissions=":read-only" pozwala Codeksowi czytać i proponować, a ":workspace" pozwala edytować wewnątrz repozytorium.

Naucz agenta swoich konwencji w dniu migracji

Stare IDE pilnowało stylu przez konfigurację formatera i lintera. Agenci też ją czytają, ale potrzebują reguł, których żaden plik konfiguracyjny nie zawiera: gdzie co leży, które wzorce są zakazane i które polecenie dowodzi, że zmiana działa. To trafia do pliku instrukcji projektu i warto go przygotować przed pierwszym prawdziwym zadaniem.

Treść piszesz raz. Nazwa pliku zależy od narzędzia:

Narzędzie	Plik, który czyta agent	Polecenie tworzące szkic
Codex	AGENTS.md w katalogu głównym repozytorium	/init w interfejsie terminalowym
Claude Code	CLAUDE.md; od v2.1.277 czyta AGENTS.md, gdy CLAUDE.md nie istnieje	/init w sesji
Cursor	AGENTS.md i CLAUDE.md w katalogu głównym projektu i w podkatalogach; reguły w .cursor/rules/ tylko dla Cursora	Zobacz Reguły projektu w Cursorze

Zespół mieszany może trzymać jeden AGENTS.md dla Codeksa i Cursora oraz dla Claude Code od v2.1.277. O synchronizacji plików pisze Migracja między Codexem, Cursorem i Claude Code. Niezależnie od pliku zakończ go sekcją weryfikacji podobną do tej, bo to ona pozwala przestać czytać każdą linię:

## Verification (run before saying a task is done)
- npm run typecheck
- npm run lint
- npm test -- --run
- Report each command's exit status. Never edit or delete a test to make it pass.

## Boundaries
- Do not touch src/auth/ or applied migrations in db/migrations/ without asking.

Prompt do skopiowania: szkic pliku instrukcji z repozytorium

Analyze this repository and draft a project instructions file for coding agents.
Infer conventions from the code, not from general best practice:
directory layout and naming, the test framework and where tests live, the lint
and formatter rules in the config files, the data-access and error-handling
patterns, and the commit message style from the last 50 commits in git log.
Where the codebase is inconsistent, state the dominant pattern and list the
exceptions with file paths. End with a "Verification" section that lists the
exact typecheck, lint, and test commands from package.json (or the equivalent
build file), and a "Boundaries" section for directories an agent should not
edit without asking. Keep it under 150 lines. Do not write any other file.

Przejrzyj szkic tak jak pull request kolegi i zapisz go w commicie. Resztę tego, co przygotowuje repozytorium na agentów, opisuje playbook konwersji projektu.

Jak przekazać refaktoryzację agentowi?

W tradycyjnym IDE przepisujesz handlery plik po pliku, a mechaniczne części załatwiasz przez Find and Replace. W pracy z agentem podajesz stan docelowy, zakres i dowód, a agent tworzy skoordynowany diff w wielu plikach.

Weź zadanie, które znasz: przeniesienie modułu tras Express z obsługi błędów w stylu callbacków na async/await z jednym wspólnym middleware błędów. Zrób to w dwóch przejściach. Najpierw utrwal obecne zachowanie testami, żeby „nadal działa” było poleceniem, a nie twoją opinią. Potem refaktoryzuj względem tych testów.

Prompt do skopiowania: utrwal obecne zachowanie testami przed refaktoryzacją

Before we refactor anything in src/routes/, write characterization tests that
pin the current behavior of every route in that directory: status codes,
response bodies, and error responses for invalid input and for a failing
downstream call. Put them in tests/routes/characterization/. Do not change any
file outside that test directory. Run the new tests against the current code
and show me that they all pass. If a behavior looks like a bug, keep the test
asserting the current behavior and list it separately as a suspected bug.

Cursor

Otwórz Agenta, przełącz na Plan Mode, żeby Cursor napisał plan implementacji przed edycją, i wklej poniższy prompt refaktoryzacji. Przejrzyj plan, zanim Cursor zacznie edytować. O poprawności diffu decydują testy z pierwszego przejścia; widok diffu pokazuje tylko, co się przesunęło.

Claude Code

Zacznij w trybie planowania, żeby nic nie zostało zmienione przed akceptacją planu:

claude --permission-mode plan

Wklej prompt refaktoryzacji, przeczytaj plan i zatwierdź go. Jeśli któryś krok pójdzie źle, /rewind przywraca wcześniejszy punkt kontrolny. Sesje interaktywne w planach Pro, Max i Team startują w trybie auto (od v2.1.283, na obu kanałach wydań na 2026-10-12, we wszystkich planach i u wszystkich dostawców), w którym klasyfikator zatwierdza rutynowe akcje, więc przy pierwszych refaktoryzacjach świadomie wybierz tryb planowania.

Codex

Zostań w jednej sesji. Zacznij w trybie tylko do odczytu, w którym Codex czyta i planuje, ale nie edytuje:

codex -c default_permissions=":read-only"

Wklej prompt refaktoryzacji i zatwierdź plan. Potem w interfejsie terminalowym uruchom /permissions i przełącz się na :workspace, żeby Codex edytował w tej samej sesji, z planem wciąż w kontekście. Profil :workspace ogranicza edycję do repozytorium. Jeśli sesja jest już zamknięta, codex resume --last -c default_permissions=":workspace" otwiera ją ponownie z prawem edycji.

Prompt do skopiowania: refaktoryzacja z ograniczonym zakresem, która raportuje dowody

Refactor the route handlers in src/routes/ from callback-style error handling
to async/await. Thrown errors must reach one shared errorHandler middleware in
src/middleware/error.ts (create it if it does not exist). Scope: only files in
src/routes/, src/middleware/, and tests/routes/. Keep every route's public
behavior identical; the characterization tests in
tests/routes/characterization/ must pass unchanged.
Before editing, list the files you will change and a one-paragraph plan, then
wait for my approval. After editing, run the typecheck, lint, and full test
suite and report: each command with its exit status, the files changed, any
test you added, and anything you were unsure about.

Mechanika różni się między narzędziami, ale dyscyplina jest ta sama: nazwij stan docelowy, nazwij zakres i nazwij polecenie, które go dowodzi.

Jak sprawdzić diff agenta bez czytania każdej linii?

Jeśli czytasz każdą linię diffu w 20 plikach, agent oszczędza ci pisania, ale nie czasu. Przenieś sprawdzanie do rzeczy, które da się uruchomić: testów, bramek i agentów przeglądających.

1. Zachowanie jest utrwalone w testach przed zmianą. Testy charakteryzujące istnieją i przechodzą na starym kodzie. Refaktoryzacja, która zmienia zachowanie, sprawi, że te testy przestaną przechodzić.
2. Bramki uruchamiają się dwa razy. Agent uruchamia sprawdzanie typów, lint i testy oraz raportuje kody wyjścia. Ty albo CI uruchamiacie je ponownie, bo podsumowanie agenta to deklaracja, a nie dowód.
3. Pliki testów są chronione. Po każdym zadaniu sprawdź git diff --stat -- tests/. Refaktoryzacja, która edytowała testy charakteryzujące, zmieniła reguły w trakcie gry; odrzuć ją. Wzorzec opisuje strona ochrona wyroczni testowej.
4. Drugi agent robi przegląd. Uruchom /code-review w Claude Code, /review (lub codex review) w Codeksie albo Bugbota na pull requeście w Cursorze. Czytasz uwagi, a nie cały diff.
5. Ryzykowne fragmenty czytasz sam. Uwagę poświęcasz ścieżkom z sekcji Boundaries, nowym zależnościom i wszystkiemu, co agent oznaczył jako niepewne.

Zatwierdzasz na podstawie dowodów: zielonych bramek, nietkniętych testów i rozwiązanych uwag z przeglądu. Pakiet dowodów zamienia to w standardowy manifest dla każdego pull requesta, a dlaczego dowody zastępują czytanie diffów wyjaśnia samą zasadę.

Którego modelu używać po zmianie?

Stare IDE miało jeden silnik podpowiedzi. Teraz masz wybór modelu. Zacznij od domyślnego modelu narzędzia, podnieś poziom wysiłku (effort), zanim zmienisz model, i zmieniaj model dopiero wtedy, gdy przemawiają za tym twoje własne wyniki.

• Claude Code: Claude Opus 5.5 jest domyślny od v2.1.280, na obu kanałach wydań (sprawdzone 2026-10-12); domyślny model u twojego dostawcy sprawdź w centrum modeli. Wysiłek podnosisz przez /effort, a Claude Fable 5.1 wybierasz przez /model fable tylko do najdłuższych i najtrudniejszych zadań.
• Codex: GPT-6.1 Sol to domyślny model dołączony do CLI (od CLI 0.159.1). GPT-6 Luna w selektorze kosztuje mniej przy rutynowej pracy, a GPT-6 Astra nadaje się do najtrudniejszej pracy.
• Cursor: wybierz model w selektorze modeli; centrum modeli śledzi, co oferuje każde narzędzie.

Ceny i szczegóły planów są w centrum modeli.

Jak funkcje IDE przekładają się na nowe narzędzia

Funkcja tradycyjnego IDE	Cursor	Claude Code	Codex
Find and Replace w wielu plikach	Edycja agenta na podstawie opisu	Edycja wielu plików jednym promptem	Edycja wielu plików jednym promptem
Uzupełnianie kodu	Uzupełnianie Tab w Cursorze	Zostaje uzupełnianie twojego edytora	Zostaje uzupełnianie twojego edytora
Debugger	Debugger edytora	Debugger twojego IDE; agent czyta stack trace i pisze test, który odtwarza błąd	Debugger twojego IDE; ten sam wzorzec
Integracja z gitem	Wbudowana w edytor	git z terminala; agent może commitować	git z terminala; codex apply <id-zadania> nakłada diff zadania z Codex Cloud na drzewo robocze
Przegląd kodu	Bugbot na pull requestach	/code-review	/review, codex review
Rozszerzenia	Rozszerzenia VS Code	Wtyczki, skille i serwery MCP	Wtyczki, skille i serwery MCP

Uwaga

Najbardziej różni się uzupełnianie w linii. Claude Code i Codex to agenci, a nie silniki podpowiedzi. Jeśli cały dzień polegasz na podpowiedziach, zostaw uzupełnianie edytora obok nich albo wybierz Cursora.

Aby połączyć agenta z zadaniami w GitHubie, bazą danych lub przeglądarką, dodaj serwery MCP. Konfiguracja serwerów MCP w trzech narzędziach pokazuje polecenia dla każdego z nich (claude mcp add, codex mcp add i ustawienia MCP w Cursorze).

Kiedy migracja z IDE się sypie

Krytyczne rozszerzenie nie ma odpowiednika. Porównaj vscode-extensions.txt z tym, co oferuje nowe środowisko. Jeśli brakuje debuggera lub pakietu językowego, zostaw stare IDE do tego jednego zadania. Nie instaluj ręcznie rozszerzenia, którego licencja ogranicza je do produktów Microsoftu; najpierw sprawdź licencję na jego stronie w Marketplace.

Agent ignoruje zapisaną konwencję. Ogólnikowa reguła daje ogólnikowe efekty. Zastąp „dbaj o obsługę błędów” dziesięcioma liniami przykładu dokładnie tego wzorca i dodaj regułę lintera, jeśli istnieje; bramka egzekwuje to, co proza tylko sugeruje.

Agent przepisuje kod, którego nie kazałeś ruszać. W każdym prompcie nazwij zakres, zaczynaj w trybie planowania (Claude Code, Cursor) lub w profilu tylko do odczytu (Codex) i odrzuć każdy diff, którego git diff --stat obejmuje pliki spoza zakresu. Cofasz zmiany przez /rewind w Claude Code albo git restore na zmienionych ścieżkach.

Pierwszy tydzień wydaje się wolniejszy. Może taki być. W randomizowanym badaniu METR z 2025 roku doświadczeni programiści open source potrzebowali o 19% więcej czasu na zadania, przy których wolno było używać narzędzi AI. Kontynuacja METR z 2026 roku wskazuje w drugą stronę (około 18% mniej czasu u powracających programistów), ale przedział ufności przecina zero, a sam METR nazywa te dane niewiarygodnym sygnałem (METR, repozytorium Measuring-Late-2025-AI-on-OSS-Devs, 2026). Zacznij od mało ryzykownych zadań, notuj czas na zadanie i oceniaj po kilku tygodniach, a nie po kilku dniach.

Stare skróty wywołują polecenia AI. Rozszerzenia przenoszące skróty z innych IDE i funkcje AI walczą o te same kombinacje klawiszy. Przemapuj polecenia AI w edytorze skrótów klawiszowych, a klawisze edycji zostaw.

Nadal czytasz każdą linię. Jeśli przegląd trwa dłużej niż sama zmiana, bramki są za słabe. Dodaj testy charakteryzujące i agenta przeglądającego, zanim dołożysz kolejne zadania.

Dokąd dalej po zmianie IDE

Playbook konwersji projektu Przygotuj repozytorium na agentów: instrukcje, bramki i kontekst.

Migracja między Codexem, Cursorem i Claude Code Jeden AGENTS.md, polecenia importu i przebieg porównawczy między narzędziami.

Claude Code lub Codex obok GitHub Copilota Zostaw Copilota i dodaj agenta z tymi samymi bramkami CI.

Onboarding i adopcja w zespole Jak przenieść zmianę na cały zespół, a nie na jednego programistę.