Migracja z tradycyjnych IDE

Masz dziesięć lat pamięci mięśniowej w VS Code lub JetBrains. Skróty klawiszowe wrosły ci w palce, rozszerzenia masz dostrojone dokładnie tak, jak lubisz, a po kodzie poruszasz się z zamkniętymi oczami. A potem kolega z zespołu dowozi funkcję w jedno popołudnie, choć tobie zajęłaby ona dwa dni — i okazuje się, że zamiast ją wpisywać, opisał ją agentowi. Zmiana wydaje się ryzykowna: nie chcesz tracić konfiguracji, którą budowałeś latami, tylko po to, by gonić za szybszym przepływem pracy.

Nie musisz. Ten playbook przenosi cię z tradycyjnego IDE do Cursor, Claude Code lub Codex bez wyrzucania ustawień, skrótów klawiszowych czy przepływu z gitem — i pokazuje jeden nawyk, który naprawdę się zmienia: przejście od “pisz każdą linię” do “opisz zmianę, przejrzyj diff”.

Co z tego wyniesiesz

• Twoje ustawienia, skróty klawiszowe i rozszerzenia z VS Code lub JetBrains zaimportowane do nowego narzędzia (albo jasną listę tego, co się nie przeniesie i dlaczego)
• Plik CLAUDE.md / AGENTS.md / .cursor/rules wygenerowany z istniejących konwencji repozytorium, dzięki czemu agent od pierwszego dnia trzyma się stylu twojego zespołu
• Gotowy prompt do wklejenia na potrzeby refaktoryzacji, który pokazuje przepływ “opisz, nie pisz” na prawdziwym module
• Listę “Kiedy coś się psuje” z trybami awarii, na które trafia w pierwszym tygodniu każdy migrujący deweloper

Wybierz swoją ścieżkę migracji

Najgładsza ścieżka zależy od tego, które IDE opuszczasz i czy chcesz zachować edytor graficzny, czy przejść do terminala.

Cursor

Najlepsza ścieżka z VS Code — Cursor to fork VS Code, więc import jest niemal natychmiastowy, a rozszerzenia, motywy i skróty klawiszowe przenoszą się razem z tobą.

1. Zainstaluj Cursor, a przy pierwszym uruchomieniu wybierz Import from VS Code (lub uruchom polecenie Cursor: Import VS Code Settings z palety). Pobierze to settings.json, keybindings.json, zainstalowane rozszerzenia i motywy.

