codex-plugin-cc

KO | EN

gitlite — search

#python #react #python3 #reactjs #java #typescript #github-config #api #docker #deep-learning #machine-learning #javascript

codex-plugin-cc

★ 31,942 Open GitHub ↗

Claude Code 내부에서 Codex를 사용하여 코드를 검토하거나 작업을 위임할 수 있습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Code용 Codex 플러그인

Claude Code 내부에서 Codex를 사용하여 코드 리뷰를 진행하거나 Codex에 작업을 위임할 수 있습니다.

이 플러그인은 기존 작업 흐름에서 간편하게 Codex를 사용하고자 하는 Claude Code 사용자를 위한 도구입니다.

## 제공 기능

- 일반적인 읽기 전용 Codex 리뷰를 위한 `/codex:review`
- 조율 가능한 심층 검증 리뷰를 위한 `/codex:adversarial-review`
- 작업 위임, 세션 인계, 백그라운드 작업 관리를 위한 `/codex:rescue`, `/codex:transfer`, `/codex:status`, `/codex:result`, `/codex:cancel`

## 요구 사항

- **ChatGPT 구독(무료 포함) 또는 OpenAI API 키.**
  - 사용량은 Codex 사용량 한도에산 반영됩니다. [자세히 알아보기](https://developers.openai.com/codex/pricing).
- **Node.js 18.18 이상**

## 설치

Claude Code에 마켓플레이스를 추가합니다:

```bash
/plugin marketplace add openai/codex-plugin-cc
```

플러그인을 설치합니다:

```bash
/plugin install codex@openai-codex
```

플러그인을 다시 불러옵니다:

```bash
/reload-plugins
```

그런 다음 다음 명령을 실행합니다:

```bash
/codex:setup
```

`/codex:setup`은 Codex 사용 준비가 완료되었는지 알려줍니다. Codex가 없고 npm을 사용할 수 있는 경우, Codex 설치를 제안합니다.

직접 Codex를 설치하려면 다음을 사용하세요:

```bash
npm install -g @openai/codex
```

Codex가 설치되어 있으나 아직 로그인되어 있지 않은 경우 다음을 실행합니다:

```bash
!codex login
```

설치 후 다음 항목들을 확인할 수 있습니다:

- 아래에 나열된 슬래시 명령어들
- `/agents`의 `codex:codex-rescue` 서브에이전트

간단한 첫 실행 예시는 다음과 같습니다:

```bash
/codex:review --background
/codex:status
/codex:result
```

## 사용법

### `/codex:review`

현재 작업에 대해 일반적인 Codex 리뷰를 실행합니다. Codex 내부에서 직접 `/review`를 실행하는 것과 동일한 품질의 코드 리뷰를 제공합니다.

> [!NOTE]
> 특히 여러 파일이 변경된 경우 코드 리뷰에 다소 시간이 걸릴 수 있습니다. 일반적으로 백그라운드에서 실행하는 것을 권장합니다.

다음과 같은 경우에 사용하세요:

- 현재 커밋되지 않은 변경 사항을 리뷰하고 싶을 때
- `main`과 같은 베이스 브랜치와 현재 브랜치를 비교하여 리뷰하고 싶을 때

브랜치 리뷰를 위해 `--base <ref>`를 사용하세요. `--wait` 및 `--background`도 지원합니다. 이 명령어는 조율할 수 없으며 커스텀 포커스 텍스트를 받지 않습니다. 특정 결정이나 위험 영역에 대해 이의를 제기하고 싶을 때는 [`/codex:adversarial-review`](#codexadversarial-review)를 사용하세요.

예시:

```bash
/codex:review
/codex:review --base main
/codex:review --background
```

이 명령어는 읽기 전용이며 어떠한 변경도 수행하지 않습니다. 백그라운드에서 실행할 때는 [`/codex:status`](#codexstatus)를 사용하여 진행 상황을 확인하고 [`/codex:cancel`](#codexcancel)을 사용하여 진행 중인 작업을 취소할 수 있습니다.

### `/codex:adversarial-review`

선택된 구현과 디자인에 대해 의문을 제기하는 **조율 가능한(steerable)** 리뷰를 실행합니다.

가설, 트레이드오프, 실패 모드, 그리고 더 안전하거나 단순한 접근 방식이 있었는지 여부를 압박 테스트(pressure-test)하는 데 사용할 수 있습니다.

브랜치 리뷰를 위한 `--base <ref>`를 포함하여 `/codex:review`와 동일한 리뷰 대상 선택 방식을 사용합니다.
또한 `--wait` 및 `--background`를 지원합니다. `/codex:review`와 달리 플래그 뒤에 추가 포커스 텍스트를 입력할 수 있습니다.

다음과 같은 경우에 사용하세요:

- 코드 세부사항뿐만 아니라 방향성 자체에 이의를 제기하는 배포 전 리뷰
- 디자인 선택, 트레이드오프, 숨겨진 가설, 대안적 접근 방식에 초점을 맞춘 리뷰
- 인증, 데이터 손실, 롤백, 경쟁 상태(race condition), 안정성 등 특정 위험 영역에 대한 압박 테스트

예시:

```bash
/codex:adversarial-review
/codex:adversarial-review --base main challenge whether this was the right caching and retry design
/codex:adversarial-review --background look for race conditions and question the chosen approach
```

이 명령어는 읽기 전용입니다. 코드를 수정하지 않습니다.

### `/codex:rescue`

`codex:codex-rescue` 서브에이전트를 통해 Codex에 작업을 넘깁니다.

Codex에 다음과 같은 작업을 시키고 싶을 때 사용하세요:

- 버그 조사
- 수정 시도
- 이전 Codex 작업 이어하기
- 더 작고 저렴한 모델을 사용하여 더 빠르거나 가볍게 처리하기

> [!NOTE]
> 작업 및 선택한 모델에 따라 시간이 오래 걸릴 수 있으므로, 가급적 작업을 백그라운드에서 강제로 실행하거나 에이전트를 백그라운드로 전환하는 것을 권장합니다.

`--background`, `--wait`, `--resume`, `--fresh`를 지원합니다. `--resume`과 `--fresh`를 생략하면 플러그인이 이 저장소의 가장 최근 구조(rescue) 스레드를 이어갈 것인지 제안할 수 있습니다.

예시:

```bash
/codex:rescue investigate why the tests started 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 the flaky integration test
/codex:rescue --model spark fix the issue quickly
/codex:rescue --background investigate the regression
```

또는 단순히 Codex에 작업을 위임하도록 요청할 수도 있습니다:

```text
Ask Codex to redesign the database connection to be more resilient.
```

**참고사항:**

- `--model` 또는 `--effort`를 전달하지 않으면 Codex가 자체 기본값을 선택합니다.
- `spark`를 지정하면 플러그인이 이를 `gpt-5.3-codex-spark`로 매핑합니다.
- 후속 구조 요청을 통해 해당 저장소의 최신 Codex 작업을 이어갈 수 있습니다.

### `/codex:transfer`

현재 Claude Code 세션에서 영구적인 Codex 스레드를 생성하고 `codex resume <session-id>` 명령어를 출력합니다.

Claude Code에서 디버깅 또는 구현 대화를 시작한 후, 동일한 컨텍스트를 Codex에서 직접 이어가고 싶을 때 사용하세요.

예시:

```bash
/codex:transfer
/codex:transfer --source ~/.claude/projects/-Users-me-repo/<session-id>.jsonl
```

플러그인의 기존 `SessionStart` 훅이 현재 트랜스크립트 경로를 자동으로 제공하며, `--source`는 수동 오버라이드용으로 사용할 수 있습니다. 이 전송은 Codex의 외부 에이전트 세션 임포터를 사용하므로, Codex 앱에서 Claude 기록을 가져오는 것과 동일한 변환 규칙을 따르며 앱이나 TUI에서 이어갈 수 있는 가시적인 턴(turn)을 생성합니다. 소스 경로는 `~/.claude/projects` 아래에 있어야 하며, 세션 가져오기를 지원하지 않는 이전 버전의 Codex는 이 명령어를 사용하기 전에 업그레이드해야 합니다.

### `/codex:status`

현재 저장소에 대해 실행 중이거나 최근에 실행된 Codex 작업을 표시합니다.

예시:

```bash
/codex:status
/codex:status task-abc123
```

다음 목적으로 사용하세요:

- 백그라운드 작업 진행 상황 확인
- 가장 최근에 완료된 작업 확인
- 작업이 여전히 실행 중인지 확인

### `/codex:result`

완료된 작업에 대해 최종 저장된 Codex 출력을 표시합니다.
가능한 경우, `codex resume <session-id>`를 사용하여 Codex에서 해당 실행을 직접 다시 열 수 있도록 Codex 세션 ID도 함께 포함됩니다.

예시:

```bash
/codex:result
/codex:result task-abc123
```

### `/codex:cancel`

활성 상태인 백그라운드 Codex 작업을 취소합니다.

예시:

```bash
/codex:cancel
/codex:cancel task-abc123
```

### `/codex:setup`

Codex가 설치되어 있고 인증되었는지 확인합니다.
Codex가 없고 npm을 사용할 수 있는 경우, Codex 설치를 제안할 수 있습니다.

`/codex:setup`을 사용하여 선택적 리뷰 게이트를 관리할 수도 있습니다.

#### 리뷰 게이트 활성화

```bash
/codex:setup --enable-review-gate
/codex:setup --disable-review-gate
```

리뷰 게이트가 활성화되면 플러그인은 `Stop` 훅을 사용하여 Claude의 응답을 기반으로 타겟팅된 Codex 리뷰를 실행합니다. 해당 리뷰에서 문제가 발견되면 정지가 차단되어 Claude가 먼저 문제를 해결할 수 있도록 합니다.

> [!WARNING]
> 리뷰 게이트는 장기 실행되는 Claude/Codex 루프를 유발할 수 있으며 사용량 한도를 빠르게 소진시킬 수 있습니다. 세션을 활발하게 모니터링할 계획일 때만 활성화하세요.

## 일반적인 작업 흐름

### 배포 전 리뷰

```bash
/codex:review
```

### Codex에 문제 넘기기

```bash
/codex:rescue investigate why the build is failing in CI
```

### 장기 실행 작업 시작하기

```bash
/codex:adversarial-review --background
/codex:rescue --background investigate the flaky test
```

그런 다음 다음 명령어로 상태를 확인합니다:

```bash
/codex:status
/codex:result
```

## Codex 통합

Codex 플러그인은 [Codex 앱 서버](https://developers.openai.com/codex/app-server)를 래핑합니다. 환경에 설치된 전역 `codex` 바이너리를 사용하고 [동일한 설정을 적용합니다](https://developers.openai.com/codex/config-basic).

### 일반적인 설정

플러그인이 사용할 기본 추론 노력(reasoning effort)이나 기본 모델을 변경하려면 사용자 수준 또는 프로젝트 수준의 `config.toml` 내에서 정의할 수 있습니다. 예를 들어 특정 프로젝트에 대해 항상 `high` 설정으로 `gpt-5.4-mini`를 사용하려면 Claude를 시작한 디렉토리 루트의 `.codex/config.toml` 파일에 다음을 추가하면 됩니다:

```toml
model = "gpt-5.4-mini"
model_reasoning_effort = "high"
```

설정은 다음 순서로 반영됩니다:

- `~/.codex/config.toml`의 사용자 수준 설정
- `.codex/config.toml`의 프로젝트 수준 오버라이드
- 프로젝트 수준 오버라이드는 [프로젝트가 신뢰된 경우에만](https://developers.openai.com/codex/config-advanced#project-config-files-codexconfigtoml) 로드됩니다.

더 많은 [설정 옵션](https://developers.openai.com/codex/config-reference)은 Codex 문서를 참고하세요.

### 작업을 Codex로 이동하기

위임된 작업 및 모든 [스톱 게이트(#what-does-the-review-gate-do)](#what-does-the-review-gate-do) 실행은 `/codex:result` 또는 `/codex:status`에서 받은 특정 세션 ID를 사용하여 `codex resume`을 실행하거나 목록에서 선택하는 방식으로 Codex 내에서 직접 이어갈 수 있습니다.

이렇게 하면 Codex 작업을 검토하거나 그곳에서 작업을 계속 진행할 수 있습니다.

## FAQ

### 이 플러그인을 위해 별도의 Codex 계정이 필요한가요?

이 기기에서 이미 Codex에 로그인되어 있다면, 해당 계정은 여기서도 즉시 작동합니다. 이 플러그인은 로컬 Codex CLI 인증을 사용합니다.

현재 Claude Code만 사용 중이고 Codex를 아직 사용해 보지 않은 경우, ChatGPT 계정 또는 API 키를 사용하여 Codex에 로그인해야 합니다. [Codex는 ChatGPT 구독에 포함되어 제공되며](https://developers.openai.com/codex/pricing/), [`codex login`](https://developers.openai.com/codex/cli/reference/#codex-login)은 ChatGPT 및 API 키 로그인을 모두 지원합니다. `/codex:setup`을 실행하여 Codex가 준비되었는지 확인하고, 준비되지 않았다면 `!codex login`을 사용하세요.

### 플러그인이 별도의 Codex 런타임을 사용하나요?

아니요. 이 플러그인은 동일한 기기의 로컬 [Codex CLI](https://developers.openai.com/codex/cli/) 및 [Codex 앱 서버](https://developers.openai.com/codex/app-server/)를 통해 위임합니다.

즉, 다음 사항들이 적용됩니다:

- 직접 사용할 때와 동일한 Codex 설치를 사용합니다.
- 동일한 로컬 인증 상태를 사용합니다.
- 동일한 저장소 체크아웃과 기기 로컬 환경을 사용합니다.

### 이미 가지고 있는 기존 Codex 설정을 그대로 사용하나요?

네. 이미 Codex를 사용 중인 경우, 플러그인이 동일한 [설정](#common-configurations)을 불러옵니다.

### 기존 API 키나 베이스 URL 설정을 계속 사용할 수 있나요?

네. 플러그인이 로컬 Codex CLI를 사용하므로 기존 로그인 방식과 설정이 계속 적용됩니다.

내장 OpenAI 제공자를 다른 엔드포인트로 지정해야 하는 경우, [Codex 설정](https://developers.openai.com/codex/config-advanced/#config-and-state-locations)에서 `openai_base_url`을 설정하세요.

codex-plugin-cc

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README