Codex 설치 방법｜Windows 초보자도 따라 하는 A to Z 완벽 가이드!

Codex 설치 방법｜Windows 초보자도 따라 하는 A to Z 완벽 가이드

요즘 개발자들 사이에서 Codex라는 이름을 자주 볼 수 있습니다.

그런데 막상 설치하려고 하면 생각보다 헷갈립니다.

"Codex는 어디에서 다운로드하지?"

"ChatGPT를 설치하면 되는 건가?"

"Codex 앱과 Codex CLI는 뭐가 다른 거지?"

"Windows에서는 어떻게 설치하지?"

"설치한 다음에는 내 프로젝트를 어떻게 연결하지?"

 

처음 사용하는 사람이라면 당연히 어려울 수 있습니다.

그래서 이번 글에서는 Windows PC를 기준으로 Codex를 처음 설치하는 과정부터 프로젝트를 연결하고 첫 번째 작업을 시키는 과정까지, 컴퓨터를 잘 모르는 사람도 따라 할 수 있도록 하나씩 설명해보겠습니다.

---

1. 먼저 Codex가 무엇인지 알아보자

Codex는 OpenAI에서 제공하는 AI 코딩 에이전트입니다.

단순히 질문을 하면 코드를 만들어주는 AI와 조금 다릅니다.

예를 들어 일반적인 AI에게는 다음과 같이 질문합니다.

"Unity에서 버튼을 누르면 팝업이 나타나는 C# 코드를 만들어줘."

 

그러면 AI가 코드를 작성해줍니다.

하지만 Codex는 프로젝트 자체를 대상으로 작업할 수 있습니다.

예를 들어:

"이 프로젝트에서 버튼 클릭 이벤트를 담당하는 코드를 찾아서 팝업이 표시되지 않는 원인을 분석해줘."

라고 요청할 수 있습니다.

 

프로젝트의 파일을 확인하고, 관련 코드를 찾아보고, 필요한 경우 코드를 수정하는 방식으로 작업할 수 있습니다.

OpenAI는 Codex를 코드 생성뿐 아니라 대규모 코드베이스 분석, 구현, 테스트 등의 개발 작업을 수행하는 코딩 에이전트로 소개하고 있습니다.

---

2. 오늘 설치할 것은 무엇인가?

Codex를 처음 접한다면 가장 먼저 알아야 할 것이 있습니다.

Codex에는 여러 가지 사용 방법이 있습니다.

방법 ① Codex 앱

Windows에서 프로그램처럼 실행하는 방법입니다.

방법 ② Codex CLI

PowerShell이나 Windows Terminal 같은 터미널에서 사용하는 방법입니다.

방법 ③ IDE에서 사용

VS Code와 같은 개발 환경에서 Codex를 사용하는 방법입니다.

이번 글에서는 초보자에게 가장 쉬운 방법인

Windows용 Codex 앱

 

Windows용 Codex 앱부터 시작하겠습니다.

---

3. 설치 전에 준비할 것

Codex를 설치하기 전에 딱 두 가지만 준비하면 됩니다.

준비물

① Windows PC

② OpenAI/ChatGPT 계정

그리고 인터넷 연결이 필요합니다.

여기서 중요한 점이 있습니다.

Codex를 사용하기 위해 무작정 인터넷에서 설치 파일을 검색하지 않는 것을 추천합니다.

가급적 OpenAI 공식 사이트를 이용하세요.

OpenAI Codex 공식 페이지

---

4. STEP 1 — OpenAI 공식 Codex 페이지 열기

이제 실제로 설치를 시작해보겠습니다.

먼저 Windows에서 인터넷 브라우저를 실행합니다.

Chrome을 사용한다면:

① 화면 아래쪽 작업 표시줄에서

Chrome 아이콘을 클릭합니다.

또는

키보드에서:

Windows 키 → Chrome 검색 → Enter

를 눌러도 됩니다.

---

화면에서 확인할 위치

브라우저가 열리면 가장 위쪽에 긴 주소창이 있습니다.

그 주소창을 클릭합니다.

그리고 OpenAI의 공식 Codex 페이지로 이동합니다.

OpenAI Codex 공식 페이지

 

---

5. STEP 2 — Codex 다운로드 버튼 찾기

Codex 공식 페이지에 들어가면 화면에서 Codex 관련 안내와 시작/다운로드 영역을 찾습니다.

