Mistrzostwo w aplikacji Codex

Masz monorepo z frontendem, backendowym API i współdzieloną biblioteką. Musisz zrefaktorować interfejs we współdzielonej bibliotece, zaktualizować konsumentów API i naprawić wynikające z tego błędy typów na frontendzie — wszystko tak, żeby trzy zadania nie wchodziły sobie nawzajem w pliki. Robienie tego sekwencyjnie oznacza czekanie; robienie tego w jednym wątku oznacza chaos. Aplikacja Codex została stworzona dokładnie do tego typu równoległej orkiestracji.

Codex App v260416 (16 kwietnia 2026)

Aplikacja Codex dodała w kwietniu 2026 kilka nowych możliwości, które zmieniają to, co jest osiągalne:

• Wbudowana przeglądarka: Wczytuj lokalne lub publiczne strony bez logowania; komentuj bezpośrednio na wyrenderowanych stronach.
• Obsługa komputera (macOS): Aplikacja może klikać, wpisywać i wchodzić w interakcję wizualnie — przydatne do testów UI lub sterowania inną aplikacją obok kodu.
• Chaty: Wątki niezależne od projektu, do badań i analizy. Zacznij Chat, gdy chcesz rozmowę niezwiązaną z konkretnym repo.
• Automatyzacje wątków: Zaplanuj wybudzenia zachowujące kontekst rozmowy — aplikacja wznawia wątek według twojego harmonogramu i wykonuje pracę.
• Pasek boczny zadań: Plany, źródła, artefakty i podsumowania żyją obok aktywnego wątku, zamiast przewijać się poza ekran.
• Przeglądy PR z GitHuba: Sprawdzaj diffy i komentarze recenzji wewnątrz aplikacji — bez wycieczki do przeglądarki.
• Podgląd artefaktów: PDF-y, arkusze, dokumenty i prezentacje renderują się inline.
• Wspomnienia: Przenoś kontekst z poprzednich zadań do nowych wątków.
• Zdalne połączenia (SSH, alpha): Połącz aplikację ze zdalną maszyną; Codex działa tam, podczas gdy ty kierujesz lokalnie.
• Multi-terminal i multi-window: Rozłóż równoległą pracę bez żonglowania jednym oknem naraz.
• System tray na Intel Macu i Windowsie: Pełnoprawne wsparcie na tych platformach.

Czego się nauczysz

• Workflow do zarządzania wieloma projektami i równoległymi wątkami w jednym oknie aplikacji Codex
• Techniki wykorzystania synchronizacji z IDE, dyktowania głosowego i inline’owego przeglądu diff, żeby skrócić czas review o połowę
• Strategia łączenia trybów Local, Worktree i Cloud w tej samej sesji
• Gotowe wzorce produkcyjne dla integracji skills i konfiguracji serwerów MCP w aplikacji

Orkiestracja wielu projektów

Sidebar aplikacji Codex to twoje centrum dowodzenia. Każdy projekt mapuje się na katalog na dysku i możesz przełączać się między nimi natychmiast. Kluczowa obserwacja jest taka, że każdy projekt utrzymuje własny sandbox, stan worktree i historię wątków.

1. Dodaj swoje projekty. Kliknij ”+” w sidebarze i wskaż katalog każdego codebase’u. W przypadku monorepo podziel odrębne pakiety na osobne projekty, żeby sandbox zawierał tylko istotne pliki.

2. Uruchom równoległe wątki. W ramach jednego projektu otwórz wiele wątków — jeden w trybie Local do szybkich edycji, jeden w trybie Worktree dla eksperymentalnego feature’a, jeden w trybie Cloud dla ciężkiego refaktoringu, który nie powinien blokować twojej maszyny.

3. Monitoruj skrzynkę. Wyniki automatyzacji i ukończone zadania chmurowe pojawiają się w sekcji Triage. Filtruj po “unread”, żeby skupić się na tym, co wymaga twojej uwagi.

Prompt: Konfiguracja równoległej pracy nad feature'ami

Otwórz trzy wątki Worktree w tym samym projekcie z tymi promptami:

Wątek 1: “Refactor the UserService interface to accept a generic ID type. Update all direct consumers in this package. Run the type checker after each change.”

Wątek 2: “Add integration tests for the payment webhook handler. Follow the patterns in tests/integration/. Run the test suite to verify.”

Wątek 3: “Update the API documentation in docs/api/ to reflect the new UserService interface. Cross-reference the existing OpenAPI spec.”

Synchronizacja z IDE: pomost między aplikacją a edytorem

Gdy rozszerzenie Codex IDE Extension jest zainstalowane w VS Code lub Cursor i zarówno aplikacja, jak i IDE wskazują na ten sam projekt, synchronizują się automatycznie. Daje ci to dwie supermoce:

Automatyczny kontekst — Aplikacja śledzi, które pliki masz otwarte w edytorze. Gdy pytasz “What’s this file about?” w aplikacji, wie, że chodzi o plik, na który patrzysz w VS Code.

