요약

헤드리스 Linux 머신의 Codex 세션에 휴대폰으로 접근하는 방법은 네 가지입니다. 차이는 한 가지 질문으로 정리됩니다. Linux 머신 말고 또 무엇이 실행 중이어야 하나?

1. OpenAI의 Remote (공식, 지원됨): Mac이나 Windows PC에서 ChatGPT 데스크톱 앱을 실행하고, SSH로 Linux 머신에 연결하며, 휴대폰은 그 PC와 페어링합니다. 작업은 Linux 머신이 하지만 Mac이나 PC가 깨어 있어야 합니다.
2. Linux 머신에서 직접 codex remote-control: CLI 명령으로 문서화되어 있고, ChatGPT 모바일과 함께 동작했다는 보고가 있습니다. 하지만 OpenAI의 Remote connections 페이지에는 여전히 모바일 설정이 데스크톱 앱에서 시작된다고 되어 있으니, 비공식 방법으로 보고 변경을 예상하세요.
3. 휴대폰 터미널 앱에서 SSH + tmux (또는 mosh): 서버에 추가로 설치할 것이 없고 완전히 제어할 수 있지만, 작은 화면에서 diff를 읽고 승인에 답하기는 괴롭습니다.
4. Linux 머신에서 실행되는 컴패니언 앱: 예를 들어 Happier는 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 그 머신이 Codex 세션을 직접 시작하는 머신이 되고, Codex CLI 0.131.0 이상에서는 네이티브 Codex TUI와 휴대폰이 같은 스레드를 씁니다.

항상 켜져 있는 Mac이 이미 있다면 1번이 간단하고 지원되는 답입니다. 항상 켜져 있는 컴퓨터가 Linux 머신뿐이라면 계속 읽어 보세요.

문제

흔한 구성: 오래 걸리는 Codex 작업은 벽장 속 Linux 머신에서 돌아갑니다. 절전에 들어가지 않고, 저장소도 있고, 필요한 도구 체인도 갖춰져 있습니다. 노트북은 수시로 절전에 들어갑니다.

"Linux 서버에서 Codex 원격 제어"를 검색하면 "지원되지 않는다", "된다, 명령은 이렇다", "10분은 됐는데 그다음 휴대폰에 다시 환영 화면이 떴다"가 뒤섞여 나옵니다. 어떤 방법을 택하느냐에 따라 셋 다 사실입니다.

이 가이드는 각 방법에 무엇이 필요한지, 무엇을 얻는지, 사람들이 실제로 보고한 실패 사례를 정리합니다.

1번: OpenAI의 Remote, 중간에 Mac이나 Windows PC 두기

지원되는 방법입니다. 2026-10-11 기준 OpenAI의 Remote connections 페이지에는 다음과 같이 나와 있습니다.

• 원격 접근은 "macOS와 Windows에서 ChatGPT 데스크톱 앱을 실행하는 호스트를 지원"합니다.
• "모바일 설정은 앱에서 시작합니다. Codex CLI나 IDE 확장에서는 설정할 수 없습니다."
• Linux 머신은 SSH 호스트로 연결됩니다. 데스크톱 앱이 ~/.ssh/config에서 구체적인 호스트 별칭을 읽고, SSH로 원격 Codex 앱 서버를 시작하며, 원격 파일 시스템을 대상으로 채팅을 실행합니다. codex가 원격 사용자의 PATH에 있어야 합니다.
• ChatGPT 워크스페이스에서는 "관리자가 Remote Control 접근을 활성화해야 할 수 있습니다".

실제로는 이런 뜻입니다.

• 장점: 공식 제품이고, 다듬어진 휴대폰 UI로 승인과 diff를 휴대폰에서 다룰 수 있으며, 작업은 실제로 Linux 머신에서 실행됩니다.
• 단점: 데스크톱 앱을 실행하는 Mac이나 Windows PC가 경로에 끼어 있습니다. 그 PC가 절전에 들어가거나, 네트워크가 끊기거나, 앱을 닫으면 원격 접근이 멈춥니다. OpenAI도 그 호스트를 전원에 연결하고 깨어 있게 두라고 안내합니다.

어차피 항상 켜 둔 Mac mini가 있다면 여기서 멈추세요. 구성 요소가 적은 답입니다.

2번: Linux 머신에서 직접 codex remote-control

OpenAI의 개발자 명령 레퍼런스에는 다음이 문서화되어 있습니다.

codex remote-control          # run in the foreground
codex remote-control start    # start the local app-server daemon with remote control enabled
codex remote-control pair     # print a short-lived manual pairing code
codex remote-control stop

