RUN 실행학교 실전 1기 준비 시작

PREP GUIDEBOOK · 수업 전 1회 완료

설치는 오늘 끝내고, 첫날엔 바로 실행합니다.

ChatGPT 유료가입, Codex 설치, 기본 테스트까지 한 번에 끝내는 실전 1기 사전 준비 가이드북입니다. 어려운 용어는 줄이고, 수강생이 실제로 눌러야 할 것과 확인해야 할 것만 남겼습니다.

1단계부터 보기 테스트 과정 먼저 보기

Start Here

오늘 완료할 3가지

체크 상태는 이 브라우저에 저장됩니다. 다른 기기에서는 다시 체크해야 하지만, 진행 흐름을 잃지 않도록 도와줍니다.

1

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

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

10-20분
권장 선택

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

확인할 것
  • 수업에 쓸 이메일로 로그인했는지
  • 결제 후 플랜명이 계정 화면에 보이는지
  • 회사 계정이면 관리자가 Codex 사용을 허용했는지
  1. ChatGPT 플랜 페이지에서 Plus, Pro, Business 중 본인 상황에 맞는 플랜을 선택합니다.
  2. 결제 후 같은 브라우저에서 ChatGPT를 한 번 열고, 새 대화가 정상적으로 시작되는지 확인합니다.
  3. 비밀번호 로그인 계정이라면 MFA, 즉 2단계 인증을 켜 두는 것을 권장합니다. 계정을 더 안전하게 지키는 장치입니다.
2

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

Codex는 터미널에서 실행하는 코딩 에이전트입니다. selected folder, 즉 지금 열어 둔 폴더 안의 파일을 읽고 고치고 명령을 실행할 수 있습니다.

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

macOS는 터미널, Windows는 PowerShell을 사용합니다.

Node / npm 설치 도구

npm으로 Codex CLI를 설치합니다. 실전 1기 하네스는 Node 20 이상을 씁니다.

Codex CLI 로컬 실행 파트너

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

node -v
npm -v
npm install -g @openai/codex
codex --version
codex
설치 중 비밀번호, 토큰, API key, ~/.codex/auth.json 내용을 채팅방이나 단체방에 붙여넣지 마세요. 로그인 캐시는 비밀번호처럼 다뤄야 합니다.
macOS 수강생

터미널 앱을 열고 위 명령을 순서대로 실행합니다. npm이 없으면 Node.js LTS를 먼저 설치한 뒤 다시 진행하세요.

Windows 수강생

PowerShell을 열고 같은 명령을 실행합니다. Windows에서는 PowerShell 네이티브 실행 또는 WSL2 환경 중 하나를 선택할 수 있습니다.

3

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

codex를 처음 실행하면 브라우저 로그인 흐름이 열립니다. 수업에서 결제한 ChatGPT 계정과 같은 계정으로 로그인하세요.

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

기본 테스트는 “파일 만들기 → 읽기 → 수정”까지 합니다.

설치만 끝난 상태는 아직 준비 완료가 아닙니다. Codex가 내 폴더에서 실제로 작업하는지, 승인 요청을 이해했는지 확인해야 수업 첫날 막히지 않습니다.

10-15분 
mkdir run-academy-codex-test
cd run-academy-codex-test
codex
Codex 안에 붙여넣을 첫 번째 테스트 프롬프트

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

현재 폴더를 확인한 뒤 README.md 파일을 만들어줘.
파일에는 "실행학교 실전 1기 Codex 테스트 완료", 내 운영체제, node -v, npm -v 확인 결과를 표로 정리해줘.
명령을 실행하기 전에는 무엇을 확인하는지 한 문장으로 알려줘.
두 번째 테스트 프롬프트

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

README.md를 읽고, 다음 수업 전 내가 준비해야 할 것을 3줄 체크리스트로 추가해줘.
마지막에는 "테스트 통과"라고 적어줘.
성공 기준
  • README.md 파일이 생김
  • Node/npm 버전이 파일 안에 적힘
  • 두 번째 요청 후 체크리스트와 “테스트 통과”가 추가됨
캡처해서 보관할 화면
  • codex --version 실행 결과
  • Codex가 만든 README.md
  • 개인 토큰이나 인증 파일이 보이지 않는 터미널 화면
5

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

실전 1기는 “AI가 대신 해줬다”가 아니라 “내가 AI를 조정해서 판단했다”는 흔적이 중요합니다. 시작 전 이 4가지만 익혀두세요.

5분
/status 현재 상태 확인

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

/model 모델 선택

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

Approval 승인 요청 읽기

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

수업 폴더 밖의 개인 파일, 다운로드 폴더 전체, 비밀번호가 들어간 파일을 Codex에게 무심코 읽히지 마세요. Codex는 강력한 도구라서 “어느 폴더에서 실행하는지”가 곧 안전장치입니다.
6

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

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

상시
codex: command not found

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

npm: command not found

Node.js가 없는 상태입니다. Node.js LTS를 설치한 뒤 새 터미널에서 node -v, npm -v를 확인하세요.

브라우저 로그인이 안 열림

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

사용량 제한 메시지

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