Codex 앱을 Windows ARM64에서 돌리기 — 리패키징 스크립트 완전 가이드

Codex 앱을 Windows ARM64에서 돌리기 — 리패키징 스크립트 완전 가이드

최근 ASUS Zenbook A16을 장만했다. ARM 기반 노트북치고 성능과 배터리 수명이 모두 만족스러웠다. 그런데 개발 코딩 에이전트를 GitHub Copilot에서 OpenAI Codex로 전환하려는 순간, 예상불도한 문제에 맞닿았다. Codex CLI는 Windows ARM64를 지원하지만, 정작 Codex 앱은 x64 에뮬레이션으로만 실행된다는 것이다.

이 글에서는 개발자 kck4156이 만든 비공식 리패키징 스크립트 airtaxi/codex-app-windows-arm64를 소개한다.Electron 기반 Windows 앱을 ARM64 환경에서 네이티브에 가까운 성능으로 돌리는 방법과 그 원리를 자세히 살펴본다.

проблема: 왜 Codex 앱이 ARM64에서 늦을까

Microsoft Store에서 내려받을 수 있는 Codex 앱은 현재 x64 빌드만 제공한다. Windows ARM64 기기에서 x64 앱을 실행하면 Windows가 HQAT(Hybrid Emulation) 또는 ARM64EE(ARM64 Emulation Engine)를 통해 바이너리를 번역하는데, 이 과정에서 다음과 같은 성능 저하가 발생한다.

• 입력 지연: 키 입력카라 응답까지 레이턴시가 눈에 띄게 증가한다

• UI 멈춤: 채팅창에 текст를 입력할 때 버벅임이 발생한다

• 배터리 소모: 에뮬레이션 레이어가 계속 작동하면서 전력 소비가 늘어난다

Codex CLI는 이미 ARM64 네이티브 바이너리를 제공하므로 문제가 없다. 그러나 GUI 기반의 Codex 앱은 마소스토어 배포 정책상 ARM64 빌드가 제공되지 않아서, 이런 불편을 감수해야 했다.

해결책: 리패키징 스크립트의 동작 원리

개발자 Howon Lee(airtaxi)는 공식 x64 Codex 앱을 arb64 구성요소로 재조립하는 PowerShell 스크립트를 만들었다. 핵심 원리는Electron 앱이 사실상 웹 앱이기 때문에 런타임을 교체하면가구 변환이 가능하다는 점이다.

1단계: 소스 준비

스크립트는 Microsoft Store에 설치된 공식 x64 패키지를 시작점으로 사용한다. Build-CodexWoA.bat -SourceMode Installed 명령으로 설치된 앱을 자동으로 탐지한다.

2단계: 런타임 교체

- Electron 런타임 → win32-arm64로 교체- Node.js → win-arm64로 교체

，제양개조건가 ARM64 네이티브로 실행되면서 에뮬레이션 오버헤드가 크게 줄어든다.

3단계: 네이티브 모듈 재빌드

Codex 앱 내부에서 사용하는 네이티브 확장이 있다.

- better-sqlite3: 데이터베이스 모듈- node-pty: 터미널 에뮬레이션

이 모듈들은 x64용으로 컴파일되어 있어 ARM64에서 작동하지 않는다. 스크립트는 node-gyp을 통해 ARM64 크로스 컴파일로코레라오재빌드한다.

4단계: Helper 바이너리 교체

Codex 앱에는 codex.exe, codex-command-runner.exe, rg.exe(ripgrep) 같은 보조 실행 파일이 포함되어 있다. ARM64 빌드가 제공되는 파일은 교체하고, 아직 ARM64 버전이 없는 파일(node_repl.exe, tectonic.exe)은 에뮬레이션으로후오루백한다.

5단계: MSIX 패키징 및 서명

변환이 끝난 파일들을 makeappx.exe로 MSIX 패키지로 묶고, 자체 서명 인증서로 서명한다. 이렇게 해야 Windows가 패키지를 신뢰할 수 있다.