페어링 코드는 ChatGPT 모바일 앱에 입력합니다. r/codex 사용자들은 헤드리스 Linux에서 이 방법이 동작한다고 보고하는데, 반복해서 부딪히는 요구 사항이 두 가지 있습니다. API 키가 아니라 ChatGPT 로그인이 필요하다는 점(스레드에 인용된 오류는 "remote control requires ChatGPT authentication"), 그리고 npm 빌드는 안 됐지만 설치 스크립트 빌드는 됐다는 댓글이 있다는 점입니다.

사람들이 보고한 문제 (Reddit, 2026년 7월~9월. 버전에 따라 결과는 다릅니다):

• 휴대폰이 연결된 뒤 몇 분이 지나면 Mac 앱을 연결하라는 환영 화면이 뜹니다.
• 세션 기록은 보이지만, 휴대폰에서 메시지를 보내면 이미 실행 중인 CLI 세션이 아니라 별도의 포크로 갈라져 나갑니다.
• 업데이트 후 휴대폰이 마치 컴퓨터와 페어링한 적이 없는 것처럼 동작합니다. 그 스레드의 OpenAI 직원 답변은 codex remote-control pair를 안내합니다.

실제로는: 실재하는 명령이고, 특히 휴대폰에서 새 채팅을 시작할 때는 시도해 볼 만합니다. 다만 같은 방식으로 계속 동작한다는 전제로 워크플로를 만들지는 마세요. 공식 페이지는 CLI가 모바일 설정의 지원 경로가 아니라고 말합니다.

3번: 휴대폰에서 SSH + tmux

오래된 믿을 만한 방법입니다. 서버에서:

tmux new -s codex     # or: tmux attach -t codex
codex

휴대폰에서는 아무 SSH 클라이언트나 쓰면 됩니다 (Termius, Blink, Moshi, Android의 Termux). 네트워크가 자주 바뀐다면 mosh를, SSH를 인터넷에 열고 싶지 않다면 Tailscale을 쓰세요.

• 장점: 새로 믿어야 할 것이 없고, 어떤 에이전트에도 쓸 수 있으며, tmux가 세션을 유지하므로 연결이 끊겨도 버팁니다.
• 단점: 휴대폰에서 전체 터미널 UI를 읽어야 합니다. diff 리뷰, 긴 승인 프롬프트, "세 개의 창 중 어디가 막혔지?" 같은 순간에 지칩니다. 직접 훅을 구성하지 않으면 푸시 알림도 없습니다.

가끔 확인하는 정도라면 이걸로 충분하고 무료입니다.

4번: Linux 머신에서 실행되는 컴패니언 앱

다른 컴퓨터를 깨워 두지 않고 휴대폰으로 Linux 머신의 Codex를 제어하고 싶다면, Happier는 휴대폰, 데스크톱, 웹에서 Codex, Claude Code, OpenCode 등 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 이 분야에는 다른 앱도 있고, 그중 일부는 Linux의 Codex를 지원합니다. 아래 단계는 Happier 설정을 다룹니다.

방식은 1번, 2번과 다릅니다. Linux 머신에 Happier CLI를 설치하면 그 머신이 내 계정의 머신으로 등록되고, 휴대폰은 릴레이(Happier Cloud 또는 직접 호스팅한 릴레이)를 통해 머신과 통신합니다. 세션 내용은 기본적으로 종단 간 암호화됩니다. ID, 타임스탬프, 기기 ID 같은 메타데이터는 암호화되지 않습니다.

1) Linux 머신에 Happier 설치

curl -fsSL https://happier.dev/install | bash
happier setup

happier setup은 사용할 릴레이를 묻고, 로그인하고, 이 머신을 등록하고, 백그라운드 서비스의 자동 시작을 설정합니다.

데스크톱에서 진행하고 싶다면 데스크톱 앱에서 SSH로 원격 머신을 설정할 수도 있습니다 (Machines 설정의 Add machine over SSH, 또는 CLI가 이미 설치된 컴퓨터에서 happier machine setup --ssh user@host).

2) 머신에 Codex가 설치되고 로그인되어 있는지 확인

happier install provider codex   # or: npm install -g @openai/codex
codex --version                  # shared TUI control needs 0.131.0 or newer

그다음 로그인합니다. 머신에서 codex login을 실행하거나, Happier가 자격 증명을 갖도록 할 수 있습니다.

happier connect codex --device   # device-code flow, handy on a headless box
happier connect codex --paste    # fallback: paste the redirect URL
happier connect codex --api-key  # API key mode

기기 인증을 쓰려면 먼저 ChatGPT 설정에서 "device code authorization for Codex"를 켜야 할 수 있습니다.

3) 어느 쪽에서든 세션 시작

머신에서 (SSH가 끊겨도 TUI가 남도록 tmux 안에서):

cd ~/src/my-repo
happier codex

또는 휴대폰에서: 새 세션을 만들고, Linux 머신을 고르고, Codex를 고른 뒤 작업을 입력합니다.

