Codex++ — 공식 Codex 데스크톱 앱을 위한 관리 레이어

Codex++ (프로젝트 이름: BigPizzaV3/CodexPlusPlus)는 공식 OpenAI Codex / ChatGPT 데스크톱 애플리케이션을 위한 동반 관리 도구입니다. AI 제공업체와 모델에 대한 통합 제어, 더 나은 채팅 세션, 작업 공간 사용자 지정을 제공하는 "++" 레이어를 추가합니다.

기능

Codex++ 구성 창을 열고 설정한 다음 시작을 클릭하면 설정이 적용된 공식 Codex 앱이 시작됩니다. Codex++는 Chrome DevTools 프로토콜(CDP)과 자체 내장 런타임 서비스를 통해 작동합니다. 공식 앱의 app.asar 파일을 수정하거나 설치 디렉터리에 패치 파일을 쓰지 않습니다.

주요 기능

제공업체 및 모델 관리

• 네 가지 사용 모드: 공식 로그인, 공식 로그인 + API(요청은 항상 구성된 API를 통해 전송), 순수 API(공식 계정 불필요), 통합 제공업체.
• 통합 제공업체는 두 가지 유형이 있습니다: 장애 조치(실패 시 제공업체 간 전환, 순환/가중치 적용) 및 모델 통합(각 모델을 특정 멤버 제공업체로 라우팅). 멤버는 API 제공업체 또는 로그인된 공식 계정일 수 있습니다.
• 모델별 설정: 각 모델에 대해 사용자 지정 컨텍스트 창 및 자동 압축 임계값을 설정합니다(예: deepseek-v4-pro[1M]).
• 모델 선택기는 제공업체별로 그룹화되며 접기/펼치기가 가능하고 제공업체 이름과 모델 수를 표시합니다.
• 네이티브 빠른 잠금 해제: 순수 API 키 사용자가 지원되는 모델에서 Codex의 네이티브 표준 / ⚡ 빠른 컨트롤을 사용할 수 있게 합니다(기본적으로 꺼져 있음, 실제 속도와 요금은 제공업체에 따라 다름).

세션 관리

• 로컬 세션 스캔, 삭제(실행 취소 포함), 일괄 관리.
• 세션을 Markdown으로 내보내기, 토큰 기록 보기, 프로젝트 이동, 스레드 ID 확인.

요청 안정성

• 요청 충격 흡수: 업스트림 제공업체가 과부하 오류(server_overloaded, at capacity 등)를 반환하면 자동으로 재시도하므로 일시적인 혼잡으로 세션이 중단되지 않습니다. 두 가지 모드: 스트리밍(실시간 출력 유지, 첫 토큰 후 과부하 오류를 Codex의 네이티브 재시도에 넘김) 및 전체 버퍼(전체 응답을 버퍼링하고 과부하 시 재시도 — 그러나 스트리밍은 손실).
• 요청 상태 표시줄에 현재 단계, 모델, 경과 시간, 재시도 횟수, 마지막 실패 이유가 표시됩니다.

작업 공간 개선

• 입력 상자 아래 사용량 상태 표시줄: 실시간 생성 속도, 캐시 적중률, 컨텍스트 사용량(로컬 Codex 세션 기록의 데이터).
• 입력 및 읽기 편의 기능: 음성 입력, 붙여넣기 수정, 세션 너비, 스크롤 위치 복원, 다음 단계 제안, 답변 개요, 커서 타이핑 효과(무지개 입자, 불꽃놀이, 별빛).
• 확장 기능: 커뮤니티 사용자 스크립트 탐색 및 설치(Codex의 공식 플러그인 스토어와 별개의 마켓), MCP, Skill, Codex 플러그인 관리.
• 사용량 위젯 및 데스크톱 펫(개발 미리 보기): 토큰 통계, 작업 상태, 드래그/크기 조절 가능, 교체 가능한 캐릭터 이미지와 스킨.

다중 인스턴스 및 협업

