RA 실행학교 실전 2기 준비 가이드

RUN ACADEMY GUIDEBOOK LIBRARY · 실전 2기

수강생 가이드북

01 사전 준비 02 GitHub 가입 03 Discord 참여 04 OS 설치 다음 가이드 준비중

이미 쇼핑몰을 해봤지만 소싱, 상세페이지, AI 자동화, 혼자 실행에서 막혔던 분들이 첫 주에 바로 손을 움직일 수 있게 정리합니다.

가이드북 목록 보기 기본 테스트 보기

Guidebook Library

필요한 순간에 바로 여는 실전 2기 안내서

확정자 답변에서 가장 많이 나온 고민은 “강의는 들었는데 내 상품에 적용이 안 된다”, “소싱과 상세페이지가 막힌다”, “혼자 하면 흐름이 끊긴다”였습니다. 이 가이드는 그 지점부터 줄입니다.

Guide 01 필수
사전 준비 가이드

계정, 설치, 첫 테스트를 끝내고 1주차에 내 상품 고민을 바로 가져갈 수 있는 상태를 만듭니다.

40-70분 준비 가이드
Guide 02 신규
GitHub 가입하기

이메일 준비, 가입 화면 열기, 사용자 이름 만들기, 이메일 인증, 로그인 확인까지 처음 하는 사람 기준으로 진행합니다.

15-25분 초보자용
Guide 03 신규
디스코드·이룸라운지 참여

공지, 질문답변, 팀별 활동, 소싱에이전트 서포트, 공개 챌린지 참여를 위한 커뮤니티 입장 흐름입니다.

15-25분 커뮤니티
Guide 04 쉬운 설치
실전 2기 OS 설치

Windows가 처음이어도 괜찮습니다. Codex에게 부탁하는 문장부터 설치 확인, Codex Auth 연결, 4777 코치 화면 열기까지 천천히 진행합니다.

30-45분 복붙 설치
Guide 05 바로 사용
완료 보고 템플릿

환경 준비가 끝났는지, 첫 주에 어떤 문제를 풀고 싶은지 남길 수 있는 보고 양식입니다.

5분 복사 양식
모든 가이드북은 소개 → 준비물 → 단계별 실행 → 완료 기준 → 문제해결 → 질문 템플릿 순서로 작성합니다. 수강생은 긴 설명을 처음부터 외울 필요 없이, 지금 막힌 단계의 명령과 기준만 확인하면 됩니다.
2

GitHub 가입은 “수업용 파일 보관함에 내 이름표를 만드는 단계”입니다.

GitHub는 개발자들이 파일과 작업 기록을 보관하는 웹사이트입니다. 이번 단계에서는 코드를 몰라도 됩니다. 목표는 딱 하나, 내 GitHub 계정을 만들고 이메일 인증까지 끝내는 것입니다.

15-25분
GitHub 파일 보관 사이트

수업 자료, 프로젝트 파일, 작업 기록을 올리고 관리할 수 있는 곳입니다.

Account 내 계정

이메일, 비밀번호, 사용자 이름으로 만드는 나만의 로그인 정보입니다.

Verify email 이메일 인증

GitHub가 보낸 메일을 열어 “이 이메일이 내 것”이라고 확인하는 단계입니다.

이번 GitHub 가입에서는 터미널, PowerShell, 명령어를 사용하지 않습니다. 웹브라우저에서 가입만 하면 됩니다. PowerShell은 아래 “용어 도움말”에서 따로 아주 쉽게 설명해두었습니다.
1

가입 전에 준비물 4개만 확인합니다.

가입 중간에 메일함을 열어야 하므로, 이메일 비밀번호를 알고 있고 메일을 받을 수 있는 상태인지 먼저 확인합니다.

5분
Email 바로 열 수 있는 이메일

Gmail, Naver, 회사 메일 모두 가능합니다. 인증 메일을 받을 수 있어야 합니다.

Password GitHub용 새 비밀번호

다른 사이트와 같은 비밀번호를 쓰지 않는 것을 권장합니다. 메모장에는 비밀번호를 그대로 적지 마세요.

Username 영문 사용자 이름 후보

예: run-jihye, jihye-ai. 이미 쓰는 사람이 있으면 다른 이름으로 바꿉니다.

Browser 인터넷 창

Chrome, Edge, Safari 중 하나만 열면 됩니다. 새 프로그램 설치가 꼭 필요하지는 않습니다.

브라우저가 뭔가요?

브라우저는 인터넷 보는 앱입니다

네이버나 구글을 볼 때 쓰는 창입니다. Windows는 Edge가 기본으로 있고, macOS는 Safari가 기본으로 있습니다.

Chrome을 쓰고 싶다면

Google Chrome 다운로드에서 설치할 수 있습니다. 이미 Chrome이 있다면 다시 설치하지 않아도 됩니다.

2

GitHub 가입 화면을 엽니다.

주소창은 인터넷 창 맨 위에 있는 긴 입력칸입니다. 네이버 검색창이 아니라, https:// 같은 주소가 보이는 칸입니다.

3분
  1. 인터넷 창을 엽니다. Windows는 화면 아래 검색창에 Edge 또는 Chrome을 입력해 실행합니다. Mac은 Dock 또는 Launchpad에서 Safari나 Chrome을 엽니다.
  2. 맨 위 주소창을 한 번 클릭합니다. 기존 주소가 파랗게 선택되면, 그대로 다음 주소를 입력하면 됩니다.
  3. 아래 주소를 그대로 입력합니다. 입력 후 키보드의 Enter를 누릅니다.
https://github.com/signup
검색 결과로 들어가도 되나요?

가능하면 주소창에 직접 입력하세요. 검색 결과에는 광고나 비슷한 페이지가 섞일 수 있습니다. 주소가 github.com으로 시작하는지 확인하면 안전합니다.

3

화면이 묻는 순서대로 입력합니다.

GitHub 화면은 영어로 보일 수 있습니다. 겁먹지 않아도 됩니다. 대부분 이메일, 비밀번호, 사용자 이름을 차례대로 묻는 흐름입니다.

10분
Email 내가 바로 열 수 있는 이메일 주소를 입력합니다. 인증 메일이 이 주소로 옵니다.
Password GitHub에서 새로 쓸 비밀번호를 만듭니다. 너무 짧거나 쉬우면 다시 만들라고 나올 수 있습니다.
Username GitHub에서 보일 내 이름표입니다. 영문 소문자, 숫자, 하이픈을 섞어 만들면 쉽습니다.
Continue 각 입력 후 Continue 버튼이 보이면 누릅니다. 화면 문구가 조금 달라도 “다음으로 넘어가는 버튼”이라고 생각하면 됩니다.

사용자 이름 예시

좋은 예시
  • run-jihye
  • jihye-commerce
  • ai-seller-min
피하면 좋은 예시
  • 전화번호가 들어간 이름
  • 생년월일 전체가 들어간 이름
  • 회사 내부 프로젝트명이 들어간 이름
비밀번호는 수업 채팅방에 절대 보내지 않습니다. 운영팀이 도와달라고 해도 비밀번호 원문은 공유하지 마세요.
4

이메일 인증까지 해야 가입이 끝납니다.

GitHub 계정을 만들면, 입력한 이메일 주소로 확인 메일이 옵니다. 메일함에서 GitHub 메일을 찾아 버튼이나 인증 링크를 누릅니다.

5분
  1. 새 탭을 엽니다. 인터넷 창 맨 위의 + 버튼을 누르면 새 탭이 열립니다.
  2. 내 메일함으로 갑니다. Gmail이면 gmail.com, Naver 메일이면 mail.naver.com을 엽니다.
  3. GitHub에서 온 메일을 찾습니다. 받은편지함에 없으면 스팸함, 프로모션함, 전체메일함도 확인합니다.
  4. 메일 안의 확인 버튼을 누릅니다. 버튼을 누르면 GitHub 화면으로 돌아가거나 인증 완료 화면이 보입니다.
메일이 안 올 때

1-2분 기다린 뒤 새로고침합니다. 그래도 없으면 GitHub 화면에서 인증 메일 다시 보내기 버튼을 찾습니다.

회사 메일을 쓰는 경우

회사 보안 정책 때문에 인증 메일이 늦게 오거나 차단될 수 있습니다. 막히면 개인 Gmail로 다시 가입하는 편이 빠를 수 있습니다.

5

가입 완료는 “로그인해서 내 프로필이 보이는 상태”입니다.

계정을 만들었다고 끝이 아니라, 다시 들어가도 로그인되는지 확인해야 합니다. 아래 3개가 보이면 GitHub 준비는 완료입니다.

3분
Login GitHub 로그인 성공

github.com에 들어갔을 때 오른쪽 위에 내 프로필 아이콘이 보입니다.

Email 이메일 인증 완료

인증을 하라는 빨간 안내가 사라졌거나, 인증 완료 화면을 봤습니다.

Username 사용자 이름 기록

