Day 1 · 설치 실행 안내서

어디를 열고
무엇을 확인할지

터미널 명령을 직접 타이핑하지 않습니다. 안내서의 문장을 복사해 Codex와 작업하고, GitHub Desktop에서 변경과 첫 업로드를 눈으로 확인하세요.

macOS · Windows GitHub 계정·Desktop · Git 저장소 · Codex 앱 · Node.js·npm·npx · 스킬 · Vercel 공식 문서 확인 · 2026-07-27

처음에는 다섯 곳만 사용합니다

  1. 브라우저 — 이 안내서와 로그인 화면을 봅니다.
  2. Codex 앱 — 프로젝트 폴더를 열고 AI와 대화합니다.
  3. GitHub Desktop — 변경점과 온라인 업로드 상태를 확인합니다.
  4. 파일 창 — 내 프로젝트 폴더를 만들고 위치를 확인합니다.
  5. 터미널 — 스킬 설치 명령을 한 번 붙여 넣습니다.
터미널은 설치할 때 한 번만 씁니다

명령을 외우거나 직접 타이핑하지 않습니다.

진행자와 함께 터미널을 열어 이 안내서에서 명령을 복사해 붙여 넣습니다.

0 / 8

준비 순서

앞 단계의 통과 기준을 확인한 뒤 다음으로 갑니다. 오류가 나면 같은 버튼이나 승인을 반복하지 말고 맨 아래 도움 요청 양식을 사용하세요.

GitHub 계정과 GitHub Desktop을 준비합니다

설치보다 먼저 권한, 이메일, 계정과 온라인 저장소 화면을 준비합니다.

  1. 이 노트북에 프로그램을 설치할 수 있는지 확인합니다.
  2. 수업 중 바로 열어 볼 수 있는 개인 이메일을 준비합니다.
  3. 계정이 없다면 GitHub 가입 페이지에서 개인 계정을 만듭니다. 무료 계정이면 충분합니다.
  4. GitHub가 보낸 메일의 확인 링크를 열어 이메일 주소 인증을 마칩니다.
  5. 이미 계정이 있다면 로그인합니다. 새 기기 확인이 나오면 본인 이메일이나 GitHub Mobile에서 직접 승인합니다.
  6. 새 저장소 만들기 화면이 열리는지 확인합니다. 저장소는 6단계에서 GitHub Desktop으로 만듭니다.
  7. GitHub Desktop 공식 다운로드에서 앱을 설치하고 같은 GitHub 계정으로 로그인합니다.
  8. ChatGPT와 Vercel에 로그인할 계정도 준비하고 브라우저, Codex 앱, GitHub Desktop과 파일 창을 열어 둡니다.
인증 정보는 본인만 봅니다 비밀번호, 이메일 확인 코드, 2단계 인증 코드와 복구 코드는 Codex·멘토·동료에게 보여 주지 않습니다.
2단계 인증 GitHub가 권장하는 보안 설정입니다. 수업 통과 조건은 아니며, 설정한다면 복구 코드를 개인 저장 공간에 보관합니다.
공용 컴퓨터라면 수업이 끝난 뒤 브라우저의 GitHub·Vercel과 GitHub Desktop·Codex에서 반드시 로그아웃합니다.

Codex 앱을 설치하고 로그인합니다

프로젝트 폴더 안에서 함께 일할 코딩 에이전트입니다.

macOS · 공식 앱 다운로드 페이지에서 macOS용 앱을 내려받아 설치합니다.

  1. 설치한 앱을 열고 Continue to sign in을 선택합니다.
  2. 브라우저에서 ChatGPT 계정으로 로그인한 뒤 앱으로 돌아옵니다.
  3. 앱 위쪽의 메뉴에서 Codex를 선택합니다.
이름이 달라도 맞습니다 공식 다운로드 페이지에서는 ChatGPT 데스크톱 앱으로 안내합니다. 앱 안에서 Codex를 선택해 사용합니다.

내 프로젝트 폴더에서 첫 응답을 확인합니다

설치만 끝내지 않고 실제 작업 위치에서 한 번 대화합니다.

  1. Finder에서 my-small-service 폴더를 만듭니다.
  2. Codex 앱에서 Cmd + O를 누릅니다.
  3. 방금 만든 폴더를 선택해 엽니다.

Codex 입력창에 아래 문장을 붙여 넣습니다.

이 폴더에 무엇이 있는지 설명해 줘. 파일은 아직 만들거나 바꾸지 마.

Codex에게 개발 환경을 확인해 달라고 합니다

명령은 직접 입력하지 않고 확인할 내용과 결과만 읽습니다.

입력창 아래 권한 메뉴에 Ask for approval이 보이면 선택한 뒤, 아래 문장을 Codex 입력창에 붙여 넣습니다. 해당 메뉴가 보이지 않으면 설정을 바꾸지 말고 그대로 진행합니다.