Windows PC라면 Windows용 Codex 앱을 선택합니다.

현재 Codex 앱은 Windows에서도 공식적으로 제공되고 있습니다. OpenAI는 2026년 3월 4일 Windows용 Codex 앱 지원을 발표했습니다.

 

Windows PC → Windows용 Codex 앱

 

을 선택하면 됩니다.

(주의) Mac용 다운로드를 선택하면 안 됩니다.

---

6. STEP 3 — 다운로드가 시작됐는지 확인하기

다운로드 버튼을 클릭하면 Windows에서 설치 파일 다운로드가 시작됩니다.

Chrome을 사용한다면 일반적으로 브라우저 오른쪽 위의 다운로드 영역에서 파일을 확인할 수 있습니다.

화면 오른쪽 위를 확인하세요.

찾을 것

다운로드된 Codex 설치 파일입니다.

---

만약 다운로드 파일이 보이지 않는다면?

걱정하지 않아도 됩니다.

키보드에서:

Ctrl + J

를 눌러보세요.

그러면 Chrome의 다운로드 페이지가 열립니다.

여기에서 방금 다운로드한 파일을 확인할 수 있습니다.

---

7. STEP 4 — Codex 설치 파일 실행하기

다운로드가 완료되었다면 설치 파일을 클릭합니다.

그러면 Windows에서 프로그램 설치가 시작됩니다.

만약 Windows에서 다음과 비슷한 보안 확인 창이 나타난다면:

"이 앱이 디바이스를 변경할 수 있도록 허용하시겠습니까?"

 

설치 파일이 OpenAI에서 공식적으로 받은 파일인지 확인한 뒤 설치를 진행합니다.

---

8. STEP 5 — Codex 설치 완료

설치가 정상적으로 진행되면 Codex 앱이 설치됩니다.

설치가 완료되면 Codex를 실행합니다.

Windows 검색을 이용해도 됩니다.

① 키보드의 Windows 키를 누릅니다.

② 검색창에

Codex

를 입력합니다.

③ 검색 결과에서 Codex를 클릭합니다.

---

9. STEP 6 — Codex 첫 화면 확인하기

Codex가 처음 실행되면 로그인 화면 또는 시작 화면이 나타날 수 있습니다.

여기에서 ChatGPT/OpenAI 계정으로 로그인합니다.

이미 브라우저에서 ChatGPT를 사용하고 있다면 같은 계정을 사용하는 것이 편합니다.

---

10. STEP 7 — 로그인하기

로그인 화면에서 안내되는 방식에 따라 로그인합니다.

일반적으로:

Codex 실행
 ↓
로그인 선택
 ↓
OpenAI/ChatGPT 계정 인증
 ↓
Codex 화면으로 이동

순서로 진행됩니다.

---

11. STEP 8 — 가장 중요한 부분: 프로젝트 선택

로그인까지 끝났다면 이제부터가 정말 중요합니다.

Codex에게 실제 프로젝트를 작업시키려면 작업할 프로젝트 폴더를 지정해야 합니다.

예를 들어 Unity 프로젝트가 다음 위치에 있다고 해보겠습니다.

D:\ProjectTest_01

여기서 중요한 것은:

프로젝트의 가장 바깥쪽 폴더를 선택하는 것

입니다.

---

12. Unity 프로젝트라면 어떤 폴더를 선택해야 할까?

예를 들어 Unity 프로젝트가 다음과 같이 구성되어 있다고 해보겠습니다.

D:\PreojectTest_01
│
├─ Assets
├─ Library
├─ Packages
├─ ProjectSettings
└─ UserSettings

이때:

❌ Assets만 선택하지 않습니다.

D:\PreojectTest_01\Assets

보다는

⭕ Unity 프로젝트 전체 폴더를 선택합니다.

D:\PreojectTest_01

즉, Assets가 들어 있는 상위 프로젝트 폴더를 선택한다고 생각하면 됩니다.

---

13. STEP 9 — 프로젝트 폴더 열기

Codex에서 프로젝트를 추가하거나 열 수 있는 메뉴를 찾습니다.

화면에서 다음과 같은 의미의 버튼을 찾으면 됩니다.

Open folder

Open project

Add folder

또는 프로젝트를 선택하는 버튼

 

버튼 이름은 앱 버전에 따라 달라질 수 있으므로 "폴더를 선택하는 기능"을 찾으면 됩니다.