2. Sprawdź, czy rozszerzenia się rozwiązały. Cursor instaluje z rejestru Open VSX, a nie z Microsoft Marketplace, więc kilku zastrzeżonych rozszerzeń (zwłaszcza debuggerów C/C++ i C# oraz niektórych narzędzi tylko od Microsoftu) może brakować. Odnotuj braki i znajdź odpowiedniki w Open VSX.

3. Przychodzisz z JetBrains? Nie ma importu jednym kliknięciem. Zainstaluj rozszerzenie IntelliJ IDEA Keybindings, by zachować skróty, a następnie ręcznie dodaj wsparcie języków i konfigurację debuggera.

4. Poznaj cztery punkty wejścia do AI: Cmd/Ctrl+K do edycji inline, Cmd/Ctrl+I do trybu Agent, panel boczny chatu do pytań oraz Tab do akceptowania wielolinijkowych sugestii.

Claude Code

Najlepsza ścieżka, jeśli chcesz zachować edytor — Claude Code to narzędzie terminalowe, więc nie migrujesz z VS Code, JetBrains czy Vima. Dokładasz agenta obok nich.

1. Zainstaluj CLI: npm install -g @anthropic-ai/claude-code, a następnie uruchom claude w katalogu głównym projektu.

2. Zostaw otwarty dotychczasowy edytor do czytania i ręcznych edycji. Uruchom claude w podzielonym terminalu (albo użyj oficjalnego rozszerzenia VS Code / JetBrains) i deleguj mu pracę wieloplikową.

3. Wygeneruj CLAUDE.md, żeby agent znał twoje konwencje — uruchom /init w REPL, by Claude Code naszkicował go na podstawie repozytorium, a potem go dopracuj.

4. Użytkownicy Vima: w edytorze nic się nie zmienia. Zejdź do terminala, uruchom claude "..." i przejrzyj wynik przez git diff w swoim zwykłym przepływie.

Codex

Najlepsza ścieżka do pracy równoległej i asynchronicznej — Codex obejmuje CLI, rozszerzenie do IDE, aplikację webową i Cloud, więc możesz zachować edytor i przekazywać dobrze zdefiniowane zadania do uruchomienia w tle.

1. Zainstaluj CLI: npm install -g @openai/codex, a następnie uruchom codex w projekcie i zaloguj się kontem ChatGPT.

2. Codex do instrukcji projektu używa AGENTS.md zamiast importowania ustawień IDE — nie ma nic do migracji z settings.json. Uruchom /init w TUI, by go wygenerować.

3. Zachowaj swoje IDE do edycji interaktywnej. Użyj rozszerzenia Codex do IDE dla zadań w edytorze albo zlecaj dłuższe prace do Codex Cloud i przeglądaj diffy, gdy się skończą.

4. Ustaw poziom autonomii jawnie za pomocą --ask-for-approval (untrusted, on-failure, on-request lub never) oraz trybu --sandbox (read-only, workspace-write, danger-full-access), tak aby granice agenta odpowiadały twojemu poziomowi komfortu.

Wskazówka

Gotowy prompt do importu konfiguracji edytora (Cursor):

“Read my imported keybindings.json and settings.json. List any keybindings that conflict with Cursor’s AI shortcuts (Cmd/Ctrl+K, Cmd/Ctrl+I). Then check my installed extensions against the Open VSX registry and flag any that aren’t available there, with a suggested open-source alternative for each so I can replace the ones that didn’t transfer.”

Naucz agenta swoich konwencji

Tradycyjne IDE wymusza twój styl przez konfigurację linterów i formaterów. Narzędzia AI czytają zamiast tego plik z instrukcjami projektu. To najbardziej dźwigniowa rzecz, jaką możesz zrobić w dniu migracji: dobry plik instrukcji to różnica między agentem, który pisze kod jak twój zespół, a takim, który wymyśla własne wzorce.

Plik różni się w zależności od narzędzia, ale treść jest taka sama — twoja architektura, reguły nazewnictwa, wymagania testowe i oczekiwania co do przepływu pracy.

Cursor

Cursor czyta pliki reguł z .cursor/rules/. Trzymaj je wąsko zakrojone — jeden plik na zagadnienie (architektura, testy, konwencje API), dzięki czemu możesz dołączać odpowiednie do każdego zadania.

---
description: API route conventions
globs: ["src/pages/api/**"]
---

- API routes live in src/pages/api/ with kebab-case filenames
- Validate input with Zod at the top of every handler
- Return typed JSON: `new Response(JSON.stringify(data), { status, headers })`
- Never log request bodies (they contain PII)

Claude Code

Claude Code czyta CLAUDE.md z katalogu głównego repozytorium. Skonsoliduj wszystko w jeden spójny dokument.

# Project Instructions

## Architecture
- Components in src/components/ (PascalCase), API routes in src/pages/api/ (kebab-case)
- State in TanStack Query; no global stores for server data

## Conventions
- TypeScript strict mode; named exports only; `unknown` over `any`

## Workflow
- Explain the plan before editing more than one file
- Run `npm test` after every significant change
- Use conventional commit messages

Codex

Codex czyta AGENTS.md z katalogu głównego repozytorium. Ponieważ Codex często działa autonomicznie, bądź bardziej preskryptywny i jawnie wypisz granice.

# Agent Instructions

## Conventions
- TypeScript strict mode, named exports only
- Components in src/components/, API routes in src/pages/api/

## Verification
- Run `npm test` and `npm run type-check` after changes

## Boundaries
- Do not modify src/auth/ without explicit approval
- Do not edit applied database migrations or delete test files

Wskazówka

Gotowy prompt do wygenerowania pliku instrukcji z istniejącego repozytorium:

“Analyze this repository and draft a project instructions file. Infer my conventions from the actual code, not from defaults: directory structure and naming patterns, the testing framework and how tests are organized, lint/formatter rules from the config files, the state-management and data-fetching approach, and the commit message style from git log. Output it as [a single CLAUDE.md | a single AGENTS.md | scoped files for .cursor/rules/]. Where the codebase is inconsistent, note the dominant pattern and flag the exception.”

Jeden nawyk, który się zmienia: opisuj, nie pisz

W tradycyjnym IDE wprowadzasz zmianę linia po linii i polegasz na Znajdź-i-zamień przy mechanicznych częściach. Przepływ pracy w podejściu AI-first odwraca to: opisujesz stan docelowy i ograniczenia, agent proponuje skoordynowany, wieloplikowy diff, a twoim zadaniem staje się przeglądanie zamiast pisania. Umiejętność, którą budujesz, to precyzyjne specyfikowanie, a nie szybsze pisanie.

Weź prawdziwe, rozpoznawalne zadanie — migrację modułu tras Express z obsługi błędów w stylu callbacków na async/await ze współdzielonym middleware obsługi błędów. W starym przepływie otwierałbyś każdy plik tras, przepisywał handlery ręcznie, aktualizował testy i miał nadzieję, że wyłapałeś każde miejsce wywołania. W nowym przepływie:

Cursor

Otwórz tryb Agent przez Cmd/Ctrl+I i opisz zmianę. Cursor ją zaplanuje, zedytuje każdy dotknięty plik i pokaże diff per plik do zaakceptowania lub odrzucenia.

Refactor src/routes/ from callback-style error handling to async/await.
Wrap each handler so thrown errors propagate to a shared
errorHandler middleware in src/middleware/error.ts (create it if it
doesn't exist). Update the matching tests in tests/routes/ and run
the suite. Show me the diff before applying.

Claude Code

Claude Code jest agentowy domyślnie — sam odkrywa dotknięte pliki, więc nie musisz ich oznaczać przez @. Przejrzyj potem przez git diff.

claude "Refactor src/routes/ from callback-style error handling to
async/await. Route thrown errors to a shared errorHandler middleware
in src/middleware/error.ts. Update tests in tests/routes/ and run
npm test. Plan the change before editing."

Codex

Przekaż zadanie Codeksowi i pozwól mu działać w sandboxie, a potem przejrzyj powstały diff. Dobre do dobrze zakrojonych refaktoryzacji, które potrafisz zdefiniować z góry.

codex "Refactor src/routes/ from callback-style error handling to
async/await, routing errors to a shared errorHandler middleware in
src/middleware/error.ts. Update tests in tests/routes/ and run
npm test to verify."

Mechanika się różni, ale dyscyplina jest identyczna we wszystkich trzech narzędziach: określ stan docelowy, nazwij pliki lub katalogi objęte zakresem, podaj sposób weryfikacji (uruchom testy) i przejrzyj diff, zanim mu zaufasz.

Wskazówka

Gotowy prompt do zakrojonej refaktoryzacji z przeglądem na początku:

“Refactor only the files I name — do not touch anything outside this scope. Target files: [list]. Goal: [describe the end state precisely]. Constraints: keep the public API of these modules unchanged, preserve existing behavior, and update the matching tests. Before editing, give me a one-paragraph plan and the list of files you intend to change. After editing, run the test suite and summarize what changed and why.”

Notatka

To także moment, w którym serwery MCP się opłacają. Podłącz serwer GitHub MCP, a agent otworzy PR dla refaktoryzacji; podłącz serwer Postgres MCP, a będzie mógł zweryfikować zmianę schematu względem twojej rzeczywistej bazy danych zamiast zgadywać. Wszystkie trzy narzędzia wspierają MCP. Cursor i Claude Code współdzielą ten sam kształt konfiguracji JSON mcpServers, więc wpis serwera kopiuje się wprost; Codex używa innego formatu — tabel [mcp_servers.<name>] w ~/.codex/config.toml — więc definiujesz tam każdy serwer od nowa (lub uruchamiasz codex mcp add).

Po który model sięgnąć

Przychodząc z IDE, w którym jedynym wyborem “modelu” był silnik autouzupełniania, picker modeli jest nowością. Rozsądna drabinka domyślna:

• Claude Fable 5 — najpotężniejszy model Anthropica (premiera 9 czerwca 2026). Sięgaj po niego przy najtrudniejszych refaktoryzacjach, budowie od zera i długich zadaniach, gdy ważniejsza jest prędkość i jakość niż koszt. Przełącz w Claude Code przez /model fable. Dostępny w pickerze modeli Cursora i przez API. ($10/$50 za milion tokenów; 2× Opus 4.8.) Szczegóły dot. planów zob. porównanie modeli.
• Claude Opus 4.8 — domyślny model Claude Code. Świetny do złożonej pracy wieloplikowej i agentowego planowania; dobry wybór na co dzień, gdy koszt Fable 5 jest czynnikiem.
• Claude Sonnet 4.6 — koń roboczy do rutynowych edycji i szybkiej iteracji, gdy liczy się koszt.
• GPT-5.5 — domyślnie napędza Codex na wszystkich powierzchniach; gpt-5.4-mini to tańsza opcja, która rozciąga twoje użycie, gdy trafisz na limity.
• Gemini 3.1 Pro — sięgnij po niego, gdy potrzebujesz ekstremalnego kontekstu albo analizy obrazu/wideo.

W Cursor picker sprawia, że przełączanie jest trywialne — zacznij od najmocniejszego modelu i schodź niżej tylko wtedy, gdy zależy ci na koszcie. W Claude Code i Codex ustaw model na sesję lub w konfiguracji.

Zmapuj stare funkcje na nowe

Większość tego, co robiło twoje IDE, wciąż istnieje — tylko jest sterowana opisem zamiast menu.

Tradycyjna funkcja	Cursor	Claude Code	Codex
Znajdź i zamień	Refaktoryzacja AI w trybie Agent	Edycja wieloplikowa z jednego promptu	Edycja wieloplikowa w zakresie zadania
IntelliSense	Uzupełnienia AI + Tab	Sugestie inline przez rozszerzenie do edytora	Uzupełnienia przez rozszerzenie do IDE
Debugger	Natywny debugger + diagnoza AI	Natywny debugger + AI z terminala	Natywny debugger + AI w IDE
Integracja Git	Wbudowana + wiadomości commit od AI	Git z CLI + wiadomości commit od AI	Git z CLI + wiadomości commit od AI
Rozszerzenia	Kompatybilne z Open VSX	Działa obok dowolnego edytora	Działa obok dowolnego edytora
Snippety	Generowane na żądanie	Generowane na żądanie	Generowane na żądanie

Uwaga

Autouzupełnianie inline to jedyna funkcja, która naprawdę się różni. Cursor ma pełne doświadczenie uzupełniania Tab, do którego przywykłeś. Claude Code i Codex są agent-first — nie zastępują autouzupełniania inline, więc jeśli żyjesz w uzupełnieniach, albo używaj obok nich uzupełnień swojego edytora, albo wybierz Cursor.

Kiedy coś się psuje

Krytycznego rozszerzenia nie ma w Open VSX. Cursor pobiera z Open VSX, więc zastrzeżonych rozszerzeń Microsoftu (część debuggerów, Live Share, niektóre pakiety językowe) może brakować. Poszukaj w Open VSX odpowiednika open-source albo zatrzymaj stare IDE do tego jednego przepływu, który go wymaga. Nie wgrywaj na ślepo plików VSIX z Marketplace — wiele rozszerzeń Microsoftu jest licencjonowanych wyłącznie do produktów Microsoftu.

Agent ignoruje konwencję, którą zapisałeś. Mgliste reguły dają mgliste przestrzeganie. Zastąp “use good error handling” konkretnym blokiem przykładowym w pliku instrukcji, pokazującym dokładnie ten wzorzec, którego chcesz. To konkretność sprawia, że reguły przyklejają się na dobre.

Agent nadmiernie refaktoryzuje. Przychodząc z ręcznej edycji, największym szokiem jest agent “pomocnie” przepisujący kod, którego nie prosiłeś go tknąć. Zakreślaj zakres każdego promptu: nazwij pliki lub katalog i dodaj “do not change anything outside these files”. W narzędziach autonomicznych ustaw --sandbox read-only lub --ask-for-approval on-request, dopóki nie zaufasz granicom.

W pierwszym tygodniu wydaje się wolniej. To prawda i tak ma być. Wymieniasz szybkość pisania na szybkość specyfikowania, a ta druga umiejętność potrzebuje paru tygodni, by się wyrobić. Zacznij na pobocznym projekcie o niskiej stawce lub na niekrytycznych ticketach, a nie na produkcyjnej ścieżce krytycznej, póki formują się nowe odruchy.

Pamięć mięśniowa pudłuje. Twoje stare skróty klawiszowe mogą kolidować ze skrótami AI (Cmd/Ctrl+K, Cmd/Ctrl+I). Przemapuj polecenia AI, zamiast uczyć się od nowa klawiszy edycji — tarcie znika, gdy tylko konflikty zostaną usunięte.

Co dalej

Migracja z GitHub Copilot Już na Copilocie? Przejdź z sugestii inline na pełne możliwości agentowe.

Migracja z Windsurf Zmapuj Cascade i Flows na Cursor, Claude Code i Codex.

Migracja między Codex, Cursor i Claude Code Strategie migracji między narzędziami dla zespołów wielonarzędziowych.

Playbook konwersji projektu Przygotuj dowolne repozytorium na AI z właściwym kontekstem i plikami konfiguracji.