Codex Desktop GUI app을 linux에서 설치하고 사용하는 방법

 

이번 포스트에서는 codex app (GUI)을 Linux에서 사용할 수 있는 방법에 대해 알아봅니다. 

OpenAI의 Codex Desktop GUI 앱은 현재 macOS와 windows를 공식적으로 지원하고 있으며, 아직 Linux는 지원하지 않고 있습니다.  macOS용으로 가장 먼저 론칭했으며, 26년 3월부터 WIndows도 정식 지원하기 시작했습니다 만, Linux는 아직 지원을 하지 않고 있기 때문에 Linux에서는 Codex CLI 및 IDE 확장(VS Code, Cursor..)을 통해 기능을 활용할 수 있을 뿐입니다. 

이번 포스트에서 소개하는 codex-desktop-linux github 프로젝트는 macOS의 공식 패키지(.dmg) 파일을 이용하여 Linux에서 사용할 수 있도록 package로 만들고, 자동으로 설치까지 해주는 프로젝트입니다. 

좀 더 구체적으로는 macOS용 upstream DMG를 다운로드하고, app.assr를 패치한 후, Linux용 네이티브 모듈을 재빌드 하여 Linux용 Electron Runtime 패키지를 구성하는 방법을 사용합니다. 프런트엔드가 대부분 JavaScript/HTML/CSS 이기 때문에 쉽게 포팅할 수 있게 된 것 같습니다.  

설치 방법은 installer를 통해 쉽게 설치할 수 있습니다. 

우선,  아래와 같이 빌드 및 패키지를 위한 임시 폴더를 생성해 줍니다. 

mkdir -p ~/tmp/codex-work ~/tmp/codex-cache

export TMPDIR=~/tmp/codex-work
export XDG_CACHE_HOME=~/tmp/codex-cache

그리고, 아래와 같이 git clone으로 다운로드 받은 후, make bootstrap-native 명령을 내리면 끝입니다. 

git clone https://github.com/ilysenko/codex-desktop-linux.git
cd codex-desktop-linux
make bootstrap-native

시간은 대략 6분 ~10분 정도 걸린 것 같습니다. 아래의 스샷은 bootstap-native 의 마지막 부분입니다. 

팔자는 Fedora Asahi Linux를 사용하고 있으며. 스샷을 보면 aarch64.rpm 패키지를 만들고 해당 패키지를 install까지 자동으로 해 주고 있는 것을 볼 수 있습니다.

 rofi에서 codex로 검색을 하니, Codex Desktop 이 설치된 것을 알 수 있습니다.  실행을 해 보면, 아래와 같이 Codex Desktop 이 실행되는 것을 볼 수 있습니다. 

빌드 및 배포 산출물은 사용하는 Linux 배포판에 따라, .deb, .rpm, .pkg,tar.zst 는 물론 Nix flake까지 지원하며, 설치 후에는 로컬 자동 업데이트가 동작해, 새 upstream DMG 가 나오면 Linux 패키지를 다시 빌드할 수 있습니다. 

codex-computer-use-linux plug-in 으로 Linux Desktop을 관찰하고 제어하는 Computer Use 기능도 제공하며, appr.aasr 패치, Native Module 재 빌드, Linux Launcher 생성, 패키징, systemd 유저 서비스 설치가 포함되어 있습니다. 

codex cli 에 대한 의존성이 있기 때문에 설치되어 있어야 하는데 설치되어 있지 않다면 첫 실행 때 @opengl/codex를 번들된 managed Node.js runtime으로 자동 설치 및 업데이트해 줍니다. 

Linux 환경에서 Codex CLI 를 사용하시는 사용자 분이시라면 검토해 보시기 바랍니다.