수업에서 물어볼 수 있으니 내 GitHub 사용자 이름을 따로 적어둡니다.

Safety 비밀번호 비공개

비밀번호, 인증 코드, 복구 코드는 누구에게도 보내지 않습니다.

완료 보고 템플릿

이름:
GitHub 가입: 완료 / 미완료
GitHub 사용자 이름:
이메일 인증: 완료 / 미완료
막힌 지점이 있다면 화면 문구 그대로:
?

PowerShell은 “Windows에서 명령을 입력하는 창”입니다.

GitHub 가입에는 PowerShell이 필요 없습니다. 다만 다음 설치 가이드에서 “PowerShell을 여세요”라는 말이 나오면, 아래처럼 이해하면 됩니다.

용어 도움
PowerShell 명령 입력창

마우스로 누르는 대신 글자로 명령을 입력하는 Windows 프로그램입니다.

Terminal 명령창 전체 이름

PowerShell, 명령 프롬프트, Windows Terminal 같은 도구를 묶어서 부르는 말입니다.

Prompt 입력 대기 줄

PS C:\Users\...처럼 보이는 줄입니다. 그 뒤에 명령을 입력합니다.

Windows 11에서 여는 방법

  1. 화면 아래 작업표시줄의 검색창을 클릭합니다. 돋보기 아이콘만 보이면 돋보기를 누릅니다.
  2. PowerShell이라고 입력합니다. 영어 대소문자는 중요하지 않습니다.
  3. Windows PowerShell 또는 PowerShell 7이 보이면 클릭합니다.
  4. 파란색 또는 검은색 창이 열리고 커서가 깜빡이면 성공입니다.
없으면 어디서 받나요?

Windows에는 보통 Windows PowerShell이 기본으로 있습니다. PowerShell 7을 새로 설치해야 한다면 Microsoft 공식 PowerShell 설치 안내를 열고, 안내 안의 Latest stable release 또는 Microsoft Store 링크를 누르세요.

Windows Terminal은 뭔가요?

PowerShell을 담아서 보여주는 큰 창입니다. Microsoft 안내에 따르면 Windows 11에서는 PowerShell 같은 콘솔 앱이 Windows Terminal 안에서 열릴 수 있습니다.

초보자는 “관리자 권한으로 실행”을 먼저 누르지 않아도 됩니다. 수업 가이드에서 특별히 관리자 권한이라고 말할 때만 사용하세요.
6

막힐 때는 화면 문구를 그대로 보고 해결합니다.

GitHub 가입 문제는 대부분 이메일, 사용자 이름, 인증 메일에서 생깁니다. 아래와 비슷한 상황이면 해당 안내부터 보세요.

상시
사용자 이름을 쓸 수 없다고 나올 때

이미 다른 사람이 쓰는 이름입니다. 뒤에 숫자를 붙이거나 단어를 하나 더 넣습니다. 예: jihye-run-2026

비밀번호가 약하다고 나올 때

길이를 늘리고, 영어 대문자, 소문자, 숫자, 특수문자를 섞습니다. 다른 사이트 비밀번호를 그대로 쓰지 마세요.

인증 메일이 안 올 때

스팸함과 전체메일함을 봅니다. 회사 메일이면 보안 필터에 걸릴 수 있어 개인 Gmail로 다시 시도하는 것이 빠릅니다.

영어 화면이라 모르겠을 때

이메일, 비밀번호, 사용자 이름, Continue 버튼만 찾으면 됩니다. 그래도 막히면 화면 전체를 캡처하되 비밀번호는 가리고 질문하세요.

이미 계정이 있다고 나올 때

그 이메일로 예전에 가입했을 수 있습니다. 로그인 화면에서 비밀번호 찾기를 먼저 시도합니다.

2단계 인증을 물어볼 때

처음 가입 단계에서는 일단 안내에 따라 진행하되, 복구 코드는 안전한 곳에 보관합니다. 복구 코드는 단체방에 보내지 않습니다.

질문할 때 붙여넣을 문장

GitHub 가입 중 막혔습니다.
지금 단계: 이메일 입력 / 비밀번호 입력 / 사용자 이름 / 이메일 인증 / 로그인 확인 중 선택
화면에 나온 문구:
사용 중인 브라우저: Chrome / Edge / Safari
비밀번호와 인증 코드는 가리고 캡처했습니다.
GitHub 가입 화면 GitHub 계정 만들기 공식 문서 GitHub 계정 시작하기 PowerShell Windows 설치 Windows PowerShell 도움말
3

이룸라운지는 실전 2기 전용 커뮤니티 게시판입니다.

수업 기간 동안 공지, 질문답변, 팀별 활동, 소싱에이전트 서포트, 공개 챌린지를 한 곳에서 확인합니다. 처음에는 버튼과 채널이 많아 복잡해 보일 수 있지만, 며칠만 쓰면 카카오톡보다 자료를 찾기 쉽고 질문 흐름을 놓치지 않는 공간이 됩니다.

15-25분
Notice 공지와 안내

수업 전후 안내, 제출 기한, 운영 공지를 놓치지 않게 모아둡니다.

Q&A 질문답변 게시판

막힌 화면, 에러 문구, 설치 질문을 올리고 답변을 함께 확인합니다.

Support 팀 활동과 에이전트 도움

팀별 활동, 소싱에이전트 서포트, 공개 챌린지 참여를 연결합니다.

Discord 서버와 채널 목록 예시 화면
왼쪽에는 서버 아이콘, 가운데에는 주제별 채널이 보입니다. 이룸라운지에서도 공지, 질문, 팀별 활동 채널을 눌러 이동합니다.
Discord 텍스트 채널 위치 예시 화면
텍스트 채널은 글로 질문하고 답변을 남기는 게시판입니다. 카카오톡처럼 흘러가는 대화보다 나중에 다시 찾기 쉽습니다.
1

카카오톡은 빠른 전달, Discord는 커뮤니티 활동 공간입니다.

둘 다 필요하지만 쓰임이 다릅니다. 카카오톡은 전체 공지와 빠른 전달에 가깝고, Discord 이룸라운지는 수강생들이 질문을 남기고 서로 답하고 팀별 활동을 이어가는 커뮤니티 게시판에 가깝습니다.

3분
카카오톡에서 주로 하는 것
  • 전체 공지 빠르게 확인
  • 긴급 전달사항 받기
  • 운영팀의 짧은 리마인드 확인
Discord 이룸라운지에서 주로 하는 것
  • 질문답변을 게시판처럼 남기기
  • 팀별 활동과 공유 자료 모아보기
  • 소싱에이전트 서포트와 공개 챌린지 참여
처음에는 “서버”, “채널”, “역할”이라는 말이 낯설 수 있습니다. 서버는 커뮤니티 방, 채널은 게시판, 역할은 실전 2기 출입증이라고 생각하면 됩니다.
2

먼저 휴대폰에 Discord 앱을 설치하는 것을 추천합니다.

PC에서도 쓸 수 있지만, 처음 입장과 알림 확인은 모바일이 가장 편합니다. 수업 중 빠르게 질문을 확인하고 챌린지 공지를 받으려면 휴대폰 앱으로 로그인해두세요.

8분
  1. 휴대폰에서 앱스토어를 엽니다. iPhone은 App Store, Android는 Play 스토어를 엽니다.
  2. 검색창에 Discord를 입력합니다. 보라색 말풍선 모양 아이콘의 앱을 찾습니다.
  3. 받기 또는 설치를 누릅니다. 설치가 끝날 때까지 기다립니다.
  4. 앱을 열고 가입 또는 로그인을 진행합니다. 처음 쓰는 분은 이메일 또는 전화번호, 사용자명, 비밀번호를 입력해 계정을 만듭니다.
  5. 이메일 인증을 확인합니다. Discord에서 보낸 인증 메일이 오면 메일 안의 확인 버튼을 누릅니다.
Discord 공식 다운로드 App Store에서 받기 Google Play에서 받기 모바일 시작 공식 안내
3

초대 링크로 이룸라운지에 들어옵니다.

Discord 앱 설치와 로그인이 끝났다면 아래 초대 링크를 눌러 이룸라운지에 입장합니다. 링크로 들어오면 실전 2기 역할이 부여되는 흐름으로 안내됩니다.

5분
이룸라운지 초대 링크

휴대폰에서 이 링크를 누르면 Discord 앱으로 연결됩니다. 앱이 열리면 초대 수락 또는 참가 버튼을 누릅니다.

https://discord.gg/XeFzSTWBk
초대 링크 열기 Discord 사용법 영상 보기

기존 Discord 가입자라면

한이룸에게 Discord 아이디를 알려주세요

이미 Discord 계정이 있는 분은 새 계정을 만들 필요가 없습니다. 이룸라운지에 들어온 뒤, 본인의 Discord 아이디를 한이룸에게 알려주면 실전 2기 역할 승인을 도와드립니다.

4

이룸라운지에서는 채널을 눌러 필요한 게시판으로 이동합니다.

