Codex CLI 설치

Codex CLI는 npm으로 설치할 수 있고, 공식 문서와 GitHub 저장소에는 Homebrew 설치 방법도 함께 안내되어 있습니다. macOS 사용자는 brew가 더 편할 수 있고, Node.js 환경이 이미 있다면 npm 설치가 가장 빠릅니다. 

# npm 설치
npm install -g @openai/codex

# Homebrew 설치
brew install codex

설치가 끝났다면 아래 명령으로 정상 설치 여부를 확인합니다.

codex

처음 실행 시 Codex CLI는 터미널 기반 인터페이스로 실행되며, 현재 디렉터리의 코드를 읽고 수정하거나 명령을 실행할 수 있는 형태로 동작합니다. 따라서 아래와 같이 작업을 시작 할 경로에서 Codex를 실행해야됩니다.

cd my-project
codex "이 저장소를 읽고, 백엔드와 프론트엔드 구조를 구분해서 설명해줘"

 

로그인 및 인증 설정

Codex CLI는 첫 실행 시 인증을 요구합니다.
공식적으로 지원되는 방식은 다음 두 가지입니다.

• ChatGPT 계정으로 로그인
• OpenAI API 키로 로그인

즉, 개인적으로 빠르게 시작하려면 ChatGPT 계정 로그인이 편하고, 팀/과금 분리나 API 기반 운영을 원하면 API 키 방식이 적합합니다.

또한 CLI 레퍼런스에는 codex login 명령으로 OAuth, device auth, API key 입력 방식이 가능하다고 안내되어 있습니다.

# 로그인
codex login

# 로그아웃
codex logout