코덱스(Codex) 데스크톱 앱 다운로드와 첫 프로젝트: Codex app으로 내 컴퓨터에 첫 페이지 만들기

코덱스(Codex) 데스크톱 앱(Codex app)은 따로 있지 않고 ChatGPT 데스크톱 앱 안에 들어 있습니다. 공식 다운로드 위치는 chatgpt.com/download와 OpenAI 공식 문서 빠른 시작의 Download ChatGPT 버튼입니다. macOS(Apple Silicon·Intel)와 Windows(Microsoft Store)용이 있고 Linux용은 미리보기입니다. 받은 앱을 열어 ChatGPT 계정으로 로그인하고 앱 위쪽 선택 메뉴에서 Codex를 고르면 됩니다.

9월 가톨릭대학교 AI 부트캠프에서 신입생들에게 Codex는 ChatGPT 데스크톱 앱 안에서만 쓰게 했습니다. 학생들이 가장 많이 막힌 곳은 코딩이 아니라 설치였어요. 그래서 자세한 설치 안내서를 미리 준비했습니다. 대부분은 설치를 마치고 왔지만 Windows PC를 쓰는 학생들이 더 자주 막혔습니다.

이 글은 앱을 설치한 다음부터 따라갑니다. 빈 폴더를 열고 권한 모드를 고른 뒤 자기소개 페이지 한 장을 만들어 내 컴퓨터에서 열어 보는 첫 프로젝트예요. 터미널용 Codex CLI 설치 명령과 Windows 샌드박스, Linux 패키지, 설치 오류 해결은 코덱스(Codex) 설치 방법에 따로 정리했습니다. 공개 배포는 다음 단계로 남겨 둡니다. CLI·IDE 확장·클라우드까지 코덱스를 쓰는 곳 전체가 궁금하다면 코덱스(Codex) 사용법을 먼저 보세요. 출처 목록의 공식 문서는 2026년 11월 8일에 다시 확인했습니다. 한국 계정에서 메뉴가 어떻게 보이는지는 확인하지 못했습니다.

코덱스(Codex) 다운로드 위치

Codex만 따로 받는 데스크톱 설치 파일은 없어요. 다른 사이트에 올라온 파일은 공식 파일인지 확인할 방법이 없으니 이 공식 경로에서만 받으세요.

코덱스(Codex) 앱은 ChatGPT 앱 안에 있습니다

검색하면 "Codex 앱"과 "ChatGPT 데스크톱 앱"이 섞여 나와서 헷갈릴 수 있는데요. 공식 What's new에 따르면 7월 9일에 Codex 앱이 macOS·Windows용 ChatGPT 데스크톱 앱으로 합쳐졌습니다. 그래서 지금은 ChatGPT 데스크톱 앱을 설치한 뒤 앱 안에서 Codex를 고르는 방식입니다. 기존 Codex 앱을 쓰던 사람은 평소처럼 업데이트하면 되고 Codex를 기본 화면으로 둘 수도 있습니다. 같은 공지는 이 앱을 Free를 포함한 모든 ChatGPT 플랜에서 전 세계에 제공한다고 적었습니다.

사용 안내는 세 가지 선택지를 이렇게 나눕니다. 질문과 대화는 Chat, 문서·발표 자료 같은 결과물은 ChatGPT Work, 코드와 개발 도구가 필요한 일은 Codex입니다. ChatGPT에는 웹사이트를 만들어 공유하는 Sites 기능도 있어요. 이 글처럼 내 폴더 안에 파일을 만들고 직접 고쳐 가는 실습은 Codex 쪽입니다.

시작 전 준비: 요금제와 계정