Discord 공식 안내에서도 서버는 텍스트 채널과 음성 채널로 구성된다고 설명합니다. 이룸라운지에서는 먼저 텍스트 채널만 익숙해져도 충분합니다.

7분
공지 수업 일정, 제출 기한, 운영 안내를 확인합니다. 읽고 넘어가도 되는지, 답글이 필요한지 먼저 봅니다.
질문답변 설치, 가입, 소싱, 에이전트 사용 중 막힌 화면을 올립니다. 에러 문구는 그대로 적고, 비밀번호나 인증 코드는 가립니다.
팀별 활동 팀 안에서 공유할 링크, 후보 상품, 회의 기록, 역할 분담을 남깁니다.
소싱에이전트 서포트 소싱에이전트 사용 중 막힌 단계, 결과물 검토, 다음 액션 질문을 올립니다.

질문할 때는 이렇게 올리면 답변이 빨라집니다

현재 단계:
하고 싶었던 일:
화면에 나온 문구:
내가 눌러본 것:
캡처 첨부: 비밀번호/인증코드는 가림
5

공개 챌린지에 참여하면 보너스 스코어를 받을 수 있습니다.

이룸라운지에는 수강생이 서로 배우고 자극받을 수 있는 공개 챌린지가 열릴 수 있습니다. 챌린지는 혼자 조용히 제출하는 과제가 아니라, 다른 사람도 참고할 수 있게 공개적으로 실행 흔적을 남기는 방식입니다.

보너스
Challenge 공개 실행 인증

소싱 결과, 질문, 개선 전후, 배운 점을 공개 채널에 남깁니다.

Score 보너스 스코어 기회

운영 기준에 맞게 참여하면 보너스 스코어를 받을 수 있습니다.

Team 팀 활동 가속

좋은 질문과 실행 로그는 팀원들의 다음 액션에도 도움이 됩니다.

Archive 나중에 다시 찾기

카카오톡보다 게시글과 답변을 다시 찾기 쉬운 형태로 남습니다.

6

막히면 “어느 단계에서 멈췄는지”만 알려주세요.

Discord는 처음 화면이 낯설어서 어렵게 느껴질 수 있습니다. 하지만 대부분은 앱 설치, 로그인, 초대 수락, 역할 승인 중 한 단계에서 막힙니다.

상시
초대 링크를 눌렀는데 앱이 안 열릴 때

먼저 Discord 앱을 설치한 뒤 다시 링크를 누릅니다. 그래도 안 되면 링크를 복사해 Discord 앱의 서버 참가 화면에 붙여넣습니다.

이메일 인증을 못 찾을 때

받은편지함, 스팸함, 프로모션함을 확인합니다. 인증이 안 되면 나중에 로그인이나 계정 복구에서 불편할 수 있습니다.

실전 2기 채널이 안 보일 때

역할 승인이 아직 안 되었을 수 있습니다. Discord 아이디를 한이룸에게 알려주고 승인 요청을 합니다.

알림이 너무 많을 때

처음에는 공지와 팀 채널만 확인해도 됩니다. 익숙해진 뒤 필요한 채널 중심으로 알림을 조정하세요.

완료 보고 템플릿

이름:
Discord 가입/로그인: 완료 / 미완료
이룸라운지 입장: 완료 / 미완료
Discord 아이디:
실전 2기 채널 확인: 완료 / 미완료
막힌 지점:
Discord 초보자 공식 안내 모바일 시작 공식 안내 서버 참가 공식 안내 Discord 사용법 참고 영상
0

이 가이드는 “이미 사업을 해본 사람의 첫 주 준비표”처럼 쓰면 됩니다.

확정자 대부분은 완전한 무경험자가 아니라, 판매 경험은 있지만 AI를 어디에 붙여야 할지 막힌 분들이었습니다. 지금 하는 단계만 보고, 명령은 복사해서 실행하고, 결과가 다르면 바로 문제해결로 내려가세요.

전체 40-70분
Step 1 계정부터 맞춥니다

유료 강의와 유튜브를 많이 봤어도, 결제 계정과 Codex 로그인 계정이 섞이면 첫날 바로 멈춥니다.

Step 2 터미널에서 확인합니다

브라우저 ChatGPT와 달리 Codex는 내 컴퓨터의 특정 폴더에서 일합니다. 컴퓨터가 낯설수록 이 확인이 첫 번째 안전장치입니다.

Step 3 작은 파일로 테스트합니다

내 쇼핑몰 자료를 바로 넣기 전에 README.md 하나로 생성, 읽기, 수정 흐름만 먼저 검증합니다.

실행 배웠지만 적용이 안 됨

강의와 도구는 많이 봤지만 내 상품, 내 상세페이지, 내 업무 흐름으로 연결하는 데 막혔다는 답변이 많았습니다.

상품 소싱과 상세페이지가 막힘

무엇을 팔지, 어떤 가격과 메시지로 들어갈지, 상세페이지 재료를 어떻게 모을지가 첫 주의 핵심 고민입니다.

리듬 혼자 하면 흐름이 끊김

막힌 지점과 다음 액션을 팀에 남길 수 있어야 4주 동안 실행이 이어집니다.

진행 원칙

  1. 명령은 한 줄씩 실행합니다. 여러 명령을 한 번에 붙여넣기보다, 출력이 정상인지 보고 다음 줄로 넘어가면 원인을 찾기 쉽습니다.
  2. 승인 요청은 읽고 누릅니다. Codex가 파일을 바꾸거나 명령을 실행하려 할 때 무엇을 하려는지 먼저 설명합니다. 수업 폴더 안 작업이면 승인하고, 낯선 개인 폴더를 읽으려 하면 멈춥니다.
  3. 막히면 에러 문장을 그대로 남깁니다. “안 돼요”보다 npm: command not found처럼 보이는 문장을 보내면 훨씬 빨리 도와드릴 수 있습니다.
1

ChatGPT 유료가입부터 확인합니다.

Codex CLI는 ChatGPT 계정으로 로그인해 사용할 수 있습니다. 실전 2기는 설치와 테스트를 먼저 통과하는 것이 목표라, 처음에는 API key보다 ChatGPT 유료 계정과 로그인 상태가 더 중요합니다.

10-20분
권장 선택

개인 수강생은 Plus 이상으로 시작하면 됩니다. 더 긴 작업량이 필요하면 Pro, 회사 워크스페이스에서 진행해야 한다면 Business 또는 Enterprise 권한을 확인하세요.

확인할 것
  • 수업에 쓸 이메일로 로그인했는지
  • 결제 후 플랜명이 계정 화면에 보이는지
  • 회사 계정이면 관리자가 Codex 사용을 허용했는지

가입 전에 헷갈리기 쉬운 것

ChatGPT Plus 개인 수강생의 기본 권장 선택입니다. Codex 사용을 시작하기에 충분합니다.
ChatGPT Pro 더 긴 작업, 더 잦은 사용이 예상되는 분에게 적합합니다. 사용량 여유가 더 큽니다.
API key 결제 이번 사전 준비의 필수 항목이 아닙니다. API key는 나중에 별도 안내가 있을 때 준비하면 됩니다.
회사 계정 관리자가 Codex 사용을 막아두면 로그인이 되어도 사용할 수 없습니다. 수업 전 권한을 확인하세요.
  1. ChatGPT 플랜 페이지에서 Plus, Pro, Business 중 본인 상황에 맞는 플랜을 선택합니다. 수업에서는 “Codex에 로그인할 수 있는 계정”이 필요합니다.
  2. 결제 후 같은 브라우저에서 ChatGPT를 한 번 열고, 새 대화가 정상적으로 시작되는지 확인합니다. 이 화면이 열려야 Codex 로그인도 부드럽게 이어집니다.
  3. 이메일 주소를 기록합니다. 수업 당일에는 “어느 계정으로 결제했더라?”가 가장 흔한 막힘 지점입니다. 개인 메모장에 결제 이메일만 적어두세요. 비밀번호는 적지 않습니다.
  4. 비밀번호 로그인 계정이라면 MFA, 즉 2단계 인증을 켜 두는 것을 권장합니다. 계정을 더 안전하게 지키는 장치입니다.
2

터미널 준비 후 Codex를 설치합니다.

Codex는 터미널에서 실행하는 코딩 에이전트입니다. 지금 열어 둔 폴더 안의 파일을 읽고, 고치고, 필요한 명령을 실행할 수 있습니다. 그래서 먼저 “내 컴퓨터에서 명령이 먹히는지”를 확인합니다.

15-25분
Terminal 명령을 입력하는 창

macOS는 터미널, Windows는 PowerShell 또는 WSL2를 사용합니다.

Node / npm 설치 도구

npm으로 Codex CLI를 설치합니다. Node 20 이상이면 수업용 하네스와도 맞습니다.

Codex CLI 로컬 실행 파트너

브라우저 ChatGPT와 달리 내 폴더 안에서 파일 작업을 같이합니다.

내 운영체제별 시작 위치

macOS 터미널 앱을 엽니다

