Migracja między Codex, Cursor i Claude Code

Twój zespół używa Cursor do codziennej pracy, ale właśnie widziałeś demo, w którym ktoś uruchomił pięć zadań Codex równolegle i przejrzał wyniki w dwadzieścia minut. Albo używasz Codex do asynchronicznego refaktoringu, ale potrzebujesz interaktywnego debugowania, które zapewnia Claude Code. Albo chcesz używać wszystkich trzech narzędzi do różnych scenariuszy — Cursor do pracy w IDE, Claude Code do operacji CLI i Codex do zadań w tle — i potrzebujesz, żeby wszystkie czytały te same konwencje.

Ten przewodnik obejmuje każdy kierunek migracji między trzema narzędziami, w tym sposób ich jednoczesnego uruchamiania bez konfliktów konfiguracji.

Czego się nauczysz

• Translacja konfiguracji między CLAUDE.md, AGENTS.md i .cursor/rules/
• Mapowanie przepływów pracy dla typowych zadań we wszystkich trzech narzędziach
• Konfiguracja wielonarzędziowa utrzymująca zsynchronizowane konwencje
• Migracja konfiguracji MCP między narzędziami
• Framework decyzyjny, które narzędzie wybrać do jakiego zadania

Translacja konfiguracji

Największym zadaniem migracyjnym jest przetłumaczenie instrukcji projektu między trzema formatami. Każde narzędzie czyta konwencje z innej lokalizacji.

