로컬 환경

로컬 환경을 사용하면 worktree를 위한 설정 단계와 프로젝트의 일반 작업을 구성할 수 있습니다.

Codex 앱 설정 창에서 로컬 환경을 구성합니다. 생성된 파일을 프로젝트 Git 저장소에 커밋해 다른 사람과 공유할 수 있습니다.

Codex는 이 구성을 프로젝트 루트의 .codex 폴더 안에 저장합니다. 저장소에 프로젝트가 여러 개 있다면 공유 .codex 폴더가 있는 프로젝트 디렉터리를 엽니다.

설정 스크립트

worktree는 로컬 작업과 다른 디렉터리에서 실행되므로 프로젝트 설정이 완전하지 않거나 저장소에 커밋되지 않은 의존성 또는 파일이 빠져 있을 수 있습니다. 설정 스크립트는 Codex가 새 스레드 시작 시 새 worktree를 만들 때 자동으로 실행됩니다.

의존성 설치나 빌드 실행처럼 환경을 구성하는 데 필요한 명령을 이 스크립트에 넣습니다.

예를 들어 TypeScript 프로젝트에서는 설정 스크립트로 의존성을 설치하고 초기 빌드를 실행할 수 있습니다.

npm install
npm run build

설정이 플랫폼별로 다르다면 macOS, Windows, Linux용 설정 스크립트를 정의해 기본값을 재정의합니다.

작업

작업을 사용하면 앱 개발 서버 시작이나 테스트 모음 실행 같은 일반 작업을 정의할 수 있습니다. 이러한 작업은 빠르게 접근할 수 있도록 Codex 앱 상단 막대에 표시됩니다. 작업은 앱의 통합 터미널 안에서 실행됩니다.

작업은 프로젝트 빌드 트리거 또는 개발 서버 시작처럼 자주 쓰는 명령을 매번 입력하지 않게 해 줍니다. 일회성 빠른 디버깅에는 통합 터미널을 직접 사용할 수 있습니다.

예를 들어 Node.js 프로젝트에서는 다음 스크립트를 포함하는 "Run" 작업을 만들 수 있습니다.

npm start

작업 명령이 플랫폼별로 다르다면 macOS, Windows, Linux용 플랫폼별 스크립트를 정의합니다.

작업을 구분하려면 각 작업과 연결할 아이콘을 선택합니다.