codex-plugin-cc - GitLite

KO | EN

gitlite — search

#python #ai #typescript #golang #android #rust #deep-learning #linux #nodejs #windows #cli #kubernetes #vue #ios

codex-plugin-cc

(★ 32,145)

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

파일 탐색기

최종 버전 다운로드 (.zip)

- marketplace.json
- - pull-request-ci.yml
- - CHANGELOG.md
  - LICENSE
  - NOTICE
- bump-version.mjs
- broker-endpoint.test.mjs
- bump-version.test.mjs
- commands.test.mjs
- fake-codex-fixture.mjs
- git.test.mjs
- helpers.mjs
- process.test.mjs
- render.test.mjs
- runtime.test.mjs
- state.test.mjs
.gitignore
LICENSE
NOTICE
package-lock.json
package.json
README.md
tsconfig.app-server.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/openai/codex-plugin-cc

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd codex-plugin-cc

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다.

npm install -g @openai/codex

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install -g @openai/codex

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Code용 Codex 플러그인

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

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

<video src="./docs/plugin-demo.webm" controls muted playsinline autoplay></video>

## 제공 기능

- 일반적인 읽기 전용 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`을 설정하세요.