설치 방법: 3단계로 끝내기

방법 A: 빌드된 릴리즈 사용 (권장)

1. https://github.com/airtaxi/codex-app-windows-arm64/releases 에서 최신 릴리즈 다운로드2. 압축 해제3. Install.bat 실행

Install.bat은 인증서를 신뢰 저장소에 자동 등록하고 MSIX를 설치까지 처리한다.

방법 B: 직접 빌드

빌드 환경이 갖춰져 있다면 스크립트로 직접 빌드할 수도 있다.

전제 조건:

• Windows on ARM 기기

• Microsoft Store에서 설치한 Codex 앱(x64)

• PowerShell 7(pwsh)

• Node.js(npm, npx 포함)

• Windows SDK(makeappx.exe, signtool.exe)

• Visual Studio C++ ARM64 크로스 컴파일 도구

빌드 명령:

.\Build-CodexWoA.bat -SourceMode Installed -Force

빌드가 완료되면 dist\Codex-WoA__arm64.msix가 생성된다.

기술적 깊이: Electron 앱 리패키징의 함정

단순히 파일을 교체하는 것만으로는Electron 앱이 정상 작동하지 않는다. 주요 문제점과 해결 방법을 정리하면 다음과 같다.

AppxManifest.xml 수정

MSIX 패키지의 AppxManifest.xml에는 대상 아키텍처와 런타임 정보가 기록되어 있다. 여기서 OSMinVersion과 ProcessorArchitecture를 ARM64로 변경해야 패키지가 인식된다.

자체 서명 인증서 문제

Microsoft Store 앱은 MS Store 인증서로 서명되어 있다. 앱을 수정하면 기존 서명이 무효화되므로, 자체 서명 인증서를 만들어서 다시 서명해야 한다. signtool.exe를 사용하며, 서명 후 Install.ps1이 인증서를 시스템 신뢰 저장소에 등록한다.

업데이트 기능 비활성화

Codex 앱에는 자동 업데이트 기능이내치되어 있다. 자체 서명된 패키지에서는 업데이트 서버와의 통신 문제가 발생할 수 있으므로 windows-updater.node 모듈을 제거한다.

현재 지원 상태

프로젝트 README에 따르면 다음 기능이검증되었다.

• 기본 앱 실행 및 로그인

• 대화 기능 사용

• ARM64 네이티브 node-pty 작동

• ARM64 빌드 ripgrep(rg.exe) 교체

반면 일부 helper 도구(node_repl.exe, tectonic.exe)는 아직 ARM64 대체재를 찾지 못해 x64 에뮬레이션으로 동작한다. 이는 전체 성능을 저하시키지 않고 부분적으로에미유레시요은취호이다.

향후 전망

OpenAI가 공식 Windows ARM64 버전을 제공하면 이 프로젝트는 자연스럽게력사적의의만 갖게 된다. 그 전까지는 Codex 앱 버전이 올라갈 때마다 스크립트를갱신할 계획이다. GitHub Issues나 Pull Request를 통한 기여도 환영하므로,ARM64 네이티브 대체재를 찾거나 패치지 검증에 참여할 수 있다.

요약

airtaxi/codex-app-windows-arm64는 다음 세 가지 핵심 문제점을 한 번에 해결한다.

문제	해결
Codex 앱 x64 에뮬레이션 성능 저하	Electron/Node.js ARM64 런타임 교체
네이티브 모듈 비호환	better-sqlite3, node-pty ARM64 재빌드
MSIX 서명 문제	자체 서명 인증서로 재패키징

Windows on ARM 기기에서 Codex 앱을 부드럽게 사용하고 싶은 개발자라면 지금 바로 시도해볼 것을 권한다.

---

📚 출처

• https://github.com/airtaxi/codex-app-windows-arm64

• https://news.hada.io/topic?id=29156

---

📚 출처

• https://news.hada.io/topic?id=29156