Dwukierunkowa widoczność wątków — Wątki uruchomione w aplikacji pojawiają się w sidebarze rozszerzenia IDE i odwrotnie. Możesz uruchomić ciężkie zadanie w aplikacji, przełączyć się na IDE, żeby kontynuować kodowanie, i obserwować postęp wątku bez przełączania kontekstu.

Gdy synchronizacja wprowadza zamieszanie

Jeśli aplikacja dołącza kontekst, którego się nie spodziewałeś, wyłącz “Auto context” w kompozytorze i zadaj pytanie ponownie. Automatyczny kontekst jest pomocny przy reaktywnej pracy, ale może dodawać szum, gdy skupiasz się na konkretnym pliku, który nie jest aktualnie otwarty w edytorze.

Wybór właściwego trybu

Każdy nowy wątek w aplikacji Codex prosi cię o wybór trybu. Oto jak podjąć decyzję:

Tryb	Kiedy używać	Kompromis
Local	Szybkie edycje, debugowanie, eksploracja kodu	Zmiany zachodzą bezpośrednio w katalogu roboczym — ryzyko konfliktów, jeśli wiele wątków dotyka tych samych plików
Worktree	Praca nad feature’ami, eksperymenty, równoległe zadania	Izolacja Git worktree oznacza brak konfliktów, ale musisz zsynchronizować lub zmergować zmiany z powrotem
Cloud	Ciężkie refaktoringi, zadania do delegowania, mobilna segregacja	Działa zdalnie, wymaga skonfigurowanego środowiska, nie ma dostępu do narzędzi tylko lokalnych

Prompt: Delegowanie refaktoringu do chmury

“Migrate all class components in src/components/ to functional components with hooks. Preserve all existing prop interfaces and test coverage. Use the existing ESLint and Prettier configs for formatting. Run the full test suite before finishing.”

Wbudowany workflow Git

Aplikacja zawiera kompletny workflow Git: przegląd diff, komentowanie inline, staging, commitowanie, pushowanie i tworzenie PR-ów. Panel diff pokazuje standardowy zunifikowany diff twoich zmian. Możesz:

• Dodawać komentarze inline, które Codex uwzględni w następnej turze
• Stagować lub wycofywać poszczególne fragmenty lub całe pliki
• Commitować, pushować i otwierać PR bez opuszczania aplikacji

Dla wątków worktree użyj “Create branch here”, żeby zamienić detached HEAD w nazwany branch, a potem wypchnij bezpośrednio do remote’a.

Skills w aplikacji

Aplikacja obsługuje te same agent skills co CLI i rozszerzenie IDE. Kliknij “Skills” w sidebarze, żeby przeglądać dostępne skills we wszystkich projektach. Aby jawnie wywołać skill w wątku, poprzedź go $:

$recent-code-bugfix

Łącz skills z automatyzacjami do cyklicznych zadań. Na przykład skill $dependency-audit w połączeniu z tygodniową automatyzacją utrzymuje twoje zależności przejrzane bez ręcznego wysiłku.

Zaawansowane skróty klawiaturowe

Skrót	Akcja
Cmd + J	Przełącz wbudowany terminal
Cmd + K	Otwórz paletę poleceń
Ctrl + M (przytrzymaj)	Dyktowanie głosowe
Ctrl + L	Wyczyść terminal

Wbudowany terminal jest ograniczony do bieżącego projektu lub worktree. Używaj go do uruchamiania testów, sprawdzania statusu gita lub wykonywania dowolnych poleceń bez opuszczania aplikacji.

Prompt: Głosowa segregacja błędów

Przytrzymaj Ctrl + M i powiedz: “Look at the error in the Sentry screenshot I’m about to paste. Find the root cause in the codebase, propose a fix, and write a regression test.”

Następnie upuść zrzut ekranu do kompozytora, gdy transkrypcja jest widoczna.

Profile uprawnień (CLI v0.128+)

Wydanie z 30 kwietnia 2026 wprowadziło profile uprawnień — nazwane polityki sandbox + filesystem, między którymi przełączasz per-task bez przepisywania config.toml. Siedzą one na dwuwarstwowym modelu bezpieczeństwa (sandbox + zatwierdzenia), więc jeden nazwany profil ujmuje całą postawę.

Wbudowane profile

Wbudowane noszą wiodący dwukropek. Twoje własne profile go pomijają.

Profil	Co pozwala	Typowe użycie
:read-only	Odczyt filesystem; bez edycji, bez zapisów z shella	Code review, audyt bezpieczeństwa
:workspace	Odczyt + zapis w obrębie aktywnych rootów workspace	Domyślny dla większości zadań kodowania
:danger-full-access	Usuwa lokalne ograniczenia sandboxa — bez zatwierdzeń	Środowiska throwaway, runnery CI

Przełączanie profili

