Show GN: Codex Relay - 모바일에서 코덱스 Terminal, Browser, Git, File Viewer, Markdown 탑재 완벽 가이드
Codex Relay는 모바일에서 코덱스를조공하는 오픈소스 도구입니다. ChatGPT 앱에 공식 Codex Remote가 등장했지만, Terminal, Browser, Git, File Viewer, Markdown Viewer 등 추가 기능을 하나로 모아서 편안하게 사용할 수 있는 것이 바로 Codex Relay입니다.
왜 Codex Relay인가
코덱스는 개발자라면 한 번쯤 사용해보고 싶은 AI 코드 어시스턴트입니다. 데스크톱에서 실행하면 강력하지만,외출 중에도 코덱스 세션을 관리하고 싶다면 어떻게 해야 할까요?
OpenAI가 2026년 5월 ChatGPT 모바일 앱에 Codex를 интегриру했지만, Codec Relay는 거기서 한 걸음 더 나아갑니다. 로컬 릴레이 서버를 통해 보안적으로도 안전하고, 무엇보다 무료로 완전한 기능을 제공합니다.
설치 prerequisites
Codex Relay를 시작하기 전에 다음 환경이 준비되어야 합니다.
• Node.js 22.14 이상
• Codex CLI 설치 및 로그인 상태
• Codex Relay 모바일 앱 (iOS/App Store에서 다운로드)
• 모바일과 컴퓨터가 같은 Wi-Fi 네트워크에 있거나 Tailscale로 연결된 상태
시작하는 방법 — 3단계면 끝
1단계: 릴레이 서버 실행
프로젝트 워크스페이스에서 다음 명령어를 실행합니다.
npx codex-relay@latest실행하면 QR 코드와 모바일 URL, 그리고 codex-relay://pair... 페어링 링크가 출력됩니다.
2단계: 모바일 앱에서 QR 스캔
Codex Relay 앱을 열고 출력된 QR 코드를 스캔합니다. 스캔이 불가능하면 codex-relay://pair... 링크를 앱에 직접 붙여넣습니다.
3단계: 승인
모바일 앱에 승인 코드가 표시되면, 컴퓨터에서 다음 명령어로 승인합니다.
npx codex-relay@latest approve XXXX-XXXX이제 모바일에서 로컬 Codex 세션과 통신할 수 있습니다.
주요 기능 살펴보기
실시간 Terminal 스트리밍
Codex가 코드를 생성하거나 명령어를 실행하는 과정을 모바일에서 실시간으로 볼 수 있습니다. 로컬 터미널 출력이 스트리밍되므로외출 중에도 작업 진행 상황을 확인 가능합니다.
Browser 지원
로컬 웹 서버의 출력을 모바일에서 미리볼 수 있습니다. Codex가 웹사이트를 구현하거나 검증할 때, 모바일에서 바로 결과를 확인할 수 있다는 뜻입니다.
Git 변경사항 미리보기
작업 디렉터리의 Git 상태를 모바일에서 바로 확인할 수 있습니다. 커밋하지 않은 변경사항, 현재 브랜치, 스테이지 상태 등을 inúmer없이 확인 가능합니다.
File Viewer
워크스페이스의 파일을 모바일에서 바로 열어서 볼 수 있습니다. Codex가 생성하거나 수정 중인 파일을 즉시할 수 있습니다.
Markdown Viewer
마크다운 파일을 깔끔하게 렌더링해서 확인할 수 있습니다. Codex가 작성한 문서나 README 파일을외출선에서 바로 읽을 수 있습니다.
유용한코마은도 정리
# 기본 시작npx codex-relay@latest# 백그라운드에서 실행npx codex-relay@latest --bg# 현재 QR 코드 출력 (이미 실행 중인 서버 기준)npx codex-relay@latest qr# 모바일 페어링 승인npx codex-relay@latest approve XXXX-XXXX# 모든 페어링된 모바일 앱 로그아웃npx codex-relay@latest clear네트워크 설정 — 다른 Wi-Fi 또는 원격
같은 Wi-Fi가 아니라면 Tailscale을 사용하면 됩니다.
CODEX_RELAY_PUBLIC_URL=http://<컴퓨터-IP>:8787 npx codex-relay@latestTailscale이 설치되어 있다면 원격 환경에서도 안전하게 Codex 세션에 연결할 수 있습니다.
환경 변수 설정
Codex Relay는 유연한 설정을 지원합니다.
| 변수 | 기본값 | 용도 |
|---|---|---|
PORT | 8787 | 서버 포트 |
HOST | 0.0.0.0 | 리스닝 호스트 |
CODEX_RELAY_PUBLIC_URL | 자동 생성 | 페어링 QR에 표시되는 URL |
CODEX_RELAY_WORKSPACE_PATH | 현재 디렉터리 | Codex가 사용할 워크스페이스 경로 |
CODEX_BIN | codex | Codex CLI 경로 |
백그라운드 모드에서 실행하기
데스크톱을 끄더라도 Codex 세션을 모바일에서 계속 관리하고 싶다면,에서 서버를 실행하면 됩니다.
npx codex-relay@latest --bg백그라운드 모드는 .codex-relay/ 디렉터리에 런타임 파일을 저장합니다. 서버 로그, 프로세스 상태, 페어링 데이터 등이 포함됩니다.
Codex Relay 대안 비교
OpenAI가 ChatGPT 앱에 공식 Codex Remote를 제공하지만, Codex Relay만의 فرق가 있습니다.
| 기능 | ChatGPT 공식 | Codex Relay |
|---|---|---|
| Terminal 스트리밍 | 부분 지원 | 전체 지원 |
| Git 미리보기 | 미지원 | 지원 |
| File Viewer | 미지원 | 지원 |
| Markdown Viewer | 미지원 | 지원 |
| Browser 미리보기 | 부분 지원 | 전체 지원 |
| 오픈소스 | 아닙니다 | Apache 2.0 |
| 비용 | 유료 구독 필수 | 완전 무료 |
Codex Relay는 완전한 기능을 무료로 제공하는 것이 가장 큰 차별점입니다.
이런 분에게 추천합니다
• 외출 많거나 원격 근무하는 개발자 — 모바일에서 Codex 작업 진행 상황 확인
• 여러 머신을 오가는 개발자 — 어떤 장치에서든 Codex 세션 관리
• 코드 리뷰를 빠르게 확인하고 싶은 개발자 — Git 변경사항을 모바일에서 즉시 확인
• Codex를 안정적으로 모바일에서조공하고 싶은 개발자 — Tailscale과 함께 사용하면 보안도 안심
빠른 설정 요약
# 1. 설치npm i -g codex-relay# 2. 실행npx codex-relay@latest# 3. QR 스캔 후npx codex-relay@latest approve XXXX-XXXX# 끝!Codex Relay는 로컬 우선 설계를 바탕으로 하고 있어, 코드와 세션 데이터가 항상 컴퓨터에재합니다. 모바일은 릴레이를 통해서만통신하므로 보안적으로도 안전합니다.
오픈소스 기반으로 Apache 2.0 라이선스를 갖추고 있으니, 실무에 바로 도입해도 좋습니다.외출 중에도 코덱스를조공하고 싶다면, 가장 먼저 시도해볼 만한 도구입니다.
📚 출처
'자동화&툴 리뷰' 카테고리의 다른 글
| Phosphene - Apple의 비디오 배경화면을 macOS Tahoe에서原生復刻 (0) | 2026.05.24 |
|---|---|
| Firefox의 Web Serial 지원 발표 — 개발자가 알아야 할 핵심 정리 (0) | 2026.05.23 |
| Show GN: Lemini — 두 가지 모드로 동작하는 법 자문 챗봇 완벽 가이드 (0) | 2026.05.20 |
| Show GN: Claude Code / Codex CLI의 무거운 코드 생성을 로컬 LLM으로 위임하는 tunaLlama 완벽 가이드 (0) | 2026.05.18 |
| AI 집단 광기(AI Psychosis) — MIT가 경고하는 소프트웨어 산업의 현주소 (1) | 2026.05.17 |