Przejdź do głównej treści
Polski— Wybierz język
Menu

Twoje pierwsze zadanie w Codex

Lekcja 4 z 20 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Uruchomienie pierwszego zadania
  2. Z poziomu Codex Cloud
  3. Z poziomu IDE
  4. Z poziomu CLI
  5. Anatomia wyniku Codex
  6. Pisanie dobrych instrukcji
  7. Kluczowe wnioski

Zaktualizowano 3 listopada 2026 na podstawie dokumentacji poleceń Codex (CLI 0.166.0): opcje --show-diff i --apply nie istnieją. Lokalnie Codex modyfikuje pliki bezpośrednio wewnątrz swojego piaskownicy; przeglądaj zmiany za pomocą /diff lub git diff. Polecenie rozszerzenia „Codex: New Task“ zostało zastąpione przez Codex: Open Codex Sidebar. Źródła: Polecenia deweloperskie · Rozszerzenie IDE Codex.

Uruchomienie pierwszego zadania

Masz już skonfigurowane konto, połączenie z GitHubem jest aktywne, a plik AGENTS.md znajduje się na miejscu: czas zobaczyć agenta w akcji. Oto zasada obowiązująca dla każdego poziomu zaawansowania – zacznij od zadania, w przypadku którego już znasz poprawną odpowiedź. Nie nauczysz się wiele, obserwując, jak Codex rozwiązuje problem, którego nie potrafisz zweryfikować, natomiast nauczysz się ogromnej ilości rzeczy, obserwując jego działanie na znanym Ci gruncie.

Z poziomu Codex Cloud

W przeglądarce internetowej lub w aplikacji desktopowej wybierz Work in › Cloud, wskaż opublikowane środowisko dla swojego repozytorium (Lekcja 2) i wpisz swoje zadanie w polu wprowadzania. Celowo skromne sformułowanie sprawdzi się idealnie.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

To sformułowanie zawiera warunek – „jeśli jeszcze nie istnieje“ – co czyni obserwację szczególnie interesującą. W Codex Cloud zadanie uruchamia się w środowisku, które opublikowałeś dla tego repozytorium: Codex sprawdza, czy plik .gitignore istnieje, weryfikuje, czy obejmuje on Node.js i TypeScript (jeśli istnieje), tworzy lub aktualizuje plik w razie potrzeby, a następnie wyświetla wynik jako diff. Dziennik wykonania strumieniuje się w czasie rzeczywistym: to właśnie tam zobaczysz, czy agent uszanował warunek, czy może nadpisał istniejący plik.

Z poziomu IDE

Otwórz swój projekt w VS Code (lub Cursor, Windsurf) i uruchom Codex za pomocą jego ikony lub Palety poleceń:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Następnie sformułuj żądanie, które wykorzystuje lokalny kontekst, wskazując konkretny plik:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

Rozszerzenie wyświetla podsumowanie oraz zmodyfikowane linie obok kodu; zachowujesz zmiany, których potrzebujesz, i możesz zadawać pytania uzupełniające w ramach tej samej konwersacji. Dokumentacja zaleca utworzenie punktu kontrolnego Git przed i po zadaniu, aby w razie potrzeby móc cofnąć zmiany.

Z poziomu CLI

# Przejdź do katalogu projektu
cd my-project

# Rozpocznij sesję z początkową instrukcją
codex "Add a README.md with the project description, installation instructions, and available commands"

Lokalnie Codex modyfikuje pliki bezpośrednio w Twoim katalogu roboczym, w granicach piaskownicy i polityki zatwierdzania: przed podjęciem działań wymagających zgody, agent pyta o pozwolenie. Aby przejrzeć zmiany przed commitowaniem, wpisz /diff w sesji: polecenie wyświetla diff Git, uwzględniając również pliki nieśledzone. Polecenie /review prosi Codex o przeanalizowanie samego drzewa roboczego. W przypadku użycia skryptowego, codex exec uruchamia to samo zadanie bez interakcji (Lekcja 14) – w takim przypadku to Git i Twój pipeline decydują, co zostanie zachowane.

Anatomia wyniku Codex

Niezależnie od punktu wejścia, zakończone zadanie zawsze zwraca te same cztery elementy. Przejrzyj je w tej kolejności: diff mówi, co się zmieniło, dziennik wyjaśnia dlaczego, testy potwierdzają bezpieczeństwo, a dostępne działania oddają kontrolę z powrotem w Twoje ręce.

Dostarczony elementZawartość
Diff zmianKażda dodana, zmodyfikowana lub usunięta linia, plik po pliku
Dziennik wykonaniaWszystkie kroki: odczytane pliki, uruchomione polecenia, rozumowanie agenta
Wyniki testówJeśli testy istnieją, Codex uruchamia je, aby upewnić się, że nic nie zostało uszkodzone
Dostępne działaniaZatwierdź, zmodyfikuj, utwórz PR lub uruchom ponownie z innymi instrukcjami

Początkujący często pomijają dziennik wykonania, a jest to element, który uczy, jak formułować zadania. Obserwując, które pliki Codex otworzył przed podjęciem decyzji, dowiadujesz się, czego szukał, a czego nie mógł znaleźć – często jest to konwencja, która powinna była znaleźć się w pliku AGENTS.md.

Pisanie dobrych instrukcji

Jakość wyniku zależy bezpośrednio od jakości instrukcji, a różnica między poniższymi dwoma sformułowaniami jest znacznie większa niż różnica między dwoma modelami.

"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling 
with the jose library. Keep the same public interface 
(signToken, verifyToken). Update the corresponding tests."

Druga wersja działa, ponieważ odpowiada na cztery pytania, które agent i tak zadaje sobie sam. Wskazuje zaangażowane pliki, oszczędzając mu eksploracji i celowania w niewłaściwą lokalizację. Definiuje oczekiwany rezultat – zachowanie, interfejs, format – dzięki czemu agent wie, kiedy przestać. Ustala ograniczenia, w tym przypadku zachowanie publicznego interfejsu, co zapobiega „ulepszaniu“ rzeczy poprzez łamanie wywołań; w innych kontekstach może to być zasada „nie łam testów“. Gdy stawka tego wymaga, dodaje kontekst biznesowy: określenie „to jest formularz płatności, bezpieczeństwo jest kluczowe“ genuinie zmienia jego kompromisy.

Aby dostosować to do swoich potrzeb, weź istniejący projekt i połącz ze sobą trzy zadania o różnym charakterze: analiza bez modyfikacji („Wymień wszystkie pliki TypeScript, które nie mają powiązanych testów“); celowana generacja („Wygeneruj test jednostkowy dla tego pliku“); naprawa o ograniczonym zakresie („Napraw ostrzeżenia ESLint w src/utils/“). Dla każdego z nich zanotuj, co powinieneś był określić z góry: ta lista żalów stanowi Twój pierwszy szkic pliku AGENTS.md.

Kluczowe wnioski

  • Uruchamiaj swoje pierwsze zadania za pomocą prostych, celowanych próśb
  • Codex dostarcza kompletny dziennik wykonania dla każdego zadania
  • Jakość wyniku zależy od precyzji Twoich instrukcji
  • Zawsze zachowujesz kontrolę: zatwierdzaj, modyfikuj lub odrzucaj
  • Zacznij od zadań niskiego ryzyka, zanim przejdziesz do krytycznych zmian