Codex Remote란?
Codex Remote는 집이나 회사 컴퓨터에서 실행되는 Codex 작업을 스마트폰에서 확인하고 제어할 수 있는 기능이다.
스마트폰으로 다음과 같은 작업을 할 수 있다.
- 새로운 Codex 작업 시작
- 진행 중인 작업 확인
- Codex가 요청한 명령 실행 승인
- 질문에 답하거나 작업 방향 변경
- 수정된 코드와 Git diff 확인
- 터미널 출력과 테스트 결과 확인
- 여러 컴퓨터와 프로젝트 전환
- 작업 완료 또는 승인 요청 알림 수신
중요한 점은 스마트폰에서 Codex가 직접 실행되는 것이 아니라는 것이다.
실제 파일 읽기, 코드 수정, 명령 실행, 테스트는 연결된 Windows 또는 Mac 컴퓨터에서 처리된다. 프로젝트 파일, 로그인 정보, SSH 키, 개발 도구, 플러그인과 권한도 호스트 컴퓨터에 그대로 남아 있다. 스마트폰은 이 작업을 원격으로 확인하고 지시하는 역할을 한다. Codex Remote가 필요한 이유
1. 자리를 비운 동안에도 작업을 멈추지 않을 수 있다
Codex가 긴 리팩터링이나 테스트를 수행하다 보면 중간에 사용자의 선택이나 승인을 요구하는 경우가 있다.
기존에는 컴퓨터 앞으로 돌아올 때까지 작업이 멈췄지만, Codex Remote를 사용하면 스마트폰에서 승인하거나 방향을 지정할 수 있다.
예를 들면 다음과 같다.
- 출근 전에 리팩터링 요청
- 이동 중 Codex가 발견한 두 가지 구현 방식 확인
- 스마트폰에서 구현 방식 선택
- 회사에 도착하기 전 테스트와 코드 수정 완료
Codex가 장시간 작업을 수행하는 환경에서는 단순한 원격 화면보다, 질문과 승인 요청만 빠르게 처리할 수 있다는 점이 유용하다. 마트폰에서 개발 환경 전체를 다시 구성할 필요가 없다
스마트폰에 Git, Docker, Python, Rust, Node.js, CUDA 같은 개발 도구를 설치할 필요가 없다.
실제 개발 환경은 기존 컴퓨터나 서버에 그대로 두고 스마트폰에서는 다음 항목만 확인한다.
- 작업 진행 상황
- 명령 실행 요청
- 코드 변경 내역
- 테스트 성공 여부
- Codex의 질문
GPU 서버나 여러 개발 도구가 설치된 Ubuntu 서버를 운영한다면 특히 유용하다.
3. 인터넷에 개발용 포트를 직접 공개하지 않아도 된다
Codex Remote는 연결된 컴퓨터를 공용 인터넷에 직접 노출하는 방식이 아니다. OpenAI는 기기 간 연결에 보안 릴레이 계층을 사용한다고 설명한다.
SSH 서버를 외부에서 사용해야 할 때도 Codex 앱 서버 포트를 인터넷에 직접 공개하기보다는 VPN이나 메시 네트워크를 사용하는 것이 권장된다. 격 데스크톱보다 스마트폰 사용이 간단하다
원격 데스크톱은 스마트폰의 작은 화면에서 마우스와 키보드를 조작해야 한다.
Codex Remote에서는 일반 채팅처럼 지시하면 되기 때문에 다음과 같은 작업이 편하다.
- “현재 테스트 실패 원인만 분석해.”
- “데이터베이스 마이그레이션은 실행하지 말고 코드만 수정해.”
- “변경된 파일과 핵심 수정 내용을 정리해.”
- “테스트가 통과하면 커밋하지 말고 대기해.”
지원 환경
호스트 컴퓨터
Codex Remote 호스트는 현재 다음 운영체제의 ChatGPT 데스크톱 앱을 사용한다.
- Windows
- macOS
호스트 컴퓨터는 다음 조건을 만족해야 한다.
- 전원이 켜져 있어야 함
- 인터넷에 연결되어 있어야 함
- ChatGPT 데스크톱 앱이 실행 중이어야 함
- 스마트폰과 동일한 ChatGPT 계정 및 워크스페이스로 로그인해야 함
- 절전 모드에 들어가지 않아야 함
현재 모바일 연결 설정은 Codex CLI나 IDE 확장에서 시작할 수 없다. Windows 또는 macOS의 ChatGPT 데스크톱 앱에서 설정해야 한다.
- Android용 ChatGPT 앱
- iOS용 ChatGPT 앱
스마트폰 앱에 Remote 메뉴가 나타나지 않는다면 먼저 앱을 최신 버전으로 업데이트해야 한다.
요금제
Codex Remote는 2026년 6월 24일 기준 모든 ChatGPT 요금제에 정식 제공되고 있다. 다만 Codex 사용량 제한은 각 요금제에 따라 다르다.
Ubuntu에서는 Codex CLI를 실행할 수 있지만, Ubuntu용 ChatGPT 데스크톱 앱은 현재 Codex Remote의 직접 호스트로 지원되지 않는다.
따라서 Ubuntu 서버를 스마트폰에서 사용하려면 다음과 같이 구성하는 것이 좋다.
스마트폰 ChatGPT 앱
↓ Codex Remote
Windows 또는 Mac의 ChatGPT 데스크톱 앱
↓ SSH
Ubuntu 서버
↓
프로젝트 파일·Docker·GPU·개발 도구
Windows 또는 Mac은 원격 연결을 중계하고, 실제 코드와 명령은 Ubuntu 서버에서 실행하는 구조다.
Codex Remote 설치 방법
1. Windows 또는 Mac에 ChatGPT 데스크톱 앱 설치
OpenAI 공식 다운로드 페이지에서 최신 ChatGPT 데스크톱 앱을 설치한다.
2026년 7월부터 새로운 ChatGPT 데스크톱 앱에는 다음 기능이 통합되어 있다.
- 일반 Chat
- ChatGPT Work
- Codex
- Codex Remote
기존 Codex 앱을 사용하고 있었다면 앱을 최신 버전으로 업데이트하면 새로운 ChatGPT 데스크톱 앱으로 전환된다. 기존 Codex 프로젝트와 작업은 업데이트 후에도 유지되는 방식이다. 음 ChatGPT 계정으로 로그인한다.
2. 스마트폰에 ChatGPT 앱 설치 또는 업데이트
Android에서는 Google Play Store, iPhone에서는 App Store를 통해 ChatGPT 앱을 최신 버전으로 업데이트한다.
컴퓨터와 스마트폰에서 반드시 동일한 ChatGPT 계정과 워크스페이스를 사용해야 한다.
3. 데스크톱 앱에서 Remote 설정 시작
Windows 또는 Mac의 ChatGPT 데스크톱 앱에서 다음 메뉴를 연다.
사이드바 → Set up Remote
앱 버전에 따라 메뉴 이름이 다음과 같이 표시될 수도 있다.
Settings → Connections
Settings → Connections → Control this computer
Remote 연결을 허용하면 화면에 QR 코드가 표시된다.
4. 스마트폰으로 QR 코드 스캔
컴퓨터에 표시된 QR 코드를 스마트폰 카메라로 스캔한다.
QR 코드를 인식하면 ChatGPT 모바일 앱이 열리고 연결 설정이 진행된다.
다음 항목을 확인한다.
- 컴퓨터와 동일한 계정인지
- 동일한 워크스페이스인지
- 다중 인증이 필요한지
- SSO 또는 패스키 인증이 필요한지
연결에 성공하면 스마트폰 ChatGPT 앱의 Remote 메뉴에 해당 컴퓨터가 표시된다.
각 스마트폰과 각 호스트 컴퓨터는 일대일 QR 방식으로 각각 연결해야 한다. 트 컴퓨터 설정 확인
데스크톱 앱에서 다음 메뉴를 확인한다.
Settings → Connections
여기에서 다음 항목을 관리할 수 있다.
- 원격 연결 허용
- 연결된 스마트폰 목록
- 연결된 기기 제거
- 전원 연결 중 절전 방지
- Computer Use 허용
- 브라우저 연동
- 다른 컴퓨터 제어
노트북을 호스트로 사용할 경우 전원을 연결하고 절전 모드를 해제하는 것이 좋다.
Ubuntu 서버를 SSH 프로젝트로 연결하는 방법
Ubuntu 서버에 프로젝트가 있다면 Windows 또는 Mac의 ChatGPT 데스크톱 앱에서 SSH 호스트를 등록할 수 있다.
1. SSH 키 생성
Windows PowerShell 또는 Mac 터미널에서 실행한다.
ssh-keygen -t ed25519
기본 경로를 사용하면 다음 위치에 키가 생성된다.
Windows:
C:\Users\사용자명\.ssh\
macOS:
~/.ssh/
2. 공개 키를 Ubuntu 서버에 등록
ssh-copy-id 사용자명@서버주소
Windows에서 ssh-copy-id를 사용할 수 없다면 공개 키 내용을 확인한다.
type $env:USERPROFILE\.ssh\id_ed25519.pub
출력된 내용을 Ubuntu 서버의 다음 파일에 추가한다.
~/.ssh/authorized_keys
3. SSH 설정 파일 작성
Windows:
C:\Users\사용자명\.ssh\config
macOS:
~/.ssh/config
예시는 다음과 같다.
Host ubuntu-dev
HostName 192.168.0.100
User yimstar9
IdentityFile ~/.ssh/id_ed25519
Tailscale을 사용한다면 HostName에 Ubuntu 서버의 Tailscale IP 또는 MagicDNS 이름을 입력할 수 있다.
Host ubuntu-dev
HostName ubuntu-server
User yimstar9
IdentityFile ~/.ssh/id_ed25519
4. SSH 연결 테스트
ssh ubuntu-dev
비밀번호 입력 없이 정상적으로 접속되는지 확인한다.
Codex 데스크톱 앱은 ~/.ssh/config에 등록된 구체적인 호스트 별칭을 자동으로 확인한다. 와일드카드 형태로만 작성된 호스트는 검색되지 않을 수 있다. untu 서버에 Codex CLI 설치
Ubuntu 서버에서 다음 명령을 실행한다.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
설치 후 실행한다.
codex
최초 실행 시 Sign in with ChatGPT를 선택하고 인증한다.
Codex 명령이 로그인 셸의 PATH에 등록되어 있는지도 확인한다.
which codex
codex --version
Codex CLI는 프로젝트 파일을 읽고 수정하며, 설치된 개발 도구를 사용해 명령과 테스트를 실행할 수 있다. 크톱 앱에 SSH 호스트 추가
ChatGPT 데스크톱 앱에서 다음 메뉴를 연다.
Settings → Connections → SSH
앞에서 등록한 호스트를 선택한다.
ubuntu-dev
연결 후 Ubuntu 서버의 프로젝트 폴더를 선택한다.
예시:
/home/yimstar9/git/my-project
이제 Codex 작업은 Windows PC가 아니라 Ubuntu 서버의 파일 시스템과 셸에서 실행된다. 스마트폰은 Windows 또는 Mac 호스트를 통해 이 작업에 접근한다. odex Remote 사용 방법
새로운 작업 시작
스마트폰에서 ChatGPT 앱을 열고 다음 순서로 이동한다.
ChatGPT 앱 → Remote → 연결된 컴퓨터 → 프로젝트
프로젝트를 선택한 다음 작업을 입력한다.
예시:
현재 프로젝트 구조를 분석하고 실행 방법을 정리해.
파일은 수정하지 말고 분석만 해.
로그인 API에서 발생하는 500 오류 원인을 찾아줘.
재현 테스트를 먼저 작성하고 수정 전에는 승인을 요청해.
Docker Compose 구성을 확인하고 보안상 문제가 있는 설정을 찾아줘.
컨테이너를 실제로 재시작하지는 마.
진행 중인 작업 확인
Remote 화면에서는 다음 정보를 확인할 수 있다.
- Codex의 현재 작업 단계
- 실행 중인 명령
- 터미널 출력
- 테스트 결과
- 변경된 파일
- Git diff
- 브라우저 화면
- 스크린샷
- 승인 요청
- Codex의 추가 질문
작업 방향 수정
Codex가 작업 중일 때 스마트폰에서 추가 지시를 내릴 수 있다.
현재 방식은 중단하고 기존 API 구조를 유지하는 방향으로 수정해.
데이터베이스 파일은 변경하지 말고 애플리케이션 코드만 수정해.
전체 테스트 대신 이번에 수정한 모듈의 테스트만 실행해.
명령 승인
Codex가 권한이 필요한 작업을 수행하려 하면 스마트폰에 승인 요청이 표시된다.
예를 들면 다음과 같다.
- 패키지 설치
- 외부 네트워크 접근
- 작업 폴더 밖의 파일 접근
- 위험할 수 있는 셸 명령 실행
- 브라우저나 앱 조작
- 시스템 설정 변경
명령과 대상 경로를 확인한 뒤 승인하거나 거부한다.
변경 내용 검토
작업이 끝나면 스마트폰에서 diff와 테스트 결과를 확인한다.
다음과 같이 추가 검토를 요청할 수도 있다.
수정된 파일별로 변경 이유를 정리해.
아직 남아 있는 위험 요소와 테스트하지 못한 항목을 알려줘.
커밋은 하지 말고 변경 사항만 유지해.
스마트폰에서는 긴 코드를 세밀하게 검토하기 어렵기 때문에 최종 병합이나 배포 전에는 PC에서 전체 diff를 다시 확인하는 것이 안전하다.
권장 권한 설정
Codex는 편리하지만 코드와 명령을 실제 환경에서 실행할 수 있으므로 권한을 적절하게 제한해야 한다.
처음 사용할 때
다음과 같이 설정하는 것이 안전하다.
- 프로젝트 폴더만 쓰기 허용
- 명령 실행은 승인 후 진행
- 인터넷 접근은 승인 후 진행
- 프로젝트 외부 폴더 접근 제한
- 배포와 데이터 삭제는 자동 실행 금지
Codex CLI에서는 /permissions 명령으로 현재 권한을 확인하거나 변경할 수 있다. CLI 시작 옵션을 사용할 경우 승인 정책도 지정할 수 있다. 을 사용해야 할 때
반복적인 테스트나 코드 포맷팅처럼 위험성이 낮은 작업에서는 승인 횟수를 줄일 수 있다.
그러나 다음 작업은 자동 승인하지 않는 것이 좋다.
- 운영 서버 배포
- 데이터베이스 마이그레이션
- 파일 대량 삭제
- 방화벽 변경
- 사용자 권한 변경
- API 키와 인증서 수정
- 결제 또는 외부 서비스 조작
sudo명령- Git 강제 푸시
보안 설정 권장 사항
SSH 비밀번호보다 키 인증 사용
Ubuntu 서버는 SSH 키로 접속하고 비밀번호 로그인을 제한하는 것이 좋다.
최소 권한 사용자 사용
Codex가 항상 root 사용자로 작업하지 않도록 한다.
일반 사용자 계정으로 접속하고 꼭 필요한 명령에만 sudo 권한을 부여한다.
앱 서버 포트를 인터넷에 공개하지 않기
Codex 앱 서버나 내부 통신용 포트를 공유기에서 직접 포트 포워딩하지 않는다.
다른 네트워크에 있는 Ubuntu 서버에 접속해야 한다면 다음 방식을 사용한다.
- Tailscale
- 회사 VPN
- WireGuard
- 관리형 메시 네트워크
OpenAI 공식 문서도 앱 서버 전송 계층을 공용 네트워크에 직접 노출하지 말고 VPN 또는 메시 네트워크를 사용하도록 권장한다. 않을 때 연결 끄기
Remote 기능을 장기간 사용하지 않는다면 다음을 확인한다.
Settings → Connections
Allow connections끄기- 사용하지 않는 스마트폰 연결 제거
- ChatGPT 계정 로그아웃
- 불필요한 SSH 호스트 비활성화
ChatGPT 데스크톱 앱에서 로그아웃하면 기존 QR 연결 정보가 삭제되지는 않지만 Remote Control은 비활성화된다. 주 발생하는 문제
모바일 앱에 Remote 메뉴가 없다
다음을 확인한다.
- ChatGPT 모바일 앱 최신 버전 설치
- ChatGPT 데스크톱 앱 최신 버전 설치
- 모바일 앱 완전 종료 후 재실행
- 동일한 ChatGPT 계정인지 확인
- 관리형 워크스페이스라면 관리자 권한 확인
Business나 Enterprise 워크스페이스에서는 관리자가 Remote Control 또는 관련 RBAC 권한을 활성화해야 할 수 있다. 퓨터가 오프라인으로 표시된다
대부분 다음 원인이다.
- 컴퓨터가 절전 모드에 들어감
- 데스크톱 앱이 종료됨
- 인터넷 연결이 끊어짐
- ChatGPT 계정에서 로그아웃됨
- 회사 방화벽이 연결을 차단함
호스트 컴퓨터를 전원에 연결하고 Keep this computer awake 계열의 옵션을 활성화한다.
승인 요청이 스마트폰에 표시되지 않는다
- 모바일과 PC의 계정 확인
- 워크스페이스 확인
- Remote 메뉴 새로고침
- QR 코드 재연결
- 데스크톱 앱 재시작
- 스마트폰 알림 권한 확인
공식 문서에서도 동일 계정과 워크스페이스를 확인하고, 문제가 계속되면 QR 연결을 다시 진행하도록 안내한다. 스트가 표시되지 않는다
다음을 확인한다.
ssh ubuntu-dev
which codex
codex --version
또한 SSH 설정 파일에 다음처럼 구체적인 별칭이 등록되어 있어야 한다.
Host ubuntu-dev
다음과 같은 패턴만 있는 경우 자동 검색되지 않을 수 있다.
Host *
Windows 잠금 후 브라우저 조작이 실패한다
Windows에서 Computer Use를 사용하는 작업은 포그라운드에서 실행될 수 있다.
화면이 잠겨 있으면 브라우저 클릭이나 GUI 조작이 중단될 수 있으므로, GUI 자동화가 필요한 동안에는 Windows 세션을 사용할 수 있는 상태로 유지해야 한다. odex Remote와 Codex Cloud의 차이
| 구분 | Codex Remote | Codex Cloud |
|---|---|---|
| 실행 위치 | 내 Windows·Mac 또는 연결된 SSH 서버 | OpenAI 클라우드 환경 |
| 로컬 파일 사용 | 가능 | 저장소와 클라우드 환경 설정 필요 |
| 로컬 GPU·Docker 사용 | 가능 | 클라우드 환경 사양에 따름 |
| 스마트폰 제어 | 가능 | 지원되는 클라우드 작업에서 가능 |
| PC 전원 | 켜져 있어야 함 | 로컬 PC가 꺼져도 가능 |
| SSH 서버 사용 | 가능 | 별도의 클라우드 환경 사용 |
| 적합한 작업 | 로컬 개발 환경과 서버 작업 | 독립적으로 위임할 수 있는 작업 |
이미 구축된 Ubuntu 서버, GPU 환경, Docker 컨테이너, 내부 저장소를 그대로 사용하려면 Codex Remote와 SSH 조합이 적합하다.
컴퓨터 전원이 꺼져 있어도 작업이 계속되어야 한다면 Codex Cloud가 더 적합하다.
사용 후기: 실제로 쓸 만한가?
가장 만족스러운 점
Codex Remote의 가장 큰 장점은 스마트폰에서 코딩하는 것이 아니라, 컴퓨터에서 실행 중인 Codex가 멈추지 않게 관리할 수 있다는 점이다.
Codex가 다음 단계로 넘어가기 위해 승인이나 선택을 요구할 때 스마트폰으로 바로 응답할 수 있다. 긴 테스트, 빌드, 리팩터링, 프로젝트 분석을 자주 실행한다면 작업 대기 시간이 크게 줄어든다.
특히 다음 환경에서 유용하다.
- 회사와 집을 오가며 개발하는 경우
- 항상 켜져 있는 개발용 PC가 있는 경우
- Ubuntu GPU 서버를 SSH로 사용하는 경우
- 빌드와 테스트 시간이 긴 프로젝트
- 여러 프로젝트를 동시에 관리하는 경우
- Codex의 명령 승인을 자주 확인해야 하는 경우
최종 평가
Codex Remote는 스마트폰용 개발 도구라기보다 Codex 작업용 원격 관제 화면에 가깝다.
직접 코드를 한 줄씩 작성하는 용도보다는 다음 작업에 효과적이다.
- 작업 시작
- 진행 상황 확인
- 질문 답변
- 명령 승인
- 방향 수정
- 결과와 diff 검토
항상 켜져 있는 Windows 또는 Mac이 있고, 그 컴퓨터에서 Ubuntu 서버를 SSH로 연결해 사용한다면 활용도가 높다.
개인적으로 가장 권장할 만한 구성은 다음과 같다.
Android 또는 iPhone
↓
Codex Remote
↓
항상 켜져 있는 Windows PC
↓ Tailscale + SSH
Ubuntu 개발·GPU 서버
이렇게 구성하면 외부에 SSH나 Codex 관련 포트를 직접 공개하지 않고도 스마트폰에서 서버의 Codex 작업을 시작하고 관리할 수 있다.
결론적으로 Codex Remote는 개발 컴퓨터를 완전히 원격 조작하는 기능은 아니지만, 자리를 비운 동안 Codex가 승인 요청 때문에 멈추는 문제를 해결하는 데 매우 유용한 기능이다.
'AI' 카테고리의 다른 글
| OpenClaw+로컬 LLM을 이용한 Obsidian 웹 스크랩 (0) | 2026.07.19 |
|---|---|
| NPU 백엔드 설정 전체 절차 (0) | 2026.03.26 |
| 로컬 AI로 만드는 우리 회사 전용 매뉴얼 챗봇-RAG와 한국어 AI로 똑똑하게 (0) | 2026.01.13 |
| Ollama를 이용한 로컬 코딩 어시스턴트 모델 (qwen2.5) (1) | 2026.01.07 |