Codex++: OpenAI Codex 데스크톱 앱에 로컬 트윅을 설치하는 트윅 로더

9bow · 6월 10, 2026, 8:30오전

Codex++ 소개

Codex++는 OpenAI Codex 데스크톱 앱에 로컬 트윅(tweak)을 설치해 UI를 바꾸고, 설정 페이지를 추가하고, 메인 프로세스 코드를 실행하고, 네이티브 OS 기능까지 쓸 수 있게 해 주는 트윅 로더입니다. Codex 같은 AI 코딩 에이전트 앱은 보통 사용자가 내부를 건드리기 어렵게 닫혀 있습니다. Codex++는 설치된 앱을 패치해 Codex가 시작할 때 작은 Codex++ 런타임을 먼저 불러오도록 만들어, 앱을 다시 빌드하지 않고도 기능을 확장할 수 있게 합니다. OpenAI와 무관한 비공식 프로젝트이며, 앱을 직접 수정하는 도구이므로 사용에 따른 위험은 사용자가 감수해야 한다고 명시되어 있습니다.

이 프로젝트의 설계에서 핵심은 트윅과 런타임을 앱 번들 바깥에 둔다 는 점입니다. 앱에 들어가는 패치는 아주 작고, 트윅·설정·로그·백업·런타임 파일은 모두 사용자 데이터 디렉토리에 머뭅니다. 덕분에 Codex를 다시 빌드하지 않고도 트윅을 편집할 수 있습니다. Codex가 업데이트되면 보통 패치가 제거되는데, Codex++는 이를 감지해 패치를 다시 적용하는 워처(watcher)를 함께 설치합니다.

현재 macOS Codex 빌드는 Owl이라는 네이티브 앱 셸(Chromium + Electron 호환 JavaScript 런타임) 위에서 동작합니다. Codex++ 1.0.0은 Owl을 감지해 기능 상태를 보고하며, AppKit·Metal·헬퍼 프로세스·트윅 소유 네이티브 모듈을 위한 네이티브 브릿지를 지원합니다. 트윅 작성자는 Owl 내부를 직접 다루는 대신 api.codex.runtime.*, api.codex.windows.*, api.codex.native.* 같은 Codex++ SDK를 사용하도록 안내됩니다.

Codex++의 동작 방식

설치 흐름은 네 단계로 정리됩니다. Codex++가 Codex 앱을 찾아 원본 파일을 백업한 뒤 Codex의 app.asar 를 패치해 Codex++ 로더가 먼저 실행되게 하고, 런타임을 사용자 데이터 디렉토리에 스테이징하며, 필요하면 앱을 다시 서명하고, 이후 Codex 업데이트에 대비해 워처를 설치합니다.

실행 흐름은 이렇습니다. Codex를 실행하면 Codex++ 로더가 디스크의 런타임을 띄우고 Codex가 정상적으로 시작합니다. 그 다음 Codex++가 활성화된 트윅을 찾아, 렌더러 트윅은 Codex 창에서, 메인 프로세스 트윅은 Codex 메인 프로세스에서 실행하며, 설정 UI에 Codex++ 페이지와 트윅 제어 항목을 보여 줍니다.

파일 위치도 명확히 분리됩니다. 로더 패치만 Codex app.asar 안에 들어가고, 런타임은 <user-data-dir>/runtime/, 트윅은 <user-data-dir>/tweaks/, 설정·상태·로그·백업은 모두 사용자 데이터 디렉토리에 저장됩니다. macOS 기본 경로는 ~/Library/Application Support/codex-plusplus/ 입니다.

보안 측면에서는 트윅이 Codex 앱 안에서 로컬 코드를 실행하므로 신뢰하는 출처의 트윅만 설치하라고 권고합니다. Codex++는 트윅 파일을 조용히 갱신하지 않고, 업데이트 확인은 검토용 GitHub Releases 링크로 연결하며, 네이티브 브릿지 경로는 트윅 디렉토리 안의 파일로 제한됩니다.

Codex++ 설치 및 사용법

설치는 여러 경로가 있습니다. Homebrew, 소스 설치 스크립트, Windows PowerShell, Bun을 지원합니다.

# Homebrew (macOS)
brew install b-nnett/codex-plusplus/codexplusplus
codexplusplus install

# GitHub 소스 설치 스크립트
curl -fsSL https://raw.githubusercontent.com/b-nnett/codex-plusplus/main/install.sh | bash

설치 후 Codex를 평소처럼 실행하고 설정에서 Codex++ 섹션을 열면 됩니다. 자주 쓰는 명령은 패치와 런타임을 설치하는 codexplusplus install, 상태를 보는 status, 업데이트 뒤 패치를 다시 적용하는 repair, 모든 트윅을 지우지 않고 끄는 safe-mode 등입니다.

트윅은 매니페스트와 엔트리 파일로 이루어진 폴더입니다. 개발용 명령으로 새 트윅을 만들고 검증한 뒤 로컬에서 연결할 수 있습니다.

codexplusplus create-tweak ./my-tweak --id com.you.my-tweak --name "My Tweak"
codexplusplus validate-tweak ./my-tweak
codexplusplus dev ./my-tweak

트윅 작성 전체 가이드는 저장소의 docs/WRITING-TWEAKS.md 에 정리되어 있습니다.

Codex++의 라이선스

Codex++는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

Codex++ GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~