설치와 인증

Codex CLI는 명령줄 도구로 제공됩니다. npm으로 전역 설치하거나, 패키지 매니저(예: Homebrew)로 설치할 수 있습니다.

학습 목표

• Codex CLI 설치 방법을 안다.
• ChatGPT 계정 로그인과 API 키 인증의 차이를 이해한다.
• 프로젝트 폴더에서 첫 세션을 연다.

사전 준비

• Node.js (npm 설치 시) 또는 Homebrew 등 패키지 매니저
• ChatGPT 계정(요금제) 또는 OpenAI API 키

설치

npm으로 설치하는 경우(Node 22 이상 필요):

npm install -g @openai/codex

반드시 @openai/ 스코프가 붙은 패키지를 설치하세요. 스코프 없는 codex는 전혀 다른 옛 패키지입니다.

설치 후 버전을 확인합니다.

codex --version

인증 방식

Codex는 두 가지 인증 방식을 지원합니다.

• ChatGPT 계정 로그인: 구독 요금제에 포함된 사용량으로 이용. 별도 키 관리가 필요 없다.
• API 키: OpenAI 플랫폼의 API 키로 인증. 사용량만큼 과금된다.

대화형으로 로그인하려면 프로젝트 폴더에서 실행한 뒤 안내에 따릅니다.

cd my-project
codex

처음 실행 시 로그인 흐름이 시작되고, 한 번 인증하면 자격 정보가 저장됩니다.

첫 세션 열기

인증을 마치면 프롬프트에 작업을 입력할 수 있습니다.

> 이 프로젝트의 폴더 구조와 핵심 진입점을 설명해줘

프로젝트 루트에서 실행하기

Codex는 실행한 디렉터리를 작업 공간(workspace)으로 삼습니다. 항상 프로젝트 루트에서 실행하고, git 저장소에서 작업하면 변경을 추적하기 좋습니다.

설치 명령과 인증 방식은 버전에 따라 달라질 수 있으니, 공식 문서에서 최신 절차를 함께 확인하세요.

요약

Codex CLI는 npm install -g @openai/codex 등으로 설치하고, ChatGPT 계정 또는 API 키로 인증합니다. 프로젝트 루트에서 codex를 실행하면 그 폴더가 작업 공간이 되어 첫 세션이 시작됩니다.