Narzędzie	Lokalizacja konfiguracji	Format	Zakres
Cursor	.cursor/rules/*.md	Wiele plików markdown	Oddzielne pliki per reguła
Claude Code	CLAUDE.md (root)	Pojedynczy plik markdown	Cały projekt
Codex	AGENTS.md (root)	Pojedynczy plik markdown	Cały projekt

Z AGENTS.md do CLAUDE.md

Jeśli przenosisz się z Codex do Claude Code, twój AGENTS.md tłumaczy się niemal bezpośrednio na CLAUDE.md. Formaty są podobne — oba to pliki markdown w korzeniu repozytorium, które agent czyta na początku sesji.

cp AGENTS.md CLAUDE.md

Następnie wprowadź te poprawki:

# Poprawki w CLAUDE.md po skopiowaniu z AGENTS.md

## Co zmienić:

# 1. Dodaj polecenia workflow, które Claude Code może uruchomić lokalnie
## Key Commands
- npm run dev         # Start dev server
- npm run test        # Run test suite
- npm run lint        # Check linting

# 2. Usuń instrukcje specyficzne dla sandboxa Codex
# (Codex działa w izolowanym sandboxie; Claude Code działa na twoim komputerze)
# USUŃ: "You are running in a sandboxed environment"
# USUŃ: "Do not attempt to access the network"

# 3. Dodaj wskazówki dotyczące interaktywnego przepływu pracy
# Claude Code obsługuje rozmowę w obie strony,
# więc dodaj instrukcje, kiedy prosić o wyjaśnienia
## Workflow
- For ambiguous requirements, ask for clarification before proceeding
- Use /think for complex architectural decisions
- Run tests after every significant change

Wskazówka

Gotowy prompt do konwersji AGENTS.md na CLAUDE.md:

“Read AGENTS.md and convert it to a CLAUDE.md file. Remove any Codex-specific sandbox instructions. Add a ‘Key Commands’ section listing the build, test, lint, and dev commands from package.json. Add workflow instructions for interactive development (asking for clarification, using /think for planning, running tests incrementally). Keep all coding conventions and architecture rules unchanged.”

Z CLAUDE.md do AGENTS.md

Przejście z Claude Code do Codex wymaga bardziej preskryptywnych instrukcji, ponieważ Codex działa autonomicznie bez interaktywnego feedbacku.

cp CLAUDE.md AGENTS.md

Poprawki:

# Poprawki w AGENTS.md po skopiowaniu z CLAUDE.md

## Co zmienić:

# 1. Dodaj jawne polecenia weryfikacyjne
## Verification
- After making changes, run: npm test
- After modifying API routes, run: npm run type-check
- After changing database schemas, run: npm run db:migrate

# 2. Dodaj granice dla autonomicznego działania
## Boundaries
- Do not modify files in migrations/ that have already been applied
- Do not delete test files
- Do not change environment variable names without updating .env.example
- Do not install new dependencies without explicit instruction

# 3. Usuń instrukcje interaktywne
# USUŃ: "Ask for clarification if requirements are ambiguous"
# USUŃ: "Use /think for complex decisions"
# Codex nie może zadawać pytań w trakcie zadania -- musi pracować z tym, co ma

# 4. Bądź bardziej precyzyjny we wzorcach
# Zamiast "follow our component pattern", pokaż dokładny wzorzec:
## Component Pattern
Every new component must follow this structure:
```tsx
interface ComponentNameProps {
  // props here
}
export function ComponentName({ ...props }: ComponentNameProps) {
  // implementation
}
```

Z .cursor/rules/ do CLAUDE.md lub AGENTS.md

Cursor używa wielu plików reguł. Claude Code i Codex używają pojedynczego pliku. Skonsoliduj.

Do CLAUDE.md

# Połącz wszystkie reguły Cursor w CLAUDE.md
echo "# Project Instructions" > CLAUDE.md
echo "" >> CLAUDE.md
for file in .cursor/rules/*.md; do
  cat "$file" >> CLAUDE.md
  echo -e "\n" >> CLAUDE.md
done

Następnie edytuj CLAUDE.md, aby:

• Usunąć zduplikowane nagłówki
• Zorganizować w logiczne sekcje (Architecture, Conventions, Testing, Workflow)
• Dodać sekcję Key Commands
• Dodać instrukcje przepływu pracy specyficzne dla Claude Code

Do AGENTS.md

# Połącz wszystkie reguły Cursor w AGENTS.md
echo "# Agent Instructions" > AGENTS.md
echo "" >> AGENTS.md
for file in .cursor/rules/*.md; do
  cat "$file" >> AGENTS.md
  echo -e "\n" >> AGENTS.md
done

Następnie edytuj AGENTS.md, aby:

• Usunąć zduplikowane nagłówki
• Dodać polecenia weryfikacyjne dla każdego typu zmiany
• Dodać jawne granice dla autonomicznego działania
• Usunąć wszelkie instrukcje specyficzne dla interaktywności/GUI

Z CLAUDE.md lub AGENTS.md do .cursor/rules/

W drugą stronę — podziel pojedynczy plik na skupione pliki reguł.

mkdir -p .cursor/rules

Utwórz oddzielne pliki dla każdego obszaru:

.cursor/rules/
  architecture.md        # Struktura plików, granice modułów
  code-conventions.md    # Nazewnictwo, importy, wzorce TypeScript
  testing.md             # Struktura plików testowych, frameworki, pokrycie
  git-workflow.md        # Wiadomości commitów, format PR, branching
  api-patterns.md        # Struktura routów, obsługa błędów, autoryzacja

Wskazówka

Gotowy prompt do podziału na reguły Cursor:

“Read CLAUDE.md (or AGENTS.md) and split it into separate .cursor/rules/ files. Create one file per concern: architecture.md, code-conventions.md, testing.md, git-workflow.md, and api-patterns.md. Each file should be self-contained and focused on a single topic. Remove any CLI-specific instructions and add Cursor-specific guidance where appropriate (use @codebase for searching, use Agent Mode for multi-file changes).”

Migracja konfiguracji MCP

Serwery MCP są konfigurowane inaczej w każdym narzędziu, ale same serwery są takie same.

Konfiguracja MCP Cursor

Cursor przechowuje konfigurację MCP w .cursor/mcp.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://localhost:5432/mydb"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Konfiguracja MCP Claude Code

Claude Code używa polecenia claude mcp add lub .mcp.json:

# Dodaj przez CLI
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres
claude mcp add context7 -- npx -y @upstash/context7-mcp

Lub utwórz .mcp.json w korzeniu projektu w tym samym formacie co Cursor:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token"
      }
    }
  }
}

Konfiguracja MCP Codex

Codex ma ograniczone wsparcie MCP w porównaniu z Cursor i Claude Code. Używa głównie wbudowanych integracji:

# Codex używa własnego formatu konfiguracji
# Sprawdź aktualną dokumentację Codex pod kątem statusu wsparcia MCP

Dla narzędzi, których Codex nie obsługuje przez MCP, podaj dane w opisie zadania lub umieść odpowiednie pliki w repozytorium, aby sandbox miał do nich dostęp.

Skrypt migracyjny

Użyj tego wzorca do tłumaczenia konfiguracji MCP między narzędziami:

# Skopiuj konfigurację MCP Cursor do Claude Code
cp .cursor/mcp.json .mcp.json

# Skopiuj konfigurację MCP Claude Code do Cursor
cp .mcp.json .cursor/mcp.json

Format JSON jest kompatybilny między Cursor i Claude Code. Zweryfikuj, że zmienne środowiskowe (tokeny API) są prawidłowo ustawione dla środowiska uruchomieniowego każdego narzędzia.

Translacja przepływów pracy

Interaktywna praca deweloperska

Zadanie	Cursor	Claude Code	Codex
Napisz nową funkcję	Agent Mode w Composer	Opisz w rozmowie	Utwórz zadanie
Zdebuguj test	Agent Mode + terminal	Rozmowa + automatyczne uruchamianie testów	Zadanie z wynikami testów
Refaktoruj wiele plików	Agent Mode (auto-edycje)	Rozmowa (auto-edycje)	Zadanie (zwraca diffy)
Przeglądnij PR	BugBot lub ręczny przegląd	claude "Review PR #123"	Zadanie: “Review changes in PR #123”
Wygeneruj testy	Agent Mode: “Write tests for…"	"Write tests for…”	Zadanie: “Write tests for…”

Praca w tle i równoległa

To jest obszar, w którym Codex się wyróżnia, a inne narzędzia mają ograniczenia.

Cursor

Cursor jest interaktywny i jednowątkowy. Możesz uruchomić tylko jedną rozmowę Agent Mode na raz w jednym oknie. Do pracy równoległej otwórz wiele okien Cursor.

# Okno 1: Rozwój funkcji
"Implement the user profile page with avatar upload"

# Okno 2: Naprawa błędu
"Fix the race condition in the payment processing queue"

To jest mało eleganckie, ale działa.

Claude Code

Claude Code obsługuje uruchamianie wielu sesji terminalowych. Możesz prowadzić równoległe rozmowy w oddzielnych kartach terminala.

# Terminal 1
claude "Implement the user profile page with avatar upload"

# Terminal 2
claude "Fix the race condition in the payment processing queue"

Każda sesja jest niezależna. Uważaj, gdy obie sesje edytują te same pliki.

Codex

Codex jest zbudowany do wykonywania równoległego. Uruchom wiele zadań, a będą działać jednocześnie w izolowanych sandboxach.

# Wszystkie trzy działają równolegle
codex "Implement the user profile page with avatar upload"
codex "Fix the race condition in the payment processing queue"
codex "Refactor the notification service to use the event bus pattern"
codex "Add comprehensive tests for the billing module"
codex "Update API documentation for all v2 endpoints"

Każde zadanie działa we własnym sandboxie z pełną kopią twojego repozytorium. Brak konfliktów między zadaniami. Przejrzyj i scal wyniki po ich zakończeniu.

Wskazówka

Gotowy prompt do planowania przepływu wielonarzędziowego:

“I want to use Cursor for interactive development, Claude Code for CLI automation and debugging, and Codex for background refactoring tasks. Given my current project (analyze the codebase), suggest which pending tasks should go to which tool. Prioritize interactive work for Cursor, terminal-heavy operations for Claude Code, and well-defined refactoring for Codex.”

Konfiguracja wielonarzędziowa

Wiele zespołów używa wszystkich trzech narzędzi jednocześnie. Kluczem jest utrzymanie zsynchronizowanych konfiguracji.

Zsynchronizowana konfiguracja

Utwórz skrypt generujący wszystkie trzy formaty konfiguracji z jednego źródła prawdy:

scripts/sync-ai-config.sh

#!/bin/bash
# Generuje .cursor/rules/, CLAUDE.md i AGENTS.md z jednego źródła

SOURCE="docs/ai-conventions.md"

# Generuj CLAUDE.md
echo "# CLAUDE.md - Auto-generated from $SOURCE" > CLAUDE.md
echo "" >> CLAUDE.md
cat "$SOURCE" >> CLAUDE.md
echo "" >> CLAUDE.md
cat docs/claude-code-specific.md >> CLAUDE.md

# Generuj AGENTS.md
echo "# AGENTS.md - Auto-generated from $SOURCE" > AGENTS.md
echo "" >> AGENTS.md
cat "$SOURCE" >> AGENTS.md
echo "" >> AGENTS.md
cat docs/codex-specific.md >> AGENTS.md

# Generuj reguły Cursor
mkdir -p .cursor/rules
cp docs/cursor-rules/*.md .cursor/rules/

echo "AI configurations synchronized from $SOURCE"

Synchronizacja MCP

# Użyj jednego źródła MCP i skopiuj do obu narzędzi
cp mcp-config.json .cursor/mcp.json
cp mcp-config.json .mcp.json

Przenośność Skills

Skills zainstalowane przez npx skills add działają w Cursor i Claude Code. CLI skills wykrywa, które narzędzia są obecne i instaluje w odpowiednich lokalizacjach:

# Instaluje zarówno do .cursor/rules/ jak i .claude/skills/
npx skills add vercel-labs/agent-skills

Framework decyzyjny: które narzędzie do jakiego zadania

Scenariusz	Najlepsze narzędzie	Dlaczego
Interaktywne pisanie nowych funkcji	Cursor	Integracja z IDE, wizualny feedback, edycje inline
Debugowanie z wyjściem terminala	Claude Code	Bezpośredni dostęp do terminala, automatyczne wykonywanie poleceń
Wsadowy refaktoring (5+ niezależnych zmian)	Codex	Równoległe wykonanie w chmurze, bez zużycia lokalnych zasobów
Przegląd kodu	Claude Code lub Cursor	Oba mają silne możliwości przeglądu
Szybkie prototypowanie	Cursor	Najszybsza pętla feedbacku z sugestiami inline
Debugowanie CI/CD	Claude Code	Natywny dla terminala, może uruchamiać potoki lokalnie
Generowanie dokumentacji	Codex	Dobrze zdefiniowane zadanie, nie wymaga interakcji
Audyt bezpieczeństwa	Claude Code	Głęboka analiza wymaga interaktywnego kontynuowania
Migracja legacy kodu	Codex	Zmiany na dużą skalę dobrze działają równolegle
Programowanie w parze	Cursor	Najbardziej przypomina współpracownika w IDE

Wskazówka

Gotowy prompt do wyboru narzędzia:

“I need to [describe task]. I have access to Cursor, Claude Code, and Codex. Based on whether this task is interactive or async, whether it involves terminal operations, and how well-defined the requirements are, which tool should I use? Explain why.”

Ścieżka migracji według kierunku

Dodanie Codex do istniejącej konfiguracji Cursor + Claude Code

Jeśli już używasz Cursor i Claude Code i chcesz dodać Codex do równoległej pracy w tle:

1. Utwórz AGENTS.md. Zacznij od CLAUDE.md i dodaj instrukcje specyficzne dla Codex (polecenia weryfikacyjne, granice, jawne wzorce).

2. Zidentyfikuj zadania dla Codex. Szukaj dobrze zdefiniowanych, niezależnych zadań: generowanie testów, aktualizacje dokumentacji, poprawki lintingu, aktualizacje zależności, generowanie klientów API.

3. Zacznij od zadań niskiego ryzyka. Używaj Codex do zadań, gdzie nieprawidłowy wynik jest łatwy do wykrycia: generowanie testów (uruchom testy), dokumentacja (przejrzyj tekst), formatowanie (sprawdź diff zmian).

4. Dokładnie przeglądaj wyniki Codex. Codex działa autonomicznie. Nie zadaje pytań wyjaśniających. Sprawdź dokładnie, czy wyniki odpowiadają twoim oczekiwaniom przed scaleniem.

5. Skaluj stopniowo. W miarę poznawania, jakie zadania Codex dobrze obsługuje, przenoś więcej pracy w tle do niego. Zachowaj interaktywną i eksploracyjną pracę w Cursor i Claude Code.

Przejście z Codex do Cursor do codziennej pracy

Jeśli głównie korzystałeś z Codex i chcesz interaktywnego doświadczenia Cursor:

1. Zainstaluj Cursor. Zaimportuj ustawienia VS Code, jeśli dotyczy.

2. Przetłumacz AGENTS.md na .cursor/rules/. Podziel pojedynczy plik instrukcji na skupione pliki reguł (architecture, conventions, testing, workflow).

3. Skonfiguruj serwery MCP w Cursor. Skopiuj konfigurację MCP, dostosowując do formatu .cursor/mcp.json Cursor.

4. Naucz się interaktywnego przepływu. Ćwicz z Agent Mode (Cmd+I), autouzupełnianiem Tab i @-mentions. Interaktywna pętla jest bardzo różna od asynchronicznego przesyłania zadań.

5. Zachowaj Codex do pracy w tle. Nie musisz wybierać jednego narzędzia. Używaj Cursor do interaktywnej pracy, a Codex do równoległych zadań wsadowych.

Przejście z Codex do Claude Code do pracy CLI

Jeśli preferujesz terminal i chcesz więcej interaktywnej kontroli niż zapewnia Codex:

1. Zainstaluj Claude Code. npm install -g @anthropic-ai/claude-code

2. Przekonwertuj AGENTS.md na CLAUDE.md. Usuń instrukcje specyficzne dla sandboxa, dodaj wskazówki dotyczące interaktywnego przepływu i kluczowe polecenia.

3. Zmigruj konfigurację MCP. Użyj claude mcp add lub skopiuj do .mcp.json.

4. Dostosuj swój przepływ pracy. Claude Code jest synchroniczny i interaktywny. Zamiast przesyłać zadania i przeglądać później, prowadzisz rozmowę i kierujesz pracą w czasie rzeczywistym.

5. Korzystaj z rozszerzonego myślenia. Polecenie /think w Claude Code daje ci możliwość planowania, którą Codex obsługuje niejawnie. Używaj go do złożonych zadań.

Kiedy coś się psuje

Konfiguracje rozjeżdżają się między narzędziami. Jeśli aktualizujesz CLAUDE.md, ale zapominasz zaktualizować AGENTS.md i .cursor/rules/, narzędzia dają różne wyniki. Użyj skryptu synchronizacji powyżej lub dodaj sprawdzenie CI weryfikujące, czy pliki są zsynchronizowane.

Tokeny MCP wygasają w jednym narzędziu, ale nie w innym. Każde narzędzie zarządza uwierzytelnianiem MCP niezależnie. Gdy token wygaśnie, może być konieczna aktualizacja w wielu lokalizacjach. Rozważ użycie zmiennych środowiskowych, które wszystkie narzędzia czytają z tego samego pliku .env.

Codex daje inne wyniki niż Claude Code dla tego samego promptu. Narzędzia używają różnych modeli (Codex domyślnie codex-mini, Claude Code używa Claude). Prompty, które dobrze działają dla jednego modelu, mogą wymagać dostosowania dla innego. Bądź bardziej precyzyjny w promptach Codex, ponieważ nie ma możliwości doprecyzowania.

Konflikty plików przy równoległym uruchamianiu narzędzi. Jeśli Cursor i Claude Code jednocześnie edytują pliki w tym samym katalogu, pojawią się konflikty. Pracuj nad różnymi obszarami bazy kodu lub koordynuj, które narzędzie jest aktywne na których plikach.

Skills instalują się dla jednego narzędzia, ale nie innego. CLI skills może nie wykryć wszystkich narzędzi. Zweryfikuj instalację, sprawdzając zarówno .cursor/rules/ jak i .claude/skills/ po uruchomieniu npx skills add.

Co dalej

Migracja z Windsurf Przejście z Windsurf do dowolnego z trzech głównych narzędzi AI do kodowania.

Migracja z GitHub Copilot Upgrade z autouzupełniania do pełnych możliwości agentowych.

Playbook konwersji projektu Przygotuj swój projekt na AI z odpowiednią konfiguracją dla wszystkich narzędzi.