프로젝트 소개
Codex++는 OpenAI Codex / ChatGPT 데스크톱 애플리케이션을 위한 외부 실행기이자 관리 도구입니다. Chromium DevTools Protocol(CDP)과 로컬 보조 서비스를 활용하여 공급자 전환, 프로토콜 변환, 세션 관리 및 인터페이스 강화 기능을 제공하며, 공식 앱의 app.asar를 수정하거나 설치 디렉터리에 패치 파일을 기록하지 않습니다.
설치 후 두 가지 진입점이 제공됩니다. Codex++는 공식 데스크톱 앱을 자동으로 실행하고 저장된 공급자 구성과 강화 기능을 로드합니다. Codex++ 관리 도구는 공급자, 모델, 도구 플러그인, 세션, 강화 기능, 스크립트, 업데이트 및 진단을 관리하는 데 사용됩니다. 처음 사용 시 관리 도구를 먼저 열어 앱 경로와 실행 상태를 확인한 후, 공급자와 강화 기능을 구성하고 Codex++ 진입점을 통해 시작하는 것이 좋습니다. Windows 설치 패키지는 바탕화면과 시작 메뉴 바로가기를 생성하며, macOS DMG는 Codex++.app과 관리 도구 앱을 설치합니다.
공급자 구성은 공식 로그인, 공식 로그인과 API 혼합, 순수 API, 통합 공급자를 지원하며, Responses/Chat Completions 프로토콜, 모델 테스트, 모델 목록, Provider Doctor, cc-switch 및 링크 가져오기 기능을 포함합니다. 공식 로그인 모드는 공식 계정만 사용합니다. 공식 로그인 + API 모드는 공식 계정과 플러그인 진입점을 유지하지만, 모델 요청은 항상 호환 API를 통해 전송됩니다. 순수 API 모드는 사용자 정의 Base URL과 Key를 완전히 사용합니다. 통합 공급자는 여러 일반 API 공급자 간에 라우팅을 지원하며, 장애 조치, 세션별 라운드 로빈, 요청별 라운드 로빈 및 가중치 라운드 로빈을 제공합니다. Chat Completions는 로컬 프록시를 통해 Codex가 사용하는 Responses 프로토콜로 변환될 수 있습니다.
모델 및 컨텍스트 측면에서는 모델별 컨텍스트 창, 자동 압축 임계값, model_catalog_json, 일반 구성, 그리고 공급자별 MCP, Skill 및 Plugin 선택을 지원합니다. 모델별 창은 1M, 200K 또는 순수 숫자를 지원하며, Codex++는 독립적인 model_catalog_json을 생성합니다.
세션 관리는 로컬 세션 스캔, 일괄 삭제, Markdown 내보내기, 토큰 사용량 기록, Provider 메타데이터 동기화 및 백업을 지원합니다. Codex 강화 기능에는 플러그인 마켓 및 모델 화이트리스트, 세션 작업, 붙여넣기 수정, 중국어 인터페이스, 빠른 실행, 세션 너비 및 스크롤 복원, 서비스 수준 제어, Goals, Stepwise, 이미지 오버레이가 포함됩니다. 개발 워크플로는 프로젝트 이동, Upstream worktree, 스레드 ID, Zed Remote 프로젝트 식별 및 열기를 지원합니다. 스크립트 및 유지 관리에는 사용자 스크립트 설치 및 시작/중지, 앱 감지, 바로가기, Watcher, 환경 충돌, 로그 진단, 상태 확인 및 릴리스 업데이트가 포함됩니다. 모든 인터페이스 강화 기능은 개별적으로 비활성화할 수 있으며, Codex 강화 기능의 전체 스위치를 끄면 공급자 및 실행 관리 도구로만 사용할 수 있습니다.
데이터 위치는 Codex 구성 ~/.codex/config.toml, 로그인 상태 ~/.codex/auth.json, 로컬 데이터베이스 ~/.codex/sqlite/*.db (구버전은 state_5.sqlite로 대체), Codex++ 상태 및 로그 ~/.codex-session-delete/, Provider 동기화 백업 ~/.codex/backups_state/provider-sync입니다. 실제 API Key는 로컬 시스템에만 저장됩니다.
프로젝트는 GitHub Release를 통해 설치 패키지를 배포하며, Windows용 NSIS 설치 프로그램과 macOS용 Intel x64 및 Apple Silicon arm64 두 가지 DMG를 생성합니다. 관리 도구의 정보 페이지에서 업데이트를 확인하고 시작할 수 있습니다. 프로젝트는 GNU Affero General Public License v3.0을 사용하며, SPDX 식별자는 AGPL-3.0-only입니다. Codex++는 공식 데스크톱 앱의 페이지 구조, CDP 및 로컬 데이터 형식에 의존하므로, 공식 앱이 업데이트되면 일부 주입 기능이 이에 맞게 조정되어야 할 수 있습니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.