Spotlight에서 “터미널”을 검색해 실행합니다. npm이 없으면 Node.js LTS를 설치한 뒤 터미널을 완전히 닫았다가 다시 엽니다.

Windows PowerShell 또는 WSL2를 엽니다

처음이라면 PowerShell로 시작해도 됩니다. 개발 환경을 이미 쓰는 분은 WSL2 안에서 설치해도 괜찮습니다. 둘 중 하나만 골라 끝까지 진행하세요.

1. 설치 도구가 있는지 확인

node -v
npm -v
정상 예시 v20.x, v22.x처럼 버전 숫자가 보입니다. 숫자가 다를 수는 있지만 Node는 20 이상, 가능하면 공식 페이지의 LTS 버전을 권장합니다.
막힌 예시 command not found가 보이면 Node.js가 없거나 경로가 연결되지 않은 상태입니다. 아래 “Windows 11에서 Node.js LTS 설치”를 먼저 진행한 뒤 새 PowerShell에서 다시 확인합니다.

2. Windows 11에서 Node.js LTS 설치

먼저 이해할 것

PowerShell 7.6.2를 설치한 것은 “명령 입력창”을 준비한 것입니다. node와 npm은 Node.js LTS를 따로 설치해야 생깁니다.

초보자 권장 경로

명령어 설치보다 공식 설치 파일이 더 쉽습니다. Node.js 공식 다운로드 페이지에서 LTS라고 표시된 Windows Installer를 받아 기본값으로 설치하세요.

  1. 열려 있는 PowerShell을 모두 닫습니다. 설치 후 경로가 새로 잡혀야 하므로, 먼저 실행 중인 터미널 창을 정리합니다.
  2. Node.js 공식 다운로드 페이지로 이동합니다. 화면에 보이는 LTS 버전을 선택합니다. 버전 숫자는 시점마다 바뀔 수 있으니, 숫자보다 LTS 표시를 기준으로 보면 됩니다.
  3. Windows Installer(.msi)를 내려받아 실행합니다. 설치 마법사에서는 특별한 이유가 없으면 기본값 그대로 Next를 누릅니다. npm과 PATH 설정이 함께 들어갑니다.
  4. 설치가 끝나면 새 PowerShell 7을 엽니다. 기존 창에서는 여전히 node를 못 찾을 수 있습니다.
  5. 다시 확인합니다. 아래 명령에서 두 줄 모두 버전 숫자가 나오면 다음 단계로 넘어갑니다.
node -v
npm -v
PowerShell에서 바로 설치하고 싶은 분

Windows 11에는 보통 WinGet이 포함되어 있습니다. 아래 명령으로 LTS 패키지를 설치할 수도 있습니다. 설치 중 권한 요청 창이 뜨면 허용하고, 끝난 뒤 PowerShell을 새로 여세요.

winget --version
winget install --id OpenJS.NodeJS.LTS -e --source winget
설치 후에도 안 될 때 PowerShell을 닫고 새로 열었는지 먼저 확인합니다. 그래도 안 되면 Windows를 한 번 재시작한 뒤 node -v를 다시 실행합니다.
경로 확인 where.exe node를 실행했을 때 C:\Program Files\nodejs\node.exe처럼 Node.js 경로가 보이면 연결된 상태입니다.

3. Codex CLI 설치

npm install -g @openai/codex

설치가 끝나면 터미널에 패키지 추가 메시지가 보입니다. 경고가 몇 줄 떠도 마지막에 실패하지 않았다면 다음 단계로 넘어가도 됩니다.

4. 설치 확인과 첫 실행

codex --version
codex
설치 중 비밀번호, 토큰, API key, ~/.codex/auth.json 내용을 채팅방이나 단체방에 붙여넣지 마세요. 로그인 캐시는 비밀번호처럼 다뤄야 합니다.
정상적으로 보이는 화면

codex --version 뒤에 버전명이 나오고, codex 실행 후 로그인 안내 또는 Codex 입력 화면으로 들어갑니다.

아직 준비 완료가 아닌 상태

버전 확인만 되고 로그인이나 테스트 파일 생성까지 하지 않았다면 아직 끝난 것이 아닙니다. 다음 단계까지 이어서 진행하세요.

3

Codex에 ChatGPT 계정으로 로그인합니다.

codex를 처음 실행하면 브라우저 로그인 흐름이 열립니다. 수업에서 결제한 ChatGPT 계정과 같은 계정으로 로그인하세요. 다른 계정으로 들어가면 유료 플랜이 있어도 Codex 사용 권한이 안 보일 수 있습니다.

5-10분
  1. 터미널에서 codex를 입력합니다.
  2. 로그인 선택지가 나오면 Sign in with ChatGPT를 선택합니다.
  3. 브라우저에서 로그인을 마치고 터미널로 돌아옵니다.
  4. 프로젝트 신뢰 여부를 묻는 화면이 나오면, 수업용 폴더인지 확인한 뒤 진행합니다.
  5. Codex 안에서 /status를 입력해 계정과 사용 상태가 보이는지 확인합니다.
브라우저가 자동으로 안 열릴 때

codex login --device-auth를 실행하면 링크와 코드가 나옵니다. 링크를 브라우저에 열고 코드를 입력해 로그인하는 방식입니다.

API key로 로그인하라는 말이 보일 때

이번 준비는 ChatGPT 유료 계정 로그인이 기준입니다. 특별한 안내를 받지 않았다면 먼저 Sign in with ChatGPT를 선택하세요.

로그인 후 Codex 안에서 확인할 명령

/status
/model
/status 계정, 로그인 상태, 사용 상태를 확인합니다. 수업 전 캡처할 때 개인 토큰이나 인증 파일은 보이지 않게 합니다.
/model 모델 선택 화면입니다. 처음에는 기본 추천 모델을 사용하고, 사용량 제한이 보이면 더 작은 모델로 바꿔 이어갑니다.
4

Codex 첫 테스트는 “내 상품 고민을 넣기 전 손풀기”입니다.

설치만 끝난 상태는 아직 준비 완료가 아닙니다. Codex가 내 폴더에서 실제로 작업하는지, 승인 요청을 이해했는지 확인해야 1주차 소싱과 상세페이지 준비로 바로 넘어갈 수 있습니다. 테스트는 일부러 빈 폴더에서 합니다.

10-15분
왜 테스트 폴더를 따로 만드나요?

확정자 답변에는 이미 판매 중인 상품, 실패한 광고, 상세페이지 고민, 자동화하고 싶은 반복 업무가 많이 나왔습니다. 처음부터 그 자료가 있는 폴더에서 실행하지 말고, 빈 폴더에서 작은 README 하나만 만들어 Codex의 기본 흐름을 안전하게 익히세요.

mkdir run-academy-codex-test
cd run-academy-codex-test
codex
mkdir 테스트 전용 폴더를 만듭니다. 이미 있다고 나오면 cd run-academy-codex-test만 실행해도 됩니다.
cd Codex가 일할 위치를 테스트 폴더로 옮깁니다. 현재 위치가 곧 Codex의 작업 범위입니다.
codex Codex 대화 화면을 시작합니다. 이후 프롬프트는 터미널 안의 Codex 입력창에 붙여넣습니다.
Codex 안에 붙여넣을 첫 번째 테스트 프롬프트

아래 문장을 그대로 붙여넣으세요. Codex가 어떤 명령을 실행하려는지 설명하고, 필요한 경우 승인 요청을 띄우는지 봅니다.

현재 폴더를 확인한 뒤 README.md 파일을 만들어줘.
파일에는 "실행학교 실전 2기 Codex 테스트 완료", 내 운영체제, node -v, npm -v 확인 결과를 표로 정리해줘.
그 아래에는 내가 1주차에 풀고 싶은 고민을 아래 3개 중 하나로 적어줘: 상품 소싱 / 상세페이지 개선 / 반복 업무 자동화.
명령을 실행하기 전에는 무엇을 확인하는지 한 문장으로 알려줘.
두 번째 테스트 프롬프트

이 단계에서 Codex가 방금 만든 파일을 다시 읽고 수정할 수 있는지 확인합니다.

README.md를 읽고, 내가 고른 1주차 고민을 기준으로 다음 수업 전 준비물 3개를 체크리스트로 추가해줘.
예: 팔아본 상품 링크, 실패하거나 막힌 이유, 참고하고 싶은 상세페이지나 경쟁 상품.
마지막에는 "테스트 통과 - 내 1주차 고민을 가져갈 준비 완료"라고 적어줘.
Approve 승인 요청 읽기

Codex가 파일을 만들거나 명령을 실행하기 전, 무엇을 하려는지 보여주면 내용을 읽고 승인합니다. 내 판매 자료를 읽기 전에도 같은 습관을 씁니다.

Read 파일 재확인

두 번째 요청에서 Codex가 방금 만든 README.md를 다시 읽고, 내가 고른 1주차 고민 기준으로 체크리스트를 추가하면 정상입니다.