# Wewnątrz TUI — zmień postawę w trakcie sesji
/permissions

# Wczytaj profil konfiguracji, który przypina profil uprawnień (per-invocation)
codex --profile review

Zdefiniuj własne profile pod [permissions.<name>] w config.toml, a następnie ustaw domyślny za pomocą klucza najwyższego poziomu default_permissions. Najlepiej rozszerzaj wbudowany profil, żeby bazowe zabezpieczenia przeniosły się dalej — własny profil może rozszerzać :read-only lub :workspace, ale nigdy :danger-full-access.

# config.toml — postawa review rozszerzająca :read-only
[permissions.review]
extends = ":read-only"

# Uczyń ją domyślną dla tego projektu
default_permissions = "review"

Marketplace pluginów

Niedawne wydania CLI dodały system pluginów: drzewo poleceń codex plugin z zagnieżdżonym podpoleceniem marketplace do zarządzania źródłami, z których instalujesz. Najpierw dodaje się marketplace’y, a potem instaluje pluginy ze snapshotu skonfigurowanego marketplace’u.

# Zarejestruj źródło marketplace
# Akceptuje owner/repo, owner/repo@ref, URL git HTTPS/SSH lub lokalny katalog
codex plugin marketplace add my-org/my-plugin
codex plugin marketplace add my-org/my-plugin@v2          # przypnij ref inline...
codex plugin marketplace add my-org/my-plugin --ref v2    # ...albo równoważną flagą
codex plugin marketplace add ./local-plugin/ --sparse plugins/

# Wylistuj skonfigurowane marketplace'y i odśwież ich snapshoty
codex plugin marketplace list
codex plugin marketplace upgrade

# Zainstaluj plugin ze skonfigurowanego marketplace'u
codex plugin add openai-docs
codex plugin list

# Usuń zainstalowany plugin albo źródło marketplace
codex plugin remove openai-docs
codex plugin marketplace remove my-org/my-plugin

Wewnątrz TUI /plugins otwiera panel zarządzania z przeglądaniem w zakładkach, inline togglami i jedno-klikowym install/uninstall.

Autoryzacja AWS Bedrock

Codex CLI dostarcza wbudowanego providera modelu amazon-bedrock (podpisywanie SigV4, łańcuch poświadczeń AWS). Skieruj na niego Codex za pomocą klucza najwyższego poziomu model_provider, a następnie skonfiguruj profil i region AWS w tabeli providera [model_providers.amazon-bedrock.aws].

config.toml

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]
profile = "codex-bedrock"   # nazwany profil w ~/.aws/credentials
region  = "eu-central-1"    # lub twój region Bedrock

Dwie ścieżki autoryzacji

1. Klucz API Bedrock — wyeksportuj AWS_BEARER_TOKEN_BEDROCK ze swoim kluczem API Bedrock. Jeśli jest ustawiony, Codex używa go w pierwszej kolejności.
2. Łańcuch poświadczeń AWS SDK — jeśli nie ma tokena bearer, Codex wraca do standardowego łańcucha SDK, który honoruje nazwany profile powyżej (oraz zmienne środowiskowe, role instancji, SSO itd.).

Wybierz model serwowany przez Bedrock za pomocą /model gpt-5.5 (lub jakiegokolwiek id modelu Bedrock, które wystawia twoje konto — id wyglądają jak openai.gpt-5.5 albo openai.gpt-oss-120b). Połącz z profilami uprawnień, aby utrzymać mały blast radius — profil :read-only plus provider Bedrock daje ci w pełni izolowanego agenta review.

Gdy coś nie działa

• Konflikty branchy worktree: Git pozwala na checkout brancha tylko w jednym worktree naraz. Jeśli utworzysz branch na worktree i spróbujesz go checkoutować lokalnie, Git zgłosi błąd. Użyj “Sync with local” zamiast ręcznego checkoutu brancha.
• Miejsce na dysku z powodu worktree: Każdy worktree kopiuje cały twój repo. Archiwizuj wątki, których już nie potrzebujesz, żeby Codex mógł automatycznie wyczyścić worktree (starsze niż 4 dni lub gdy przekroczysz 10 worktree).
• Synchronizacja z IDE nie działa: Zarówno aplikacja, jak i rozszerzenie IDE muszą wskazywać na ten sam root projektu. Sprawdź, czy żadne z nich nie wskazuje na katalog nadrzędny lub podrzędny drugiego.
• Powiadomienia nie działają: Zweryfikuj ustawienia powiadomień w preferencjach aplikacji. Na macOS sprawdź też Ustawienia systemowe > Powiadomienia dla aplikacji Codex.

Co dalej

• Worktree — szczegółowy przewodnik — Opanuj workflow synchronizacji, branchowania i mergowania
• Automatyzacje — Skonfiguruj cykliczne zadania w tle raportujące do twojej skrzynki
• Środowiska chmurowe — Skonfiguruj zdalne wykonywanie dla ciężkich obciążeń