한국어

클라우드 환경

Codex의 종속성과 도구 사용자 지정

환경을 사용하여 클라우드 채팅 중 Codex가 설치하고 실행하는 항목을 제어할 수 있습니다. 예를 들어 종속성을 추가하고, 린터 및 포매터와 같은 도구를 설치하며, 환경 변수를 설정할 수 있습니다.

Codex 설정에서 환경을 구성하세요.

Codex 클라우드 채팅의 실행 방식

프롬프트를 제출하면 다음 과정이 진행됩니다.

  1. Codex가 컨테이너를 생성하고 선택한 브랜치 또는 커밋 SHA에서 저장소를 체크아웃합니다.
  2. Codex가 설정 스크립트를 실행하며, 캐시된 컨테이너를 재개하는 경우 선택적으로 유지 관리 스크립트도 실행합니다.
  3. Codex가 인터넷 액세스 설정을 적용합니다. 설정 스크립트는 인터넷 액세스가 허용된 상태로 실행됩니다. 에이전트의 인터넷 액세스는 기본적으로 꺼져 있지만, 필요한 경우 제한적 또는 무제한 액세스를 활성화할 수 있습니다. 에이전트 인터넷 액세스를 참조하세요.
  4. 에이전트가 반복적으로 터미널 명령을 실행합니다. 코드를 편집하고, 검사를 실행하며, 작업 결과를 검증하려고 시도합니다. 저장소에 AGENTS.md이 포함되어 있으면 에이전트는 이를 사용하여 프로젝트별 린트 및 테스트 명령을 찾습니다.
  5. 에이전트가 작업을 마치면 답변과 변경한 파일의 diff를 표시합니다. PR을 열거나 후속 질문을 할 수 있습니다.

기본 범용 이미지

Codex 에이전트는 universal이라는 기본 컨테이너 이미지에서 실행되며, 이 이미지에는 일반적으로 사용하는 언어, 패키지 및 도구가 사전 설치되어 있습니다.

환경 설정에서 패키지 버전 설정을 선택하여 Python, Node.js 및 기타 런타임의 버전을 고정하세요.

codex-universal에는 빠르고 편리하게 사용할 수 있도록 언어가 사전 설치되어 있지만, 설정 스크립트를 사용하여 컨테이너에 추가 패키지를 설치할 수도 있습니다.

환경 변수와 시크릿

환경 변수는 설정 스크립트와 에이전트 단계를 포함한 전체 채팅 기간 동안 설정됩니다.

시크릿은 환경 변수와 유사하지만 다음과 같은 차이가 있습니다.

  • 추가 암호화 계층을 적용하여 저장되며 작업 실행 시에만 복호화됩니다.
  • 설정 스크립트에서만 사용할 수 있습니다. 보안을 위해 에이전트 단계가 시작되기 전에 시크릿이 제거됩니다.

자동 설정

일반적인 패키지 관리자(npm, yarn, pnpm, pip, pipenvpoetry)를 사용하는 프로젝트에서는 Codex가 종속성과 도구를 자동으로 설치할 수 있습니다.

수동 설정

개발 환경 구성이 더 복잡한 경우 사용자 지정 설정 스크립트를 제공할 수도 있습니다. 예:

# Install type checker
pip install pyright

# Install dependencies
poetry install --with test
pnpm install

컨테이너 캐싱

Codex는 새 채팅과 후속 작업의 속도를 높이기 위해 컨테이너 상태를 최대 12시간 동안 캐시합니다.

환경이 캐시될 때는 다음 작업이 수행됩니다.

  • Codex가 저장소를 복제하고 기본 브랜치를 체크아웃합니다.
  • Codex가 설정 스크립트를 실행하고 그 결과로 생성된 컨테이너 상태를 캐시합니다.

캐시된 컨테이너를 재개할 때는 다음 작업이 수행됩니다.

  • Codex가 채팅에 지정된 브랜치를 체크아웃합니다.
  • Codex가 유지 관리 스크립트를 실행합니다(선택 사항). 설정 스크립트가 이전 커밋에서 실행되어 종속성을 업데이트해야 할 때 유용합니다.

설정 스크립트, 유지 관리 스크립트, 환경 변수 또는 시크릿을 변경하면 Codex가 캐시를 자동으로 무효화합니다. 저장소 변경으로 인해 캐시된 상태가 호환되지 않게 된 경우 환경 페이지에서 캐시 재설정을 선택하세요.

인터넷 액세스 및 네트워크 프록시

설정 스크립트 단계에서는 종속성을 설치할 수 있도록 인터넷 액세스가 허용됩니다. 에이전트 단계에서는 인터넷 액세스가 기본적으로 꺼져 있지만 제한적 또는 무제한 액세스를 구성할 수 있습니다. 에이전트 인터넷 액세스를 참조하세요.

환경은 보안 및 악용 방지를 위해 HTTP/HTTPS 네트워크 프록시 뒤에서 실행됩니다. 모든 아웃바운드 인터넷 트래픽은 이 프록시를 통과합니다.