---

실제 화면에서 어디를 봐야 할까?

이 부분은 블로그에서 캡처에 번호를 붙이면 아주 이해하기 쉽습니다.

┌───────────────────────────────┐
│ Codex                         │
│                               │
│   [프로젝트 영역]             │
│                               │
│        + 프로젝트 열기        │ ← ①
│                               │
└───────────────────────────────┘

① 프로젝트를 여는 버튼

을 클릭합니다.

그다음 Windows의 파일 선택 창이 나타납니다.

---

14. STEP 10 — Windows 폴더 선택창에서 프로젝트 찾기

이제 Windows의 폴더 선택 화면이 나타납니다.

예를 들어:

내 PC
 └─ D:
     └─ ProjectTest_01

와 같이 프로젝트를 찾습니다.

순서

① D 드라이브 클릭

↓

② ProjectTest_01 폴더 찾기

↓

③ PreojectTest_01 폴더 선택

↓

④ 열기/선택 버튼 클릭

---

15. STEP 11 — Codex에 프로젝트가 나타나는지 확인

프로젝트 폴더를 정상적으로 연결했다면 Codex 화면에 프로젝트가 나타납니다.

이제 Codex가 해당 프로젝트를 작업 대상으로 사용할 수 있습니다.

여기서 바로 코드를 수정시키기보다는 먼저 프로젝트를 분석시키는 것을 추천합니다.

---

16. STEP 12 — 첫 번째 명령을 입력해보자

처음에는 아주 간단한 명령을 입력해보세요.

다음 문장을 그대로 복사해도 됩니다.

이 프로젝트의 전체 구조를 분석해줘.

아직 파일을 수정하지 말고,
주요 폴더와 핵심 시스템이 무엇인지 설명해줘.

이것이 첫 번째 Codex 명령입니다.

---

17. 왜 처음부터 코드 수정을 시키면 안 될까?

초보자에게 가장 중요한 부분입니다.

Codex가 프로젝트를 제대로 이해하지 못한 상태에서 바로:

"전투 시스템을 수정해줘."

 

라고 하면 원하는 결과가 나오지 않을 수 있습니다.

따라서 다음 순서가 좋습니다.

① 프로젝트 분석
       ↓
② 관련 파일 찾기
       ↓
③ 문제 원인 분석
       ↓
④ 수정 계획
       ↓
⑤ 코드 수정
       ↓
⑥ 테스트

이것이 Codex를 안정적으로 사용하는 기본 방법입니다.

---

18. STEP 13 — 특정 기능을 찾아보자

프로젝트 분석이 끝났다면 특정 시스템을 찾아보게 할 수 있습니다.

예를 들어 Unity 게임의 스테이지 시스템을 확인하고 싶다면:

스테이지 시스템을 분석해줘.

스테이지 시작부터
스테이지 클리어,
다음 스테이지 해금까지의
전체 흐름을 찾아줘.

관련된 파일 이름과 주요 클래스도 알려줘.

아직 코드는 수정하지 마.

라고 요청할 수 있습니다.

---

19. STEP 14 — 이제 실제 코드 수정하기

분석이 끝났다면 그때 수정 작업을 요청합니다.

예를 들어:

1-6 스테이지를 클리어한 후
1-7 스테이지가 해금되지 않는 문제가 있어.

관련 코드를 확인하고
원인을 먼저 설명해줘.

원인을 확인한 후
필요한 파일만 최소한으로 수정해줘.

수정한 파일과 변경 내용을 마지막에 정리해줘.

이렇게 요청합니다.

---

20. Codex에게 좋은 명령을 만드는 방법

Codex를 사용할 때는 단순히:

"고쳐줘."

 

라고 하는 것보다 구체적으로 말하는 것이 좋습니다.

좋지 않은 예

버그 고쳐줘.

좋은 예

게임에서 1-6을 클리어한 뒤
1-7이 해금되지 않는 문제가 있다.

먼저 관련 코드를 찾아서
원인을 분석해줘.

아직 수정하지 말고
원인과 수정 방법을 먼저 설명해줘.

더 좋은 예

1-6 클리어 후 1-7 진입이 되지 않는 문제를 수정해줘.

조건:
1. 기존 스테이지 시스템은 유지
2. 관련 파일만 최소한으로 수정
3. 저장 데이터 구조는 변경하지 않음
4. 다른 스테이지에 영향을 주지 않도록 함