이 폴더에서 웹 프로젝트를 만들 준비가 되었는지 확인해 줘. Node.js, npm, npx, Git의 설치 여부와 버전만 확인해. 파일이나 설정은 만들거나 바꾸지 말고, 프로그램도 설치하지 마. 명령을 실행하기 전에는 무엇을 확인하는지 쉬운 말로 설명하고 내 승인을 기다려. 결과는 ‘준비됨 / 설치 필요 / 확인 실패’로 나눠 표로 보여 줘.
승인 창이 나오면 버전을 확인하는 작업인지 설명을 먼저 읽습니다. 설치·삭제·설정 변경이라고 적혀 있으면 승인하지 말고 멘토를 부릅니다.
Node.js·npm·npx 설치 필요 결과 화면을 멘토에게 보여 준 뒤 5단계로 갑니다. Git 설치 필요가 나오면 혼자 해결하지 말고 Git 공식 설치 페이지를 멘토와 함께 확인합니다.

Node.js가 없다면 LTS 버전을 설치합니다

Node.js를 설치하면 npm과 npx도 함께 준비됩니다. 이미 준비됐다면 설치는 건너뛰고 확인만 합니다.

  1. 4단계에서 Node.js, npm 또는 npx가 설치 필요로 나왔을 때만 진행합니다.
  2. 멘토와 함께 Node.js 공식 다운로드를 엽니다.
  3. LTS로 표시된 버전의 macOS용 Installer를 내려받습니다.
  4. 내려받은 설치 파일을 열고 화면의 기본 안내에 따라 설치를 마칩니다.
  1. 열려 있던 터미널과 Codex 앱을 완전히 닫았다가 다시 엽니다.
  2. Codex에서 my-small-service 폴더를 다시 열고 아래 문장을 붙여 넣습니다.
Node.js 설치가 끝났는지 확인해 줘. node --version, npm --version, npx --version을 차례로 실행하기 전에 무엇을 확인하는지 쉬운 말로 설명하고 내 승인을 기다려. 파일이나 설정은 만들거나 바꾸지 말고, 프로그램도 추가로 설치하지 마. 세 명령의 결과를 ‘준비됨 / 확인 실패’로 나눠 표로 보여 줘. 확인 실패라면 추측으로 고치지 말고 오류 원문과 다음 확인 한 단계만 알려 줘.
npx는 따로 설치하지 않습니다 Node.js 공식 Installer로 설치하면 npm이 함께 준비되고, npx는 npm 명령줄 도구에서 사용할 수 있습니다.
이미 모두 준비됨이라면 Node.js를 다시 설치하지 않습니다. 위 확인 문장으로 세 버전만 확인하고 통과 표시를 합니다.

Git 변경을 연습하고 첫 커밋을 GitHub에 올립니다

로컬 복구 지점을 만든 뒤 변경점 확인·되돌리기·비공개 첫 업로드까지 해봅니다.

  1. 4단계에서 Git이 준비됨으로 확인된 경우에만 진행합니다.
  2. Codex 입력창에 아래 문장을 붙여 넣습니다.
이 폴더를 수업 프로젝트용 Git 저장소로 준비해 줘. 먼저 현재 상태를 확인하고, 저장소가 아니라면 무엇을 할지 쉬운 말로 설명해. README.md와 웹 프로젝트용 .gitignore 초안을 제안하되, 내가 승인하기 전에는 파일을 만들거나 커밋하지 마. 내가 승인하면 저장소 초기화, 두 파일 생성, 첫 커밋까지 진행해. Git 사용자 이름이나 이메일이 없으면 전역 설정을 바꾸지 말고 이 저장소에만 설정할 값을 물어봐. 끝나면 저장소 여부, 마지막 커밋, 아직 커밋하지 않은 변경을 표로 보여 줘.
  1. Codex가 설명한 대상이 현재 my-small-service 폴더인지 확인합니다.
  2. README.md와 .gitignore에 들어갈 내용을 읽고 승인합니다.
  3. 마지막 표에서 저장소, 첫 커밋과 현재 변경 상태를 확인합니다.
  4. GitHub Desktop에서 File → Add Local Repository를 선택하고 my-small-service 폴더를 엽니다.

아래 문장으로 변경점 확인과 되돌리기를 한 번 연습합니다.

Git 연습을 할게. README.md 맨 아래에 ‘Git 연습용 한 줄’만 추가하고 커밋하지 마. 바뀐 파일과 추가한 한 줄을 설명한 뒤 멈춰. 내가 GitHub Desktop의 Changes 화면에서 확인하고 ‘돌려줘’라고 말하면, 방금 추가한 그 한 줄만 원래대로 되돌려. 다른 파일이나 이전 커밋은 건드리지 말고, 끝나면 아직 커밋하지 않은 변경이 없는지 보여 줘.
  1. GitHub Desktop의 Changes에서 README에 한 줄만 추가되었는지 확인합니다.
  2. Codex에 돌려줘라고 입력한 뒤 Changes 목록이 비었는지 확인합니다.
  3. GitHub Desktop에서 Publish repository를 선택합니다.
  4. Keep this code private를 선택한 상태로 게시하고 View on GitHub를 엽니다.
  5. 브라우저에서 README와 첫 커밋이 보이는지 확인합니다.
