Quick Flow

Codex CLI는 설치 위치보다 어느 프로젝트 디렉터리에서 시작하는가가 먼저입니다. macOS/Linux의 현재 공식 기본 설치·업데이트 경로는 standalone installer이며, 첫 실행에서 사용할 로그인 방법을 선택합니다.

# macOS / Linux: 설치와 업데이트에 같은 installer를 사용한다.
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 의도한 Git repository에서 시작한다.
cd /path/to/project
codex

# 세션의 directory, model, permissions를 확인한다.
/status

설치와 업데이트

공식 설치 페이지는 macOS/Linux에서 standalone installer를 기본 경로로 제시하고, Windows·npm·Homebrew도 환경별 선택지로 제공합니다. 팀에서는 하나의 설치 경로를 강제하기보다 운영체제별 기준과 최소 지원 버전을 정하고, 문제가 생기면 OS, 설치 방식, codex --version을 함께 기록합니다.

새 설치                  -> 현재 공식 설치 페이지에서 OS별 방법 선택
같은 CLI를 업데이트       -> 해당 설치 방식의 update 절차 사용
명령을 찾지 못함          -> PATH와 설치 방식 확인
버전별 동작이 다름         -> --version과 config·plugin 버전 비교

installer를 셸로 실행하는 방식은 내려받는 내용을 실행합니다. 공식 chatgpt.com URL인지 확인하고, 조직에서 패키지 관리·프록시·승인 경로를 정했다면 그 기준을 우선합니다. 개인 편의 때문에 다른 설치 방법을 섞으면 support와 재현이 어려워집니다.

로그인과 실행 범위

프로젝트 디렉터리에서 codex를 실행하면 첫 실행에 ChatGPT sign-in 또는 제공되는 다른 sign-in 방법을 고릅니다. 계정 로그인, API 기반 사용, 관리형 workspace는 사용량·권한·사용 가능한 기능이 같은 경로가 아닐 수 있습니다. 자동화에 사용할 인증 정보와 개인 대화형 작업의 로그인 정보를 혼용하지 않습니다.

대화형 로컬 작업          -> 사용 중인 ChatGPT 계정과 workspace 확인
CI·비대화형 실행          -> 별도 자동화 인증과 secret 관리 사용
공유·임시 machine         -> 작업 후 credential 잔존 여부 확인

로그인 후에도 바로 쓰기 작업을 시작하지 않습니다. /status로 현재 directory와 session 설정을 보고, /permissions에서 작업에 맞는 권한을 확인합니다. 저장소 루트보다 상위에서 시작하면 읽기·명령 범위가 불필요하게 넓어질 수 있고, 너무 깊은 하위 폴더에서 시작하면 root AGENTS.md, package 설정, 검증 명령을 놓칠 수 있습니다.

설치 뒤 확인할 것

• codex --version은 재현 가능한 버전 정보를 남깁니다. update 직후 기존 작업과 같은 결과를 보장하지는 않습니다.
• /init은 새 AGENTS.md를 만들 수 있습니다. 이미 프로젝트 규칙이 있다면 덮어쓰기 전에 내용과 우선순위를 검토합니다.
• /review는 변경을 수정하지 않고 finding을 보고하는 review 흐름입니다. 설치 확인 대신 실제 task 결과 검토에 사용합니다.
• API key나 access token을 terminal history, repository, AGENTS.md에 넣지 않습니다. CI는 secret store와 해당 실행 환경의 인증 방식을 사용합니다.

작업 권한은 sandbox와 승인 정책, 비대화형 실행은 Codex exec 기본에서 이어서 확인할 수 있습니다.