yynxxxxx/Codex-X — OpenAI Codex 데스크톱·CLI를 위한 시각형 관리 도구

AI 요약

Codex-X는 OpenAI Codex 데스크톱 앱과 Codex CLI를 함께 사용하는 환경에서 Prompt, API 공급자, 로그인 상태, 세션, Skills/MCP, 설정 파일을 시각적 인터페이스로 통합 관리하는 크로스플랫폼 데스크톱 도구입니다. Codex 데스크톱, CLI, 제3자 API, 여러 Prompt와 확장 기능을 동시에 사용하면 설정이 서로 다른 파일과 디렉터리에 흩어질 수 있는데, Codex-X는 이러한 작업의 현재 상태를 한 화면에서 확인하고 자주 쓰는 조작을 버튼으로 수행하도록 구성합니다.

■ Prompt 템플릿과 주입 방식

Prompt 관리 기능은 템플릿을 카테고리별로 정리하고, Markdown 파일을 가져오거나 직접 작성·편집하며, 개별 Prompt를 한 번의 조작으로 활성화하거나 비활성화할 수 있도록 합니다. 설치 패키지에는 5개의 템플릿이 오프라인으로 포함되고, 실행 후에는 GitHub의 examples/ 디렉터리에서 소프트웨어 개발과 글쓰기 지원에 사용하는 6개 템플릿을 추가로 동기화합니다. 온라인 동기화에 성공한 템플릿은 로컬에 캐시되므로 일시적으로 오프라인 상태에서도 사용할 수 있습니다. 사용자는 제목, 파일명, 내용, 설명과 분류를 직접 수정할 수 있으며, 자체 템플릿을 라이브러리처럼 관리할 수 있습니다.

활성화 방식은 두 가지입니다. ‘기존 Prompt 유지’ 방식은 사용자가 원래 갖고 있던 지침을 그대로 두고 Codex-X가 관리하는 내용을 추가하며, 비활성화할 때도 Codex-X가 추가한 부분만 제거합니다. ‘기존 Prompt 교체’ 방식은 선택한 템플릿을 현재 주요 지침으로 사용하도록 전체 전환합니다. 서로 다른 모델, 작업, Prompt를 빠르게 바꾸려는 경우를 각각 고려한 구성입니다. 활성화·비활성화 작업 전에는 자동으로 백업을 생성합니다. 제공되는 템플릿에는 일반적인 코딩용, GPT-5.4 및 Codex CLI 기반 CTF·보안 연구용, 소프트웨어 유지보수·디버깅·코드 리뷰용, 기술 문서와 글쓰기용 등이 포함됩니다.

■ Provider/API와 로그인 관리

Codex-X는 여러 개의 공식 Codex 로그인 설정과 제3자 API 공급자를 이름을 붙여 저장하고, 현재 사용 중인 항목을 확인하면서 복사하거나 전환할 수 있게 합니다. 제3자 Provider는 연결 검사, 모델 목록 가져오기, 모델 테스트를 지원하며, cc-switch에 저장된 공급자를 가져올 때는 신규 항목, 업데이트, 병합, 건너뛰기를 구분합니다. 동일한 URL과 Key를 가진 항목이 중복으로 표시되지 않도록 처리합니다.

Provider 편집 화면에서는 Base URL, API Key, Model, Wire API와 전체 TOML을 수정할 수 있습니다. 공식 로그인 상태로 되돌아갈 때도 기존 공식 인증 상태를 유지하며, 제3자 설정이 사라지지 않도록 구성되어 있습니다. 새로운 제3자 Provider를 활성화한 뒤에는 Codex 전체를 재시작할 필요 없이 새 세션을 만들거나 기존 세션을 다시 열면 해당 중계 설정을 사용할 수 있다고 설명합니다. 모델이 지원하는 경우 Provider 편집 화면에서 ‘1M 컨텍스트 윈도우’를 켤 수도 있으며, 저장 후 적용됩니다.

■ 세션, Skills와 MCP 관리

