Codex CLI 설치방법

1) Codex CLI란?

Codex CLI는 OpenAI의 AI 기반 코딩 에이전트 도구로, 터미널에서 코드를 읽고, 수정하고, 실행까지 가능하게 해주는 CLI 도구입니다. 즉, 명령줄 환경에서도 ChatGPT처럼 코드를 생성하거나 수정할 수 있습니다.

2) 사전 준비

운영체제: macOS 12 이상 / Ubuntu 20.04+ / Windows 11 (WSL2 권장)
Node.js 22 이상 설치 필요
Git 설치 (옵션)
OpenAI 계정 및 API Key 보유

3) 설치 방법

npm으로 설치 (추천)

npm install -g @openai/codex

Homebrew로 설치 (macOS / Linux)

brew install codex

설치 완료 후 버전 확인:

codex --version

버전 정보가 표시되면 설치 성공입니다 ✅

4) 인증 및 설정

Codex CLI는 OpenAI 계정 인증이 필요합니다.
처음 실행 시 로그인 절차가 시작됩니다.

환경 변수로 API Key 설정 (macOS / Linux)

export OPENAI_API_KEY="your-openai-api-key"

Windows PowerShell에서는:

$env:OPENAI_API_KEY = "your-openai-api-key"

그 다음 로그인 명령을 실행합니다:

codex --login

로그인이 완료되면 Codex CLI가 터미널에서 AI 코딩 환경으로 동작합니다.

5) 기본 사용법

# 대화형 모드 실행
codex

# 한 줄 명령 실행
codex "Python으로 Hello World 출력하는 코드 작성"

# 파일 수정 요청
codex edit app.js "React Hook을 사용하도록 변경해줘"

# 명령 실행 요청
codex exec "npm run build"

Codex는 코드 수정, 실행, 명령 수행까지 터미널 안에서 모두 처리할 수 있습니다.

6) 승인 모드 (Approval Mode)

suggest : 파일 변경 전 매번 승인 요청
auto-edit : 코드 자동 수정, 명령 실행은 승인 필요
full-auto : 모든 작업 자동 실행 (⚠️ 주의 필요)

설정 파일은 ~/.codex/config.toml 에서 수정 가능합니다.

7) 요약

단계	명령	비고
설치	`npm install -g @openai/codex`	전역 설치
API 키 등록	`export OPENAI_API_KEY="..."`	OpenAI 인증용
로그인	`codex --login`	초기 인증
실행	`codex`	대화형 모드
명령 실행	`codex exec "명령"`	터미널 자동화

✅ 정리:
Codex CLI는 OpenAI의 개발자용 AI 코딩 도구로, 터미널 환경에서 직접 코드 작성과 실행을 지원합니다.
설치 후 codex 명령으로 대화형 AI 개발을 바로 시작할 수 있습니다.

Daily-it