코덱스 "Waiting for desktop" 해결 방법: 모바일 페어링이 안 될 때 (2026)

휴대폰의 Codex가 "Waiting for desktop"에서 넘어가지 않는다면, Mac이 OpenAI에 온라인 컴퓨터로 등록되지 않은 상태입니다. 대부분 설정이 맞지 않거나, Mac의 프록시나 VPN이 Codex 원격 연결 서비스를 막고 있는 경우입니다.

이 메시지의 뜻, 먼저 확인할 것, 그래도 안 될 때 GitHub 사용자들이 시도한 방법을 정리했습니다.

"Waiting for desktop"의 뜻

페어링은 두 단계로 이뤄집니다. 먼저 휴대폰이 ChatGPT 데스크톱 앱의 QR 코드를 스캔합니다. 그다음 데스크톱 앱이 Mac이 온라인이고 준비됐다고 OpenAI에 알립니다. 두 번째 단계가 실패하면 휴대폰은 계속 기다립니다.

보통 데스크톱 앱은 "Approve on your device" 화면에 QR 코드를 띄운 채 멈춰 있습니다. 휴대폰에는 "Authorize this phone"이 나타나지 않습니다. GitHub 보고를 보면 Mac의 원격 연결 서비스가 "connecting"에 머물렀고, OpenAI의 연결된 컴퓨터 목록은 비어 있었습니다.

먼저 확인할 것

아래 내용은 OpenAI 공식 Codex 모바일 설정 가이드를 바탕으로 합니다.

• 같은 계정과 워크스페이스: 휴대폰과 Mac에서 같은 ChatGPT 계정과 같은 워크스페이스로 로그인하세요.
• 데스크톱 앱 실행: ChatGPT 데스크톱 앱을 열고 로그인한 상태여야 합니다. 설정은 Settings > Connections > Control this Mac or PC에 있습니다.
• Mac은 깨어 있고 온라인: OpenAI는 컴퓨터가 잠들지 않고 온라인이어야 한다고 안내합니다. 잠자기를 막는 방법은 caffeinate 가이드에 있습니다.
• 최신 버전: 휴대폰의 ChatGPT 앱과 Mac의 데스크톱 앱을 업데이트하세요.
• 워크스페이스 설정: 회사나 학교 워크스페이스라면 관리자가 먼저 원격 접속을 허용해야 할 수 있습니다.

흔한 원인: 프록시나 VPN

GitHub 이슈 #22851과 #25424의 보고 대부분은 Mac에서 프록시나 VPN을 쓰고 있었습니다. ChatGPT 앱 자체는 프록시를 거쳐도 잘 동작합니다. 하지만 Mac을 등록하는 백그라운드 서비스는 프록시 설정을 읽지 않습니다. 그래서 OpenAI에 닿지 못하고, Mac이 온라인으로 나타나지 않습니다.

프록시 앱, 회사 프록시, TUN 모드 VPN을 쓰고 있다면 해당될 수 있습니다. 보고된 로그에는 127.0.0.1:7890 같은 로컬 프록시가 보였습니다.

먼저 해 볼 것

프록시나 VPN을 끄세요. 데스크톱 앱을 완전히 종료하고 다시 연 뒤, 새 QR 코드로 처음부터 페어링하세요. 이렇게 해서 연결되면 원인은 프록시입니다.

사용자들이 공유한 우회 방법

프록시를 계속 써야 한다면 이슈 #22851에서 사용자들이 공유한 방법이 있습니다. OpenAI가 확인한 방법은 아니니 주의해서 쓰세요.

• Mac: 데스크톱 앱을 완전히 종료한 뒤 터미널에서 실행합니다. 이때 HTTP_PROXY, HTTPS_PROXY, ALL_PROXY에 프록시 주소를, NO_PROXY에 localhost,127.0.0.1을 지정합니다. 그러면 앱과 원격 연결 서비스가 모두 프록시를 씁니다.
• Windows: HTTP_PROXY, HTTPS_PROXY, NO_PROXY를 사용자 환경 변수로 추가하고, Codex를 완전히 종료한 뒤 다시 여세요.
• 서비스만 재시작: 원격 연결 서비스만 같은 프록시 설정으로 다시 시작한 뒤 새 QR 코드를 만든 사용자도 있습니다.

다시 페어링하는 방법

1. Mac에서 ChatGPT 데스크톱 앱을 엽니다.
2. Settings > Connections > Control this Mac or PC로 가서 Set up 또는 Add를 선택합니다.
3. 원격 접속을 허용하고 요청하는 인증을 마칩니다.
4. 휴대폰으로 새 QR 코드를 스캔하고 같은 계정과 워크스페이스로 로그인합니다.
5. 휴대폰에서 연결을 승인합니다.
6. ChatGPT 앱에서 Codex를 열고 Mac을 고릅니다.

그래도 안 될 때

OpenAI 쪽 버그일 가능성이 큽니다. 2026년 10월 기준으로 이슈 #22851과 #25424는 수정 발표 없이 열려 있습니다. 이슈에서 소식을 확인하거나 상황을 남겨 주세요.

대신 “Pairing code unavailable”이나 “Couldn't update remote control availability”가 보인다면 Mac에서 Codex 원격 연결이 안 될 때를 참고하세요.

휴대폰에서 Codex를 쓰는 다른 방법

Mac 터미널에서 Codex CLI를 쓰고 있다면 다른 방법도 있습니다. Macky는 별도의 앱이며 OpenAI의 페어링을 고쳐 주지는 않습니다. Mac의 터미널 자체를 iPhone에서 열어 주기 때문에 거기서 Codex를 실행할 수 있습니다.

• Codex 모드: Mac의 실제 터미널에서 쓰는 전용 Codex 모드입니다. OpenAI의 원격 연결을 쓰지 않습니다.
• 키 바로 승인: y와 Enter를 탭해 승인합니다. Ctrl+C로 작업을 멈출 수 있고 Esc와 Tab도 있습니다.
• Mac 전체: 전체 셸과 원격 데스크톱을 한 앱에서 씁니다.
• 덮개를 닫은 채로: Pro에서는 MacBook 덮개를 닫은 채로 쓸 수 있습니다. 백그라운드 연결도 Pro 기능입니다.

Macky는 5분 세션까지 무료로 써볼 수 있습니다. Pro는 1회 결제 ₩49,000입니다. App Store에서 받기.

휴대폰에서 Codex를 처음 쓴다면 Codex 모바일 설정 가이드부터 보세요. 승인 단계에서 멈춘다면 “Awaiting approval” 해결법을 참고하세요.