Integracja z GitHub

Twój zespół otwiera pull request, recenzent jest zajęty przez dwa dni, a PR leży bezczynnie. Tymczasem inny członek zespołu wspomina o bugu w issue i nikt nie ma przepustowości aby to zbadać. A co jeśli agent mógł przeglądać każdy PR w ciągu minut od otwarcia i zacząć pracować nad komentarzami do issues w momencie ich opublikowania? Dokładnie to robi Codex po połączeniu z GitHub.

Co wyniesiesz z tego przewodnika

Codex Cloud połączony z repozytorium GitHub
@codex review działający na pull requestach do przeglądów kodu na żądanie
Automatyczne przeglądy kodu włączone dla każdego nowego PR
Wzmianki @codex w issues i komentarzach PR wyzwalające zadania w chmurze
Wytyczne przeglądu w AGENTS.md dostosowujące co Codex oznacza
Działający workflow od issue przez PR do merge

Wymagania wstępne

Integracja z GitHub wymaga:

Subskrypcji ChatGPT (Plus, Pro, Business lub Enterprise) — uwierzytelnianie kluczem API nie obsługuje funkcji chmurowych
Środowiska Codex Cloud skonfigurowanego z twoim repozytorium
Dostępu administratora repozytorium (lub kogoś z dostępem administratora do zatwierdzenia aplikacji Codex GitHub)

Połączenie repozytorium z Codex Cloud

Otwórz chatgpt.com/codex w przeglądarce.
Przejdź do Settings > Environments i kliknij New Environment.
Połącz swoje konto GitHub jeśli jeszcze tego nie zrobiłeś. Instaluje to aplikację Codex GitHub na twoim koncie lub organizacji.
Wybierz repozytorium z którym chcesz aby Codex pracował.
Skonfiguruj środowisko: wybierz branch, ustaw wymagane zmienne środowiskowe i zdefiniuj polecenia konfiguracji (jak npm install lub pip install -r requirements.txt).
Zapisz środowisko. Codex może teraz uruchamiać zadania w chmurze dla tego repozytorium.

Przeglądy kodu na żądanie

Gdy twoje repozytorium jest połączone, każdy współpracownik może poprosić o przegląd Codex komentując pull request.

Poproś o przegląd

Dodaj komentarz na dowolnym PR:

@codex review

Codex reaguje emoji oczek aby potwierdzić żądanie, czyta diff PR-a i publikuje standardowy przegląd kodu GitHub z komentarzami inline — tak jak ludzki recenzent.

Skoncentruj przegląd

Możesz zawęzić przegląd do konkretnych zagadnień:

@codex review for security regressions

@codex review focusing on error handling and edge cases

@codex review the database migration for data loss risks

Prompt do przetestowania pierwszego przeglądu kodu:

Otwórz dowolny istniejący PR w połączonym repozytorium i skomentuj:

@codex review

W ciągu kilku minut Codex powinien opublikować przegląd. Jeśli nic się nie dzieje, zweryfikuj że repozytorium ma włączony Codex Cloud i że przegląd kodu jest włączony w ustawieniach.

Włączenie automatycznych przeglądów

Jeśli chcesz aby Codex przeglądał każdy PR bez pytania:

Przejdź do chatgpt.com/codex/settings/code-review.
Włącz Automatic reviews dla swojego repozytorium.
Zapisz. Od teraz Codex publikuje przegląd za każdym razem gdy nowy PR jest otwarty do przeglądu.

Automatyczne przeglądy używają tych samych wytycznych z twoich plików AGENTS.md. Codex domyślnie oznacza tylko problemy P0 i P1 — nie czepia się formatowania ani stylu chyba że twój AGENTS.md mu to każe.

Dostosowanie wytycznych przeglądu

Codex stosuje wytyczne z najbliższego AGENTS.md do każdego zmienionego pliku. Dodaj sekcję “Review guidelines” do AGENTS.md twojego projektu:

## Review guidelines

- Flag any API endpoint missing authentication middleware.
- Flag any database query using string interpolation instead of parameterized inputs.
- Verify that new dependencies have an active maintainer and more than 1000 weekly npm downloads.
- Treat typos in user-facing strings as P1 issues.
- Do not flag formatting issues -- ESLint handles those.

Dla kontroli specyficznej dla pakietu, umieszczaj bardziej ukierunkowany AGENTS.md głębiej w drzewie:

## Review guidelines

- Every change to payment logic must include a test case.
- Flag any modification to the refund flow that does not update the audit log.
- Verify PCI compliance: no card numbers logged, no plaintext storage.

Wyzwalanie zadań Cloud z GitHub

