[AI] ChatGPT Plus로 Codex CLI 설치 및 사용하기 (Windows)

 

최근 ChatGPT Plus 사용자도 Codex CLI를 사용할 수 있게 되었다.

기존에는 ChatGPT 웹에서 코드를 복사하여 질문하는 방식이 일반적이었다면,

Codex CLI는 로컬 프로젝트를 직접 분석할 수 있다는 점이 가장 큰 장점이다.

특히 대규모 레거시 프로젝트나 현대화 프로젝트를 분석할 때 상당히 유용하다.

이번 글에서는 Windows 환경에서 Codex CLI를 설치하고 사용하는 방법을 정리해 보려고 한다.

---

1. Node.js 설치

Codex CLI는 Node.js 기반으로 동작한다.

먼저 Node.js를 설치한다.

https://nodejs.org/ko/download

Node.js — Node.js® 다운로드

 

설치 후 Windows PowerShell에서 정상 설치 여부를 확인한다.

<Windows PowerShell>

node -v

 

 

<출력 예시>

v24.18.0

---

2. npm 실행 정책 설정

Windows PowerShell에서는 실행 정책 때문에 npm이 동작하지 않는 경우가 있다.

다음 명령어를 한 번 실행한다.

<Windows PowerShell>

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

 

Windows PowerShell을 다시 실행한 후

<Windows PowerShell>

npm -v

 

버전이 출력되면 정상이다.

---

3. Codex CLI 설치

<Windows PowerShell>

npm install -g @openai/codex

 

설치가 완료되면

 

<Windows PowerShell>

codex --version

 

버전 출력으로 설치 여부를 확인한다.

---

4. Codex 로그인

최초 한 번만 로그인하면 된다.

<Windows PowerShell>

codex

 

브라우저가 열리면서 ChatGPT 로그인 화면이 나타난다.

ChatGPT Plus 사용자는 별도의 API Key 없이 로그인하여 사용할 수 있다.

---

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

Codex는 현재 디렉토리를 기준으로 프로젝트를 분석한다.

따라서 반드시 프로젝트 루트(Project Root)에서 실행하는 것이 좋다.

프로젝트 루트인지 확인하는 방법은

<Windows PowerShell>

git rev-parse --show-toplevel

 

현재 위치와 동일한 경로가 출력되면 현재 위치가 프로젝트 루트이다.

예를 들어

<Windows PowerShell>

cd C:\Scaffold\backoffice-scaffold

 

이후

<Windows PowerShell>

git rev-parse --show-toplevel

 

결과가

<출력 예시>

C:/Scaffold/backoffice-scaffold

 

이라면 현재 위치가 프로젝트 루트인 것이다.

---

6. Codex 실행

프로젝트 루트에서

<Windows PowerShell>

codex

 

입력하여 실행하면 된다.

최초 실행 시

• 프로젝트 신뢰(Trust)
• Sandbox 설정

등을 한 번만 진행하면 된다.

---

7. 추천 사용 방법

✅ 한국어로 사용하기

Codex CLI는 기본적으로 영어 인터페이스를 사용한다.

한국어로 질문하고 답변받고 싶다면 최초 실행 후 아래 프롬프트를 한 번 입력하면 된다.

From now on, always answer in Korean

 

이후부터는 한국어로 질문하면 대부분 한국어로 답변받을 수 있다.

 

✅ 프로젝트 분석부터 시작하기

Codex는 단순한 코드 생성 도구뿐만 아니라 프로젝트를 분석하고 이해하는 데에도 매우 강력한 AI 개발 도구이다.

특히 다음과 같은 작업에서 많은 도움을 받을 수 있다.

• 프로젝트 구조 분석
• 호출 흐름 분석
• 아키텍처 리뷰
• 리팩토링 포인트 분석
• 레거시 코드 분석
• 현대화(Migration) 방향 제안

처음에는 코드 생성이나 수정 요청보다는 프로젝트를 충분히 분석하도록 요청하는 것을 추천한다.

예를 들어 다음과 같이 질문할 수 있다.

README.md와 docs 디렉토리를 먼저 읽고 이 프로젝트의 전체 아키텍처를 설명해줘

또는

이 프로젝트를 충분히 분석한 후 전체 구조, 계층별 역할, 설계 의도, 개선해야 할 부분을 설명해줘

---