4) 휴대폰과 TUI를 같은 스레드에서 사용

Happier 0.2.13부터 macOS나 Linux에서 Codex CLI 0.131.0 이상을 쓰면, Happier와 Codex TUI가 같은 실행 중인 앱 서버 스레드에 연결됩니다. SSH로 TUI에서 입력한 뒤 다음 명령을 휴대폰에서 승인해도 양쪽 모두 실시간으로 유지됩니다. 휴대폰에서 시작한 세션이라면 머신에서 happier attach <session-id>를 실행해 같은 세션의 TUI를 열 수 있습니다.

솔직한 한계:

• 공유 제어는 Happier로 시작한 세션에만 적용됩니다. codex로 직접 시작한 스레드는 실행 중에 Happier가 참여할 수 없습니다. Codex는 스레드마다 활성 작성자를 하나만 두기 때문입니다.
• Windows, ACP 모드, 오래된 Codex CLI에서는 제어가 배타적입니다. 휴대폰에서 보낸 메시지는 터미널 쪽 턴이 안전한 경계에 도달할 때까지 기다립니다.
• Linux 머신은 온라인이어야 합니다. Happier가 꺼진 머신, 끊긴 네트워크, 제공자 장애를 해결해 주지는 않습니다. 깨어 있어야 하는 게 그 머신 하나뿐이게 해 줄 뿐입니다.

선택 사항: 터미널 멀티플렉서로 Herdr를 쓴다면, Happier 0.2.16 릴리스에서 새 세션의 터미널 호스트로 Herdr가 추가되었습니다 (Herdr 0.9.2 이상, macOS와 Linux). 일부 문서 페이지는 업데이트를 따라잡는 동안 아직 개발 빌드 기능으로 표시하고 있습니다.

무엇을 골라야 할까?

문제 해결

"remote control requires ChatGPT authentication"

API 키로 로그인되어 있습니다. 1번과 2번에서는 ChatGPT 계정으로 Codex에 로그인하세요 (codex login 후 ChatGPT 선택). Happier에서는 happier connect codex --api-key로 API 키 모드를 쓸 수 있지만, 어떤 계정으로 세션 요금이 청구되길 원하는지 확인하세요.

휴대폰에 "Mac을 연결하세요" 환영 화면이 다시 뜸

2번에서 자주 보고되는 증상입니다. codex remote-control pair를 다시 실행해 다시 페어링하세요. 계속 반복된다면 이 경로의 지원되지 않는 부분이 드러나는 것입니다. 안정적인 경로는 1번이나 4번입니다.

휴대폰에서 보낸 메시지가 CLI 세션을 이어 가지 않고 새 채팅을 시작함

2번에서 보고되는 포크 동작입니다. Happier에서는 happier codex로 (또는 앱에서) 세션을 시작하면 TUI와 휴대폰이 같은 스레드를 공유합니다. 일반 codex로 시작한 스레드에는 실시간으로 참여할 수 없습니다.

Happier에서 Linux 머신이 오프라인으로 표시됨

머신에서:

happier daemon status --all

머신과 휴대폰이 같은 릴레이와 계정을 쓰는지 확인하세요. 서비스는 실행 중인데 세션에서 Codex가 시작되지 않는다면, codex가 대화형 셸뿐 아니라 백그라운드 서비스가 보는 PATH에도 있는지 확인하세요.

자주 묻는 질문

휴대폰으로 Codex를 제어하려면 Mac이 필요한가요?

OpenAI가 지원하는 Remote 경로라면 필요합니다. ChatGPT 데스크톱 앱을 실행하는 Mac이나 Windows PC가 있어야 합니다 (2026-10-11 기준). codex remote-control CLI 경로와 서드파티 컴패니언 앱에는 필요하지 않습니다.

작업은 휴대폰에서 실행되나요, 클라우드에서 실행되나요?

네 가지 모두 코드와 명령은 Linux 머신에서 실행됩니다. 휴대폰은 프롬프트와 승인을 보낼 뿐입니다. (Codex 클라우드 작업은 OpenAI의 별도 제품이며 여기서는 다루지 않습니다.)

Claude Code로도 같은 걸 할 수 있나요?

네. 다만 Anthropic의 Remote Control은 요구 사항이 다릅니다 (API 키가 아니라 claude.ai 로그인). 휴대폰으로 Claude Code 모니터링하는 방법을 참고하세요.

Happier는 무료인가요?

앱과 CLI는 오픈 소스입니다. Codex 자체 요금은 여전히 OpenAI 요금제나 API 키로 청구됩니다.

관련 가이드

• 휴대폰에서 Codex 사용하는 방법
• 홈 서버에서 Claude Code, Codex, OpenCode를 실행하고 휴대폰 브라우저로 진행 상황 확인하는 방법
• Tailscale로 휴대폰에서 Happier에 접속하는 방법