Mac은 터미널(Spotlight에서 "터미널"), Windows는 PowerShell(시작 메뉴에서 검색). 새로 깔 건 없고 이미 들어 있습니다.
~/자료/설치
설치하고
로그인하기까지.
수업에서 가장 많은 시간을 잡아먹는 30분입니다. 미리 해오면 첫 시간부터 만들기 시작할 수 있습니다. 둘 중 하나만 깔아도 수업은 끝까지 따라옵니다.
2026년 9월 9일 공식 문서 확인
준비물 세 가지
Codex는 ChatGPT 계정, Claude Code는 Claude 구독(Pro·Max·Team·Enterprise) 또는 Console 계정이 필요합니다. 무료 계정으로는 실행이 안 됩니다.
바탕화면에 폴더 하나 만들어두세요. 에이전트는 실행한 위치의 폴더를 자기 작업장으로 씁니다.
Codex 설치하기
OpenAI의 코딩 에이전트입니다. ChatGPT 유료 플랜에 포함돼 있어서, 이미 ChatGPT를 쓰고 있다면 추가 결제 없이 시작할 수 있습니다.
Mac · Linux
curl -fsSL https://chatgpt.com/codex/install.sh | shHomebrew를 쓴다면 brew install --cask codex도 됩니다.
Windows
공식 문서에 Windows 탭이 따로 있습니다. 명령이 바뀔 수 있어 여기 옮겨 적지 않았습니다 — 아래 Codex 설치 문서 링크에서 Windows 탭을 그대로 따라 하세요.
npm으로 깔 수도 있습니다(npm i -g @openai/codex, Node 22 이상). ⚠️ 패키지 이름을 조심하세요 — 그냥 codex는 관계없는 옛날 패키지입니다. 반드시 @openai/가 앞에 붙어야 합니다.
실행과 로그인
작업할 폴더로 이동한 뒤 codex를 칩니다. 첫 실행에서 Sign in with ChatGPT를 고르면 브라우저가 열립니다.
| 안에서 치는 명령 | 하는 일 |
|---|---|
| /init | 이 폴더의 설명서(AGENTS.md)를 만듭니다. 처음 한 번 |
| /model | 모델과 생각의 깊이를 고릅니다 |
| /permissions | 어디까지 허락할지 — 읽기 전용 / 자동 / 전체 |
| /plan | 바로 고치지 말고 계획부터 세우게 합니다 (Shift+Tab도 같은 기능) |
| /review | 바뀐 것을 검토하고 문제를 찾습니다 |
| /status | 지금 어떤 설정으로 돌고 있는지 |
Claude Code 설치하기
Anthropic의 코딩 에이전트입니다. 설치 방식이 여러 개인데 맨 위 것 하나만 하면 됩니다. 이 방식은 알아서 최신으로 갱신됩니다.
Mac · Linux · WSL
curl -fsSL https://claude.ai/install.sh | bashHomebrew를 쓴다면 brew install --cask claude-code. 단, 이쪽은 자동 갱신이 안 돼서 가끔 brew upgrade claude-code를 쳐야 합니다.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iexwinget install Anthropic.ClaudeCode도 됩니다. 그리고 Git for Windows를 같이 깔아두는 걸 권합니다 — 없으면 일부 기능이 제한됩니다.
⚠️ PowerShell과 CMD는 다른 창입니다. 프롬프트에 PS C:\가 보이면 PowerShell, C:\만 보이면 CMD입니다. 'irm'을 인식할 수 없다는 메시지가 나오면 CMD에 치고 있는 겁니다 — PowerShell을 여세요.
실행과 로그인
설치가 됐는지 먼저 확인하고, 작업 폴더에서 claude를 칩니다. 처음 실행하면 로그인 안내가 나옵니다.
| 안에서 치는 명령 | 하는 일 |
|---|---|
| /login | 계정을 바꾸거나 다시 로그인합니다 |
| /help | 쓸 수 있는 명령 목록 |
| /clear | 대화를 비웁니다. 얘기가 길어져 헤매기 시작하면 이걸 먼저 |
| /exit | 나가기 (Ctrl+D 두 번도 같음) |
| Shift+Tab | 권한 모드를 바꿉니다 — 물어보게 할지, 알아서 하게 할지 |
터미널을 껐다 켠 뒤에도 이어서 하려면 claude -c(가장 최근 대화 이어하기), claude -r(지난 대화 골라서 열기)를 쓰세요.
여기까지 됐으면 성공
-
버전이 찍힌다
codex --version또는claude --version을 쳤을 때 숫자가 나오면 설치는 끝난 겁니다. -
폴더 안에서 실행된다
작업 폴더로
cd한 뒤 실행하면, 화면 위쪽에 지금 위치한 폴더 경로가 보입니다. 여기가 맞는지 매번 확인하는 습관을 들이세요. 엉뚱한 폴더에서 시작해 엉뚱한 파일을 고치는 사고가 제일 흔합니다. -
말을 걸면 답한다
"이 폴더에 뭐가 있어?"라고 한글로 물어보세요. 파일 목록을 읽고 설명하면 준비 완료입니다.
여기서 자주 막힙니다
"command not found" · "인식할 수 없습니다"
설치는 됐는데 터미널이 아직 그걸 모르는 상태입니다. 새로 깐 프로그램의 위치는 창을 새로 열어야 반영됩니다.
터미널을 완전히 껐다가 다시 여세요. 그래도 안 되면 설치 명령을 한 번 더 실행하고 마지막 안내 문구를 읽어보세요.
설치 중에 비밀번호를 물어본다
컴퓨터 로그인 비밀번호입니다. 정상입니다.
타이핑해도 화면에 아무것도 안 보이는 게 정상입니다. 그냥 치고 엔터를 누르세요.
붙여넣은 명령이 두 줄로 잘려 실행된다
긴 명령을 복사할 때 줄바꿈이 섞여 들어간 경우입니다.
이 페이지의 검은 상자를 클릭해 한 줄씩 복사하세요. 여러 줄짜리는 위에서부터 한 줄씩 엔터로 실행합니다.
로그인 창이 열렸는데 다시 터미널로 안 돌아온다
브라우저에서 승인은 됐는데 터미널 창이 뒤에 가려져 있는 경우가 대부분입니다.
터미널 창을 직접 앞으로 꺼내보세요. 이미 로그인돼 있을 겁니다.
결제/구독이 없다고 나온다
둘 다 유료 플랜이 있어야 돌아갑니다. Codex는 ChatGPT 유료 플랜, Claude Code는 Claude Pro 이상 또는 Console 크레딧입니다.
둘 중 이미 쓰고 있는 쪽 하나만 고르세요. 수업은 어느 쪽으로도 끝까지 갑니다.
공식 문서
명령어는 바뀝니다. 이 페이지와 다르면 공식 문서가 맞습니다. 참고로 Codex 문서 주소가 최근 learn.chatgpt.com으로 옮겨졌습니다.