Stop 낯선 폴더면 멈춤

Downloads, Desktop 전체, 비밀번호 파일처럼 수업과 무관한 위치를 읽으려 하면 승인하지 않습니다.

성공 기준
  • README.md 파일이 생김
  • Node/npm 버전이 파일 안에 적힘
  • 1주차 고민이 상품 소싱, 상세페이지 개선, 반복 업무 자동화 중 하나로 적힘
  • 두 번째 요청 후 준비물 체크리스트와 “테스트 통과” 문구가 추가됨
캡처해서 보관할 화면
  • codex --version 실행 결과
  • Codex가 만든 README.md와 1주차 고민 체크리스트
  • 개인 토큰이나 인증 파일이 보이지 않는 터미널 화면
5

수업에서 자주 쓰는 습관을 미리 익힙니다.

실전 2기는 “AI가 대신 해줬다”가 아니라 “내가 AI를 조정해서 판단했다”는 흔적이 중요합니다. 시작 전 이 습관만 익혀도 수업 속도가 훨씬 빨라집니다.

5분
/status 현재 상태 확인

로그인, 모델, 사용 상태를 볼 때 씁니다.

/model 모델 선택

작업 성격에 맞춰 사용 가능한 모델을 고를 때 씁니다.

Approval 승인 요청 읽기

파일 변경이나 명령 실행 전, 무엇을 하려는지 확인하고 승인합니다.

Codex에게 요청할 때 좋은 문장 구조

좋은 요청
  • “현재 폴더 구조를 먼저 확인해줘.”
  • “파일을 바꾸기 전에 변경 계획을 3줄로 말해줘.”
  • “실행 결과가 실패하면 원인과 다음 명령을 알려줘.”
피해야 할 요청
  • “내 컴퓨터 전체를 보고 알아서 해줘.”
  • “비밀번호 파일을 찾아서 넣어줘.”
  • “에러는 무시하고 계속 실행해줘.”
수업 폴더 밖의 개인 파일, 다운로드 폴더 전체, 비밀번호가 들어간 파일을 Codex에게 무심코 읽히지 마세요. Codex는 강력한 도구라서 “어느 폴더에서 실행하는지”가 곧 안전장치입니다.
6

완료 보고에는 “내 1주차 고민”까지 짧게 남깁니다.

질문이 없어도 아래 양식으로 준비 상태와 첫 주에 풀고 싶은 문제를 남겨두면, 수업 첫날 환경 확인과 팀별 실행 방향 잡기가 빨라집니다.

5분
완료 보고 템플릿

아래 내용을 복사해 본인 정보만 채워두세요. 비밀번호, API key, 인증 토큰은 절대 넣지 않습니다.

이름:
사용 OS: macOS / Windows PowerShell / Windows WSL2 중 선택
ChatGPT 플랜: Plus / Pro / Business / 기타
결제 이메일과 Codex 로그인 이메일이 같은가요?: 예 / 아니오
node -v 결과:
npm -v 결과:
codex --version 결과:
README.md 생성, 읽기, 수정 테스트: 완료 / 미완료
1주차에 풀고 싶은 고민: 상품 소싱 / 상세페이지 / AI 자동화 / 기타
판매 중이거나 테스트하고 싶은 상품/카테고리:
막힌 지점이 있다면 에러 문장 그대로:
Capture 1 버전 확인 화면

node -v, npm -v, codex --version 결과를 한 화면에 모아둡니다.

Capture 2 README.md 결과

테스트 문구와 “테스트 통과”가 보이는 파일 내용을 보관합니다.

Privacy 가릴 것

이메일은 일부 가려도 됩니다. 토큰, 인증 파일, 결제 정보, 비밀번호는 절대 캡처에 포함하지 않습니다.

막힌 상태로 질문할 때도 이렇게 보내세요

지금 막힌 단계:
실행한 명령:
화면에 나온 에러 문장:
내 운영체제:
이미 해본 조치:
캡처에서 가린 정보: 비밀번호 / 토큰 / 결제 정보
7

막힐 때는 여기부터 봅니다.

설치 문제는 대부분 같은 지점에서 납니다. 아래 문장과 비슷한 에러가 보이면 해당 안내부터 확인하세요.

상시
codex: command not found

설치가 안 됐거나 터미널이 설치 경로를 못 찾는 상태입니다. 터미널을 새로 열고 npm install -g @openai/codex를 다시 실행하세요.

npm: command not found

PowerShell은 설치됐지만 Node.js LTS가 아직 없는 상태일 수 있습니다. 설치 섹션의 “Windows 11에서 Node.js LTS 설치”를 따라 한 뒤, PowerShell을 새로 열고 node -v, npm -v를 확인하세요.

EACCES 또는 권한 오류

전역 설치 권한 문제일 수 있습니다. 같은 명령을 반복하기 전에 에러 문장을 그대로 캡처해 질문하세요. 운영체제에 따라 해결법이 다릅니다.

브라우저 로그인이 안 열림

codex login --device-auth를 시도할 수 있습니다. 화면에 나온 링크와 코드를 브라우저에 입력해 로그인하는 방식입니다.

유료 플랜인데 권한이 없다고 나옴

결제한 ChatGPT 이메일과 Codex에 로그인한 이메일이 같은지 먼저 확인합니다. 회사 계정이면 관리자의 Codex 허용 설정도 확인해야 합니다.

사용량 제한 메시지

/status로 현재 상태를 확인하고, 더 작은 모델을 선택하거나 잠시 후 다시 시도합니다. Pro/Business는 사용량 여유가 더 큽니다.

README.md가 안 만들어짐

현재 폴더가 테스트 폴더인지 확인합니다. Codex 안에서 “현재 폴더 위치를 알려줘”라고 묻고, 필요한 승인 요청을 놓치지 않았는지 봅니다.

8

공식 문서 링크

아래 링크는 가입, 인증, 설치 안내가 바뀔 때 가장 먼저 확인할 기준입니다. 수업 자료보다 공식 문서가 새로워졌다면 공식 문서를 우선합니다.

2026년 5월 기준으로 반영한 공식 안내

Codex CLI는 터미널에서 실행하는 로컬 코딩 에이전트입니다. 이번 실전 2기 수강생 흐름은 API key를 직접 연결하는 방식이 아니라, Codex 기본 인증인 ChatGPT 계정 로그인 흐름을 기준으로 안내합니다.

OpenAI Codex CLI Codex Authentication Codex Pricing Codex Models Node.js LTS Download Node.js on Windows Microsoft WinGet openai/codex GitHub
4

오늘 목표는 딱 하나입니다. 내 컴퓨터에서 코치 OS 화면을 여는 것.

설치 과정에서 어려운 말이 나와도 괜찮습니다. 이번 가이드는 수강생이 명령어를 외우는 흐름이 아니라, Codex App에게 설치를 맡기고 마지막에 화면이 열렸는지만 확인하는 흐름입니다.

30-45분
Codex App 사용 GitHub URL 설치 Codex Auth 연결 4777 화면 확인

설치가 어려워 보이는 진짜 이유

권한 GitHub 저장소가 안 열림

수업용 저장소 초대를 아직 받지 않았거나 수락하지 않으면 설치 명령을 시작하기 전부터 404처럼 보일 수 있습니다.

폴더 엉뚱한 위치에서 실행

package.json이 안 보이는 폴더에서 npm 명령을 실행하면 설치가 실패합니다. 먼저 정확한 OS 폴더를 찾아야 합니다.

인증 Codex Auth가 안 잡힘

코치 OS가 새 로그인창을 여는 것이 아니라, 내 컴퓨터에 저장된 Codex 로그인 상태를 빌려 씁니다. 그래서 codex login status 확인이 중요합니다.

실행 4777 화면이 안 열림

서버가 꺼졌거나 이미 켜져 있거나, 브라우저가 자동으로 열리지 않은 상태일 수 있습니다. 이때는 서버 상태부터 확인합니다.

완료되면 보이는 3가지

1 설치 확인

npm run validate가 실패 없이 끝납니다.

2 Codex Auth 확인

codex login status에서 로그인 상태가 확인됩니다.

3 코치 화면 확인

http://127.0.0.1:4777에서 실전 2기 코치 화면이 열립니다.

주의 비밀 정보는 공유하지 않기

비밀번호, 인증 코드, 토큰, auth.json, API Key는 캡처나 채팅방에 올리지 않습니다.

이 설치는 “수업용 OS를 내 컴퓨터에서 켜는 준비”입니다. 상품 조사는 설치가 끝난 뒤 Week 1 Sourcing Coach에서 시작합니다.
1

Windows는 명령어를 외우지 말고, Codex에게 옆에서 도와달라고 하면 됩니다.

이 가이드는 컴퓨터를 아주 천천히 배우는 분도 따라올 수 있게 만들었습니다. 우리는 어려운 명령어를 외우지 않습니다. 복사하고, 붙여넣고, Codex가 알려주는 다음 한 단계만 확인합니다.

Windows
1 복사

