윈도우에 Codex CLI 설치하기: 완전 초보용 순서 가이드

윈도우에서 Codex CLI를 설치하는 방법을 초보자 기준으로 정리합니다.

Windows에 Codex CLI 설치하기

Codex CLI는 터미널에서 실행하는 OpenAI의 코딩 에이전트입니다. 코드를 대신 읽고, 수정하고, 명령어를 실행하는 방식으로 쓸 수 있습니다. 처음에는 어렵게 보이지만, 설치 순서는 길지 않습니다.

이 글은 개발자가 아닌 분도 따라 할 수 있게 구성했습니다.

공식 설치 명령은 OpenAI Codex GitHub README 기준으로 확인했습니다. Windows 설치 명령은 PowerShell에서 실행하는 install.ps1 방식입니다.
참고: OpenAI Codex GitHub →

Claude 계정을 쓰는 분은 윈도우 Claude Code CLI 설치 가이드를, Google Antigravity를 써보고 싶은 분은 윈도우 Antigravity CLI 설치 가이드를 함께 보면 됩니다.

설치가 끝난 뒤에는 AI 코딩 CLI 설치 후 처음 세팅할 것 7가지를 먼저 확인하는 편이 안전합니다.

바로 결과물을 만들어보고 싶다면 AI 코딩 CLI로 첫 홈페이지 만들기 실습으로 이어가면 됩니다.

준비물

먼저 아래 3가지만 확인합니다.

Windows 10 또는 Windows 11 PC
ChatGPT 계정
인터넷 연결

ChatGPT Plus, Pro, Business, Edu, Enterprise 계정이면 Codex를 ChatGPT 로그인으로 사용할 수 있습니다. API 키로도 쓸 수 있지만, 초보자는 ChatGPT 로그인 방식이 더 쉽습니다.

1단계: PowerShell 열기

Windows 검색창에 PowerShell을 입력합니다.

그다음 Windows PowerShell을 엽니다.

처음 설치할 때 권한 문제가 생기면 관리자 권한으로 실행합니다.

# 확인용 명령어입니다.
# PowerShell 창에서 아래 명령어를 입력하고 Enter를 누릅니다.
$PSVersionTable.PSVersion

숫자가 나오면 PowerShell이 정상으로 열린 것입니다.

2단계: Codex CLI 설치

PowerShell에 아래 명령어를 그대로 붙여넣고 Enter를 누릅니다.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

설치가 진행됩니다.

중간에 확인을 묻는 문구가 나오면 화면 안내에 따라 Y 또는 Enter를 누릅니다.

3단계: 설치 확인

설치가 끝났으면 PowerShell 창을 닫았다가 다시 엽니다.

그다음 아래 명령어를 입력합니다.

codex --version

버전 숫자가 나오면 설치가 된 것입니다.

예시는 이런 식입니다.

codex-cli 0.0.0

숫자는 설치 시점에 따라 달라질 수 있습니다.

4단계: 첫 실행 전 확인

설치는 끝났지만, 아직 아무 폴더에서나 codex를 입력하지 않습니다.

Codex는 현재 폴더를 기준으로 파일을 읽고 수정합니다. 그래서 처음 실행은 다음 단계에서 만드는 연습용 폴더 안에서 하는 편이 안전합니다.

5단계: 바탕화면에 작업 폴더 만들기

먼저 터미널 명령어로 폴더를 만들지 말고, 눈에 보이는 곳에서 직접 만듭니다.

바탕화면으로 갑니다.
빈 곳에서 마우스 오른쪽 버튼을 누릅니다.
새로 만들기 → 폴더를 누릅니다.
폴더 이름을 codex-practice로 바꿉니다.

그다음 바탕화면 위치에서 PowerShell을 엽니다.

파일 탐색기에서 바탕화면을 엽니다.
위쪽 주소창을 클릭합니다.
powershell을 입력하고 Enter를 누릅니다.

PowerShell 창이 열리면 아래처럼 입력합니다.

cd codex-practice
codex

처음 실행하면 로그인 방식 선택 화면이 나옵니다.

초보자는 Sign in with ChatGPT를 선택합니다.

브라우저가 열리면 ChatGPT 계정으로 로그인합니다.

