Codex CLI

Codex CLI(ChatGPT) 전용 설치 안내입니다. ① 사전 준비물 확인 → ② CLI 설치 → ③ OS에 맞는 설정 파일 적용 순서로 진행하세요. Claude Code용 키(sk-ant-…)로는 동작하지 않으며, 코덱스 전용 키(sk-proj-…)와 ~/.codex 설정 파일이 필요합니다.

사전 준비물

Codex CLI는 Node.js 위에서 동작하고 npm으로 설치합니다. 아래 명령으로 설치 여부를 먼저 확인하세요. 버전이 안 나오면 nodejs.org에서 Node.js를 설치한 뒤, 터미널을 새로 열어 다시 확인하세요.

1node -v2npm -v3git --version

CLI 설치

준비물이 확인되면 npm으로 Codex CLI를 전역 설치합니다.

1npm install -g @openai/codex

설정 파일

OS에 맞는 탭을 선택해 아래 명령을 실행하면 ~/.codex에 설정 파일과 인증 정보가 생성됩니다.

1mkdir -p ~/.codex2cat > ~/.codex/config.toml << 'EOF'3model_provider = "LETSFINE"4model = "gpt-5.5"5 6[model_providers.LETSFINE]7name = "LETSFINE"8base_url = "https://api.letsfine.com/codex/v1"9wire_api = "responses"10requires_openai_auth = true11EOF12cat > ~/.codex/auth.json << 'EOF'13{"OPENAI_API_KEY":"여기에_발급받은_API키를_넣어주세요"}14EOF

검증

설정이 끝나면 아래 명령으로 정상 연결을 확인하세요.

1codex --version2codex

정상적으로 실행되면 코덱스 프롬프트가 표시됩니다.