@codex review to jedno konkretne polecenie. Każda inna wzmianka @codex w komentarzu PR lub issue wyzwala ogólne zadanie w chmurze używając PR lub issue jako kontekstu.

Napraw błędy CI

Gdy CI jest na czerwono na PR, skomentuj:

@codex fix the CI failures

Codex uruchamia zadanie w chmurze, czyta logi CI, identyfikuje nieudane testy i pushuje commit z poprawką na branch PR-a.

Zaimplementuj z issue

Na issue opisującym buga lub prośbę o funkcję, skomentuj:

@codex implement this

Codex tworzy nowy branch, implementuje zmiany na podstawie opisu issue i otwiera PR.

Zaadresuj komentarze z przeglądu

Po przeglądzie PR ludzki recenzent może dodać feedback. Codex może go zaadresować:

@codex address the review feedback

Prompt do delegowania prawdziwego zadania z GitHub:

Otwórz issue w połączonym repozytorium i skomentuj:

@codex investigate this issue, identify the root cause, and suggest a fix in a new PR

Obserwuj dashboard Codex Cloud pod chatgpt.com/codex aby monitorować postęp w czasie rzeczywistym.

Pełny workflow PR

Oto jak wygląda pełny workflow z Codex i GitHub:

Deweloper otwiera issue opisujące buga.
Deweloper (lub bot) komentuje @codex implement a fix for this issue.
Codex Cloud uruchamia zadanie, czyta issue, klonuje repozytorium, identyfikuje przyczynę, implementuje poprawkę i otwiera PR.
Codex automatycznie przegląda PR (jeśli automatyczne przeglądy są włączone) lub członek zespołu komentuje @codex review.
Ludzki recenzent czyta przegląd Codex, dodaje własny feedback.
Jeśli potrzebne są zmiany, skomentuj @codex address the review feedback na PR.
Codex pushuje kolejne commity.
Recenzent zatwierdza i merguje.

Lokalne powierzchnie i Git

Aplikacja, CLI i rozszerzenie IDE również integrują się z Git, ale pracują z twoim lokalnym repozytorium a nie przez API GitHub.

Aplikacja Codex ma wbudowane narzędzia Git: przeglądanie diff-ów, stagowanie/unstage-owanie plików i hunków, commitowanie, pushowanie i tworzenie PR-ów bezpośrednio z panelu przeglądu. Wątki Worktree automatycznie tworzą izolowane branche.

CLI uruchamia polecenia git w katalogu twojego projektu. Poproś Codex o commitowanie, pushowanie lub tworzenie branchy. Użyj /review w TUI do lokalnego przeglądu kodu przed pushowaniem.

Gdy coś nie działa

@codex nie odpowiada na komentarze: Zweryfikuj że aplikacja Codex GitHub jest zainstalowana na organizacji/koncie repozytorium. Sprawdź czy repozytorium ma skonfigurowane środowisko Codex Cloud. Aplikacja Codex potrzebuje dostępu do odczytu i zapisu komentarzy.

Przegląd nie oznacza oczekiwanych problemów: Codex domyślnie oznacza tylko problemy P0 i P1. Dodaj jawne wytyczne przeglądu do AGENTS.md. Na przykład dodaj “Treat typos in docs as P1” jeśli chcesz aby Codex wyłapywał literówki.

Zadanie Cloud nie tworzy PR: Sprawdź konfigurację środowiska pod chatgpt.com/codex. Upewnij się że polecenia konfiguracji uruchamiają się pomyślnie (Codex musi zbudować projekt). Sprawdź czy uprawnienia brancha na GitHub pozwalają aplikacji Codex na pushowanie.

Błąd “MFA required”: Codex Cloud wymaga uwierzytelniania wieloskładnikowego. Włącz MFA na swoim koncie ChatGPT (lub u dostawcy logowania społecznościowego).

Codex tworzy PR, ale CI nie przechodzi: Codex nie zawsze uruchamia pełny pipeline CI przed otwarciem PR. Dodaj "Always run the test suite before opening a PR" do wytycznych przeglądu w AGENTS.md, aby Codex uwzględnił ten krok.

Prompt do weryfikacji integracji z GitHub od początku do końca:

Utwórz testowe issue w połączonym repozytorium:

Title: Test: Codex GitHub integration
Body: @codex tell me about this repository's structure

Jeśli Codex odpowie komentarzem o strukturze twojego repozytorium, integracja działa w pełni.

Co dalej

Uruchom swoje pierwsze zadanie Wykonaj prawdziwe zadanie Codex na wszystkich czterech powierzchniach i zobacz wyniki