Jak ustawić przegląd kodu OpenQodex w Claude Code

Co robi

Gdy asystent AI pisze za Ciebie kod, nikt nie sprawdza go drugi raz. OpenQodex dodaje to drugie sprawdzenie, zanim wyślesz (push) swoją pracę na GitHub lub na serwer.

Najpierw uruchamia darmowe programy skanujące, takie jak gitleaks, który szuka wyciekłych haseł, na plikach, które są objęte Twoją zmianą. Potem startuje osobną sesję Claude Code lub Codexa w roli recenzenta. Dzięki temu asystent, który napisał kod, nie ocenia sam siebie. Recenzent musi przyjąć lub odrzucić każde zgłoszenie skanera i podać powód.

W czacie dostajesz krótkie potwierdzenie, a pełny raport jako stronę HTML. Potem Twój asystent pyta, które zgłoszenia poprawić. Bramka push może Cię ostrzec albo zablokować wysyłkę, gdy nie było przeglądu.

Przykładowe prośby

„sprawdź moją zmianę przez openqodex”
„Popraw zgłoszenia 2 i 3 z raportu openqodex, resztę zostaw”
„Wyjaśnij raport openqodex prostymi słowami”
„Uruchom openqodex na całym projekcie, nie tylko na mojej ostatniej zmianie”

Jak zainstalować

$ npx openqodex init

Jak tego używać

Powiedz swojemu asystentowi: sprawdź moją zmianę przez openqodex. Potem odpowiedz, które zgłoszenia ma poprawić.

Sprawdź, czy działa

Komenda npx openqodex init pokazuje listę plików, które zapisze, i pyta o zgodę tylko raz. Potem wpisz w terminalu komendę ~/.openqodex/bin/openqodex review; na końcu zobaczysz potwierdzenie i ścieżkę do pliku report.html (z README).

Częste problemy

Brak dostępnego recenzenta — „Full review unavailable” — zainstaluj Claude Code lub Codexa i zaloguj się; wyniki skanerów są w tym czasie zapisywane bez sprawdzenia — https://github.com/openqodex/openqodex
Jeden z etapów się nie wykonał — „Review incomplete” — raport podaje, którego etapu brakuje; napraw go (często brakuje środowiska uruchomieniowego dla jakiegoś języka) i uruchom przegląd jeszcze raz — to samo README

Na co uważać

Wysyła Twoją zmianę w kodzie do usługi modelu AI, z której korzystasz po zalogowaniu w Claude Code lub Codexie
Przy pierwszym użyciu pobiera programy skanujące; niektóre skanery korzystają z sieci
Dodaje do Twojej konfiguracji hook git pre-push oraz hooki agentów
Stworzony dla macOS i Linuksa; w Windowsie użyj WSL (strona npm), ale README mówi, że nie było takich testów

Licencja i autor

Licencja: Apache-2.0
Autor: openqodex
Kod źródłowy: github.com/openqodex/openqodex

Jak to testowaliśmy

13 października 2026 zainstalowaliśmy ten dodatek na czystym komputerze testowym. Zainstalowaliśmy go i uruchomiliśmy w czystym systemie testowym. Jeszcze nieużywane w prawdziwej pracy.

Poziom testu

Jeszcze nie użyty przy prawdziwej pracy.

Szczegóły techniczne testu

Data: 13 października 2026
Metoda: Uruchomienie w piaskownicy 13 października 2026 w czystym kontenerze, bez konta: sklonowanie repozytorium, sprawdzenie plików umiejętności (skills), agentów i wtyczki (plugin) oraz uruchomienie komendy „npx -y openqodex --help”.

Sprawdzone ponownie: 13 października 2026

Alternatywy

Security Guidance — wtyczka Anthropic, która sprawdza kod w Claude Code w trakcie pracy
Gitleaks — sam skaner sekretów, bez recenzenta AI

FAQ

P: Czy potrzebuje własnego klucza API? O: Nie, korzysta z Twojego dotychczasowego logowania w Claude Code lub Codexie.
P: Czy zablokuje moje wysyłki? O: Tylko jeśli ustawisz review.block_on_severity w pliku .openqodex/config.yaml; domyślnie tylko ostrzega.
P: Czy działa w Windowsie? O: Nie bezpośrednio. Strona npm radzi używać w Windowsie WSL, a README na GitHubie mówi, że nie ma testów w Windowsie ani w WSL.

Źródła

github.com/openqodex/openqodex
npmjs.com/package/openqodex