> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reclaude.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex(recodex)

> recodex로 ReClaude가 할당한 계정을 사용해 공식 Codex CLI와 ChatGPT 데스크톱 앱을 실행합니다. 설치, 브라우저 로그인, 다중 조직 바인딩과 전환, Codex CLI 자동 다운로드와 버전 요구 사항, WebSocket 폴백과 기기 수 등 자주 묻는 질문을 다룹니다.

> [!NOTE]
>
> Codex 요금제는 현재 판매하지 않아 구매하거나 갱신할 수 없습니다. 이미 개통된 Codex 조직은 유효 기간 동안 평소처럼 사용할 수 있으며 Claude 구독과는 서로 영향을 주지 않습니다. 지원 범위는 [구독 → Codex 요금제](https://docs.reclaude.ai/ko/account/subscription.md#codex-요금제)를 참고하세요.

## recodex란

클라이언트 v1.5.0부터 같은 ReClaude 클라이언트에 `recodex` 명령(짧은 별칭 `recx`)이 추가되었습니다. ReClaude가 할당한 계정으로 공식 Codex CLI를 실행하며, v1.7.1부터는 ChatGPT 데스크톱 앱(`recodex app`)도 열 수 있습니다.

* `recodex`와 `reclaude`는 동등합니다: **로그인, 조직 바인딩, 로그아웃이 각각 독립적**이며 서로 영향을 주지 않습니다. Codex 조직과 Claude 조직은 서로 독립된 두 묶음입니다.
* 두 명령은 같은 백그라운드 서비스(daemon)를 공유합니다.
* `recx`와 `recodex`의 관계는 `rec`와 `reclaude`의 관계와 같습니다: `recx login`은 `recodex login`과 같습니다.

## 설치

**새 컴퓨터**: [CLI 설치](https://docs.reclaude.ai/ko/cli/install.md)의 한 줄 설치 명령을 사용하면 `reclaude`, `rec`, `recodex`, `recx` 네 명령을 한 번에 얻습니다.

**이전 버전이 이미 설치된 경우**: 클라이언트가 v1.5.0 이상으로 업데이트되면 `recodex` / `recx`를 자동으로 사용할 수 있습니다(새 버전이 자동으로 만들어 줍니다). 나타나지 않으면 `reclaude setup`을 한 번 실행하세요. 최신 버전을 유지하는 것을 권장합니다: ChatGPT 데스크톱 앱은 v1.7.1 이상, `recodex org bind`, `recodex logout --all`, `recodex service stop`은 v1.7.3 이상이 필요합니다.

```bash theme={null}
reclaude setup    # recodex / recx가 보이지 않을 때 한 번 실행
```

**새 터미널**을 연 뒤 `recodex version`으로 확인하세요.

**Codex CLI를 따로 설치할 필요가 없습니다**: 이 컴퓨터에 적합한 Codex CLI가 없으면 `recodex`가 공식 버전을 자동으로 다운로드합니다(VPN 불필요). 공식 Codex CLI가 이미 설치되어 있고 버전이 충분히 새롭다면 그것을 사용합니다. 자세한 내용은 아래 [Codex CLI는 어디서 오나요](#codex-cli는-어디서-오나요)를 참조하세요.

## 로그인

```bash theme={null}
recodex login
```

터미널에 인증 링크가 출력되고 브라우저를 자동으로 열려고 시도합니다. 브라우저에서:

1. 로그인되어 있지 않다면 먼저 이메일과 비밀번호로 ReClaude 계정에 로그인합니다.
2. 페이지 제목이 **recodex 로그인 승인**인지 확인하고 **기기 정보**를 확인합니다.
3. 이 기기에 기억하기 쉬운 이름을 지어 줍니다 —— 이후 [기기](https://docs.reclaude.ai/ko/account/devices.md) 페이지의 **Codex 디바이스** 그룹에 표시됩니다.
4. 여러 Codex 조직에 속해 있다면 조직 드롭다운에서 사용할 조직을 **선택**합니다. 로그인하면 이 컴퓨터에 그 조직에 대한 첫 번째 바인딩이 생기며, 다른 Codex 조직은 나중에 `recodex org bind`로 추가합니다.
5. **승인**을 클릭합니다.

> [!TIP]
>
> `recodex`를 그냥 실행했을 때 이 컴퓨터에 유효한 Codex 로그인이 없으면 같은 로그인 과정이 자동으로 시작됩니다.

* **Claude 로그인과 독립적**: `recodex login`은 Claude 측의 어떤 바인딩과 설정도 바꾸지 않으며, 기존 `reclaude` 로그인도 그대로 사용할 수 있습니다.
* Codex 안에서 `codex login`을 실행하지 **마세요**: 자격 증명은 ReClaude가 관리하며 `recodex`는 이 명령을 거부합니다(`codex login status`는 사용할 수 있습니다).

## 사용

```bash theme={null}
recodex              # 백그라운드 서비스를 시작하고 Codex CLI 열기
recodex <인수>        # 나머지 인수는 그대로 Codex에 전달됩니다. 예: recodex exec "이 저장소를 설명해 줘"
recodex app          # ChatGPT 데스크톱 앱 열기(macOS / Windows)
```

* Codex는 ReClaude가 관리하는 별도 설정을 사용합니다. 사용자 본인의 `~/.codex`에 있는 설정과 플러그인은 자동으로 옮겨지지 **않습니다**. 같은 바인딩의 Codex CLI와 ChatGPT 데스크톱 앱은 설정과 세션 기록을 공유합니다.
* `recodex update`가 업데이트하는 것은 ReClaude 클라이언트 자체(`reclaude update`와 동일)이며, Codex CLI가 **아닙니다**.

### Codex CLI는 어디서 오나요

`recodex`는 `PATH`에 사용자가 직접 설치한 공식 Codex CLI를 우선 사용합니다. 없거나 ReClaude가 요구하는 최소 버전(현재 `0.160.0`)보다 오래되었으면 ReClaude가 관리하는 공식 Codex CLI(`~/.rec/codex/cli/<버전>/`에 자동 다운로드)를 대신 사용합니다. 사용자의 것이 오래된 경우 "recodex: the local codex … is below the required …; using the managed … this time" 이 표시되지만 그대로 둡니다.

### ChatGPT 데스크톱 앱

`recodex app`은 현재 Codex 바인딩으로 ChatGPT 데스크톱 앱을 실행하며, 처음 실행할 때 ReClaude가 관리하는 설치 파일을 자동으로 다운로드합니다. `recodex app --org <org_id>`로 조직을 지정합니다. 데스크톱 앱 안의 Codex는 완전히 사용할 수 있고, Chat / Work 모드는 사용할 수 있지만 기능이 제한됩니다. macOS와 Windows만 지원합니다.

* chatgpt.com 웹, 모바일 앱, VS Code 확장은 **지원하지 않습니다**.
* `recodex app update`는 관리되는 데스크톱 설치 파일을 업데이트하고, `recodex app reset`은 데스크톱 앱의 로그인 상태와 캐시를 초기화합니다(설정과 세션 기록은 유지. 실행 전에 확인하며, 비대화형 터미널에서는 `--yes`를 붙입니다).

## 다중 조직 바인딩과 전환

Codex 조직은 Claude 조직과 따로 관리됩니다: `recodex org`는 **Codex 조직**만 보고 바인딩하며, `reclaude org`는 Claude 조직만 다룹니다. 사용법은 Claude 측과 같습니다([명령어 레퍼런스 → 다중 조직 바인딩](https://docs.reclaude.ai/ko/cli/commands.md#다중-조직-바인딩) 참조): 한 컴퓨터가 여러 Codex 조직에 각각 바인딩을 하나씩 가질 수 있고, `--org` 없이 실행하면 Codex 측 기본 바인딩을 사용합니다.

```bash theme={null}
recodex org list            # 소속된 Codex 조직(첫 열이 org_id)과 이 컴퓨터의 바인딩 여부 나열
recodex org bind <org_id>   # 브라우저에서 승인해 이 Codex 조직에 대한 바인딩을 이 컴퓨터에 추가
recodex org use <org_id>    # 기본 바인딩을 이미 바인딩된 Codex 조직으로 전환(이 컴퓨터 설정만 변경)
recodex --org <org_id>      # 이번만 지정한 조직으로 Codex CLI 열기(--org는 첫 번째 인수여야 함)
recodex app --org <org_id>  # 지정한 조직으로 ChatGPT 데스크톱 앱 열기
```

* 본인이 멤버인 Codex 조직만 바인딩하고 전환할 수 있습니다.
* 이 컴퓨터에 Codex 바인딩이 여러 개인데 기본값이 없으면 `recodex`는 선택할 수 있는 조직을 나열하고 종료합니다. `recodex org use <org_id>`로 기본값을 하나 정하세요.
* `recodex org use`는 이후에 실행하는 Codex CLI와 데스크톱 앱에만 영향을 주며, 이미 열려 있는 것은 영향을 받지 않습니다. Claude 측의 어떤 바인딩도 바꾸지 않습니다.

## 자주 쓰는 명령

| 명령 | 역할 |
| - | - |
| `recodex` | 백그라운드 서비스를 시작하고 Codex CLI 열기(일상적인 사용법) |
| `recodex app` | ChatGPT 데스크톱 앱 열기(macOS / Windows) |
| `recodex login` | 브라우저에서 승인하고 이 컴퓨터의 Codex 바인딩에 로그인 또는 다시 로그인(`--org <org_id>`로 대상 지정) |
| `recodex logout` | 이 컴퓨터의 Codex 바인딩에서 로그아웃(기본값은 기본 바인딩 하나, `--all`은 모든 Codex 바인딩). 설정과 세션 기록은 유지되며 Claude에는 영향 없음 |
| `recodex org` | 이 컴퓨터의 Codex 조직 확인, 바인딩 또는 전환 |
| `recodex status` | 백그라운드 서비스와 두 플랫폼의 상태 출력(Codex 측은 `[chatgpt]` 블록, `--check`를 붙이면 온라인으로 확인) |
| `recodex service stop` | 백그라운드 서비스 중지 —— 두 명령이 공유하므로 `reclaude`의 중계도 함께 멈춥니다. 어느 명령이든 다음에 실행하면 자동으로 다시 시작됩니다(예전 표기 `recodex stop`도 계속 사용 가능) |
| `recodex config gateway` | Codex가 사용하는 접속 경로 확인 / 고정 / 초기화(사용법은 [명령어 레퍼런스 → gateway 설정](https://docs.reclaude.ai/ko/cli/commands.md#gateway-설정)과 동일) |
| `recodex logs` | 백그라운드 서비스 로그의 마지막 200줄 출력(`-f`로 계속 추적) |
| `recodex update` | ReClaude 클라이언트 업데이트 |
| `recodex help` | 도움말 출력 |

> [!WARNING]
>
> `recodex uninstall`은 `reclaude uninstall`과 **완전히 같습니다**: 프로그램과 백그라운드 서비스을 제거하고 기본적으로 두 플랫폼의 로컬 데이터는 남깁니다. `--purge`를 붙였을 때만 ReClaude가 관리하는 모든 데이터와 기록을 지우며, **Claude 측 각 조직 바인딩의 Claude Code 설정, 세션, 메모리와 Claude Desktop 데이터도 포함됩니다**(자신의 `~/.claude`는 건드리지 않으며, 지운 데이터는 복구할 수 없습니다). Codex만 그만 쓰려면 `recodex logout`으로 충분합니다.

## 자주 묻는 질문

**"구독이 없거나 만료되었습니다. reclaude.ai에서 구매 / 갱신해 주세요"가 표시되거나, 승인 페이지에 "Codex 요금제는 현재 구매할 수 없습니다."가 표시됨**

아직 Codex 요금제가 없거나, 이 기기가 가리키는 Codex 조직이 만료되었습니다. Codex 요금제는 현재 판매하지 않아 구매하거나 갱신할 수 없습니다(Claude 요금제는 Codex에 쓸 수 없습니다). 아직 유효한 다른 Codex 조직에 속해 있다면 `recodex`가 전환할 수 있는 조직을 보여 주니 안내대로 `recodex org use <org_id>`를 실행하세요.

**"recodex: the local codex … is below the required …; using the managed … this time"이 표시됨**

직접 설치한 Codex CLI가 ReClaude가 요구하는 최소 버전보다 낮아서, 이번에는 `recodex`가 관리형 공식 버전을 대신 사용하며 평소처럼 쓸 수 있습니다. 직접 설치한 것을 계속 쓰려면 요구 버전 이상으로 업데이트하세요.

**Codex 로그에 WebSocket 실패 / `426`이 나온 뒤 HTTP로 바뀜**

v1.5.0부터 Codex의 WebSocket 연결은 기본적으로 ReClaude를 그대로 통과합니다. 경로가 일시적으로 WebSocket을 지원하지 않으면 `426`을 받은 뒤 자동으로 HTTP 스트리밍으로 이어서 진행하며, 대화에는 영향이 없습니다. 경로가 폴백되면 `recodex`를 시작할 때 터미널에 `codex_transport: fallback (WebSocket falls back to HTTP; Codex CLI works normally)` 한 줄이 먼저 출력되며, 그대로 통과할 때는 출력되지 않습니다.

**Codex는 몇 대의 기기에서 쓸 수 있나요?**

**Codex 계정당 총 4대**: 같은 계정에 묶인 모든 멤버를 합쳐 활성 기기 최대 4대이며, 한 사람이 모두 사용할 수도 있습니다. 전용 Max / Ultra와 같은 기준입니다. Codex 기기는 Claude 기기와 **따로 계산**되며, [기기](https://docs.reclaude.ai/ko/account/devices.md) 페이지의 **Codex 디바이스** 그룹에서 확인하고 폐기할 수 있습니다. 규칙은 [기기 → 기기 수 상한](https://docs.reclaude.ai/ko/account/devices.md#기기-수-상한)을 참고하세요.

**웹사이트에서 Codex 사용량과 메시지 기록을 볼 수 있나요?**

네. 웹 상단의 **조직 전환**으로 Codex 조직에 들어가면 홈에 그 계정의 사용량이 표시되고, **사용량 동기화**로 새로 고칠 수 있습니다. 메시지 기록에는 두 플랫폼의 기록이 함께 나열되며 각각 플랫폼이 표시됩니다. Codex 요청에는 비용 통계가 표시되지 않습니다.

**ChatGPT 데스크톱 앱을 쓸 수 있나요?**

네. `recodex app`을 실행하세요. 위의 [ChatGPT 데스크톱 앱](#chatgpt-데스크톱-앱)을 참고하세요. chatgpt.com 웹, 모바일 앱, VS Code 확장은 지원하지 않습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.