수정 전에 원인을 설명하고,
수정 후 변경된 파일을 정리해줘.

---

21. STEP 15 — 코드가 수정되면 바로 게임을 출시하지 말자

이것도 매우 중요합니다.

Codex가 코드를 수정했다고 해서 바로 Google Play나 App Store에 빌드해서는 안 됩니다.

먼저:

Codex 수정
 ↓
변경 파일 확인
 ↓
Unity 실행
 ↓
Console 확인
 ↓
게임 실행
 ↓
기능 테스트
 ↓
문제 없음 확인

과정을 거치는 것이 좋습니다.

---

22. Git을 사용한다면 더욱 안전하다

실제 개발 프로젝트에서 Codex를 사용할 예정이라면 Git을 함께 사용하는 것을 추천합니다.

작업하기 전에 현재 상태를 저장합니다.

git status

그리고 필요하다면 커밋합니다.

git add .
git commit -m "Before Codex changes"

그 다음 Codex에게 작업을 시킵니다.

이렇게 하면 Codex가 예상하지 못한 변경을 했을 때 이전 상태로 돌아가기 쉽습니다.

---

23. Codex CLI도 설치해보자

Codex 앱을 사용하는 것에 익숙해졌다면 다음으로 Codex CLI를 사용할 수 있습니다.

CLI는 Windows의 PowerShell이나 Windows Terminal에서 Codex를 실행하는 방식입니다.

OpenAI의 공식 개발자 문서에서는 Codex를 CLI 환경에서도 사용할 수 있도록 제공하고 있습니다.

---

24. STEP 16 — Node.js 설치 확인

Codex CLI를 설치하려면 npm을 사용할 수 있는 환경이 필요합니다.

먼저 PowerShell을 실행합니다.

Windows 검색

Windows 키 → PowerShell 입력 → PowerShell 실행

그리고 다음 명령을 입력합니다.

npm --version

버전 숫자가 나타나면 정상입니다.

예:

10.x.x

처럼 숫자가 표시됩니다.

---

25. STEP 17 — Codex CLI 설치

PowerShell에 다음 명령을 입력합니다.

npm install -g @openai/codex

Enter를 누릅니다.

잠시 기다리면 설치가 진행됩니다.

설치가 끝났다면 다음 명령을 입력합니다.

codex

Codex CLI가 실행되면 설치가 완료된 것입니다.

---

26. STEP 18 — 프로젝트 폴더에서 Codex 실행하기

이제 프로젝트 폴더로 이동합니다.

예를 들어:

D:\PreojectTest_01

라면 PowerShell에서:

cd D:\PreojectTest_01

를 입력합니다.

그리고:

codex

를 실행합니다.

그러면 현재 프로젝트 폴더를 기준으로 Codex를 사용할 수 있습니다.

---

27. Codex 앱과 CLI 중 무엇을 사용해야 할까?

처음 사용하는 분이라면 이렇게 생각하면 됩니다.

사용 방법추천 대상

Codex 앱	초보자
Codex CLI	개발자
IDE 연동	VS Code 사용자
앱 + CLI	적극적인 개발자

처음이라면 Codex 앱부터 시작하는 것을 추천합니다.

익숙해지면 CLI를 추가하면 됩니다.

---

28. Windows에서 Codex가 실행되지 않는다면?

Codex 설치 후 실행되지 않는 경우가 있을 수 있습니다.

가장 먼저 확인할 것은:

① Codex를 완전히 종료

② Windows를 재시작

③ Codex 다시 실행

입니다.

특정 Windows 환경에서는 권한 문제 등이 원인이 될 수 있다는 사용자 사례도 OpenAI 커뮤니티에 보고되어 있습니다. 다만 이는 공식적인 일반 해결책이라고 단정하기보다는 환경별 문제 해결 사례로 보는 것이 좋습니다.

---

29. npm에서 codex를 찾지 못한다면?

다음과 같은 오류가 나온다면:

'npm' is not recognized...

Node.js 또는 npm이 제대로 설치되지 않았을 가능성이 있습니다.

먼저:

node --version

그리고:

npm --version

을 각각 확인합니다.

둘 다 버전이 나오는지 확인하세요.

---

30. codex 명령어가 없다고 나온다면?

다음과 같은 오류:

'codex' is not recognized...

가 나타난다면 Codex CLI가 정상적으로 설치되었는지 확인합니다.

