Codex Cloud (레거시)
Codex의 종속성과 도구 사용자 지정
환경을 사용하여 클라우드 채팅 중 Codex가 설치하고 실행하는 항목을 제어할 수 있습니다. 예를 들어 종속성을 추가하고, 린터 및 포매터와 같은 도구를 설치하며, 환경 변수를 설정할 수 있습니다.
Codex 설정에서 환경을 구성하세요.
Codex 클라우드 채팅의 실행 방식
작업을 제출하면 다음 과정이 진행됩니다.
- Codex가 컨테이너를 생성하고 선택한 브랜치 또는 커밋 SHA에서 저장소를 체크아웃합니다.
- Codex가 설정 스크립트를 실행하며, 캐시된 컨테이너를 재개하는 경우 선택적으로 유지 관리 스크립트도 실행합니다.
- Codex가 인터넷 액세스 설정을 적용합니다. 설정 스크립트는 인터넷 액세스가 허용된 상태로 실행됩니다. 에이전트의 인터넷 액세스는 기본적으로 꺼져 있지만, 필요한 경우 제한적 또는 무제한 액세스를 활성화할 수 있습니다. 에이전트 인터넷 액세스를 참조하세요.
- 에이전트가 반복적으로 터미널 명령을 실행합니다. 코드를 편집하고, 검사를 실행하며, 작업 결과를 검증하려고 시도합니다. 저장소에
AGENTS.md가 포함되어 있으면 에이전트는 이를 사용하여 프로젝트별 린트 및 테스트 명령을 찾습니다. - 에이전트가 작업을 마치면 답변과 변경한 파일의 diff를 표시합니다. PR을 열거나 후속 질문을 할 수 있습니다.
기본 범용 이미지
Codex 에이전트는 universal이라는 기본 컨테이너 이미지에서 실행되며, 이 이미지에는 일반적으로 사용하는 언어, 패키지 및 도구가 사전 설치되어 있습니다.
환경 설정에서 패키지 버전 설정 을 선택하여 Python, Node.js 및 기타 런타임의 버전을 고정하세요.
codex-universal에는 빠르고 편리하게 사용할 수 있도록 언어가 사전 설치되어 있지만, 설정 스크립트를 사용하여 컨테이너에 추가 패키지를 설치할 수도 있습니다.
환경 변수와 시크릿
환경 변수 는 설정 스크립트와 에이전트 단계를 포함한 전체 채팅 기간 동안 설정됩니다.
시크릿 은 환경 변수와 유사하지만 다음과 같은 차이가 있습니다.
- 추가 암호화 계층을 적용하여 저장되며 작업 실행 시에만 복호화됩니다.
- 설정 스크립트에서만 사용할 수 있습니다. 보안을 위해 에이전트 단계가 시작되기 전에 시크릿이 제거됩니다.
자동 설정
일반적인 패키지 관리자(npm, yarn, pnpm, pip, pipenv 및 poetry)를 사용하는 프로젝트에서는 Codex가 종속성과 도구를 자동으로 설치할 수 있습니다.
수동 설정
개발 환경 구성이 더 복잡한 경우 사용자 지정 설정 스크립트를 제공할 수도 있습니다. 예:
# Install type checker
pip install pyright
# Install dependencies
poetry install --with test
pnpm install컨테이너 캐싱
Codex는 새 채팅과 후속 작업의 속도를 높이기 위해 컨테이너 상태를 최대 12시간 동안 캐시합니다.
환경이 캐시될 때는 다음 작업이 수행됩니다.
- Codex가 저장소를 복제하고 기본 브랜치를 체크아웃합니다.
- Codex가 설정 스크립트를 실행하고 그 결과로 생성된 컨테이너 상태를 캐시합니다.
캐시된 컨테이너를 재개할 때는 다음 작업이 수행됩니다.
- Codex가 채팅에 지정된 브랜치를 체크아웃합니다.
- Codex가 유지 관리 스크립트를 실행합니다(선택 사항). 설정 스크립트가 이전 커밋에서 실행되어 종속성을 업데이트해야 할 때 유용합니다.
설정 스크립트, 유지 관리 스크립트, 환경 변수 또는 시크릿을 변경하면 Codex가 캐시를 자동으로 무효화합니다. 저장소 변경으로 인해 캐시된 상태가 호환되지 않게 된 경우 환경 페이지에서 캐시 재설정 을 선택하세요.
인터넷 액세스 및 네트워크 프록시
설정 스크립트 단계에서는 종속성을 설치할 수 있도록 인터넷 액세스가 허용됩니다. 에이전트 단계에서는 인터넷 액세스가 기본적으로 꺼져 있지만 제한적 또는 무제한 액세스를 구성할 수 있습니다. 에이전트 인터넷 액세스를 참조하세요.
환경은 보안 및 악용 방지를 위해 HTTP/HTTPS 네트워크 프록시 뒤에서 실행됩니다. 모든 아웃바운드 인터넷 트래픽은 이 프록시를 통과합니다.
Agent Security 명령 네트워크 요구 사항
지원되는 관리형 Codex Cloud 실행 경로에서는 Agent Security 요구 사항이 명령의 네트워크 사용을 제한합니다. Codex Cloud 환경의 인터넷 설정은 별도로 적용됩니다. Agent Security에서 허용한 도메인이라도 Cloud 환경의 인터넷 설정에 따른 제한을 무시할 수는 없습니다. 이러한 명령 네트워크 제어만으로는 호스팅된 웹 검색, 앱 또는 MCP가 비활성화되지 않습니다. ChatGPT Work Cloud에는 별도의 기능 권한이 있으며, 이러한 Agent Security 요구 사항을 상속하지 않습니다.
관리형 명령 허용 목록은 관리형 프록시를 사용하는 명령에 적용됩니다. 정책에서 전체 샌드박스 권한 상승을 허용하고 승인이 이루어진 경우, 해당 실행은 명령 프록시를 우회할 수 있습니다. 제한적인 네트워크 권한 부여는 전체 샌드박스 권한 상승과 다릅니다. 의도한 경계에 맞게 강제 적용할 승인 및 샌드박스 요구 사항을 구성하고, 일반 명령과 권한이 상승된 명령을 모두 테스트하세요. 상속 및 프록시의 제한 사항은 관리형 구성을 참조하세요.