Codex 데스크톱 앱 설치와 사용법: 내 컴퓨터에 첫 페이지 만들기까지

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

이 글은 설치부터 빈 폴더에 자기소개 페이지 한 장을 만들어 내 컴퓨터에서 열어 보는 데까지 따라갑니다. 공개 배포는 다음 단계로 남겨 둡니다. 아래 출처 목록의 공식 문서는 2026년 9월 24일에 다시 확인했습니다. 다운로드 페이지(chatgpt.com/download)와 한국 계정에서 메뉴가 어떻게 보이는지는 확인하지 못했습니다.

먼저 알아 둘 것: Codex 앱은 이제 ChatGPT 앱 안에 있습니다

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

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

시작 전 준비: 요금제, 운영체제, 계정

요금제. Codex 요금 문서는 Codex가 Free, Go, Plus, Pro, Business, Edu, Enterprise 플랜에 포함된다고 안내합니다. Free와 Go는 데스크톱 앱에서 GPT-6 Luna 모델을 쓰는 구성이고 모든 계정에 한 번에 열리지는 않는다는 조건이 붙어 있습니다. Plus부터는 웹·CLI·IDE 확장에서도 Codex를 쓸 수 있고 요금 문서상 GPT-6 Sol과 GPT-6 Luna가 포함됩니다.

다만 What's new의 9월 21~25일 항목을 보면 GPT-6 Sol과 Luna는 아직 공개가 진행 중이고 플랜, 앱 종류, 워크스페이스 설정에 따라 보이는 시점이 다릅니다. 모델 선택 메뉴에 GPT-6이 없다면 보이는 모델로 그대로 실습해도 됩니다.

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

운영체제. 데스크톱 앱은 macOS, Windows, Linux용이 있고 Linux는 미리보기(preview) 단계입니다. Mac은 Apple Silicon용 설치 파일만 확인됐어요. 자세한 건 아래 Mac 설치에 적었습니다. Windows에서 필요한 것은 Windows 설치에 따로 모았습니다.

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

설치: Mac

1. 앱 문서의 Download for macOS (Apple Silicon) 버튼으로 설치 파일을 받습니다. 받는 파일 이름은 Codex.dmg입니다.
2. 받은 파일을 열고 화면 안내대로 설치한 뒤 앱을 실행합니다.
3. ChatGPT 계정으로 로그인합니다.

Intel 칩을 쓰는 Mac용 설치 파일은 공식 문서에서 찾지 못했습니다. 다운로드 페이지는 이번에 내용을 확인하지 못했어요. Intel Mac이라면 설치 전에 그 페이지에서 내 Mac용 파일이 있는지부터 보세요.

Mac에서는 격리 실행(샌드박스)이 macOS 기본 기능으로 동작해서 따로 설정할 게 없습니다. 하나만 기억해 두세요. 문제 해결 문서에 따르면 데스크톱, 다운로드, 음악 같은 폴더는 macOS가 추가 승인을 요구합니다. 그래서 실습 폴더는 홈 폴더 바로 아래에 새로 만드는 게 편해요. 만드는 순서는 아래 첫 실행에 있습니다.

설치: Windows

Windows는 Microsoft Store 설치 링크로 받습니다. 스토어에서 이름으로 검색하기보다 이 링크를 쓰는 편이 헷갈리지 않습니다. 명령으로 설치하고 싶다면 PowerShell에서 다음을 실행합니다.

winget install --id 9PLM9XGG6VKS -s msstore

Windows 앱은 기본적으로 PowerShell에서 Codex를 실행합니다. 그리고 전용 Windows 샌드박스로 작업 폴더 밖 쓰기와 허락 없는 네트워크 접속을 막습니다. WSL이나 가상 머신이 없어도 됩니다.

막혔을 때 볼 곳은 이 목록입니다. 제 경험담이 아니라 Windows 앱 문서와 Windows 샌드박스 문서가 안내하는 확인 항목입니다.

• Windows 버전. Windows 11이 권장입니다. 최신 업데이트를 마친 Windows 10도 동작은 하지만 Windows 11보다 불안정할 수 있습니다. Windows 10은 실제로 1809 버전 이상이 필요하고 그보다 오래된 빌드는 권장하지 않습니다. 내 버전은 시작 메뉴 검색창에 winver를 입력하면 나오는 창에서 볼 수 있습니다.
• winget. Windows 패키지 관리자인 winget이 있어야 합니다. 없으면 Windows를 업데이트하거나 패키지 관리자를 먼저 설치합니다.
• 관리자 승인. 권장 샌드박스(elevated)는 설정 과정에 관리자 승인이 필요합니다. 문서가 꼽는 가장 흔한 설정 실패 원인이 이 관리자 승인 창(UAC)을 거절한 경우예요. 창이 뜨면 내 PC이고 설치가 허용된 환경일 때 승인합니다. 학교·회사가 관리하는 노트북은 Windows 버전이 맞아도 이 단계가 막힐 수 있습니다.
• 더 약한 대안. 승인이 막히면 문서는 unelevated 샌드박스를 임시 대안으로 안내합니다. 앱 메뉴가 아니라 config.toml 설정 파일에서 바꾸는 방식이고 기관 정책으로 이 대안까지 막혀 있을 수 있습니다. 첫 실습이라면 직접 파일을 고치기보다 기기 관리 담당자에게 관리자 승인이 가능한지 먼저 물어보세요.
• 권한 모드. 샌드박스 보호를 받으려면 입력창 아래에서 Ask for approval을 선택한 뒤 메시지를 보냅니다.
• WSL. 꼭 필요하지 않습니다. 쓴다면 WSL2여야 합니다. Codex 0.115부터 WSL1은 지원하지 않습니다.