아래 회색 상자의 문장을 복사합니다. 문장을 전부 이해하지 못해도 괜찮습니다.

2 붙여넣기

Codex App 대화창에 붙여넣습니다. PowerShell에 바로 붙여넣지 않아도 됩니다.

3 기다리기

Codex가 현재 컴퓨터 상태를 보고, 필요한 것부터 하나씩 안내합니다.

4 확인

마지막에 http://127.0.0.1:4777 화면이 열리면 설치 성공입니다.

Windows에서 처음 Codex에게 할 말

나는 Windows 사용자이고, 터미널 명령어가 익숙하지 않아.

실전 2기 이커머스 AI OS를 설치하고 싶어.
내가 직접 명령어를 외우지 않게, 너가 먼저 내 컴퓨터 상태를 확인하고 한 단계씩 도와줘.

꼭 이렇게 진행해줘.
1. 지금 내가 OS 설치를 할 준비가 되었는지 먼저 확인해줘.
2. Node.js와 npm이 설치되어 있는지 확인해줘.
3. 없으면 공식 Node.js LTS 설치 방법을 아주 쉽게 안내해줘.
4. 설치 폴더는 Documents 안에 두는 게 좋은지 확인해줘.
5. 수업용 OS 폴더 안에 package.json이 있는지 확인해줘.
6. package.json이 있는 폴더에서만 npm ci를 실행해줘.
7. npm run validate로 설치가 맞는지 확인해줘.
8. codex login status로 Codex Auth 상태를 확인해줘.
9. npm run coach:daemon으로 코치 서버를 켜줘.
10. http://127.0.0.1:4777 화면이 열리는지 확인해줘.

중요한 약속:
- 비밀번호, API Key, 토큰, auth.json 내용은 절대 보여주거나 복사하지 않게 해줘.
- 내가 헷갈릴 수 있으니 한 번에 하나씩만 알려줘.
- 에러가 나면 에러 문장을 해석하고 다음 한 단계만 알려줘.

Windows에서 가장 자주 막히는 곳

PowerShell이 뭔지 모르겠어요 검은 화면이라 무서워 보이지만, 컴퓨터에게 짧은 부탁을 적는 창입니다. 이번 설치에서는 Codex가 대부분 대신 안내합니다.
GitHub 저장소가 404로 보여요 명령어 문제가 아니라 저장소 초대나 권한 문제일 가능성이 큽니다. 먼저 GitHub 초대를 수락했는지, 저장소가 브라우저에서 열리는지 확인합니다.
npm이 없다고 나와요 Node.js LTS가 아직 없거나 설치 후 새 터미널을 열지 않은 상태입니다. Codex에게 “Node.js LTS 공식 설치부터 안내해줘”라고 말합니다.
package.json이 없다고 나와요 폴더를 한 칸 잘못 들어간 것입니다. Codex에게 “내 컴퓨터에서 package.json이 있는 OS 폴더를 찾아줘”라고 말합니다.
Downloads에 압축을 풀었어요 괜찮습니다. 다만 오래 쓰려면 Documents 안으로 옮기는 것이 좋습니다. Codex에게 안전하게 옮겨달라고 요청합니다.
OneDrive 폴더에 있어요 동기화 때문에 설치가 느리거나 파일 잠김이 생길 수 있습니다. 가능하면 Documents\Run-Academy처럼 단순한 위치를 씁니다.
Codex Auth 확인이 안 돼요 코치 OS 문제가 아니라 Codex 로그인 상태 문제일 수 있습니다. 아래 04-04 섹션의 복구 순서대로 codex login status부터 다시 확인합니다.
4777이 안 열려요 서버가 꺼졌거나 다른 프로그램이 같은 번호를 쓰는 중일 수 있습니다. Codex에게 npm run coach:status부터 확인해달라고 말합니다.
창을 닫으니 OS가 꺼졌어요 수업용 OS는 내 컴퓨터 안에서 켜지는 프로그램입니다. 다시 npm run coach:daemon으로 켜면 됩니다.
천천히 해도 됩니다. 설치가 막힌 것은 실력이 부족해서가 아니라, Windows의 폴더 위치와 로그인 상태가 조금 헷갈리기 때문인 경우가 대부분입니다. 에러 문장만 그대로 남기면 Codex와 운영팀이 이어서 도와줄 수 있습니다.
2

가장 쉬운 방법은 Codex에게 GitHub URL을 주고 설치를 맡기는 것입니다.

아래 문장을 Codex App 채팅창에 그대로 붙여넣습니다. 수업용 GitHub URL은 이미 넣어두었습니다.

수업용 GitHub 저장소: IrumHahn/run-academy-ai-os-harness-student

복붙 
아래 GitHub 저장소를 내 컴퓨터에 설치해줘.

1. 저장소를 다운로드하거나 clone 해줘.
2. README.md와 INSTALL_KR.md가 있으면 먼저 읽어줘.
3. Node 버전을 확인해줘.
4. package.json이 있는 폴더에서 npm ci를 실행해줘.
5. .env.example이 있으면 .env로 복사해줘.
6. npm run validate로 설치 상태를 확인해줘.
7. npm run coach:daemon으로 코치 서버를 켜줘.
8. 마지막에 내가 열어야 할 로컬 주소를 알려줘.

GitHub URL:
https://github.com/IrumHahn/run-academy-ai-os-harness-student
Codex가 권한을 물어보면

파일 다운로드, 패키지 설치, 서버 실행처럼 설치에 필요한 요청은 허용합니다. 잘 모르겠으면 화면 문장을 캡처해서 질문합니다.

Codex가 멈춘 것 같으면

“지금 어디까지 진행됐는지 확인해줘”라고 물어봅니다. 같은 명령을 여러 번 누르기 전에 현재 폴더와 에러 문장을 먼저 확인합니다.

3

수동으로 확인해야 할 때는 이 4줄만 봅니다.

Codex가 자동 설치를 잘 끝냈다면 이 단계는 확인만 하면 됩니다. 직접 실행해야 할 때는 반드시 package.json이 보이는 폴더에서 시작합니다.

선택
macOS 
ls
npm ci
cp .env.example .env
npm run validate
Windows PowerShell 
dir
npm ci
Copy-Item .env.example .env
npm run validate
정상 폴더 package.json, coach, scripts, agents가 보입니다.
잘못된 폴더 package.json이 안 보이면 한 단계 안쪽 폴더로 들어가거나, Codex에게 “현재 폴더에서 package.json을 찾아줘”라고 요청합니다.
설치 명령 가능하면 npm install보다 npm ci를 사용합니다. 수업용으로 정해진 패키지 버전을 더 정확히 맞춥니다.
4

설치 후에는 Codex Auth를 연결합니다.

코치 OS 안에 따로 로그인 버튼이 있는 것이 아닙니다. 먼저 내 컴퓨터의 Codex가 ChatGPT 계정으로 로그인되어 있고, 코치 OS가 그 로그인 상태를 빌려 쓰는 방식입니다.

10분

Codex에게 이렇게 부탁하세요

내 컴퓨터의 Codex Auth 연결을 확인해줘.

나는 터미널 명령어가 익숙하지 않으니, 내가 직접 외우지 않게 한 단계씩 도와줘.

꼭 이렇게 진행해줘.
1. 먼저 codex login status로 지금 로그인 상태를 확인해줘.
2. 로그인이 안 되어 있으면 codex login을 실행해서 로그인 과정을 안내해줘.
3. 브라우저가 열리면 어떤 계정으로 로그인해야 하는지 쉽게 설명해줘.
4. 로그인이 끝나면 다시 codex login status로 연결 상태를 확인해줘.
5. 그 다음 코치 OS 화면에서 Text Auth가 Codex Auth로 되어 있는지 확인하게 도와줘.

중요한 약속:
- auth.json, 토큰, API Key, 비밀번호는 절대 보여주거나 복사하지 않게 해줘.
- 에러가 나오면 에러 문장을 해석하고 다음 한 단계만 알려줘.
- 내가 헷갈릴 수 있으니 한 번에 하나씩만 진행해줘.

Codex Auth가 확인되지 않을 때 복구 순서

1. 새 PowerShell 열기 Codex나 Node를 방금 설치했다면 기존 창이 새 경로를 못 읽을 수 있습니다. PowerShell 또는 Codex App 터미널을 새로 열고 다시 확인합니다.
2. 로그인 상태 확인 codex login status를 실행합니다. 로그인되어 있지 않거나 토큰이 만료되었다고 나오면 다음 단계로 갑니다.
3. 일반 로그인 codex login을 실행하고, 브라우저가 열리면 수업에 사용할 ChatGPT 계정으로 로그인합니다.
4. 브라우저가 안 열릴 때 codex login --device-auth를 실행합니다. device auth는 화면에 나온 링크와 코드를 브라우저에 직접 입력해 로그인하는 방식입니다.
5. codex 명령 자체가 안 될 때 codex --version 또는 codex doctor로 설치 상태를 확인합니다. spawn codex ENOENT처럼 나오면 Codex CLI가 설치되지 않았거나 PATH가 연결되지 않은 상태입니다.
6. 마지막 복구 계속 만료된 인증으로 보이면 codex logout으로 저장된 인증을 지운 뒤 codex login --device-auth로 다시 연결합니다. 이때 토큰이나 auth.json 내용은 절대 공유하지 않습니다.
7. 코치 OS 재시작 로그인 상태가 정상으로 바뀐 뒤 npm run coach:stop, npm run coach:daemon 순서로 코치 서버를 다시 켭니다.
Codex에게 복구를 맡기고 싶을 때