처음에는 비공개로 둡니다 공개가 필요한 시점과 공개할 파일을 확인하기 전에는 Keep this code private를 해제하지 않습니다.
저장소에 넣지 않습니다 .env, API 키, 비밀번호, 개인정보, 공개 권한이 없는 원본 이미지·영상과 큰 작업 파일은 프로젝트 밖의 개인 저장 공간에 둡니다.

Matt Pocock 스킬 전체를 복사해 설치합니다

스킬은 AI용 작업 안내서입니다. AI는 스킬에 따라 기획·구현·검토처럼 반복되는 일을 같은 순서로 진행합니다.

  1. 5단계에서 Node.js, npm과 npx가 준비됨으로 확인된 경우에만 진행합니다.
  2. 진행자와 함께 my-small-service 프로젝트 폴더 위치에서 터미널을 엽니다.
  3. 아래 명령 전체를 복사해 터미널에 붙여 넣고 Enter를 한 번 누릅니다.
npx skills@latest add mattpocock/skills --skill '*' --agent codex --copy --yes
  1. 파일 창에서 .agents/skills 폴더와 여러 스킬 폴더가 생겼는지 확인합니다.
  2. Codex에서 프로젝트를 다시 열고 새 대화를 시작합니다.
  3. $setup-matt-pocock-skills를 입력하고 수업에서 서비스 설계서와 작업을 프로젝트 문서로 관리한다고 답합니다. 모르는 선택지는 진행자에게 보여 줍니다.
  4. $ask-matt를 입력해 사용할 스킬을 안내하는지 확인합니다.
방금 스킬 설치와 설정으로 바뀐 파일을 설명해 줘. 비밀번호, 토큰, API 키 같은 비밀정보가 포함되지 않았는지 확인해. 내가 변경 내용을 확인하고 승인하면 이번에 바뀐 파일만 커밋해. 원격 저장소에는 아직 올리지 말고, 끝나면 마지막 커밋과 아직 커밋하지 않은 변경이 있는지 보여 줘.
  1. GitHub Desktop에서 커밋 내용을 다시 확인하고 Push origin을 선택합니다.
  2. View on GitHub에서 마지막 커밋이 같은지 확인합니다.
설치와 설정은 다릅니다 위 명령은 스킬 파일을 가져옵니다. $setup-matt-pocock-skills는 이 프로젝트에서 서비스 설계서와 작업 문서를 어떻게 관리할지 정합니다.
오류가 보이면 명령을 반복 실행하지 말고 오류 원문을 그대로 멘토에게 보여 주세요. 비밀번호나 토큰이 보이면 먼저 가립니다.

Vercel 계정에 로그인합니다

오늘은 계정만 확인합니다. 배포 도구는 아직 설치하지 않습니다.

  1. Vercel 로그인 페이지를 엽니다.
  2. 수업에 사용할 이메일 또는 GitHub 계정으로 로그인합니다.
  3. 대시보드가 열리는지 확인합니다.
배포는 Day 4에 Day 4 배포 Runbook에서 최종 커밋, GitHub 업로드, Vercel 연결과 공개 주소 검사를 차례로 진행합니다.

오늘의 통과 기준

설치가 남아 있어도 수업을 이어갈 수 있도록 목표 통과와 최소 통과를 따로 둡니다.

목표 통과

  • GitHub 가입과 이메일 확인을 마치고 GitHub Desktop에 로그인했습니다.
  • Codex 앱으로 내 프로젝트 폴더를 열고 응답을 한 번 받았습니다.
  • Codex가 Node.js, npm, npx와 Git의 준비 상태를 표로 보여 줬습니다.
  • Node.js가 필요했다면 LTS 버전을 설치하고 node, npm과 npx의 버전을 확인했습니다.
  • 변경점 확인과 되돌리기를 연습했고 첫 커밋을 GitHub 비공개 저장소에 올렸습니다.
  • Matt Pocock 스킬이 .agents/skills에 설치되고 $ask-matt가 응답했으며 변경을 GitHub에 올렸습니다.
  • Vercel 대시보드에 로그인했습니다.

최소 통과

  • 내 기기 또는 짝 기기에서 Codex 응답을 한 번 봤습니다.
  • 남은 설치의 실패 원인 한 줄과 Day 2 첫 해결 단계를 적었습니다.

막히면 이렇게 요청합니다

“안 돼요” 대신 환경, 누른 버튼, 오류 원문, 기대와 실제를 함께 전달합니다.

공유 전에 가릴 것

  • API 키와 토큰
  • 비밀번호와 인증 코드
  • 개인 이메일과 개인 경로
  • 공개 권한이 없는 이미지·영상과 개인정보

도움 요청 양식

내 환경:
지금 진행한 단계:
누른 버튼 또는 승인한 작업:
오류 원문:
기대한 결과:
실제 결과:

다음 한 단계만 알려 줘.

공식 안내

이 안내서는 아래 공식 문서를 바탕으로 만들었습니다. 수업 직전 변경 여부를 다시 확인합니다.