0주차 · 개강 전 준비
개강 전에 도구를 설치합니다
영상 8개 · 총 14분. 하루에 다 하지 않으셔도 됩니다. 나눠서 하셔도 진행 상태가 남습니다.
단계마다 영상을 보고, 아래에 적힌 확인 방법으로 잘 됐는지 직접 보시면 됩니다. 막히면 그 자리에 있는 안내를 먼저 읽어 보세요.
영상 8개는 모두 윈도우 기준으로 촬영했습니다. Mac을 쓰시면 설치 화면이 다르게 보입니다. 잘못하신 것이 아닙니다. Mac 전용 영상은 따로 만들지 않습니다 — 치는 명령은 두 운영체제가 같기 때문입니다. 영상은 순서를 보는 용도로 쓰시고, 각 단계의 확인 명령으로 결과만 맞추시면 됩니다. 화면이 달라 막히시면 아래 도움 요청으로 알려 주세요.
영상과 화면 설명은 모두 윈도우 기준입니다.
1부 · 도구 설치
컴퓨터에 필요한 도구를 설치합니다
- 확인터미널에 아래를 입력하세요
node -v
→ v로 시작하는 버전 번호가 표시되면 됩니다
막히면설치한 뒤 터미널을 새로 열었는지 확인하세요.
그래도 안 되면 자주 막히는 증상
- 확인터미널에 아래를 입력하세요
npm -v
→ 숫자.숫자.숫자 형태의 버전 번호가 표시되면 됩니다
막히면명령을 찾을 수 없다면 터미널을 새로 열고, 그래도 안 되면 컴퓨터를 다시 시작해 보세요.
그래도 안 되면 자주 막히는 증상
- 확인터미널에 아래를 입력하세요
git --version
→ git version 으로 시작하는 줄이 나오면 됩니다
막히면설치한 뒤 터미널을 새로 열었는지 확인하세요.
그래도 안 되면 자주 막히는 증상
- 확인터미널에 아래를 입력하세요
codex --version
→ 버전 번호가 표시되면 됩니다
막히면설치 명령이 오류 없이 끝났는지 확인하세요. 권한 오류나 실행 정책 오류가 나오면 설정을 임의로 바꾸지 말고 화면 전체를 보내 주세요.
그래도 안 되면 자주 막히는 증상
- 확인터미널에 아래를 입력하세요
codex --version
→ 업데이트 명령이 오류 없이 끝나고 버전 번호가 다시 표시되면 됩니다
막히면업데이트 중 권한 오류가 나오면 임의로 권한을 올리지 말고 화면 전체를 보내 주세요.
그래도 안 되면 자주 막히는 증상
2부 · 계정 준비
ChatGPT 계정을 만듭니다
3부 · 연결 확인
설치한 도구와 계정을 잇습니다
- 확인터미널에 아래를 입력하세요
codex login status
→ Logged in using ChatGPT 가 보이면 됩니다
막히면브라우저에서 로그인한 뒤 터미널이 멈춘 것 같다면, 같은 계정으로 로그인했는지와 브라우저 탭에 완료 표시가 있는지 확인하세요.
그래도 안 되면 자주 막히는 증상
터미널을 먼저 엽니다
아래 명령은 터미널이라는 창에 입력합니다. 치는 명령은 윈도우와 맥이 같고, 여는 프로그램만 다릅니다.
| 운영체제 | 여는 것 | 열면 이렇게 보입니다 |
|---|---|---|
| 윈도우 | PowerShell — 시작을 누르고 PowerShell 을 검색합니다 | PS C:\Users\내이름> |
| 맥 | 터미널 — Command+Space 를 누르고 터미널 을 검색합니다 | 내이름@맥 ~ % |
윈도우에서 「명령 프롬프트(cmd)」를 열면 1강에서 쓰는 pwd 가 동작하지 않습니다. PowerShell 을 여세요.
마지막 확인
여섯 줄을 한 줄씩 입력하세요. 윈도우 기본 터미널에서는 여러 줄을 한 번에 이어 붙일 수 없고, 한 줄씩이면 어디서 멈췄는지도 그대로 드러납니다. 여섯 줄이 모두 오류 없이 값을 출력하면 설치가 끝난 것입니다.
버전 숫자는 사람마다 다릅니다. 아래에 적은 것은 출력의 형태일 뿐이니, 숫자가 다르다고 실패한 것이 아닙니다.
node -v→ v로 시작하는 버전 번호npm -v→ 숫자.숫자.숫자git --version→ git version 으로 시작하는 줄codex --version→ 버전 번호codex login status→ Logged in using ChatGPTcodex doctor --summary→ 진단 요약 (문제 없음)
설치가 끝나면, 아직 한 가지 남았습니다
수업에 쓸 시작 파일을 받아야 합니다. 시작 파일은 수강생에게만 드리기 때문에 이 페이지에는 없습니다. 로그인한 뒤 수업 목록에서 1강을 여세요.
자주 막히는 증상
아래는 설치에서 가장 많이 나오는 증상입니다. 보안 경고나 실행 정책 경고를 이유 없이 허용하지 마세요.
| 증상 | 먼저 확인 | 안전한 다음 조치 |
|---|---|---|
| node 또는 npm 을 찾을 수 없음 | 설치한 뒤 터미널을 새로 열었는가 | Node.js LTS 설치를 다시 확인하고 컴퓨터를 재시작합니다 |
| git 을 찾을 수 없음 | Git 설치 뒤 새 터미널을 열었는가 | 공식 설치 파일로 설치했는지 확인하고 컴퓨터를 재시작합니다 |
| codex 를 찾을 수 없음 | npm 설치 명령이 오류 없이 끝났는가 | 오류 전체와 npm -v 결과를 함께 보내 주세요 |
| Mac 에서 npm 권한 오류 | 오류에 EACCES 가 있는가 | 무작정 sudo 를 붙이지 말고 화면 전체를 보내 주세요 |
| Windows 에서 스크립트 실행 정책 오류 | PowerShell 오류 문구 | 보안 설정을 임의로 낮추지 말고 문구 전체를 보내 주세요 |
| 브라우저 로그인 뒤 터미널이 멈춤 | 같은 계정인지, 브라우저 탭에 완료 표시가 있는지 | 터미널을 닫기 전에 오류 화면을 캡처해 주세요 |
혼자 안 되면 보내 주세요
30분 넘게 같은 자리에서 막히면 혼자 붙들지 마세요. 아래 다섯 줄을 채워 kjh@maipharm.com 으로 보내 주시면 원인을 더 빨리 찾을 수 있습니다.
개강 전 도움 요청 양식
운영체제: Mac / Windows / WSL2 막힌 단계: 입력한 명령: 화면에 나온 오류 전체: node / npm / git / codex 버전 중 확인된 것:
비밀번호 · 로그인 인증 코드 · API 키는 보내지 않습니다. 화면에 그런 값이 보이면 가리고 보내 주세요. 저희가 물어보는 일도 없습니다.