첫 페이지 실습에는 필요 없지만 나중에 만날 수 있는 항목도 두 가지 적어 둡니다.

• Git. Git이 없으면 변경 내용을 보여 주고 되돌리는 검토 패널 같은 일부 기능을 쓸 수 없습니다. 필요해지면 PowerShell에 winget install --id Git.Git를 붙여 넣어 설치합니다.
• PowerShell 실행 정책. 나중에 Node.js나 npm을 쓰다가 npm.ps1 cannot be loaded because running scripts is disabled on this system. 같은 오류가 날 수 있습니다. 문서는 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned를 흔한 해결책으로 소개하면서 바꾸기 전에 Microsoft 실행 정책 안내를 확인하라고 덧붙여요. 이 오류가 실제로 났을 때만 보고 학교·회사 PC라면 관리자에게 먼저 물어보세요.

학교나 회사 노트북이라면 설치 전에 관리자 권한과 앱 설치 정책부터 확인해 두세요. 이 부분은 사용자 혼자 바꿀 수 없는 경우가 많습니다.

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

로그인하고 나면 어디서 일할지 고릅니다. 빠른 시작은 채팅 시작, 프로젝트 만들기, 폴더 열기의 세 가지를 안내합니다. 웹페이지를 만들 때는 폴더를 여는 것이 핵심이에요. 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. 실행 위치를 확인합니다. 새 대화를 시작하면 실행 위치를 Local, Worktree, Cloud 중에서 고를 수 있습니다. 첫 메시지를 보내기 전에 Local인지 확인하세요. Local은 내 컴퓨터의 그 폴더에서 바로 작업하는 방식입니다. Worktree는 다른 폴더에 작업 사본을 만들고 Cloud는 OpenAI 쪽 환경에서 실행돼서 내 폴더에 바로 파일이 생기지 않아요. 기본값이 무엇인지는 문서에서 확인하지 못했습니다.

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

다음은 권한 모드입니다. 권한 문서는 처음에는 Ask for approval로 시작하라고 권합니다. 이 모드에서 Codex는 열어 둔 폴더 안의 파일 수정과 일상적인 명령 실행은 알아서 합니다. 인터넷에 접속하거나 폴더 밖으로 나갈 때만 멈추고 물어봐요. 보안 문서에 따르면 기본 설정에서는 명령의 인터넷 접속도 꺼져 있습니다.

나머지 두 모드는 처음에는 메뉴에 없습니다. Approve for me(설정 이름은 Auto-review)와 Full access는 설정 > General > Permissions에서 켜야 나타납니다. Full access는 작업 폴더 밖까지 손댈 수 있어서 공식 문서도 의도치 않은 동작으로 데이터가 사라질 위험이 커진다고 경고합니다. 첫 실습에서는 켜지 않는 편이 안전합니다.

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

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

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

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

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

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

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

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

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

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

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

반응이 없거나 멈춘 것 같을 때 문제 해결 문서가 권하는 순서는 이렇습니다. 먼저 Codex가 승인을 기다리는 중인지 봅니다. 그래도 안 되면 더 작고 구체적인 요청으로 새 대화를 시작합니다.

폴더가 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로 시작하면 됩니다.

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

자주 묻는 질문

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

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

무료 계정으로도 되나요?

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

Intel Mac에서도 되나요?

2026년 9월 24일 공식 문서에서 확인한 macOS 다운로드 버튼은 Apple Silicon용만 있습니다. 다운로드 페이지는 확인하지 못했어요. Intel Mac이라면 다운로드 페이지에서 내 Mac용 설치 파일이 있는지 먼저 확인하고 없다면 이 실습은 다른 컴퓨터에서 하는 편이 낫습니다.

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

같은 Codex를 명령창에서 쓰는 도구입니다. 빠른 시작은 터미널이나 코드 에디터에서 쓰려는 개발자에게 CLI와 IDE 확장을 권합니다. 처음이라면 데스크톱 앱으로 충분합니다.

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

관리자 승인 창을 닫았거나 승인이 정책으로 막혔을 가능성이 큽니다. 위 Windows 확인 항목을 본 뒤 기기 관리 담당자에게 앱 설치와 관리자 승인이 가능한지 물어보세요.

다음 단계

• 웹사이트·앱 만들기 주제 모음: 주제별 안내
• 부트캠프에서 무엇을 했는지: 가톨릭대학교 운영 사례, 틀렸던 것과 다행이었던 것
• 학교에서 같은 방식으로 해 보고 싶다면: 대학 AI 부트캠프 안내

출처와 확인 (2026-09-24)

• ChatGPT desktop app (설치 순서, macOS 다운로드 버튼과 Codex.dmg)
• Quickstart (드롭다운에서 Codex 선택, 폴더 열기, Sites는 ChatGPT Work)
• What's new (7월 9일 Codex 앱 통합, 9월 GPT-6 공개 진행)
• Pricing (포함 플랜, 플랜별 모델)
• Authentication (Continue to sign in, Sign in another way)
• Use ChatGPT (Chat, Work, Codex 비교, Sites)
• ChatGPT desktop app for Windows (설치 링크, winget, Git, 실행 정책, Full access 경고)
• Windows sandbox (Windows 버전, 관리자 승인, unelevated 설정)
• Permissions (권한 모드와 설정 위치)
• Agent approvals & security (기본 네트워크 꺼짐)
• Sandbox (macOS·Windows 샌드박스)
• Keyboard shortcuts (폴더 열기 단축키)
• Troubleshooting (macOS 폴더 승인, Add new project, 실행 위치와 위쪽 화살표, 멈춤 대처, Last turn 보기)
• Claude Code desktop quickstart (Code 탭 요금제, Manual 모드)