Porady dotyczące CLI i komend slash

Otwierasz terminal, wpisujesz codex "fix the bug" i czekasz. Działa, ale to najwolniejszy sposób korzystania z CLI. Zaawansowani użytkownicy łączą sesje, przekierowują ustrukturyzowane wyjście, forkują konwersacje, gdy trafią w ślepy zaułek, i używają komend slash do uruchamiania przeglądów kodu bez opuszczania TUI. CLI Codex to pełne środowisko deweloperskie ukryte w pojedynczym pliku binarnym.

Co wyniesiesz z tego artykułu

• Wzorce zarządzania sesjami eliminujące ponowne wprowadzanie kontekstu
• Komendy slash do przeglądów, uprawnień i przełączania modeli
• Techniki wprowadzania obrazów do wizualnego debugowania z terminala
• Wzorce skryptowe z codex exec do automatyzacji
• Skróty klawiszowe i triki TUI oszczędzające czas przy każdej turze

Zarządzanie sesjami

Wznawiaj zamiast tłumaczyć od nowa

Najczęstsze marnotrawstwo w CLI to ponowne wyjaśnianie kontekstu. Zamiast tego użyj resume:

# Wznów ostatnią sesję
codex resume --last

# Wznów z dowolnego katalogu (nie tylko bieżącego)
codex resume --last --all

# Wznów konkretną sesję po ID
codex resume abc12345-...

# Wznów i od razu daj instrukcję kontynuacji
codex resume --last "The approach we discussed works. Implement it and run tests."

Wznowiona sesja przenosi cały transkrypt, więc Codex pamięta każdą decyzję, ograniczenie i plik, którego dotknął.

Forkuj, gdy chcesz eksplorować

Chcesz wypróbować alternatywne podejście bez utraty bieżącej konwersacji?

# Forkuj ostatnią sesję
codex fork --last

# Forkuj konkretną sesję
codex fork abc12345-...

To tworzy nowy wątek z pełnym transkryptem twojej poprzedniej sesji. Możesz rozgałęzić konwersację w innym kierunku, podczas gdy oryginał pozostaje nienaruszony.

Prompt: Forkuj i porównaj podejścia

Rozpocznij sesję:

codex "Propose two approaches for implementing caching in our API service"

Następnie sforkuj i zbadaj każde:

codex fork --last "Implement approach 1: Redis-based caching"
# W osobnym terminalu:
codex resume --last "Implement approach 2: In-memory LRU cache"

Porównaj wyniki z obu forków.

Nieinteraktywne wznawianie

Resume działa również z codex exec, więc możesz kontynuować zautomatyzowane sesje:

# Kontynuuj ostatnią sesję exec z nowymi instrukcjami
codex exec resume --last "Fix the race conditions you found"

# Wznów konkretną sesję exec
codex exec resume abc12345-... "Implement the plan"

Komendy slash

Wbudowane komendy

Wpisz je wewnątrz interaktywnego TUI:

Komenda	Co robi
/review	Otwiera menu przeglądu kodu
/fork	Forkuje bieżącą sesję
/model	Przełącza model w trakcie sesji
/permissions	Zmienia tryb zatwierdzania bez restartu
/status	Sprawdza pozostały kontekst, kredyty i załadowane pliki
/exit	Zamyka sesję
/feedback	Wysyła opinię do OpenAI
/skills	Przeglądaj i wywołuj dostępne umiejętności
/compact	Ręczne wyzwolenie kompaktowania kontekstu

Przegląd kodu z /review

/review otwiera menu z czterema presetami:

1. Przegląd względem gałęzi bazowej — Porównuje twoją pracę z bazą scalania upstream
2. Przegląd niezacommitowanych zmian — Sprawdza pliki staged, unstaged i untracked
3. Przegląd commita — Wybiera ostatni commit i analizuje dokładny zestaw zmian
4. Niestandardowe instrukcje przeglądu — Twój własny prompt (np. “Skup się na regresjach dostępności”)

Przegląd działa jako przejście tylko do odczytu i raportuje wyniki bez modyfikowania plików. Ustaw dedykowany model przeglądu w konfiguracji:

review_model = "gpt-5.3-codex"

Przełączanie uprawnień z /permissions

Zacząłeś w trybie tylko do odczytu, ale teraz ufasz agentowi na tyle, by włączyć pełny tryb auto? Przełącz bez restartu:

/permissions

Wybierz między Auto, Read-only i Full Access w trakcie sesji.

Skróty klawiszowe w TUI

Skrót	Co robi
@	Rozmyte wyszukiwanie plików — wstaw ścieżkę do wiadomości
!	Uruchom lokalne polecenie powłoki inline
Enter (podczas działania)	Wstrzyknij instrukcje do bieżącej tury
Tab (podczas działania)	Kolejkuj kontynuację na następną turę
Esc (2x)	Edytuj swoją poprzednią wiadomość
Esc (powtórzony)	Cofaj się przez wcześniejsze wiadomości, aby sforkować z dowolnego punktu
Ctrl + G	Otwórz edytor $VISUAL do pisania długich promptów
Ctrl + C	Anuluj bieżącą operację

Odwołanie do pliku z @

Wpisz @ w kompozytorze, a otworzy się rozmyte wyszukiwanie plików w twojej przestrzeni roboczej. Naciśnij Tab lub Enter, aby wstawić ścieżkę do wiadomości. To szybsze niż ręczne wpisywanie ścieżek i zapewnia dokładność.