요금제. Codex 요금 문서에 따르면 Free와 Go 플랜은 데스크톱 앱에서 GPT-6 Luna 모델을 쓰는 구성이고 모든 계정에 한 번에 열리지는 않는다는 조건(subject to rollout)이 붙어 있습니다. Plus부터는 웹·CLI·IDE 확장·iOS에서도 Codex를 쓸 수 있고 요금 카드에 적힌 모델은 GPT-6.1 Sol과 GPT-6 Luna입니다. 같은 문서의 사용량 표에는 GPT-6 Astra, GPT-6.1 Terra, GPT-6 Sol도 함께 나와요. GPT-6.1 Terra는 10월 26~30일 주간 업데이트로 Plus 이상 플랜의 Codex에 들어왔습니다(What's new).

어떤 모델이 보이는지는 플랜, 앱, 작업공간 설정에 따라 다릅니다. 모델 선택 메뉴에 GPT-6.1 Sol이 없다면 보이는 모델로 그대로 실습해도 됩니다. GPT-5.5는 10월 14일 정오(태평양 시간, 한국 시간 10월 15일 오전 4시)부터 ChatGPT 계정으로 로그인한 Codex에서 빠졌습니다(모델 문서). 플랜별 가격과 한도는 코덱스 요금제 정리에 모았습니다.

부트캠프는 ChatGPT Plus를 기준으로 준비했습니다. 무료로 먼저 써 보는 것도 방법입니다. 다만 한도에 걸리면 진행 중인 요청은 마무리되더라도 다음 요청부터 막혀 실습이 멈출 수 있으니 수업이나 마감이 있다면 여유 있게 잡는 편이 낫습니다. 남은 한도는 사용량 대시보드에서 봅니다.

계정. 앱을 열고 ChatGPT 계정으로 로그인합니다. 인증 문서에 따르면 로그인 전 화면에서 Continue to sign in을 누르면 브라우저 창이 열리고 로그인이 끝나면 앱으로 돌아옵니다. Sign in another way를 누르면 API 키로 로그인할 수도 있습니다. 하지만 사용량만큼 따로 과금되고 일부 기능이 빠지니 처음에는 ChatGPT 계정으로 시작하세요.

운영체제별 주의점. Mac은 데스크톱, 다운로드, 음악 같은 폴더에 Codex가 접근할 때 macOS가 추가 승인을 요구합니다(문제 해결 문서). 그래서 실습 폴더는 홈 폴더 바로 아래에 새로 만드는 게 편해요. Windows는 PowerShell에서 Codex를 실행하고 Windows 샌드박스로 작업 폴더 밖 쓰기와 허락 없는 네트워크 접속을 막습니다.

Windows 샌드박스 문서에 따르면 개인 계정의 데스크톱 앱은 기기가 지원하면 관리자 승인 없이 도는 MXC 방식을 먼저 씁니다. MXC는 Microsoft가 Windows 11에 차례로 배포하고 있는 기능이라 지원하지 않는 기기에서는 관리자 승인이 필요한 예전 방식으로 설정합니다. 이때 관리자 승인 창(UAC)이 뜰 수 있고 학교·회사가 관리하는 노트북은 이 단계에서 막히기도 합니다. 막혔을 때 확인할 항목은 코덱스(Codex) 설치 방법에 모았습니다.

첫 실행: 폴더 열기와 권한 모드

로그인하고 나면 어디서 일할지 고릅니다. 빠른 시작은 채팅 시작, 프로젝트 만들기, 폴더 열기의 세 가지를 안내합니다. 웹페이지를 만들 때는 폴더를 여는 것이 핵심이에요. Codex는 고른 폴더 안의 파일을 읽고 고칩니다. 반대로 말하면 그 폴더가 작업 범위입니다.

1. 빈 폴더를 만듭니다. Mac은 Finder 메뉴에서 이동 > 홈으로 간 뒤 새 폴더를 만들고 이름을 codex-practice로 바꿉니다. 이 위치를 줄여서 ~/codex-practice라고 쓰기도 해요. ~는 홈 폴더라는 뜻입니다. Windows는 파일 탐색기에서 C:\Users\내 이름 폴더로 가서 같은 이름의 새 폴더를 만듭니다. 바탕화면, 다운로드, 음악 폴더 안에는 만들지 않습니다.
2. Codex를 고릅니다. 화면 위 선택 메뉴가 ChatGPT로 되어 있으면 눌러서 Codex로 바꿉니다.
3. 폴더를 엽니다. 사이드바의 Add new project 버튼을 누르거나 단축키(Mac은 Cmd+O, Windows는 Ctrl+O)로 방금 만든 폴더를 고릅니다.
4. 실행 위치를 확인합니다. 환경 문서에 따르면 새 대화의 Work in에서 This computer와 Cloud 중 하나를 고릅니다. 첫 메시지를 보내기 전에 내 컴퓨터에서 작업하는 This computer인지 확인하세요. Worktree 없이 그 폴더에서 바로 작업하는 이 방식을 문서는 Local이라고 부릅니다. Cloud는 OpenAI 쪽 환경에서 실행돼서 내 폴더에 바로 파일이 생기지 않아요. Git 프로젝트라면 별도의 Worktree 옵션으로 다른 폴더에 작업 사본을 만들 수도 있지만 첫 실습에서는 쓰지 않습니다.

실행 위치를 잘못 고르고 보냈다면 실행을 취소하세요. 문제 해결 문서에 따르면 입력창에서 위쪽 화살표 키를 누르면 방금 쓴 프롬프트를 다시 불러올 수 있어서 처음부터 다시 칠 필요가 없습니다.

다음은 권한 모드입니다. 권한 문서는 대부분의 작업을 Ask for approval로 시작하라고 권합니다. 이 모드에서 Codex는 열어 둔 폴더 안의 파일 수정과 일상적인 명령 실행은 알아서 합니다. 폴더 밖 파일을 고치거나 인터넷이 필요한 명령을 실행할 때 멈추고 물어봐요. 연결한 외부 앱이나 MCP 도구가 무언가를 바꾸는 동작도 승인을 요청할 수 있습니다. 보안 문서에 따르면 기본 설정에서는 명령의 인터넷 접속도 꺼져 있습니다.

권한 메뉴에는 Approve for me와 Full access가 보일 수 있습니다. 어떤 모드가 보이는지는 앱 버전, 실행 환경, 설정, 조직 정책에 따라 달라요. Approve for me는 작업 범위는 그대로 두고 범위를 넘는 요청을 사람 대신 별도의 검토 에이전트가 판단하게 하는 모드입니다. Full access는 작업 폴더 밖까지 손댈 수 있어서 공식 문서도 의도치 않은 동작으로 데이터가 사라질 위험이 커진다고 경고합니다. 첫 실습에서는 Ask for approval에 두는 편이 안전합니다.

승인 창이 뜨면 무엇을 하려는지 한 번 읽어 보세요. 모르는 명령이면 승인 전에 "이 명령이 뭘 하는 거야?"라고 물어도 됩니다.

첫 요청: 한 페이지 자기소개 사이트

첫 요청은 작게 잡습니다. 파일 하나로 끝나는 페이지라면 외부 패키지를 설치할 필요가 없으니 인터넷 접속 승인 없이도 끝까지 갈 수 있어요. 아래를 복사해서 괄호 부분만 내 이야기로 바꿔 보세요.

이 폴더에 자기소개 웹페이지 한 장을 만들어 줘.

- 파일은 index.html 하나로 만들고, CSS도 그 안에 넣어 줘. 외부 라이브러리나 설치는 쓰지 마.
- 서버는 켜지 말고 파일만 만들어 줘.
- 내용: 이름 (김OO), 한 줄 소개 (OO학과 1학년, 요즘 관심사는 OO), 좋아하는 것 3가지, 연락처 링크 (이메일 주소).
- 분위기: (깔끔하고 밝게 / 차분한 어두운 톤 등 한 줄)
- 휴대폰 화면에서도 글자가 잘리지 않게 해 줘.
- 다 만들면 어떤 파일을 만들었는지, 내 컴퓨터에서 어떻게 열어 보는지 알려 줘.

파일 하나와 설치 금지를 적어 두면 중간에 패키지를 받으려다 인터넷 접속 승인에서 멈추는 일이 줄어듭니다. 마지막에 여는 방법을 물어 두면 결과를 혼자 확인하기도 쉬워요. 뭘 적어야 할지 막막하다면 설문 답으로 학생마다 다른 프롬프트를 만든 방법에서 재료를 모으는 질문을 참고하세요. 페이지가 아니라 입력하고 결과가 나오는 서비스를 만들고 싶다면 비개발자를 위한 PRD 쓰는 법으로 한 장짜리 요구사항부터 정리하는 게 좋습니다.

결과 확인과 수정 요청하는 법

작업이 끝나면 폴더에 index.html이 생깁니다. 파일 탐색기(Mac은 Finder)에서 더블클릭하면 보통 브라우저로 열려요. 메모장 같은 다른 프로그램이 뜨면 파일을 오른쪽 클릭해서 Chrome, Edge, Safari 같은 브라우저로 열면 됩니다.

고칠 때는 같은 대화에 이어서 한 번에 하나씩 요청합니다. 여러 개를 한꺼번에 시키면 어디서 틀어졌는지 찾기 어렵거든요.

제목 글자를 지금보다 크게 하고, 좋아하는 것 3가지를 카드 모양으로 바꿔 줘. 나머지는 그대로 둬.

"예쁘게 해 줘"보다 "보이는 것 + 바꾸고 싶은 방향"으로 말하면 결과가 덜 엇나갑니다. 휴대폰에서 보고 싶다면 브라우저 창 폭을 좁혀 보는 것만으로도 대략 확인할 수 있어요.

반응이 없거나 멈춘 것 같을 때 문제 해결 문서가 권하는 순서는 이렇습니다. 먼저 Codex가 승인을 기다리는 중인지 봅니다. 다음으로 앱의 터미널을 열어 git status 같은 기본 명령을 실행해 봅니다. 첫 실습 폴더는 Git 저장소가 아니라서 오류 문구가 나올 텐데 터미널이 응답하는지만 보면 됩니다. 그래도 안 되면 더 작고 구체적인 요청으로 새 대화를 시작합니다.

폴더가 Git 저장소라면 검토 패널에서 바뀐 줄을 볼 수 있습니다. Last turn 보기로 바꾸면 마지막 요청에서 바뀐 것만 보입니다. 처음에는 코드를 전부 이해하려 하지 말고 어떤 파일이 바뀌었는지만 확인해도 충분합니다.

공개는 다음 단계입니다

지금 만든 페이지는 내 컴퓨터에만 있습니다. 다른 사람이 주소로 열어 보게 하려면 GitHub에 올리고 Vercel 같은 서비스로 배포해야 합니다. 부트캠프에서도 GitHub와 Vercel을 이어서 썼어요. 순서는 바이브 코딩으로 첫 홈페이지 만들기: Next.js 생성부터 Vercel 배포까지에 정리해 두었습니다. 그 글은 Claude Code 기준으로 쓰였지만 Codex에 같은 순서로 요청하면 됩니다. 배포 단계에서는 패키지 설치와 인터넷 접속이 필요해서 승인 창이 더 자주 뜹니다.

Claude Desktop Code 탭과 무엇이 다른가

둘 다 폴더를 열고 말로 시키는 방식이라 첫 실습 흐름은 거의 같습니다. 차이는 계정과 권한 방식에 있어요.

• 요금제. Claude Desktop의 Code 탭은 Pro, Max, Team, Enterprise 구독이 필요하고 무료 플랜에는 없습니다. Codex는 요금 문서상 Free와 Go에도 포함되지만 위 요금제 문단에 적은 조건이 붙습니다.
• 권한 모드. Claude는 Manual 모드에서 바꿀 내용을 하나씩 보여 주고 승인을 기다립니다. Codex의 Ask for approval은 연 폴더 안에서는 묻지 않고 진행하다가 폴더 밖 작업이나 인터넷 접속이 필요할 때 묻습니다. 처음에는 Claude는 Manual, Codex는 Ask for approval로 시작하면 됩니다.

이미 쓰는 구독에 맞춰 고르면 됩니다. 자세한 비교는 클로드 코드 vs 코덱스, Claude Desktop Code 탭 vs 터미널 CLI, 바이브 코딩 툴 추천 2026에 있습니다.

자주 묻는 질문

코덱스(Codex)만 따로 다운로드할 수는 없나요?

데스크톱 앱은 ChatGPT 데스크톱 앱 하나로 합쳐져서 Codex만 들어 있는 설치 파일은 없습니다. 터미널에서 쓰는 Codex CLI는 따로 설치하는 도구입니다. 운영체제별 CLI 설치 명령은 코덱스(Codex) 설치 방법에 정리했습니다.

앱 이름이 ChatGPT로 나오는데 맞게 설치한 건가요?

맞습니다. 7월 9일부터 Codex 앱이 ChatGPT 데스크톱 앱으로 합쳐졌습니다. 앱 안의 선택 메뉴에서 Codex를 고르면 됩니다.

무료 계정으로도 되나요?

요금 문서상 Free 플랜에도 데스크톱 앱의 Codex가 포함됩니다. 조건은 위 요금제 문단과 같습니다. 한도에 걸리면 실습이 멈출 수 있으니 사용량 대시보드를 가끔 확인하세요.

Intel Mac에서도 되나요?

됩니다. 공식 문서 Download ChatGPT 버튼 옆 화살표 메뉴에서 Intel용을 고르면 Codex-latest-x64.dmg를 받습니다. 11월 8일에도 같은 공식 주소에 파일이 올라와 있는 것을 확인했습니다.

터미널용 Codex CLI와 뭐가 다른가요?

같은 Codex를 명령창에서 쓰는 도구입니다. 빠른 시작은 터미널이나 코드 에디터에서 쓰려는 개발자에게 CLI와 IDE 확장을 권합니다. 처음이라면 데스크톱 앱으로 충분합니다. 앱·CLI·IDE 확장·클라우드를 언제 쓰는지는 코덱스(Codex) 사용법에 비교해 두었습니다.

학교·회사 Windows 노트북에서 샌드박스 설정이 안 됩니다

MXC 방식을 쓸 수 없는 기기에서 관리자 승인 창(UAC)을 닫았거나 승인이 정책으로 막혔을 가능성이 큽니다. Windows 샌드박스 문서가 관리자 승인 설정이 실패하는 흔한 원인으로 먼저 꼽는 것도 이 경우예요. 기기 관리 담당자에게 앱 설치와 관리자 승인이 가능한지 물어보세요. 버전·winget·WSL 같은 다른 확인 항목은 코덱스 설치 글에 정리했습니다.

다음 단계

• 코덱스를 쓰는 곳 전체 보기: 코덱스(Codex) 사용법
• 노션·GitHub 연결: Codex MCP 연결 방법
• 웹사이트·앱 만들기 주제 모음: 주제별 안내
• 부트캠프에서 무엇을 했는지: 가톨릭대학교 운영 사례, 틀렸던 것과 다행이었던 것
• 학교에서 같은 방식으로 해 보고 싶다면: 대학 AI 부트캠프 안내

출처와 확인 (2026-11-08)

• Quickstart (Download ChatGPT 버튼과 다른 운영체제 메뉴(Choose another ChatGPT download), ChatGPT 드롭다운에서 Codex 선택, 폴더 열기, API 키 로그인 시 일부 기능 제외)
• ChatGPT desktop app (macOS·Windows·Linux용 다운로드, 설치 순서)
• Download ChatGPT (데스크톱 앱에 ChatGPT Work와 Codex 포함, 기존 Codex 앱 사용자는 업데이트 후 Codex 열기. OS에 맞춘 다운로드 버튼은 10월 30일 Mac 브라우저로 확인)
• ChatGPT desktop app for Windows (설치 링크, winget 명령, PowerShell 실행과 샌드박스, Ask for approval)
• Windows sandbox (Windows 11 권장, Windows 10 1809 이상 최선 노력 지원, 개인 계정 앱의 MXC 우선 사용, 관리자 승인 설정 실패 원인)
• ChatGPT desktop app for Linux (미리보기, 지원 배포판, 패키지 종류)
• What's new (7월 9일 Codex 앱 통합과 Free 포함 전 세계 제공, 10월 26~30일 GPT-6.1 Terra)
• Pricing (포함 플랜, Free·Go의 GPT-6 Luna와 순차 제공 조건, Plus 이용 범위와 모델, 사용량 표, GPT-5.5 종료)
• Models (GPT-5.5 종료와 대체 모델)
• Authentication (Continue to sign in, Sign in another way)
• Use ChatGPT (Chat, Work, Codex 비교, Sites)
• Permissions (Ask for approval 권장, Approve for me, Full access)
• Auto-review (Approve for me 동작)
• Agent approvals & security (기본 네트워크 꺼짐)
• Codex environments (Work in의 This computer·Cloud, Worktree)
• Keyboard shortcuts (Windows 폴더 열기 단축키)
• Troubleshooting (macOS 폴더 승인, Add new project와 Cmd+O, 위쪽 화살표, 멈춤 대처 세 단계, Last turn 보기)
• Claude Code desktop quickstart (Code 탭 요금제, Manual 모드)