← 목차Part 0 · 코덱스 입문·온보딩·0-2-1 · 10분
이 클립 · 설치·온보딩·내비

macOS·Windows 코덱스 앱 설치부터 첫 로그인까지 손잡기

학습목표 / 사전지식: 이 레슨을 끝내면 macOS나 Windows에서 Codex 앱을 내려받아 설치하고, 첫 로그인 뒤 프로젝트 로딩 화면에서 막혔을 때 무엇부터 확인할지 설명할 수 있다. 선수지식은 없어도 된다.

1. 왜 필요한가 — 개념·배경을 초보자 눈높이로

Codex 앱은 한 화면에서 여러 작업자를 지휘하는 작업 관제탑에 가깝다. 공개 설명에서도 “a powerful new interface designed to effortlessly manage multiple agents at once”라고 소개됐고, macOS용 Codex 앱은 2026년 1월 30일 공개됐다. [OF-01] 여기서 에이전트란 내가 맡긴 일을 대신 진행하는 작업 단위다. 택배 기사 한 명이 한 상자를 들고 움직이듯, 에이전트 하나는 한 가지 요청을 붙잡고 진행하는 역할이라고 보면 된다. [OF-01]

Windows 사용자는 오래된 안내를 보면 헷갈리기 쉽다. Windows용 Codex 앱은 “March 4, 2026 update: The Codex app is now available on Windows.”라는 공개 문구와 함께 2026년 3월 4일 출시됐고, PowerShell·WSL·Windows 샌드박스가 함께 언급됐다. [OF-02] PowerShell·WSL·Windows 샌드박스는 초보자에게 낯선 이름이지만, 이번 클립에서는 Windows 앱 설명에 함께 등장한 실행 관련 이름표 정도로만 잡아도 충분하다. [OF-02]

초기 온보딩에서 가장 조심할 함정은 두 가지다. 하나는 예전 자료가 남긴 Windows 미지원 인상이고, 다른 하나는 “Loading projects에서 멈춘다”는 초기 멈춤 증상이다. [KO-04]

2. 준비 — 코덱스 어디로 들어가 무엇을 누르나

준비물은 현재 쓰는 운영체제를 먼저 고르는 것이다. 이 레슨의 선택지는 macOS와 Windows이며, macOS 앱 공개일은 2026년 1월 30일, Windows 앱 출시일은 2026년 3월 4일이다. [OF-01, OF-02]

다운로드 화면에서는 내 컴퓨터와 맞는 항목을 고른다. macOS라면 macOS 항목을, Windows라면 Windows 항목을 고르되, 오래된 자료에서 Windows 미지원처럼 보이면 2026년 3월 4일 Windows 출시 사실을 기준으로 다시 판단한다. [OF-02, KO-04] 로그인 단계의 목표는 계정 인증을 마치고 앱으로 돌아오는 것이다. 이 레슨은 설치와 첫 로그인, 그리고 “Loading projects에서 멈춘다”는 초기 함정 회피에 집중한다. [KO-04]

3. 따라하기 — 단계별로 아주 세세하게

1단계, 내 운영체제를 확인한다. 이 레슨의 설치 흐름은 macOS 앱 공개와 Windows 앱 출시를 나눠 다루기 때문이다. [OF-01, OF-02]

2단계, 다운로드 화면에서 운영체제에 맞는 설치 항목을 선택한다. macOS 사용자는 macOS용 Codex 앱이 2026년 1월 30일 공개됐다는 점을 기준으로 macOS 항목을 고른다. [OF-01]

3단계, Windows 사용자는 Windows 항목을 선택한다. Windows용 Codex 앱은 2026년 3월 4일 출시됐고, 공개 문구는 “The Codex app is now available on Windows.”라고 안내했다. [OF-02]

4단계, 내려받은 설치 파일을 열고 화면 안내를 따라 설치를 끝낸다. 이 단계에서는 여러 에이전트를 관리하는 App의 첫 실행 지점까지 가는 데 집중한다. [OF-01]

5단계, 설치가 끝나면 Codex 앱을 실행한다. 이 앱은 여러 에이전트를 동시에 관리하도록 설계된 인터페이스로 소개됐으니, 첫 화면은 앞으로 여러 작업을 맡길 관제탑의 입구라고 보면 된다. [OF-01]