이제 Codex에게 간단히 요청해볼 수 있습니다.

이 폴더에 hello.txt 파일을 만들고, 안에 "처음 실행한 Codex 테스트"라고 적어줘.

Codex가 파일을 만들겠다고 하면 내용을 확인한 뒤 진행하면 됩니다.

6단계: npm 방식 대안

위 설치 명령이 잘 안 될 때는 npm 방식도 있습니다.

단, 이 방식은 Node.js가 먼저 설치되어 있어야 합니다.

Node.js 설치 여부는 아래 명령으로 확인합니다.

node -v
npm -v

버전이 나오면 아래 명령어로 설치할 수 있습니다.

npm install -g @openai/codex

설치 후 다시 버전만 확인합니다.

codex --version

실제 실행은 위 5단계처럼 바탕화면의 codex-practice 폴더로 들어간 뒤 codex를 입력합니다.

Node.js가 없다면 먼저 Node.js LTS 버전을 설치합니다.

winget install OpenJS.NodeJS.LTS

설치 후 PowerShell을 닫았다가 다시 열고, npm 설치 명령을 실행합니다.

자주 막히는 지점

증상	해결
`codex` 명령어를 찾을 수 없음	PowerShell을 닫았다가 다시 열기
설치 스크립트 실행이 막힘	PowerShell을 관리자 권한으로 실행
npm 설치가 안 됨	Node.js LTS 설치 후 다시 실행
로그인 창이 안 뜸	기본 브라우저를 열어둔 상태에서 `codex` 다시 실행
아무 폴더에서 실행해서 불안함	바탕화면에 만든 `codex-practice` 폴더 안에서 먼저 테스트

초보자가 조심할 점

Codex는 파일을 읽고 수정할 수 있습니다.

처음부터 중요한 업무 폴더, 계약서 폴더, 개인정보가 들어 있는 폴더에서 실행하지 않는 편이 좋습니다.

처음에는 반드시 연습용 폴더에서 테스트합니다.

그리고 Codex가 제안하는 변경사항을 바로 승인하지 말고, 어떤 파일을 바꾸는지 먼저 확인합니다.

처음 시켜볼 만한 요청

아래처럼 작게 시작하면 됩니다.

이 폴더 구조를 설명해줘.

README.md 파일을 만들고, 이 프로젝트의 목적을 초보자도 이해하게 정리해줘.

index.html 파일을 하나 만들고, 간단한 자기소개 페이지를 만들어줘.

방금 만든 파일을 더 깔끔하게 정리해줘. 단, 내 허락 없이 파일을 삭제하지 마.

처음에는 코딩보다 파일 정리, 설명, 작은 HTML 만들기부터 해보는 편이 좋습니다.

index.html로 첫 홈페이지를 만들어보는 전체 과정은 AI 코딩 CLI로 첫 홈페이지 만들기에서 이어서 볼 수 있습니다.

설치보다 중요한 것

Codex 설치 자체는 어렵지 않습니다.

진짜 중요한 것은 어디에 적용할지 정하는 일입니다.

예를 들면 이런 식입니다.

반복되는 문서 정리
엑셀 데이터를 웹 화면으로 보기
간단한 내부 업무 도구 만들기
홈페이지 문구와 FAQ 정리
기존 코드 설명 받기
자동화 아이디어를 실제 파일로 만들기

도구를 먼저 설치하고 끝내기보다, 작은 업무 하나를 골라 실제로 줄여보는 것이 좋습니다.

Boilerplate AI 컨설팅

Boilerplate는 AI 도구 설치만 설명하는 곳이 아니라, 실제 업무에 맞게 AI를 적용하는 AI 업무자동화 컨설팅을 진행합니다.

Codex CLI, ChatGPT, Claude, Gemini 같은 도구를 어디에 써야 하는지부터 정리하고, 필요한 경우 업무자동화 흐름이나 작은 웹앱 제작까지 연결합니다.

윈도우 PC에 Codex를 설치하고 싶거나, 조직 안에서 AI 코딩 도구를 어떻게 써야 할지 정리하고 싶다면 아래 페이지로 연락주세요.

AI 컨설팅 문의하기