| name | codex-in-claude-code |
| description | Use OpenAI Codex from inside Claude Code — code reviews, adversarial reviews, and delegating tasks to Codex. Use when user asks to /codex:review, /codex:rescue, /codex:adversarial-review, delegate to Codex, run Codex review, or install the Codex plugin. |
Codex in Claude Code
Plugin oficjalny OpenAI: openai/codex-plugin-cc
Repo: https://github.com/openai/codex-plugin-cc
Pozwala wywołać Codex bezpośrednio z Claude Code — review kodu, adversarial review i delegowanie tasków do Codexa jako background job.
Wymagania
- ChatGPT subscription (w tym Free) lub OpenAI API key — plugin używa lokalnego CLI Codex
- Node.js 18.18+
- Codex CLI (
@openai/codex) zainstalowany globalnie
Instalacja (jednorazowo)
WAZNE: Te /plugin* komendy musi wpisac uzytkownik w prompt (nie wolaj ich z Bash, nie pisz /plugin ... jako komendy do siebie). Claude nie moze zainstalowac plugina sam — to akcja po stronie harnessu.
Pelna sekwencja (4 kroki, KAZDY w osobnym promptcie):
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
Kolejnosc jest obowiazkowa. Jezeli pominiesz marketplace add, krok /plugin install codex@openai-codex zwroci not found (marketplace openai-codex jeszcze nie istnieje w lokalnym registry).
Po marketplace add zobaczysz: Successfully added marketplace: openai-codex.
Po install zobaczysz: ✓ Installed codex. Run /reload-plugins to apply.
Jesli Codex CLI nie jest zainstalowany:
npm install -g @openai/codex
Logowanie (mozna tez przez !codex login w Claude Code):
codex login
Weryfikacja po instalacji:
cat ~/.claude/plugins/installed_plugins.json | python3 -c "import json,sys;print('codex' in json.load(sys.stdin)['plugins'])" → True- W nowej sesji slash commands
/codex:review, /codex:adversarial-review, /codex:rescue powinny byc dostepne
Slash Commands
/codex:review [--wait|--background] [--base <ref>]
Standardowy review kodu. Używa WC jako reviewer, taki sam jak /review w Codexie.
/codex:review
/codex:review --base main
/codex:review --background
/codex:review --wait
Read-only — nie zmienia kodu.
/codex:adversarial-review [--wait|--background] [--base <ref>] [focus...]
Review kwestionujący decyzje projektowe, nie tylko błędy. Pytania o tradeoffs, założenia, alternatywne podejścia, failure modes.
/codex:adversarial-review
/codex:adversarial-review --base main challenge whether caching approach is right
/codex:adversarial-review --background look for race conditions
Przyjmuje dodatkowy tekst jako focus area (w odróżnieniu od /codex:review).
/codex:rescue [--background|--wait] [--resume|--fresh] [--model <model>] [--effort <level>] <task>
Deleguje task do Codexa. Codex może diagnozować bugi, pisać fixy, kontynuować poprzedni run.
/codex:rescue investigate why tests are failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --resume apply the top fix from the last run
/codex:rescue --model gpt-5.4-mini --effort medium investigate flaky test
/codex:rescue --model spark fix it quickly
/codex:rescue --background investigate the regression
Modele: domyślny Codex, gpt-5.4-mini, spark (alias na gpt-5.3-codex-spark)
Effort levels: none, minimal, low, medium, high, xhigh
/codex:status [job-id]
Pokazuje aktywne i ostatnie joby Codexa dla bieżącego repo.
/codex:status
/codex:status task-abc123
/codex:result [job-id]
Pokazuje finalny output zakończonego joba. Zawiera też session ID do wznowienia w Codexie.
/codex:result
/codex:result task-abc123
/codex:cancel [job-id]
Anuluje aktywny background job.
/codex:cancel
/codex:cancel task-abc123
/codex:setup [--enable-review-gate|--disable-review-gate]
Sprawdza czy Codex jest gotowy. Opcjonalnie włącza/wyłącza review gate (Stop hook).
/codex:setup
/codex:setup --enable-review-gate
/codex:setup --disable-review-gate
Uwaga: review gate uruchamia Codex review przy każdym Stop — może szybko zużyć limity.
Typowe Flow
Review przed PR
/codex:review --base main
Delegowanie buga do Codexa
/codex:rescue investigate why the build is failing in CI
Długi task w tle
/codex:rescue --background investigate the flaky integration test
/codex:status
/codex:result
Adversarial review przed shipmentem
/codex:adversarial-review --base main challenge the auth and session design
Konfiguracja Codexa
~/.codex/config.toml (user-level) lub .codex/config.toml (project-level):
model = "gpt-5.4-mini"
model_reasoning_effort = "xhigh"
Plugin używa tych samych ustawień co lokalne CLI Codex.
Wznawianie w Codexie
Po /codex:result dostajesz session ID — możesz kontynuować pracę bezpośrednio w Codexie:
codex resume <session-id>
codex resume