• Codex 다중 실행: 제공업체 ID별로 격리된 Codex 인스턴스를 시작하며 각각 자체 구성, 세션, 사용자 데이터 디렉터리를 가집니다. 실행 중인 인스턴스는 중앙에서 나열되며 개별적으로 다시 시작하거나 중지할 수 있습니다.
• 하위 에이전트 협업: Codex 대화에서 자연어로 Codex CLI, DeepSeek Harness(dsh) 또는 Claude Code에 작업을 위임하고 결과는 현재 대화로 반환됩니다. 기본 에이전트, 모델 라우팅을 설정하고 DSH의 저장된 로그인을 재사용할 수 있습니다.
• WeChat 연결: QR 코드를 스캔하여 로컬 Codex를 연결하고 각 연락처는 독립적인 세션에 매핑됩니다(액세스 구성 가능).

플랫폼 및 기술

• 지원: Windows(x64) 및 macOS(Apple Silicon / Intel, 유니버설 DMG).
• 빌드 도구: Rust + Tauri.
• 라이선스: AGPL-3.0-only.

빠른 시작

1. GitHub Releases에서 플랫폼용 설치 프로그램을 다운로드합니다.
2. 공식 Codex / ChatGPT 데스크톱 앱이 이미 설치되어 있는지 확인합니다.
3. Codex++를 열고 공식 앱 경로를 확인하고 제공업체 모드를 선택한 다음 원하는 대로 개선 기능을 활성화하고 저장합니다.
4. Codex++ UI에서 시작을 클릭하여 구성과 함께 공식 앱을 시작합니다.

모든 UI 개선 기능은 개별적으로 또는 마스터 스위치를 통해 끌 수 있습니다. 개선 기능이 꺼져 있어도 제공업체 및 시작 관리 기능은 계속 작동합니다.

데이터 위치

데이터	위치
Codex 구성 및 로그인	~/.codex/config.toml, ~/.codex/auth.json
로컬 데이터베이스	~/.codex/sqlite/*.db (이전 대체: ~/.codex/state_5.sqlite)
Codex++ 상태 및 로그	~/.codex-session-delete/
제공업체 동기화 백업	~/.codex/backups_state/provider-sync

(CODEX_HOME이 설정된 경우 ~/.codex보다 우선합니다.)

개발 구조

• 프론트엔드: apps/codex-plus-manager
• 핵심 Rust 라이브러리: crates/codex-plus-core
• 데이터 레이어: crates/codex-plus-data
• UI 주입 스크립트: assets/inject

참고 사항 및 주의 사항

• 이 프로젝트는 여러 API 중계/프록시 서비스(JOJO Code, APIKEY.FUN, GrooRoute, RunAPI, FennoAI, 百可为AI, 七牛云, TokenMy, APINEBULA)의 후원을 받습니다. 서비스 범위, 가격, 프로모션에 대한 그들의 주장은 프로젝트의 것이 아닙니다.
• Codex++는 공식 앱의 페이지 구조, CDP 및 로컬 데이터 형식에 의존합니다. 공식 앱 업데이트 후 일부 기능은 적응이 필요할 수 있습니다.
• 고래 위젯 기능은 업스트림 프로젝트 MeteorNOX/DeepSeek-Balance-Whale-Widget에서 각색되었습니다. 해당 자산은 자체 라이선스를 따릅니다.
• 사용량 위젯과 데스크톱 펫은 개발 미리 보기 상태입니다. 스크린샷은 개발 빌드에서 가져온 것입니다.
• API 키는 로컬 컴퓨터에 저장됩니다. README는 피드백 제출 전에 키를 숨기라고 권장합니다.

SUMMARY: Codex++는 공식 OpenAI Codex/ChatGPT 데스크톱 앱을 위한 동반 관리 도구입니다. 제공업체 전환(공식 로그인, API 또는 혼합), 모델별 컨텍스트 설정, 세션 관리, 과부하 시 요청 재시도, UI 개선(사용량 상태 표시줄, 타이핑 효과, 확장 기능), 다중 인스턴스 실행, 하위 에이전트 협업을 추가합니다 — 모두 별도의 창에서 구성하고 공식 앱을 시작할 때 적용됩니다. 공식 앱의 파일을 패치하지 않습니다. Windows/macOS, Rust + Tauri로 빌드, AGPL-3.0.

TITLE: Codex++는 공식 Codex 데스크톱 앱을 위한 관리 레이어입니다: AI 제공업체 전환, 모델별 설정 조정, 세션 관리, UI 개선 추가 — 공식 앱을 수정하지 않고.