세션 관리 화면에서는 로컬 Codex 기록을 제목, 프로젝트 경로, Provider, ID로 검색하고 프로젝트 경로별로 그룹화할 수 있습니다. 각 세션이 현재 Provider 및 모델 설정과 일치하는지 검사하고, 필요할 때 현재 Provider 설정으로 동기화할 수 있으며 채팅 내용 자체는 수정하지 않습니다. 세션은 단일 또는 복수로 선택하거나 프로젝트 단위로 선택해 삭제할 수 있고, 삭제하면 Codex 자체 저장소의 해당 세션과 파생된 하위 세션도 함께 제거됩니다. 영구 삭제는 복구할 수 없으므로, 문서에서는 해당 세션을 사용 중인 Codex 창이나 CLI를 먼저 닫고 확인 창의 삭제 목록을 다시 확인하라고 안내합니다.

Skills와 MCP는 여러 디렉터리와 설정 파일을 직접 찾아가지 않고 한 화면에서 확인하도록 했습니다. 기존 Skill을 가져오거나 ZIP 파일에서 설치할 수 있으며, 항목별 활성화·비활성화와 업데이트 상태 확인을 지원합니다. MCP는 기존 MCP Server를 먼저 미리 본 뒤 관리 대상으로 가져올 수 있고, 활성화나 비활성화 이후 Codex 설정을 Codex-X가 자동으로 관리합니다.

■ 설정 파일과 사용량 통계

Codex-X는 기본적으로 ~/.codex/config.toml과 ~/.codex/auth.json을 읽습니다. CODEX_HOME 환경 변수로 Codex 설정 디렉터리를 바꿀 수 있고, CODEXX_HOME은 Codex-X 자체 데이터 경로, CC_SWITCH_HOME은 cc-switch 경로를 지정하는 데 사용할 수 있습니다. Codex-X의 로컬 데이터베이스 기본 위치는 ~/.codexx/codexx.db입니다. UI에서는 공식 Auth와 제3자 API Key를 구분해 확인하고, 현재 Codex가 사용하는 live config.toml을 코드 하이라이팅으로 볼 수 있습니다. 설정을 저장하면 Codex 설정 디렉터리에 반영되며, 중요한 쓰기 작업 전에는 자동 백업을 생성합니다.

설정 화면의 사용량 통계에서는 날짜와 모델을 기준으로 로컬 Token 사용량을 필터링할 수 있습니다. 일별 추이, 캐시 적중률, 모델별 분포, 최근 10개 주요 세션을 확인하며, 하위 에이전트의 사용량은 별도 세션으로 분리하지 않고 소속된 주요 세션에 합산합니다.

■ 배포와 기술 구성

배포 대상은 macOS Apple Silicon 및 Intel용 DMG, Windows MSI와 Portable ZIP, Linux용 DEB·RPM·AppImage입니다. GitHub Actions와 GitHub Releases를 통해 빌드·배포하며, 설치 버전은 애플리케이션 안에서 업데이트를 다운로드하고 검증한 뒤 설치할 수 있습니다. Windows Portable 버전은 수동 다운로드 방식으로 업데이트합니다. 서명되지 않았거나 공증되지 않은 macOS DMG에서 Gatekeeper가 ‘앱이 손상됐다’고 표시하는 경우에 대해서는 Apple Developer ID 서명과 notarization을 권장하고, 로컬 테스트에 한해 quarantine 속성을 제거하는 명령을 안내합니다.

구현에는 데스크톱 프레임워크로 Tauri 2, 프런트엔드로 React 18·TypeScript·Vite, 백엔드로 Rust, 로컬 데이터 저장소로 SQLite와 rusqlite, 설정 편집 형식으로 TOML·JSON을 사용합니다. 개발 환경에서는 pnpm install과 pnpm dev로 실행하며, 데스크톱 빌드는 pnpm --dir apps/desktop tauri build 명령으로 수행합니다. 프로젝트는 MIT License로 공개되어 있으며, 사용자는 합법적이고 권한을 부여받은 범위에서 사용해야 한다는 선언을 포함합니다.

원문: GitHub / 번역·요약: Trawling