06/02/2026 · zyss

OpenAI Codex CLI 설치 방법: 계정 로그인으로 시작하는 코덱스

OpenAI Codex 공식 시작 페이지에서 안내하는 Codex CLI는 터미널에서 사용하는 AI 코딩 도우미입니다. 명령어 창에서 코드 설명, 오류 분석, 수정 작업을 부탁할 수 있습니다.

처음 쓰는 사람은 API 키부터 준비할 필요가 없습니다. 먼저 OpenAI 또는 ChatGPT 계정으로 로그인해서 시작하는 방식이 가장 쉽습니다.

1. 사용 가능 조건 확인하기

Codex CLI도 설치 자체와 실제 사용 가능 조건은 다를 수 있습니다. 기본은 OpenAI 또는 ChatGPT 계정으로 로그인하는 방식이지만, 계정 종류와 사용 가능한 모델, 사용량 정책에 따라 제한이 있을 수 있습니다.

무료 계정으로 시도하는 경우 실행 화면에서 사용 권한이나 모델 제한이 나올 수 있습니다. 이런 경우 지원되는 구독 계정으로 로그인하거나, 개발자 환경에서는 API 키를 사용해야 할 수 있습니다.

Codex CLI를 설치하려면 Node.js와 npm이 필요합니다. 아래 명령어로 확인합니다.

node -v
npm -v

버전 번호가 나오면 준비가 된 것입니다.

OpenAI Codex CLI 시작 매뉴얼 기준으로, 터미널을 열고 아래 명령어를 실행합니다.

npm install -g @openai/codex

이미 설치되어 있다면 최신 버전으로 다시 설치할 수 있습니다.

npm i -g @openai/codex

설치가 끝나면 프로젝트 폴더에서 Codex를 실행합니다.

codex

처음 실행하면 OpenAI 계정 또는 ChatGPT 계정으로 로그인하는 안내가 나올 수 있습니다. 자세한 흐름은 Codex CLI 계정 로그인 안내를 참고하면 됩니다.

API 키는 개발자용 열쇠입니다. 일반 사용자가 Codex를 터미널에서 써보는 목적이라면 계정 로그인으로 충분한 경우가 많습니다.

서버 실행, 반복 자동화, 웹사이트·백엔드 연동, 팀 사용량 관리, CI/CD 환경에서는 OpenAI API 키 발급 페이지에서 키를 만들어 사용할 수 있습니다.

macOS 또는 Linux에서는 아래처럼 설정합니다.

export OPENAI_API_KEY="YOUR_API_KEY_HERE"

Windows PowerShell에서는 아래처럼 설정합니다.

$env:OPENAI_API_KEY="YOUR_API_KEY_HERE"

API 키는 비밀번호처럼 다뤄야 합니다. 공개 저장소, 블로그 글, 스크린샷, 채팅에 실제 키를 넣으면 안 됩니다.

고치고 싶은 코드가 있는 폴더로 이동한 뒤 Codex를 실행합니다.

cd my-project
codex

더 자세한 사용 예시는 OpenAI Codex GitHub 저장소를 참고할 수 있습니다.

처음에는 설명부터 요청하는 것이 안전합니다.

이 프로젝트가 어떤 구조인지 설명하고, 중요한 파일을 쉬운 말로 정리해줘.

수정이 필요할 때는 먼저 계획을 말하게 합니다.

이 오류의 원인을 먼저 분석하고, 수정 계획을 설명한 뒤, 필요한 파일만 수정해줘.