원격 연결
Remote를 사용하여 연결된 컴퓨터의 작업에 액세스하거나, SSH를 통해 ChatGPT 데스크톱 앱을 프로젝트에 연결하세요
원격 연결을 사용하면 다른 기기나 머신에서 실행 중인 작업에 액세스할 수 있습니다. ChatGPT 모바일 앱에서 Remote를 열면 연결된 Mac 또는 Windows 기기의 ChatGPT나 Codex 채팅으로 작업할 수 있습니다. ChatGPT 데스크톱 앱을 실행하는 지원되는 다른 기기에서 작업을 계속하거나, 앱을 SSH 호스트의 프로젝트에 연결할 수도 있습니다.
원격 액세스에서는 연결된 호스트의 프로젝트, 채팅, 파일, 자격 증명, 권한, 플러그인, Computer Use, 브라우저 설정 및 로컬 도구를 사용합니다.
원격으로 할 수 있는 작업
- 호스트의 프로젝트에서 새 채팅을 시작하거나 기존 채팅을 계속합니다.
- 후속 지침을 보내고, 질문에 답하며, 진행 중인 작업의 방향을 조정합니다.
- 명령 및 기타 작업을 승인합니다.
- 출력, diff, 테스트 결과, 터미널 출력 및 스크린샷을 검토합니다.
- ChatGPT가 작업을 완료하거나 사용자의 확인이 필요할 때 알림을 받습니다.
- 연결된 호스트와 채팅 간에 전환합니다.
다음 섹션에서는 ChatGPT 모바일 앱에서 Remote를 열어 데스크톱 호스트에 액세스하는 방법을 설명합니다. Codex를 SSH 호스트의 프로젝트에 연결하려면 SSH 호스트에 연결을 참조하세요.
Remote를 설정하기 전에
다음 항목을 준비하세요.
- 사용하려는 ChatGPT 계정과 워크스페이스의 Codex 액세스 권한.
- iOS 또는 Android 기기에 설치된 최신 ChatGPT 모바일 앱. 앱에 Remote가 표시되지 않으면 먼저 ChatGPT를 업데이트하세요.
- 절전 상태가 아니고 온라인 상태이며 동일한 계정과 워크스페이스에 로그인된 호스트에서 실행 중인 최신 macOS 또는 Windows용 ChatGPT 데스크톱 앱. 모바일 설정은 앱에서 시작하며 Codex CLI나 IDE 확장 프로그램에서는 설정할 수 없습니다.
- 해당 계정이나 워크스페이스에 필요한 다단계 인증, SSO 또는 패스키 구성.
ChatGPT 워크스페이스를 통해 Codex를 사용하는 경우 휴대전화에서 연결하기 전에 관리자가 Remote Control 액세스를 활성화해야 할 수 있습니다.
Remote 설정
연결하려는 호스트의 ChatGPT 데스크톱 앱에서 시작합니다. 설정 절차를 진행하면 해당 호스트의 원격 액세스가 활성화되고 휴대전화로 스캔할 수 있는 QR 코드가 표시됩니다. QR 코드는 해당 휴대전화와 호스트를 페어링합니다. 제어하려는 각 호스트에 모든 휴대전화 또는 지원되는 데스크톱 앱 기기를 각각 페어링하세요.
Remote 설정을 시작합니다.
호스트에서 앱을 열고 사이드바의 Remote 설정을 선택합니다.
QR 코드를 스캔합니다.
휴대전화로 앱에 표시된 QR 코드를 스캔합니다. 코드가 ChatGPT를 열면 모바일 앱과 호스트의 연결을 완료할 수 있습니다.
ChatGPT에서 설정을 완료합니다.
ChatGPT에서 Remote 설정 절차가 열립니다. 동일한 ChatGPT 계정과 워크스페이스인지 확인한 다음, 필요한 다단계 인증, SSO 또는 패스키 단계를 완료합니다. 설정이 완료되면 휴대전화의 Remote에 호스트가 표시됩니다.
호스트 설정을 검토합니다.
호스트의 앱에서 Settings > Connections를 사용하여 연결된 기기를 관리합니다. 컴퓨터를 절전 모드로 전환하지 않을지, Computer Use를 활성화할지 또는 Chrome 확장 프로그램을 설치할지도 선택할 수 있습니다.
연결 대상 선택
이미 ChatGPT를 사용 중인 노트북이나 데스크톱부터 시작하세요. 지속적인 액세스나 다른 환경이 필요하면 상시 켜져 있는 컴퓨터 또는 SSH 호스트를 추가하세요.
노트북 또는 데스크톱
데스크톱 앱이 이미 설치된 Mac 또는 Windows PC를 연결합니다. 그러면 기존에 사용하던 동일한 프로젝트, 채팅, 자격 증명, 플러그인 및 로컬 설정에 원격으로 액세스할 수 있습니다.
해당 컴퓨터가 절전 모드로 전환되거나 네트워크 연결이 끊기거나 앱이 종료되면 다시 사용할 수 있을 때까지 원격 액세스가 중지됩니다. 이 컴퓨터를 호스트 기기로 사용하는 경우 전원을 연결하고, 지원된다면 호스트의 연결 설정을 사용하여 절전 모드로 전환되지 않도록 설정하세요.
Mac 노트북에서는 덮개가 열려 있고 전원이 연결된 상태에서 원격 액세스를 계속 사용할 수 있습니다. 덮개를 닫는 경우 외부 디스플레이도 연결하세요. Sleep을 선택하면 원격 액세스는 중지됩니다.
Windows 호스트에서는 Computer Use를 사용하는 작업을 위해 세션을 잠금 해제된 사용 가능한 상태로 유지하세요. Windows의 Computer Use는 포그라운드에서 실행되므로, 호스트 데스크톱을 작업 전용으로 사용하는 동안 원격 제어로 작업을 시작하거나 확인하는 것이 가장 적합합니다.
상시 켜져 있는 전용 컴퓨터
ChatGPT를 장시간 실행되는 작업에도 계속 연결 가능한 상태로 유지하려면 상시 켜져 있는 전용 Mac 또는 Windows PC를 사용하세요.
ChatGPT가 해당 머신에서 사용해야 하는 프로젝트, 자격 증명, MCP 서버, 스킬 및 도구를 설치하세요.
원격 개발 환경
프로젝트가 이미 원격 환경에 있는 경우 SSH 호스트 또는 관리형 원격 개발 환경을 사용하세요. 먼저 데스크톱 앱 호스트를 해당 환경에 연결합니다. 휴대전화는 계속 동일한 호스트에 연결되며, ChatGPT는 원격 환경의 종속성, 보안 정책 및 컴퓨팅 리소스를 사용하여 작업합니다.
SSH 설정에 관한 자세한 내용은 SSH 호스트에 연결을 참조하세요.
연결된 호스트에서 제공되는 항목
휴대전화는 프롬프트, 승인 및 후속 메시지를 ChatGPT로 보냅니다. 연결된 호스트는 ChatGPT가 사용하는 환경을 제공합니다.
이는 다음을 의미합니다.
- 저장소 파일과 로컬 문서는 연결된 호스트에서 가져옵니다.
- 셸 명령은 해당 호스트 또는 원격 환경에서 실행됩니다.
- MCP 서버, 스킬, 브라우저 액세스 및 Computer Use는 해당 호스트의 구성에서 제공됩니다.
- 로그인된 웹사이트와 데스크톱 앱은 호스트에서 액세스할 수 있을 때만 사용할 수 있습니다.
- 샌드박스 설정, 보안 제어 및 작업 승인은 연결된 세션에도 계속 적용됩니다.
보안 릴레이 계층을 통해 신뢰할 수 있는 머신을 공용 인터넷에 직접 노출하지 않고도 승인된 ChatGPT 기기에서 연결할 수 있습니다.
다른 기기에서 작업 이어서 하기
로그인되어 있고 원격 제어를 지원하는 다른 기기에서 ChatGPT 데스크톱 앱을 실행하여 작업을 계속할 수 있습니다. 예를 들어 노트북을 사용할 수 없다면 휴대전화에서 상시 켜져 있는 호스트의 채팅을 시작한 다음, 나중에 노트북에서 앱을 열어 동일한 채팅을 계속할 수 있습니다.
기능을 사용할 수 있는 Mac 또는 Windows 기기에서 Settings > Connections > Control other devices를 사용하여 다른 호스트를 추가하세요. 하나의 기기에서 원격 액세스를 허용하는 동시에 다른 기기를 제어할 수 있습니다.
SSH 호스트에 연결
ChatGPT 데스크톱 앱에서 SSH 호스트의 원격 프로젝트를 추가하고 원격 파일 시스템 및 셸을 대상으로 채팅을 실행합니다. 원격 프로젝트 채팅은 원격 호스트에서 명령을 실행하고, 파일을 읽고, 변경 사항을 작성합니다.
신뢰할 수 있는 키, 최소 권한 계정, 인증되지 않은 공개 리스너 금지 등 일반적인 SSH 액세스에 적용하는 것과 동일한 보안 기준으로 원격 호스트를 구성하세요.
Codex가 자동으로 검색할 수 있도록 호스트를 SSH config에 추가합니다.
Host devbox HostName devbox.example.com User you IdentityFile ~/.ssh/id_ed25519Codex는
~/.ssh/config에서 구체적인 호스트 별칭을 읽고 OpenSSH로 이를 확인하며 패턴으로만 지정된 호스트는 무시합니다.앱을 실행하는 머신에서 호스트에 SSH로 연결할 수 있는지 확인합니다.
ssh devbox원격 호스트에 Codex를 설치하고 인증합니다.
앱은 원격 사용자의 로그인 셸을 사용하여 SSH를 통해 원격 Codex 앱 서버를 시작합니다. 해당 셸에서 원격 호스트의
PATH를 통해codex명령을 사용할 수 있는지 확인하세요.앱에서 Settings > Connections를 열고 SSH 호스트를 추가하거나 활성화한 다음 원격 프로젝트 폴더를 선택합니다.
호스트 간 채팅 핸드오프
핸드오프는 로컬 컴퓨터와 연결된 원격 호스트 간에 기존 채팅과 해당 Git 상태를 이동합니다. 로컬에서 작업을 시작하고 원격 컴퓨터의 worktree에서 계속한 다음 나중에 채팅을 다시 가져올 때 사용하세요.
채팅을 핸드오프하기 전에 대상 호스트를 연결하고 해당 호스트에서 동일한 Git 저장소의 프로젝트를 저장하세요. 프로젝트가 저장소의 하위 디렉터리라면 두 호스트 모두에서 동일한 하위 디렉터리를 저장하세요. Codex는 저장된 프로젝트가 일치하는 대상만 표시합니다.
채팅을 핸드오프하려면 다음 단계를 따르세요.
- 데스크톱 앱에서 채팅을 엽니다.
- 채팅 바닥글에서 현재 실행 위치를 선택한 다음 대상 호스트를 선택합니다. 원격 채팅을 로컬 컴퓨터로 다시 핸드오프할 때는 This computer를 선택합니다.
- 대상과 브랜치를 검토한 다음 Hand off를 선택합니다.
Codex는 대상 호스트에 worktree를 생성하거나 기존 worktree를 재사용하고, 채팅과 Git 상태를 전송한 다음 채팅을 해당 호스트로 전환합니다. 채팅이 실행 중이면 핸드오프할 때 전송 전에 현재 응답이 중단됩니다.
다른 채팅에서 Codex에 이름이 지정된 채팅을 연결된 호스트로 핸드오프하도록 요청할 수도 있습니다. Codex는 요청을 보내는 채팅 자체를 핸드오프할 수 없으며, Codex 클라우드 환경으로의 핸드오프는 지원되지 않습니다.
인증 및 네트워크 노출
원격 연결은 SSH를 사용하여 원격 Codex 앱 서버를 시작하고 관리합니다. 공유 또는 공용 네트워크에 앱 서버 전송 계층을 직접 노출하지 마세요.
현재 네트워크 외부의 원격 머신에 연결해야 한다면 앱 서버를 인터넷에 직접 노출하지 말고 VPN 또는 메시 네트워킹 도구를 사용하세요.
문제 해결
휴대전화에 호스트가 표시되지 않는 경우
호스트에서 데스크톱 앱이 실행 중이고 Allow other devices to connect를 활성화했으며 두 기기에서 동일한 ChatGPT 계정과 워크스페이스를 사용하는지 확인하세요. 2026년 6월 8일 이후 해당 연결을 사용하지 않았다면 두 앱을 모두 업데이트하고 기기를 다시 페어링하세요.
다시 로그인한 후 Remote Control이 꺼지는 경우
ChatGPT에서 로그아웃하면 Remote Control이 꺼지지만 기존 기기 페어링은 제거되지 않습니다. 다시 로그인한 후 Remote Control을 켜서 이전 연결 상태를 복원하세요.
Remote Control을 켜고 Add를 선택한 후 오류가 표시되면 호스트에서 ChatGPT 데스크톱 앱을 다시 시작한 다음 다시 시도하세요.
승인 요청이 표시되지 않는 경우
ChatGPT 모바일 앱에서 Remote를 엽니다. 휴대전화와 호스트에서 동일한 ChatGPT 계정과 워크스페이스를 사용하는지 확인한 다음 QR 코드를 다시 스캔하거나 호스트에서 설정을 다시 시작하세요. ChatGPT 워크스페이스를 사용하는 경우 관리자에게 Remote Control 액세스가 활성화되어 있는지 확인해 달라고 요청하세요.
원격 세션 연결이 끊기는 경우
호스트가 절전 모드로 전환되었거나 네트워크 연결이 끊겼거나 앱이 종료되었는지 확인하세요. ChatGPT가 작업하는 동안 호스트를 절전 모드로 전환하지 말고 연결 상태를 유지하세요.
인증으로 인해 설정이 차단되는 경우
설정 중에 표시되는 계정 또는 워크스페이스 인증 프롬프트를 완료하세요. 조직에서 SSO, 다단계 인증 또는 패스키를 요구하는 경우 다시 시도하기 전에 해당 절차를 완료하세요. 그래도 설정에 실패하면 워크스페이스 관리자에게 Remote Control 액세스가 활성화되어 있는지 확인해 달라고 요청하세요.