Polecenie powłoki z !

Poprzedź linię znakiem !, aby uruchomić polecenie powłoki bez opuszczania TUI:

!git log --oneline -5
!npm test -- --filter=auth
!cat src/routes/users.ts | head -20

Codex traktuje wyjście jako kontekst dla twojego następnego promptu. Przydatne do przekazywania komunikatów błędów, wyników testów lub zawartości plików bezpośrednio do konwersacji.

Edytor Ctrl+G

Dla długich, wieloakapitowych promptów naciśnij Ctrl + G, aby otworzyć skonfigurowany edytor ($VISUAL lub $EDITOR). Napisz prompt w edytorze, zapisz i zamknij, a Codex go wyśle.

Prompt: Wydajny przepływ debugowania w CLI

# Zacznij od błędu
codex "Here's a test failure from our CI:
$(npm test -- --filter=payments 2>&1 | tail -30)
Find the root cause and fix it."

# Jeśli poprawka działa, ale wprowadza regresję:
codex resume --last "The fix works for payments but breaks the auth tests. Fix both without reverting."

Wznawianie przenosi pełny kontekst debugowania.

Dane wejściowe z obrazów

Z wiersza poleceń

# Pojedynczy obraz
codex -i screenshot.png "This screenshot shows a broken layout. Fix the CSS."

# Wiele obrazów
codex --image before.png,after.png "The first image is correct. The second shows a regression. Find what changed."

W interaktywnym TUI

Wklej obrazy bezpośrednio do kompozytora. Na macOS możesz zrobić zrzut ekranu za pomocą Cmd + Shift + 4 i wkleić obraz ze schowka.

Skryptowanie z codex exec

Podstawowa automatyzacja

# Zadanie nieinteraktywne
codex exec --full-auto "Fix the failing linter warnings and run the tests"

# Ze strukturyzowanym wyjściem JSON
codex exec --json --full-auto "Analyze the test coverage" 2>/dev/null | jq '.item.text'

# Przekieruj prompt ze stdin
echo "Explain the auth middleware in src/middleware/auth.ts" | codex exec -

Ustrukturyzowane wyjście ze schematami

Wymuś na Codex zwrócenie danych w określonym formacie:

codex exec --output-schema schema.json --full-auto "List all API endpoints with their HTTP methods and paths"

Gdzie schema.json definiuje oczekiwany kształt:

{
  "type": "object",
  "properties": {
    "endpoints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "method": { "type": "string" },
          "path": { "type": "string" },
          "description": { "type": "string" }
        }
      }
    }
  }
}

Zapisz ostatnią wiadomość

codex exec --output-last-message result.md --full-auto "Generate a changelog for the last 10 commits"

Ostatnia odpowiedź agenta jest zapisywana do result.md do dalszego przetwarzania.

Porady dotyczące katalogu roboczego

Zacznij z dowolnego katalogu

# Ustaw katalog roboczy bez cd
codex --cd /path/to/project "Analyze the codebase"

# Przyznaj dostęp do zapisu w dodatkowych katalogach
codex --cd apps/frontend --add-dir ../backend --add-dir ../shared "Coordinate changes across frontend and backend"

Pomiń sprawdzanie repozytorium Git

Dla jednorazowych zadań poza repozytorium Git:

codex exec --skip-git-repo-check "Generate a Python script that parses CSV files"

Zadania chmurowe z CLI

# Interaktywny selektor dla zadań chmurowych
codex cloud

# Prześlij zadanie bezpośrednio
codex cloud exec --env my-env-id "Run the full integration test suite and fix any failures"

# Prześlij z wieloma próbami best-of-N
codex cloud exec --env my-env-id --attempts 3 "Implement the caching layer"

# Wyświetl ostatnie zadania chmurowe
codex cloud list --json | jq '.tasks[] | {id, status, title}'

# Zastosuj diff z zadania chmurowego lokalnie
codex apply TASK_ID

Gdy coś się psuje

• Wznawianie sesji pokazuje zły kontekst: Sesje są domyślnie ograniczone do katalogu roboczego. Użyj --all, aby znaleźć sesje z innych katalogów.
• Uzupełnianie poleceń w powłoce się nie pojawia: Upewnij się, że linia eval jest po compinit w konfiguracji powłoki. Uruchom ponownie powłokę.
• codex exec się zawiesza: Agent może czekać na zatwierdzenie. Dodaj --full-auto lub --ask-for-approval on-request, aby uniknąć interaktywnych promptów w trybie nieinteraktywnym.
• Dane wejściowe z obrazu odrzucone: Codex akceptuje PNG i JPEG. Inne formaty mogą nie być obsługiwane. Skonwertuj za pomocą convert input.webp output.png przed załączeniem.
• Polecenie ! zablokowane: Sandbox nadal obowiązuje dla wbudowanych poleceń powłoki. Jeśli polecenie potrzebuje dostępu do zapisu lub sieci, dostosuj tryb sandboxa.

Co dalej

• Przepływy pracy w chmurze — Dogłębne omówienie wzorców zadań chmurowych
• Funkcje aplikacji — Wizualne przepływy pracy uzupełniające CLI
• Zaawansowane techniki — Wzorce dla zaawansowanych użytkowników na wszystkich powierzchniach