아래 문장을 Codex App에 붙여넣으면 인증 상태, CLI 설치, 새 로그인, 코치 서버 재시작을 한 번에 점검하게 할 수 있습니다.

Codex Auth 확인이 계속 안 돼.
내가 직접 명령어를 외우지 않게, 아래 순서대로 한 단계씩 복구해줘.

1. 먼저 codex --version으로 Codex CLI가 설치되어 있는지 확인해줘.
2. codex login status로 현재 로그인 상태를 확인해줘.
3. 로그인이 안 되어 있거나 만료되어 있으면 codex login을 안내해줘.
4. 브라우저 로그인이 안 열리면 codex login --device-auth를 안내해줘.
5. 그래도 계속 실패하면 codex doctor로 진단해줘.
6. 로그인 상태가 정상으로 바뀌면 npm run coach:stop 후 npm run coach:daemon으로 코치 OS를 다시 켜줘.
7. 마지막에 http://127.0.0.1:4777 화면에서 Text Auth가 Codex Auth인지 확인하게 도와줘.

중요:
- auth.json, 토큰, API Key, 비밀번호는 절대 출력하거나 복사하지 마.
- 에러 문장이 나오면 그대로 해석하고 다음 한 단계만 알려줘.
처음 확인 Codex가 로그인 상태 확인

내 컴퓨터의 Codex가 이미 ChatGPT 계정과 연결되어 있는지 먼저 확인합니다.

로그인 필요 Codex가 로그인 안내

브라우저가 열리면 수업에 사용할 ChatGPT 계정으로 로그인하면 됩니다.

다시 확인 연결 상태 재확인

로그인 상태가 확인되면 코치 OS와 연결할 준비가 끝난 것입니다.

코치 화면 Text Auth 선택

코치 화면의 Agent Settings에서 Text Auth를 Codex Auth로 선택합니다.

이미지 생성이나 OpenAI API를 직접 호출하는 기능은 별도의 OPENAI_API_KEY가 필요할 수 있습니다. 월요일 설치 목표는 우선 텍스트 코치를 Codex Auth로 연결하는 것입니다.
5

코치 서버를 켜고 4777 화면을 엽니다.

설치와 인증 확인이 끝났다면 이제 코치 화면을 켭니다. 주소는 인터넷 주소가 아니라 내 컴퓨터 안에서만 열리는 로컬 주소입니다.

5분 
npm run coach:daemon
npm run coach:status
http://127.0.0.1:4777
정상 화면

Week 1 Sourcing Coach, Agent Settings, Data Tools 같은 메뉴가 보이면 성공입니다.

이미 켜져 있다고 나오면 
npm run coach:stop
npm run coach:daemon
6

설치 완료는 “말”이 아니라 “증거 3개”로 확인합니다.

운영팀이 빠르게 도와드릴 수 있도록, 성공한 사람도 아래 형식으로 남깁니다. 막힌 사람은 실패 화면 그대로 보내면 됩니다.

제출
Capture 1 npm run validate

설치 검사가 끝난 터미널 화면을 남깁니다.

Capture 2 codex login status

로그인 상태만 보이게 캡처합니다. 이메일은 일부 가려도 됩니다.

Capture 3 4777 코치 화면

브라우저에서 코치 화면이 열린 상태를 남깁니다.

설치 완료 보고 템플릿

이름:
사용 OS: macOS / Windows
GitHub URL 설치: 완료 / 미완료
npm run validate: 완료 / 실패
Codex Auth 확인: 완료 / 미완료
4777 코치 화면: 열림 / 안 열림
막힌 에러 문장:
비밀번호, 토큰, API Key는 공유하지 않았습니다.
7

막히면 같은 명령을 반복하지 말고, 에러 문장을 먼저 보냅니다.

설치 문제는 대부분 폴더 위치, Node 설치, 로그인 상태, 4777 포트 중 하나입니다. 아래 표에서 내 화면과 비슷한 문장을 찾습니다.

상시
npm: command not found

Node.js가 없거나 터미널이 새 경로를 못 읽는 상태입니다. Node.js 설치 후 터미널을 새로 엽니다.

package.json을 찾을 수 없음

잘못된 폴더에서 실행한 것입니다. Codex에게 “package.json이 있는 폴더로 이동해줘”라고 요청합니다.

Codex 로그인이 안 됨

codex login을 다시 실행합니다. 브라우저가 안 열리면 화면 문장을 캡처해서 질문합니다.

spawn codex ENOENT

코치 OS가 Codex CLI를 찾지 못하는 상태입니다. codex --version과 codex doctor로 설치와 PATH를 확인하고, 새 PowerShell을 엽니다.

토큰 만료 또는 인증 무효

codex login status로 상태를 확인한 뒤 codex login 또는 codex login --device-auth로 다시 로그인합니다.

4777 화면이 안 열림

npm run coach:status를 실행한 뒤, 상태 화면과 에러 문장을 함께 보냅니다.

권한 요청이 무서움

Codex가 어떤 파일을 바꾸려는지 설명해달라고 요청합니다. 비밀 정보 공유 요청이면 중단하고 질문합니다.

이미지/API 기능이 안 됨

텍스트 코치는 Codex Auth로 진행하고, 이미지 생성은 별도 API Key가 필요할 수 있습니다. 월요일에는 코치 화면 연결을 먼저 완료합니다.

막혔을 때 복사해서 보내기

OS 설치 중 막혔습니다.
지금 단계:
실행한 명령:
화면에 나온 에러 문장:
현재 폴더에서 보이는 파일:
node -v / npm -v 결과:
내 운영체제:
비밀번호, 토큰, API Key는 가렸습니다.
4

실전 2기 이커머스 코치 OS는 “내 컴퓨터 안에 설치하는 수업용 실행 장치”입니다.

브라우저에서 ChatGPT에게 질문만 하는 방식이 아니라, 각 학생의 Codex가 수업 폴더를 열고 코치 화면, 증거 폴더, 산출물 폴더를 함께 다루는 구조입니다. 그래서 설치가 조금 어렵지만, 한 번 열리면 4주 동안 같은 방식으로 계속 사용할 수 있습니다.

30-60분
학생별 필수 설치 Codex 로컬 폴더 코치 화면 4777 Codex Auth 증거 기반 소싱

이 OS가 대신 해주는 것과, 학생이 직접 해야 하는 것

OS가 도와주는 일
  • 지금 무엇을 조사해야 하는지 질문으로 안내합니다.
  • 붙여넣은 리뷰, 공급처, 경쟁사 자료를 후보와 근거로 정리합니다.
  • 주차별 리포트, shortlist, 발표용 정리물 생성을 돕습니다.
학생이 반드시 해야 하는 일
  • 실제 링크, 가격, 리뷰, 공급처 정보를 직접 모읍니다.
  • AI가 만든 가설과 내가 확인한 증거를 구분합니다.
  • 최종 후보를 왜 남기고 왜 버렸는지 판단 흔적을 남깁니다.
Step A OS 폴더 받기

수업용 폴더를 내려받아 압축을 풀고, 찾기 쉬운 위치에 둡니다.

Step B Codex로 폴더 열기

package.json이 보이는 정확한 폴더에서 명령을 실행합니다.

Step C Codex 인증 확인

codex와 /status로 ChatGPT 계정 로그인 상태를 확인합니다.

Step D 코치 화면 열기

npm run coach:daemon 후 127.0.0.1:4777을 확인합니다.

1

구조를 먼저 알면 설치가 덜 무섭습니다.

코치 OS 폴더는 “채팅 화면 + 주차별 코치 + 증거 보관함 + 결과물 생성기”로 나뉩니다. 폴더 이름이 낯설어도, 역할만 알면 어디에서 막혔는지 훨씬 빨리 찾을 수 있습니다.

5분
Coach UI 대화형 코치 화면

http://127.0.0.1:4777에서 열리는 수업용 웹 화면입니다.

Agents 주차별 코치 지침

소싱, 전략, 비주얼, 상세페이지 코치의 역할과 질문 방식이 들어 있습니다.

Evidence 조사 흔적 보관함

리뷰, 링크, 가격, 공급처, 경쟁사 자료처럼 “증거로 인정될 자료”를 남깁니다.

coach/ 브라우저 코치 화면

학생이 주차별 코치와 대화하는 화면 코드입니다. 보통 직접 고치지 않습니다.

