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