Codex Cloud 사용법 개발 환경과 테스트와 코드 검토 가이드
개발 에이전트가 코드를 잘 만들어도 프로젝트 도구가 없거나 사설 패키지에 접근하지 못하면 실제 업무는 멈춘다. Codex Cloud의 핵심은 코드 작성 기능 하나가 아니라, 저장소와 도구를 준비한 실행 환경에서 작업하고 결과를 검토할 수 있는 흐름이다.
이 글은 DevDay 2026의 클라우드 개발 주제를 2026년 9월 30일 공식 문서 기준으로 정리한다. 아래 오류 조사 사례는 자체 도입 예시이며 실제 저장소에 대한 사용 후기나 성능 측정이 아니다. 계정과 조직 정책에 따라 환경 선택과 공유 기능은 달라질 수 있다.
환경과 작업 공간과 결과를 구분하기
클라우드 환경에는 사용할 저장소, 의존성, 도구와 접근 설정이 들어간다. 이를 준비하고 게시하면 새 작업이 그 환경을 바탕으로 시작한다. 각 작업의 파일과 진행 상태는 별도의 작업 공간에 있다.
같은 프로젝트 설정을 여러 작업에서 재사용할 수 있지만, 모든 작업이 하나의 변경 파일을 공유하는 것은 아니다. 기존 작업은 자기 상태를 유지하고, 새 작업은 게시된 설정에서 출발한다. 환경을 다시 게시했다고 진행 중인 작업이 모두 새 설정으로 바뀌지 않는다.
사용자 컴퓨터가 잠든 상태에서도 클라우드 작업은 이어질 수 있다. 다만 클라우드에 없는 로컬 파일이나 권한이 필요한 서비스가 자동으로 준비되는 것은 아니다. 실제 실행 장소와 접근 대상을 확인해야 한다.
저장소를 연결하고 준비하기
웹이나 데스크톱 앱에서 Work in의 Cloud를 고르고 환경 선택을 연다. 필요한 환경이 없다면 새로 만들고 GitHub 저장소를 선택한다. Codex가 프로젝트를 살펴 의존성과 도구를 준비하며, 누락된 값이나 접근이 필요하면 요청한다.
무엇을 설치해야 하는지 모두 미리 적을 필요는 없지만, 팀의 버전과 실행 기준은 분명히 해야 한다. 예를 들어 사용 중인 런타임과 패키지 관리자, 테스트 명령과 로컬에서 필요했던 서비스를 전달한다.
준비 보고서와 검사 결과를 읽고 실패한 항목을 해결한다. 파일을 저장한 뒤 Publish를 선택해 환경 게시 완료를 확인한다. 여기서 Publish는 준비된 개발 환경을 새 작업에 제공하는 것이며 운영 사이트를 배포한다는 뜻이 아니다.
설치와 시작과 게시를 나누기
의존성을 설치하는 작업과 서버를 실행하는 작업은 다르다. 공식 문서는 설치용 명령을 기록하는 Install script와 준비 상태를 확인하는 Start skill을 구분한다.
환경 설정을 바꿨다면 저장, 검사와 다시 게시의 관계를 살핀다. 중요한 버전 변경은 새 작업에서 확인한다. 게시된 파일 상태가 재사용돼도 소스 관리가 불필요해지는 것은 아니므로 중요한 변경은 커밋이나 별도 결과로 보존한다.
한국 개발팀이라면 업무 시작 전 작은 저장소로 준비 시간을 확인하고, 자주 쓰는 프로젝트에 적용하는 방식을 검토할 수 있다. 이는 도입 제안이며 클라우드가 모든 로컬 환경보다 빠르다는 보장은 아니다.
네트워크와 인증과 비밀정보
외부 도메인을 허용하는 설정은 통신 경로를 여는 것이지 서비스 계정 권한을 주는 것이 아니다. 패키지 다운로드가 실패하면 목적지 허용 여부와 로그인·토큰을 따로 확인한다.
환경 변수는 프로그램이 직접 읽는 값이다. 네트워크 비밀정보는 지정된 HTTPS 목적지에 자격 증명을 보내는 방식으로, 프로그램에는 대체 값이 전달되고 프록시가 조건에 맞춰 실제 값을 사용한다. 현재 문서는 HTTPS 443에서의 사용과 허용 도메인 설정을 안내한다.
환경 소유 네트워크 비밀정보를 저장하면 제한된 네트워크 설정에 목적지가 추가될 수 있다. 개인 값과 직접 환경 변수는 같은 방식으로 목적지를 추가하지 않는다. 값 저장 후의 네트워크 정책을 다시 읽고 허용 범위를 좁힌다.
비밀번호와 실제 토큰을 작업 요청이나 커밋에 넣지 않는다. 개인 vault와 환경별 요청을 쓰는 경우에도 어떤 값이 어느 작업에 전달되는지 확인한다. 환경 공유와 개인 자격 증명 공유는 같은 행동이 아니다.
업무 요청에 완료 기준 넣기
작업 요청에는 문제, 재현 조건, 바꿔도 되는 범위와 확인할 검사를 함께 적는다. 주문 목록의 빈 화면 오류를 조사한다면 특정 필터에서만 발생하는지 먼저 확인하고, 관련 파일의 변경안과 검사 결과를 준비하도록 요청할 수 있다.
자체 예시에서는 진단, 변경과 검토를 나눈다. 먼저 재현 결과를 보고 원인 가설을 고른 뒤 최소한의 수정과 관련 테스트를 수행한다. 운영 데이터 변경과 자동 배포는 승인 범위에 포함하지 않는다.
질문이 조사 요청인지 구현 요청인지도 구분해야 한다. 원인을 설명하라고 했는데 저장소를 바꾸거나, 변경안을 준비하라고 했는데 자동 병합하는 것은 완료 기준을 넘어서는 일이다.
테스트와 PR을 검토하기
결과에서는 변경 파일과 테스트 로그를 함께 확인한다. 성공했다고 적힌 요약만으로는 무엇을 검사했는지 알 수 없다. 어떤 명령을 실행했는지, 환경 부족으로 건너뛴 항목이 있는지 살핀다.
코드 차이를 읽을 때 요청 범위 밖의 파일, 의존성 변경과 비밀정보가 포함되지 않았는지 확인한다. 커밋, PR 생성, 병합과 운영 배포는 각각 별도 단계다. PR을 만들 수 있다는 기능이 자동 병합의 근거가 되지는 않는다.
여러 작업을 동시에 시작하면 같은 기반 코드에 대한 변경이 충돌할 수 있다. 각 작업 공간이 분리돼 있어도 통합 결과는 검토해야 한다. 기반 버전과 변경 순서를 팀에서 관리한다.
현재 제한과 기존 Cloud의 관계
현재 Cloud environments 문서는 컴퓨터·브라우저 사용, GitLab과 자체 호스팅 GitHub Enterprise Server를 미지원 항목으로 안내한다. Agents API의 호스팅 브라우저 기능을 이 환경에 그대로 적용하면 안 된다.
저장소에 포함된 Skills와 개인 컴퓨터의 Skills도 다르다. 로컬에 있는 개인 Skill이 클라우드에 자동 동기화되는 것은 아니다. 필요한 지침을 적절한 저장소나 환경에 준비한다.
문서는 기존 Codex Cloud 환경이 Code Review와 일부 연결 흐름을 계속 지원한다고 설명한다. 새 환경의 준비 과정을 기존 자동 검토 설정의 모든 메뉴에 일괄 적용하지 않는다. 사용하는 제품 화면의 문서를 확인한다.
문제가 생겼을 때 볼 항목
도구가 없으면 준비 대화의 실패 명령과 버전을 확인한다. 다운로드가 막히면 목적지와 인증을 분리해 보고, 환경이 목록에 없으면 미게시 상태인지 확인한다. 바꾼 환경이 반영되지 않는다면 다시 게시했는지와 새 작업인지 살핀다.
Codex Cloud는 준비한 개발 환경을 반복 사용하고 작업을 이어가는 도구다. 효과적인 도입은 준비, 실행과 검토를 구분하는 데서 시작한다. 컴퓨터가 꺼져도 작업할 수 있다는 장점이 권한·검사·사람의 최종 판단을 생략해 주지는 않는다.
자료와 권리 안내
이 글은 OpenAI와 제휴하지 않은 독립적인 기능 해설이다. 제품명은 해당 권리자의 상표이며 식별 목적으로 사용했다. 그림은 설명용 일러스트와 개념도이며 실제 제품 화면이나 OpenAI 공식 이미지가 아니다.
출처: OpenAI ChatGPT Learn — Codex Cloud · Cloud environments · Pricing and account access
