Codex Cloud 환경과 Legacy 통합 구분
로컬 컴퓨터를 켜 둔 채 긴 작업을 돌리고 싶지 않을 때 Cloud를 검토할 수 있습니다. 하지만 원격 실행이 로컬 폴더를 그대로 복제한다는 뜻은 아닙니다. 저장소와 설치 단계, 시작 시 필요한 서비스, 인증과 네트워크 조건을 환경으로 준비해야 합니다.
공식 문서를 참고한 비공식 한국어 가이드입니다. 환경 생성·저장소 연결·비밀값 등록·AI 작업은 실행하지 않았습니다. 계정과 workspace에서 해당 Cloud 기능이 제공되는지 먼저 확인합니다.
현재 Cloud 작업 시작하기
공식 흐름은 ChatGPT에서 Cloud 작업을 선택하고, 환경을 만들거나 선택한 뒤 프로젝트를 준비·검토·게시하여 작업에 사용하는 방식입니다. 처음에는 공개 가능한 작은 연습 저장소로 도구와 테스트가 준비되는지 확인하는 편이 좋습니다.
환경에는 어떤 커밋을 가져오는지, 설치 단계에서 무엇을 실행하는지, 작업 시작 때 어떤 서비스가 필요한지 구분해 기록합니다. 환경을 저장하거나 게시했다는 사실과 현재 task가 새 환경 버전을 사용한다는 사실도 따로 확인합니다.
설치와 시작을 나누기
설치 단계의 의존성 준비와 task가 시작될 때의 서버 준비를 섞지 않습니다. 예를 들어 합성 프로젝트에서 다음 계약을 적을 수 있습니다.
설치: 저장소에 고정된 패키지 매니저와 lockfile로 의존성을 준비한다.
시작: 테스트에 필요한 로컬 서비스가 준비됐는지 확인한다.
완료: 관련 테스트와 빌드 출력, 변경 파일, 환경 버전을 보고한다.
금지: 운영 DB 연결, 실제 업로드, 비밀값 출력, 승인 없는 외부 게시.
기대 결과는 새 task에서도 재현할 수 있는 실행 환경입니다. 로컬에는 있던 도구가 Cloud에 없으면 명령 실패를 환경 준비 문제로 분리하고 작업 성공이라고 보고하지 않습니다.
네트워크·비밀값·OIDC
환경변수와 비밀값은 용도와 노출 범위가 다릅니다. 공식 환경 화면의 개인 값·공유 값, 설치/작업 시 접근 조건을 확인하고 최소한만 제공합니다. 네트워크 allowlist, VPN을 통한 접근, TCP 서비스 연결, 클라우드 자원의 OIDC도 공식 문서에 있습니다.
이 글은 각 provider의 인증 필드 전체를 재게시하지 않습니다. OIDC를 ‘키를 절대 다루지 않는 만능 연결’로 보지 말고 발급 대상·신뢰 정책·권한·감사 범위를 검토합니다. 승인 없는 조직 네트워크/자격 증명/비용 설정 변경은 하지 않습니다.
Legacy는 별도 환경입니다
공식 인덱스의 Codex Cloud (Legacy)는 Code Review와 GitHub·Linear 연동용 기존 환경을 설명합니다. 현재 Cloud의 재사용 환경과 Legacy의 이미지·setup·캐시·인터넷 접근 규칙을 섞으면 잘못된 설정을 찾게 됩니다.
특히 Legacy internet access의 도메인/HTTP method 제한을 현재 Cloud 전체의 기본 동작이라고 단정하지 않습니다. 사용하는 진입점과 연결 기능을 먼저 식별하고 해당 원문을 봅니다. 연동·CI에서 리뷰 연결의 경계도 확인합니다.
실패를 나눠 확인
환경 준비가 실패하면 저장소 접근, 설치 출력, 필요한 도구, 네트워크, 개인 값의 제공 여부 순으로 확인합니다. task 도중 실패했다면 환경 버전과 작업 기준 SHA를 함께 남깁니다. 환경 게시 성공을 코드 수정·테스트·PR 게시 성공으로 확대하지 마세요. 로컬 파일 격리가 목적이라면 Cloud 대신 worktree가 더 단순할 수 있습니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며 계정 조건과 요금은 공식 안내를 우선합니다.
추가 공식 참조
다음은 관련 세부 기능과 전체 참조 문서입니다. 아래 항목은 원문 전체를 한국어로 설명하거나 실행 검증한 범위가 아닙니다. 적용 조건과 정확한 옵션은 공식 원문을 확인하세요.