6단계, 로그인 버튼을 눌러 본인 계정 인증을 마친다. 이 레슨의 목적은 App을 처음 실행해 프로젝트 로딩 단계까지 통과하는 것이다. [OF-01, KO-04]

7단계, 로그인 뒤 프로젝트를 불러오는 화면을 기다린다. 여기서 “Loading projects에서 멈춘다”는 증상이 초기 버전 함정으로 언급됐으니, 이 문구에서 오래 멈추더라도 당황하지 말고 확인 순서를 따른다. [KO-04]

8단계, 멈춤이 의심되면 먼저 앱을 닫았다가 다시 연다. 그다음 내 운영체제에 맞는 설치 파일을 받았는지 확인하고, Windows 사용자는 2026년 3월 4일 이후 Windows 앱 출시 사실을 기준으로 오래된 미지원 안내와 구분한다. [OF-02, KO-04]

9단계, 첫 화면에 들어오면 작은 확인 요청만 보낸다. App은 여러 에이전트를 관리하는 인터페이스로 소개됐으니, 첫 요청은 작업을 크게 벌리기보다 준비 확인에 맞춘다. [OF-01]

4. 복붙 템플릿 — 그대로 쓰는 프롬프트/Skill + 해설

첫 로그인 확인 프롬프트:

I am doing my first Codex App login on [macOS/Windows].
Do not change files yet.
Confirm whether the app is ready to use.
Then list the next 3 onboarding steps for a beginner.

첫 줄의 [macOS/Windows]에는 지금 쓰는 운영체제를 넣는다. 이 레슨의 설치 흐름은 macOS 공개와 Windows 출시를 구분해서 다루기 때문이다. [OF-01, OF-02] Do not change files yet.은 첫 로그인 직후에는 확인만 하겠다는 안전장치다. App은 여러 에이전트를 관리하는 인터페이스로 소개됐으니, 첫 요청은 확인용으로 좁게 시작한다. [OF-01]

간단한 Skill 메모 예시:

Skill name: First Login Coach
Instructions:
- Ask whether the user is on macOS or Windows.
- Do not rely on old Windows-unsupported notes.
- If the user reports "Loading projects", suggest restarting the app and checking the OS-specific installer first.
- Keep the answer beginner-friendly and under 5 steps.

이 Skill 메모의 핵심은 오래된 Windows 미지원 인상과 “Loading projects” 멈춤을 먼저 걸러내는 것이다. 두 항목 모두 초기 버전 함정으로 언급됐다. [KO-04]

5. 응용·함정 — 변형, 자주 막히는 곳과 해결

함정 1은 오래된 자료다. macOS용 Codex 앱은 2026년 1월 30일 공개됐고, Windows용 Codex 앱은 2026년 3월 4일 출시됐다. [OF-01, OF-02]

함정 2는 “Loading projects”에서 멈춘 화면을 실패로 단정하는 것이다. 이 멈춤은 초기 버전 함정으로 언급됐으니, 먼저 앱 재실행과 OS별 설치 파일 확인 순서로 차분히 점검한다. [KO-04]

함정 3은 App을 단순 로그인 창으로만 보는 것이다. Codex 앱은 여러 에이전트를 한 번에 관리하는 강력한 인터페이스로 소개됐다. [OF-01]

6. 정리·체크리스트

macOS 사용자라면 macOS용 Codex 앱 공개 기준일인 2026년 1월 30일을 기억한다. [OF-01] Windows 사용자라면 Windows용 Codex 앱 출시 기준일인 2026년 3월 4일을 기억한다. [OF-02] Windows 미지원처럼 보이는 오래된 안내와 “Loading projects에서 멈춘다”는 초기 함정을 구분한다. [KO-04]

첫 로그인 뒤에는 큰 작업을 바로 맡기지 말고, 준비 여부를 확인하는 짧은 프롬프트부터 입력한다. App은 여러 에이전트를 관리하는 인터페이스로 소개됐다. [OF-01] 마지막으로 App의 위치를 다시 잡자. Codex 앱은 여러 에이전트를 동시에 관리하는 관제탑으로 소개된 도구다. [OF-01]

출처

본문의 [...] 표기는 아래 근거에서 확인할 수 있습니다.

← 왜 지금 코덱스인가 — 비개발자 137배·주샌드박스 3단계 권한 모드 — 안전하게 시작 →
코덱스 100가지 스킬스 활용 바이블 · 0-2-1 · 근거 기반 교재 · 2026-06 기준