TL;DR

Codex++는 Codex App의 원본 파일을 변경하지 않고 외부에서 기능을 주입해 플러그인 접근성, 세션 조작, 모델 요청 라우팅 같은 부족한 편의성을 보완하는 데 목적이 있다. Rust로 구현된 무표시(정적) 런처가 Chromium DevTools Protocol로 Codex 렌더러에 스크립트를 주입하고, Tauri + React 기반의 관리 도구가 설정·업데이트·사용자 스크립트 관리를 제공한다. 관리 도구에서 '중계 주입'을 설정하면 ~/.codex/config.toml에 provider 항목을 기록해 공식 로그인 상태는 유지한 채 모델 요청만 외부 Base URL과 Key로 전송할 수 있다. 이 접근법은 app.asar 변조 없이 확장이 가능하다는 장점이 있으나, Codex 페이지 구조가 바뀌면 주입 스크립트 업데이트가 필요하고 macOS에서는 서명/공증 부재로 Gatekeeper 우회가 요구될 수 있다. 이 도구는 플러그인 차단 문제 해결, 세션 삭제·내보내기, upstream 기반 worktree 생성 등 실무 편의 기능을 포함하며 GitHub Release 기반 자동 업데이트와 플랫폼별 설치 파일을 제공해 배포 편의성을 확보했다. 다만 외부 주입 방식이므로 주입 스크립트의 유지 보수와 중계 API의 호환성 검증(예: 모델 리스트 인증 테스트)은 사용자가 사전에 수행해야 한다.

주요 기능

• Codex를 정적(무표시)으로 시작해 런처에서 자동으로 주입 스크립트를 적용
• Tauri 기반 관리 도구로 설정·플러그인·사용자 스크립트·로그를 조작
• 중계(중转) 모드로 Base URL·Key·모델명을 바꿔 모델 요청을 외부 API로 라우팅
• 세션 삭제·내보내기·이동·Timeline 등 Codex 원본에 없는 편집 기능 제공
• Git upstream worktree 생성과 GitHub Release 기반 자동 업데이트 지원

어떻게 동작하는가

Codex++는 외부 정적 launcher(Rust 백엔드)로 Codex를 실행한 뒤 Chromium DevTools Protocol(CDP)을 통해 렌더러에 강화 스크립트를 주입한다. 관리 UI는 Tauri + React로 구현되어 설정·중계 구성·로그 조회를 제공하며, 중계 모드 설정은 ~/.codex/config.toml에 모델 공급자(provider) 항목을 기록해 요청 경로를 변경한다.

해결 문제

API Key 로그인이나 비표준 환경에서 Codex의 플러그인 접근 제한, 세션 삭제 부재, 모델 요청을 외부 API로 전송하기 어려운 문제를 해결해 플러그인 해제, 세션 관리, 모델 중계 구성을 가능하게 한다.

차별점

• 원본 app.asar나 Codex 설치 파일을 변경하지 않고 CDP 주입만으로 기능을 확장해 오리지널 바이너리 무결성을 유지
• 중계 모드(중转注入)를 통해 공식 ChatGPT 로그인 상태를 유지하면서 모델 요청만 외부 API로 라우팅해 세션 가시성·호환성을 보장
• Rust 기반의 정적(무표시) 런처와 Tauri 관리 도구를 분리해 GUI 없는 백그라운드 시작과 풍부한 설정 UI를 모두 제공

사용 사례

• 공식 계정 로그인 상태를 유지하면서 모델 요청을 사내·서드파티 중계 API로 전환해 비용·호환성 관리를 하고자 할 때
• Codex App에서 원본에 없는 세션 삭제·내보내기·이동·Timeline 기능을 이용해 작업 공간을 정리·백업할 때
• 사용자 스크립트나 플러그인 강화 기능을 관리 도구로 중앙화해 팀 단위로 배포·차단·동일 설정을 적용할 때
• 원격 SSH 컨텍스트를 감지해 Zed Remote Development로 파일을 직접 여는 워크플로를 구성할 때

시작하기

GitHub Releases에서 플랫폼에 맞는 설치 파일을 내려받아 설치(Windows: CodexPlusPlus-*-windows-x64-setup.exe, macOS: macos-x64.dmg 또는 macos-arm64.dmg). 설치 후 두 개의 실행 아이콘이 생성되며 'Codex++ 管理工具'에서 중계 설정·강화 옵션을 구성하고 'Codex++'로 정적 시작하면 주입이 적용된다. 개발용으로는 apps/codex-plus-manager에서 npm install && npm run vite:build, 루트에서 cargo build --release를 실행한다.

요구사항

• Codex App이 설치되어 있어야 함
• Rust 1.85 이상(개발 빌드용)
• Tauri 2.x 기반 프론트엔드(개발 시 Node/npm 필요)
• Windows/macOS용 각 아키텍처에 맞는 설치 파일(Windows 설치 프로그램, macOS x64/arm64 DMG) 실행 권한

이미지 분석