보너스 트랙 — 오늘 쓰던 ChatGPT를 내 컴퓨터 파일까지 (Codex 세팅 가이드)

가져가는 세팅입니다. 수업이 끝난 뒤 집에서도 그대로 쓰고, 다음 클래스(A2A·예약·오케스트레이션)의 베이스가 됩니다. Codex는 오늘 쓰던 같은 ChatGPT Plus 계정으로 동작하는 OpenAI 공식 도구입니다. 추가 결제·API 키가 필요 없습니다. 공식 문서: https://developers.openai.com/codex

1. Codex란?

지금까지 쓴 웹 ChatGPT는 채팅창 안에서만 일합니다. 답은 잘하지만, 내 컴퓨터의 진짜 폴더·파일을 직접 열고 고치지는 못합니다. 결과는 화면에서 복사하거나 내려받아야 했습니다.

Codex는 여기에 손·발을 붙입니다. 내 컴퓨터 터미널에서 폴더를 직접 열어 파일을 읽고 고칩니다.

비유하면 — 웹 ChatGPT가 말로 알려주는 비서라면, Codex는 내 폴더에 들어와 직접 손대는 비서입니다.

2. 설치 + 로그인 (약 5분)

준비물

Node.js 22 이상 — https://nodejs.org
오늘 쓰던 ChatGPT Plus 계정 그대로 (새 결제·API 키 필요 없음)

설치

macOS / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 또는 (Node 22+) npm install -g @openai/codex

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
# 또는 (Node 22+) npm install -g @openai/codex

npm 패키지 이름은 반드시 @openai/codex 입니다. (codex 만 치면 전혀 다른 옛 패키지가 깔립니다.)

3. 내 폴더에서 시켜보기

웹 ChatGPT와 달리, Codex는 지금 열려 있는 폴더의 파일을 직접 읽고 고칩니다.

폴더 열기 — 데모팩을 푼 폴더로 이동
```
cd 내폴더
codex
```
자연어로 시키기 (오늘 만든 프롬프트 그대로)

이 폴더의 agent2-한서윤-킥오프-STT.md를 agent2-회의록-양식.md 형식에 맞춰 정리해서 회의록.md로 저장해줘.
결과 — 웹 ChatGPT와 달리, 내 폴더에 실제 파일(회의록.md) 이 생기고 수정됩니다.

오늘 웹에서 만든 4개 프롬프트(디자인·회의록·분석·리서치)를 모두 같은 방식으로 내 폴더에서 굴릴 수 있습니다.

안전하게 쓰기

바꾸기 전 폴더를 백업하거나, git을 쓴다면 작업 전후로 체크포인트(커밋) 를 만듭니다.
Codex가 무엇을 바꿀지 확인하고 진행합니다. 한 번에 큰 변경보다 작은 단위로.

4. 이어지는 흐름 맛보기 (다음 클래스 예고)

오늘 만든 4개 워크플로우를 내 폴더에서 그대로 굴립니다.
OS 스케줄러로 정해진 시각 자동 실행까지 걸 수 있습니다.
- macOS·Linux: cron (예: 매주 월요일 08:00에 리서치 브리핑 실행)
- Windows: 작업 스케줄러(Task Scheduler)
사람이 복붙하지 않고 에이전트끼리 결과를 이어 돌리는 A2A·예약·오케스트레이션은 다음 클래스에서 본격적으로 다룹니다. 오늘 보너스는 그 맛보기입니다.

5. 자주 막히는 곳

증상	조치
`codex` 명령을 못 찾음	Node.js 22 이상인지 확인(`node -v`) 후 재설치. 터미널 새로 열기
`npm install` 후에도 안 됨	패키지가 `@openai/codex` 가 맞는지 확인 (옛 `codex` 패키지 주의)
로그인이 안 됨	`codex` 재실행 → Sign in with ChatGPT 선택, Plus 계정 로그인 확인
사용량 한도 도달	5시간 창이 지나면 회복. 큰 작업은 작은 단위로 나눠 실행
파일이 의도와 다르게 바뀜	미리 만든 백업/커밋으로 되돌리기. 다음엔 "무엇을 바꿀지 먼저 보여줘"라고 요청

자세한 내용은 developers.openai.com/codex 의 Quickstart / CLI 문서를 참고하세요.

Codex 세팅 가이드 (설치 + 로컬 폴더 작업).md