agents/ 주차별 에이전트 지침

Week 1 Sourcing Coach, Week 2 Strategy Coach 같은 코치의 행동 원칙입니다.

evidence/ 원자료 저장 위치

학생이 복사해 온 실제 자료가 쌓이는 곳입니다. 후보 인정의 기준이 됩니다.

outputs/ 리포트와 발표 자료

OS 리포트, shortlist, 최종 후보, 주차별 결과물이 생성되는 곳입니다.

inputs/ 현재 실행 입력값

카테고리, 타깃, 채널, 예산처럼 실행 기준이 되는 값이 들어갑니다.

scripts/ 실행 명령 엔진

npm run coach:daemon, npm run os:sourcing 같은 명령이 연결되는 곳입니다.

2

설치 전에는 4가지만 확인합니다.

대부분의 설치 문제는 Node.js가 없거나, 엉뚱한 폴더에서 명령을 실행하거나, Codex 로그인 인증이 풀린 경우입니다. 아래 준비물이 맞으면 설치 성공률이 확 올라갑니다.

5-10분
Prep 사전 준비 3개 완료

ChatGPT 유료 플랜, Codex 실행, 기본 파일 테스트를 끝냅니다.

Node Node.js 20 이상

node -v, npm -v가 숫자로 출력되어야 합니다.

Folder 수업용 OS 폴더

run-academy-ai-os-harness 폴더를 압축 해제해 둡니다.

Auth Codex 로그인 인증

codex 실행 후 /status에서 ChatGPT 계정 로그인 상태를 확인합니다.

Codex 인증 정보는 비밀번호처럼 다룹니다. ~/.codex/auth.json, 로그인 토큰, 기기 인증 코드는 단체 채팅방, 캡처 화면, 과제 제출 문장에 절대 넣지 마세요.
3

OS 폴더의 정확한 위치에서 설치 명령을 실행합니다.

여기에서 가장 많이 막힙니다. 핵심은 package.json이 보이는 폴더에서 npm install을 실행하는 것입니다. 한 단계씩 확인하세요.

10-20분

1. OS 폴더로 이동합니다

macOS 예시 
cd ~/Documents/run-academy-ai-os-harness
ls
Windows PowerShell 예시 
cd $HOME\Documents\run-academy-ai-os-harness
dir
정상 package.json, coach, agents, evidence, outputs 같은 이름이 보입니다.
막힌 상태 package.json이 안 보이면 아직 바깥 폴더에 있거나 압축을 덜 푼 상태입니다. 폴더 안으로 한 번 더 들어가세요.

2. 필요한 패키지를 설치합니다

npm install

처음 한 번만 실행하면 됩니다. 설치 중 경고가 보여도 마지막에 실패하지 않았다면 다음 단계로 넘어가도 됩니다.

Codex에게 확인을 맡기고 싶을 때

Codex를 이 폴더에서 실행한 뒤 아래 문장을 붙여넣으면, 현재 위치와 설치 가능 상태를 먼저 점검하게 할 수 있습니다.

현재 폴더가 실행학교 AI OS 하네스가 맞는지 확인해줘.
package.json, coach 폴더, agents 폴더, evidence 폴더가 있는지 보고 설치 순서를 안내해줘.
파일은 아직 수정하지 말고 확인 결과만 알려줘.
4

Codex 로그인 인증으로 코치 OS 연결 상태를 확인합니다.

이번 실전 2기 기본 설치 흐름은 OpenAI API key를 학생이 직접 넣는 방식이 아닙니다. 이미 설치한 Codex가 ChatGPT 계정으로 로그인되어 있는지 확인하고, 그 인증을 기준으로 코치 OS를 실행합니다.

10분
macOS 
codex
Windows PowerShell 
codex

Codex 화면 안에서 로그인 상태를 확인합니다

/status

정상이라면 계정, 로그인 상태, 사용 가능한 모델 또는 플랜 정보가 보입니다. 이메일은 캡처에 전부 노출하지 않아도 됩니다.

정상 상태 /status에서 ChatGPT 계정으로 로그인된 상태가 보입니다. 수업에서 결제한 계정과 같은 계정인지 확인합니다.
로그인 화면이 뜰 때 브라우저가 열리면 ChatGPT 유료 플랜이 있는 계정으로 로그인합니다. 회사 계정이면 관리자가 Codex 사용을 허용했는지도 확인합니다.
브라우저 로그인이 막힐 때 codex login --device-auth를 실행한 뒤, 화면에 나온 링크와 코드를 브라우저에 입력합니다.

먼저 dry-run으로 구조를 확인합니다

npm run os:sourcing:dry
npm run os:all:dry

dry-run은 실제 코칭 실행 전에 폴더, 입력값, 실행 스크립트가 맞는지 점검하는 안전한 예행연습입니다.

5

코치 서버를 켜고 브라우저에서 4777 화면을 엽니다.

수업 중에는 터미널이 꺼져도 코치 화면이 유지되기 쉽도록 coach:daemon 방식을 권장합니다. 실행 후 브라우저에 로컬 주소를 열면 됩니다.

5-10분

1. 코치 OS 실행

npm run coach:daemon

2. 브라우저 주소창에 직접 입력

http://127.0.0.1:4777
정상적으로 보이는 것

실전 2기 코치 화면이 열리고, Week 1 Sourcing Coach 같은 주차별 코치 또는 Agent Settings 영역을 확인할 수 있습니다.

서버 상태 확인과 종료 
npm run coach:status
npm run coach:stop

선택: 공급처 URL을 실제 브라우저로 읽는 고급 모드

처음 한 번만 설치

수업 중 상품 URL 분석을 더 적극적으로 사용할 때만 진행합니다. 기본 설치가 끝난 뒤 필요할 때 실행해도 됩니다.

npm run setup:browser-reader
6

설치 완료 기준은 “화면이 열리고, Codex 인증 상태를 확인하고, 인증 정보를 노출하지 않았다”입니다.

설치가 끝났다는 말보다, 아래 기준을 함께 확인하면 운영팀도 빠르게 도와줄 수 있습니다.

검수
Folder package.json 확인

정확한 OS 폴더에서 설치와 실행 명령을 입력했습니다.

Install npm install 완료

패키지 설치가 실패 없이 끝났습니다.

Run 4777 화면 열림

http://127.0.0.1:4777에서 코치 OS 화면을 확인했습니다.

Privacy Codex 인증 비공개

~/.codex/auth.json, 로그인 토큰, 기기 인증 코드를 캡처나 채팅방에 노출하지 않았습니다.

설치 완료 보고 템플릿

이름:
사용 OS: macOS / Windows PowerShell / Windows WSL2
OS 폴더 위치:
node -v:
npm -v:
npm install: 완료 / 실패
Codex /status 확인: 완료 / 미완료
npm run os:sourcing:dry: 완료 / 실패
npm run coach:daemon: 완료 / 실패
4777 코치 화면 확인: 완료 / 미완료
막힌 에러 문장:
다음: Week 1 Sourcing OS 30개 인정 후보 10개 shortlist 3개 RFQ 후보
7

OS 설치가 막히면 에러 문장별로 해결합니다.

설치 문제는 “무엇이 안 되는지”보다 “어느 명령에서 어떤 문장이 나왔는지”가 중요합니다. 아래 문장과 비슷한 항목부터 확인하세요.

상시
npm: command not found

Node.js LTS가 설치되지 않았거나 PowerShell이 새 경로를 못 읽는 상태입니다. 사전 준비 가이드의 Node.js 설치 섹션을 진행한 뒤 새 터미널을 여세요.

ENOENT: no such file or directory, open package.json

명령을 실행한 위치가 OS 폴더가 아닙니다. package.json이 보이는 폴더로 이동한 뒤 다시 실행합니다.

Codex 로그인 또는 인증 오류

codex를 실행해 로그인 화면이 뜨는지 보고, 로그인 후 /status를 확인합니다. 브라우저 로그인이 막히면 codex login --device-auth를 시도합니다.

port 4777 already in use

코치 서버가 이미 켜져 있을 수 있습니다. npm run coach:status로 확인하고, 필요하면 npm run coach:stop 후 다시 실행합니다.

브라우저가 자동으로 안 열림

주소창에 http://127.0.0.1:4777을 직접 붙여넣습니다. 이 주소는 내 컴퓨터에서만 열리는 로컬 주소입니다.

dry-run은 되는데 실제 실행이 실패함

폴더 구조는 맞지만 Codex 로그인 상태, 모델 권한, 네트워크, 사용량 제한 중 하나가 문제일 가능성이 큽니다. 에러 문장 전체를 복사해 질문하세요.

질문할 때 Codex나 운영팀에 보내기 좋은 문장

코치 OS 설치 중 아래 단계에서 막혔어.
실행한 명령:
에러 문장:
현재 폴더에서 보이는 파일 목록:
node -v / npm -v 결과:
내 운영체제:
Codex 인증 토큰이나 auth.json 내용은 공유하지 않을게.