다시:

npm install -g @openai/codex

를 실행한 후 터미널을 완전히 종료하고 다시 실행합니다.

그다음:

codex

를 실행합니다.

---

31. 초보자가 처음 해볼 만한 작업

설치가 완료되었다면 어려운 작업부터 시작하지 마세요.

다음 작업부터 추천합니다.

첫 번째

이 프로젝트의 폴더 구조를 분석해줘.

두 번째

게임 시작 과정을 담당하는 코드를 찾아줘.

세 번째

스테이지 시작과 종료를 담당하는 코드를 찾아줘.

네 번째

현재 코드에서 개선할 수 있는 부분을 알려줘.
아직 코드는 수정하지 마.

다섯 번째

방금 발견한 문제 중 하나를 수정해줘.
수정 전에 계획을 설명해줘.

이렇게 단계적으로 진행하면 Codex의 동작 방식을 이해하기 쉽습니다.

---

32. Unity 개발자라면 이렇게 활용해보자

Unity 프로젝트에서는 Codex를 다음과 같이 사용할 수 있습니다.

🔍 코드 검색

"플레이어 이동을 담당하는 코드를 찾아줘."

🐛 버그 분석

"게임 시작 후 UI가 표시되지 않는 원인을 찾아줘."

🔧 코드 수정

"원인을 확인했으니 최소한의 변경으로 수정해줘."

🧹 리팩토링

"중복된 코드를 찾아서 기존 동작을 유지하면서 정리해줘."

🧪 테스트

"방금 수정한 코드에서 발생할 수 있는 오류를 검토해줘."

---

33. Codex를 처음 사용하는 사람에게 가장 중요한 규칙

마지막으로 이것만 기억하세요.

① 처음부터 모든 것을 수정시키지 않는다

작은 작업부터 시작합니다.

② 수정 전에 분석시킨다

분석 → 계획 → 수정

순서를 지킵니다.

③ 변경 범위를 명확히 한다

"관련 파일만 수정해줘."

라고 요청합니다.

④ 기존 기능을 유지하도록 한다

"기존 기능에 영향을 주지 않도록 해줘."

라고 명시합니다.

⑤ Git으로 백업한다

AI가 코드를 수정하기 전에는 되돌릴 방법을 준비합니다.

⑥ 마지막에는 직접 테스트한다

AI가 수정했다고 해서 자동으로 완벽한 코드는 아닙니다.

---

34. 최종 정리 — Windows Codex 설치 순서

처음부터 끝까지 다시 정리하면 아주 간단합니다.

① Chrome 실행
       ↓
② OpenAI Codex 공식 페이지 접속
       ↓
③ Windows용 Codex 다운로드
       ↓
④ 설치 파일 실행
       ↓
⑤ Codex 설치
       ↓
⑥ Codex 실행
       ↓
⑦ ChatGPT/OpenAI 계정 로그인
       ↓
⑧ 프로젝트 폴더 선택
       ↓
⑨ 프로젝트 분석 요청
       ↓
⑩ 코드 작업 시작

그리고 CLI까지 사용한다면:

① PowerShell 실행
       ↓
② npm --version 확인
       ↓
③ npm install -g @openai/codex
       ↓
④ codex
       ↓
⑤ 프로젝트 폴더 이동
       ↓
⑥ Codex 작업 시작

---

마무리

처음 Codex를 설치하면 "이게 정말 내 프로젝트를 수정할 수 있는 건가?"라는 생각이 들 수 있습니다.

하지만 핵심은 어렵지 않습니다.

Codex를 설치하고 → 프로젝트 폴더를 연결하고 → 프로젝트를 먼저 분석시키고 → 작은 작업부터 시키는 것.

이 네 단계만 기억하면 됩니다.

특히 Unity 프로젝트를 개발하고 있다면 Codex에게 처음부터 거대한 기능을 맡기기보다는,

 

"이 코드가 어디 있는지 찾아줘."

에서 시작하는 것을 추천합니다.

그 다음

"왜 이렇게 동작하는지 설명해줘."

그리고

"이 문제를 최소한으로 수정해줘."

순서로 진행하면 됩니다.

이렇게 사용하다 보면 Codex는 단순히 코드를 만들어주는 AI가 아니라 프로젝트의 코드를 함께 탐색하고 수정하는 개발 도구로 활용할 수 있습니다.