📗 코덱스 정석 — 비개발자를 위한 공부자료

먼저 읽기

PART A · 영상에 나오는 것들 — 왜 그런가

영상에서 한 문장으로 지나가는 것들의 배경입니다. 클로드 코드 편에서 배운 개념이 코덱스에서 어디까지 그대로이고, 어디부터 다른지 — 이 구분이 PART A 전체의 뼈대입니다.

A-1. 챗GPT와 코덱스는 무슨 사이인가

공식은 하나입니다 — 클로드 : 클로드 코드 = 챗GPT : 코덱스.

코덱스Codex

한 줄로 오픈AI(OpenAI)가 만든 코딩 에이전트 — 챗GPT를 만든 오픈AI의 모델(GPT-6 계열)에, 내 컴퓨터의 파일과 명령어를 다룰 손발을 붙인 제품. 이 모델들은 앱의 Chat 탭엔 없고 Work·Codex에서 고릅니다. 10월 개정

비유 챗GPT가 카운터에서 대답해주는 상담원이라면, 코덱스는 작업장에 들어와 결과물을 만들어주는 직원입니다.

나한테 왜 필요한가 1강의 접수표 다섯 칸, 챗봇↔에이전트 구분 — 전부 그대로 통합니다. 도구가 바뀌었지, 일 맡기는 법이 바뀐 게 아닙니다.

맥락 수집 → 실행 → 결과 검증을 스스로 반복하는 에이전트 루프도 동일합니다. 클로드 코드처럼 파일을 읽고, 고치고, 명령을 실행하고, 결과를 확인합니다.

📎 Codex 공식 문서 · openai/codex (GitHub)

[사실] 2026년 7월 9일, 코덱스가 챗GPT 데스크톱 앱에 병합됐습니다.
이제 코덱스는 별도 프로그램이라기보다 챗GPT 앱 안의 작업 모드에 가깝습니다. 이미 챗GPT 앱을 쓰고 있다면, 앱 위쪽 선택기에서 Codex를 고르고 폴더를 지정하면 코덱스입니다(같은 앱의 Work도 폴더를 다룰 수 있으니 선택기를 확인하세요). 터미널이 무서운 분에게는 이게 가장 쉬운 입구입니다(창구 비교는 B-1). 📎 What's new

앱 안은 세 갈래 — Chat · Work · Codex 10월 개정
7월(7/6~10 주)에 나온 ChatGPT Work는 문서·발표자료·스프레드시트 같은 결과물 위주로 일하는 모드입니다. 깃·명령어 같은 기술 내용은 숨기고 쉬운 말로 보고하는 것이 코덱스와의 차이이고, 사용량·요금은 코덱스와 함께 씁니다. 클로드로 치면 데스크톱 앱의 Cowork 자리입니다. 코드를 다룬다면 이 책의 코덱스 쪽이 기본입니다. 📎 ChatGPT Work vs Codex · Pricing

PowerShell — 코덱스 시작 화면 (재현)

codex

╭──────────────────────────────────╮

│ ● Codex — 무엇을 도와드릴까요? │

╰──────────────────────────────────╯

폴더: C:\Users\나\우리가게-폴더 · 모델: gpt-6.1-sol · 권한: Auto

▌ 여기에 접수표(의뢰문)를 쓰면 됩니다 — 1강에서 배운 그대로.

⚠️ 이 화면은 공식 문서를 기준으로 한 재현(목업)입니다 — 버전·계정에 따라 실제 화면의 문구·배치가 다를 수 있습니다. 항상 내 화면의 글자를 직접 읽으세요.

한 줄로 기억하기
“챗GPT에는 질문하고, 코덱스에는 의뢰한다 — 클로드와 클로드 코드의 관계 그대로.”

A-2. 설치 — 윈도우에서 그냥 됩니다

설치는 PowerShell 한 줄입니다 — 이제 클로드 코드도 같습니다. 코덱스의 진짜 차이는 윈도우에서도 안전 칸막이(샌드박스)가 기본으로 작동한다는 점입니다. 10월 개정

설치 경로 — 내 상황에 맞는 줄 하나만 10월 개정

경로	명령/방법	누구에게
윈도우 CLI	`powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \| iex"` (PowerShell) — 실행 정책 오류를 피하는 공식 표기	이 시리즈의 기본 코스
윈도우 앱	Microsoft Store에서 ‘ChatGPT’ 설치(또는 다운로드 · 명령어로는 `winget install --id 9PLM9XGG6VKS -s msstore`) → 앱에서 Codex 선택 → 폴더 지정	터미널이 무서운 분
맥/리눅스	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	맥 사용자
맥 Homebrew	`brew install --cask codex` (업데이트는 `brew upgrade --cask codex`)	Homebrew를 이미 쓰는 분
npm	`npm install -g @openai/codex`	Node.js가 이미 있는 분
리눅스 앱 (미리보기)	챗GPT 데스크톱 앱 리눅스판 — 우분투·데비안은 `.deb`, 페도라는 `.rpm`. 컴퓨터 사용(Computer Use) 등 일부 기능은 아직 없음	리눅스에서 화면으로 쓰고 싶은 분

📎 Codex CLI · Windows app · Linux app

[사실] 윈도우 네이티브 정식 지원 — WSL 없이 됩니다.
공식 문서 원문: “It runs natively on Windows using PowerShell and the Windows sandbox, or you can configure it to run in WSL2.” 리눅스 가상 환경(WSL) 없이 PowerShell에서 바로 돌아가고, 샌드박스(작업 폴더 밖 쓰기 차단·무승인 네트워크 차단)도 윈도우용으로 정식 제공됩니다. 딱 하나 — 처음 샌드박스를 설정할 때 관리자 승인(UAC) 창이 뜰 수 있습니다. 코덱스를 설정하다 뜬 창인지 확인하고 승인하세요(회사 PC에서 막히면 IT팀에 문의). 10월 개정 📎 Windows sandbox

요금 — 무료로 시작됩니다pricing

한 줄로 코덱스는 챗GPT 전 요금제에 포함 — 무료(Free)·Go 계정으로도 간단한 작업을 체험할 수 있다.

비유 식당 멤버십에 배달 서비스가 딸려 오는 것 — 등급이 높을수록 배달 횟수가 늘어납니다.

나한테 왜 필요한가 “일단 깔아보세요”라고 말할 수 있습니다. 결제 없이 데스크톱 앱으로 먼저 체험해 볼 수 있다는 뜻입니다 — 단 공식 요금표는 무료·Go를 ‘데스크톱 앱의 GPT-6 Luna’로만 안내하므로, 이 시리즈의 터미널 실습은 Plus 이상을 전제로 하세요(무료 계정의 터미널 사용은 공식 문서에 명시돼 있지 않음). 10월 개정

무료·Go는 데스크톱 앱에서 GPT-6 Luna로 씁니다(계정마다 차례로 열리는 중). 클라우드 작업은 Plus부터이고, 이미지 생성은 무료에선 안 됩니다. 10월 개정

한도 — Plus·Business는 5시간마다 다시 채워지는 사용량에 주간 한도가 따로 붙을 수 있고, Pro는 현재 5시간 한도는 없지만 모델별 사용량 한도는 있습니다(다 쓰면 초기화 시각까지 그 모델을 못 씀). 다 쓰면 크레딧(요금제 사용량을 다 쓴 뒤 돈을 더 내고 사는 추가 사용권)을 충전해 이어 씁니다. 남은 양은 사용량 대시보드나 /status로 확인합니다.

정확한 한도는 모델·작업마다 다르고 자주 바뀌므로, 숫자는 외우지 말고 공식 요금 문서에서 그때그때 확인하세요.

⚠️ 틀리기 쉬운 지점 클로드 코드는 유료 플랜이 필요하지만 코덱스는 무료부터 열려 있습니다 — 다만 무료 한도로는 맛보기 수준입니다. 업무용이라면 유료 등급을 전제하세요.

📎 Pricing · Using Codex with your ChatGPT plan

💵 요금제 한눈에 — 2026-10-01 기준(미국 달러, 월) 10월 개정

요금제	월 요금	코덱스에서
Free	$0	코덱스 포함 · 데스크톱 앱 GPT-6 Luna(계정마다 차례로 열리는 중) · 클라우드·이미지 생성 제외
Go	$8	가벼운 작업용 · 데스크톱 앱 GPT-6 Luna(계정마다 차례로 열리는 중) · 클라우드 제외
Plus	$20	웹·터미널·IDE·iOS · 클라우드 · 5시간 한도 + 크레딧 충전
Pro 100	$100	Plus 전부 + 5시간 한도 없음 · 초고속(Ultrafast) 없음
Pro 200	$200	Pro 100보다 많은 사용량 · 초고속 없음
Pro 500	$500	세 Pro 중 사용량 최대 · GPT-6 Astra 초고속(Ultrafast)을 쓰는 유일한 개인 요금제
Business	1인당 월 $20(연간 결제) · 월 $25(월 결제)	2인 이상 · 업무 데이터 학습 제외가 기본

📎 Pricing · About ChatGPT Pro tiers

월 500달러 「Pro 500」은 뭐가 다른가 (2026-09-29 신설 · 처음엔 웹에서만 가입) 10월 개정

세 Pro 가운데 포함 사용량이 가장 많습니다.
GPT-6 Astra 초고속(Ultrafast)을 쓸 수 있는 유일한 개인 요금제입니다 — 답(글자)이 나오는 속도가 최대 8배(작업 전체 시간이 8배 줄지는 않음).
이와 별개로, 초고속으로 시킨 일은 같은 일이라도 요금제 사용량이 평소의 8배 깎입니다(따로 산 크레딧으로는 6배). 숫자 8이 겹칠 뿐 속도와 요금은 다른 이야기입니다.
Pro 100·200은 크레딧을 사도 초고속이 열리지 않습니다.
Pro 200에 새로 가입하면 사용량이 예전보다 적습니다 — 기존 가입자는 조건을 충족하면 10월 29일까지 예전 사용량을 유지합니다(조건은 공식 도움말).
Pro는 월결제만 됩니다(연간 결제 없음).

관찰·주장 비개발자의 수업·실습에는 과합니다 — 하루 종일 Astra로 큰 일을 돌리는 사람용입니다. 업무량이 많지 않다면 Plus로 시작하고, 부족할 때 크레딧 충전이나 상위 요금제를 검토하세요. 📎 About ChatGPT Pro tiers · Speed — Ultrafast

A-3. AGENTS.md — 접수표 세계관은 그대로, 벽보 이름만 다르다

1강에서 약속한 그대로입니다 — 작업장 벽에 거는 근무수칙, 이름만 AGENTS.md.

AGENTS.mdagent instructions

한 줄로 내가 직접 쓰는 상시 지시문 파일. 코덱스가 일을 시작할 때 자동으로 읽는다 — 클로드 코드의 CLAUDE.md와 같은 자리.

비유 작업장 벽의 명찰·근무수칙. 새 직원(새 세션)이 와도 매번 설명할 필요가 없습니다.

나한테 왜 필요한가 접수표 ①역할·⑤기준 칸에 늘 쓰는 내용을 여기 적어두면, 매번 접수표에 반복해서 쓸 필요가 없어집니다.

둘 수 있는 곳 — 내 계정 전체(~/.codex/AGENTS.md) / 프로젝트 폴더(./AGENTS.md) / 하위 폴더(중첩 지원). 클로드 코드와 비슷한 층 구조입니다.

읽는 방식도 같은 철학 — 덮어쓰지 않고 이어붙입니다(concatenate). 넓은 범위(계정·루트)부터 좁은 범위(현재 폴더) 순으로 이어붙고, 가까운 파일이 나중에 붙어 우선합니다.

/init 명령으로 초안을 자동 생성할 수 있는 것도 동일합니다.

잠깐만 계정 전체 규칙을 바꾸고 싶다면 ~/.codex/AGENTS.override.md — 있으면 원래 AGENTS.md 대신 읽고, 지우면 원래 규칙으로 돌아갑니다. 10월 개정

⚠️ 틀리기 쉬운 지점 읽는 총량에 기본 32KiB 상한(한글만이면 약 1만 자)이 있습니다(초과분은 잘림). 클로드 코드에서 배운 “200줄 미만, 긴 절차는 따로” 습관이 여기서도 정답입니다.

📎 AGENTS.md · Config reference (project_doc_max_bytes)

코덱스 — /init 으로 벽보 만들기 (재현)

/init

폴더를 둘러보는 중… 파일 7개 확인

✔ AGENTS.md 초안을 만들었습니다

├ 이 폴더는 무엇을 하는 곳인가

├ 지킬 규칙 (예: 원본은 지우지 말 것)

└ 자주 하는 작업 절차

내용은 초안입니다 — 열어서 내 가게 규칙으로 고치세요. 검증은 사장 몫.

1강의 벽보 장치와 똑같은 흐름입니다

⚠️ 공식 문서 기준 재현 — /init이 “AGENTS.md 뼈대를 현재 폴더에 생성”한다는 것은 공식 명령 목록의 [사실]이고, 화면의 세부 문구는 연출입니다.

[사실] AGENTS.md는 코덱스 전용이 아니라 업계 공용 표준입니다.
agents.md라는 공개 표준으로, 코덱스뿐 아니라 클로드 코드·제미나이 CLI·커서(Cursor)·코파일럿 등 20개 이상의 도구가 읽습니다. 형식도 자유로운 마크다운 — 필수 양식이 없습니다. 즉 벽보 한 장 잘 써두면 도구를 갈아타도 재산으로 남습니다. 특히 클로드 코드는 v2.1.277부터 CLAUDE.md가 없으면 AGENTS.md를 직접 읽습니다(클로드 코드 정석 A-3). 10월 개정 📎 agents.md (오픈 표준) · Claude Code — AGENTS.md

A-4. 손잡이 ① 모델 — GPT-6 세대

2강에서 배운 ‘건축사무소에서 누구에게 맡길까’ — 그 감각 그대로, 이름표만 바꿔 답니다.

코덱스에서 고르는 모델 (2026-10-01 기준 권장 라인업) 10월 개정

모델	급 (2강의 비유)	언제
`gpt-6-astra`	수석 설계사 — 가장 강력 (9/3 발표 · 9월 초부터 순차 제공)	코드·앱·리서치를 처음부터 끝까지 맡기는 가장 어려운 일. 한도가 빨리 닳습니다
`gpt-6.1-sol`	실무 에이스 — Astra에 가까운 성능을 더 싸게 (9/29 출시 · 공식 권장)	일상 업무 대부분, 오래 걸리는 긴 작업
`gpt-6-luna`	빠른 막내 — 가장 효율적 (9/22 출시)	요약·추출·분류처럼 정답 모양이 분명한 반복 작업. 무료·Go의 기본
`gpt-6-sol`	직전 에이스 (9/22 출시)	6.1 Sol이 아직 안 보이는 계정·도구에서

📎 Models · What's new

코덱스 — /model 피커 (재현)

/model

모델을 고르세요 (추론 깊이도 여기서 함께 정합니다)

↑↓ 이동 · Enter 선택 — 아래 버튼으로 체험해 보세요

선택: gpt-6.1-sol (실무 에이스)

⚠️ 공식 문서 기준 재현 — /model이 “활성 모델(가능하면 추론 깊이도)을 고르는” 명령이라는 것은 [사실], 목록의 화면 배치는 연출입니다. 요금제에 따라 보이는 목록이 다릅니다.

⚠️ 이름·숫자를 외우지 마세요 — 실제로 두 달 만에 다 바뀌었습니다 10월 개정
이 책 초판(8/4)의 GPT-5.6 Sol·Terra·Luna는 두 달 사이 GPT-6 세대로 통째로 교체됐고, 중간급 Terra는 새 세대에 아예 없습니다. 그래도 수석 / 에이스 / 막내 세 칸은 그대로 — “이름은 바뀌어도 급은 평생 간다”는 원칙이 그대로 증명됐습니다. 공식 권장은 복잡한 일엔 GPT-6.1 Sol, 정답 모양이 분명한 반복 작업엔 Luna입니다. 주의 — 초판의 ‘수석’ Sol은 GPT-6에선 ‘에이스’(6.1 Sol)입니다. 목록에 gpt-5.6-sol·gpt-6-sol이 함께 보여도 지금 수석은 Astra입니다. 코덱스엔 2강의 ‘소장’ 칸이 따로 없습니다.

은퇴 일정 — 옛 이름이 설정에 남아 있으면 바꾸세요 10월 개정
gpt-5.4·5.4-mini는 8/31에, gpt-5.3-codex-spark는 9/14에 은퇴했습니다. GPT-5.5는 10월 14일 챗GPT·Work·코덱스에서 은퇴합니다(OpenAI API는 영향 없음). GPT-5.6 Sol·Terra·Luna는 전환 기간 동안 남아 있습니다. config.toml·예약 작업·스크립트에 옛 이름이 적혀 있으면 미리 고쳐두세요. 📎 Models — GPT-5.5 retirement

A-5. 손잡이 ② 추론 깊이 — Low부터 Ultra까지

클로드 코드의 /effort에 해당하는 손잡이 — “얼마나 깊이 생각하고 올까”.

추론 깊이model_reasoning_effort

한 줄로 같은 모델이 얼마나 오래 고민하고 답할지 정하는 단계 — Low(앱에선 Light) · Medium · High · Extra High(xhigh) · Max · Ultra. 고를 수 있는 범위는 모델마다 다르다. 10월 개정

비유 같은 에이스 직원에게 “대충 훑고 와” vs “충분히 검토하고 와”를 정해주는 것.

나한테 왜 필요한가 결과가 얕게 느껴지면 모델을 바꾸기 전에 깊이를 한 칸 올려보는 게 먼저입니다. 반대로 간단한 일에 최고 단계는 느리고 비쌉니다.

바꾸는 곳 — 터미널에서는 /model 안에서 모델과 함께 고릅니다(별도 명령이 아니라는 점이 클로드 코드와 다릅니다). Max·Ultra는 모델을 고른 뒤 “More reasoning…”을 눌러야 보입니다. 챗GPT 앱에서는 입력창 아래 「Power」 슬라이더로 고르는데, 이 슬라이더는 모델과 깊이를 함께 바꿉니다(Luna High → Sol → Astra). Smarter 쪽 끝은 Astra라 한도가 빨리 닳으니, 깊이만 바꾸려면 Advanced에서 모델을 고정하고 조절하세요. 영구 설정은 config.toml의 model_reasoning_effort 키.

Max = 한 가지 일을 더 오래 생각. Ultra = 서브에이전트 여러 명이 일을 나눠 동시에 처리 — 나눌 수 있는 큰 일에만 의미가 있습니다. GPT-6 Luna는 Max까지(Ultra 없음). 공식 안내도 “대부분의 일에는 Max·Ultra가 필요 없다”입니다.

시작점(공식 권장) — Luna는 High, Astra는 Low(앱에선 Light), 6.1 Sol은 처음 설정 그대로. 화면 표기는 터미널이 Low, 앱·IDE가 Light — 같은 손잡이입니다.

⚠️ 틀리기 쉬운 지점 초판의 “Max·Ultra는 비공식” 안내는 틀린 말이 됐습니다 — 지금은 공식 단계입니다. 또 세대가 바뀌면 같은 이름의 단계라도 1:1로 같지 않습니다(공식). 익숙한 일을 낮은 단계로 먼저 시켜보고, 얕으면 한 칸씩 올리세요. 10월 개정

📎 Config reference · Models

A-6. 손잡이 ③ 권한 — 자물쇠가 두 개다

여기가 클로드 코드와 가장 크게 다른 지점입니다. 손잡이 하나가 아니라 자물쇠 두 개의 조합입니다.

권한의 두 축 — 회사에 비유하면

축	공식 이름	비유	정하는 것
① 출입증	`sandbox_mode`	어느 구역까지 들어갈 수 있나	읽기만 / 작업 폴더 안에서 쓰기 / 전체 개방
② 결재선	`approval_policy`	언제 상사에게 물어보나	경계를 넘을 때만 / 안 물음 — 결재자를 사람 대신 검토 AI로 바꿀 수도 있음

📎 Sandboxing · Permission modes

다만 처음부터 두 축을 조합할 필요는 없습니다. 코덱스가 묶음(프리셋)을 만들어 두었고, 비개발자는 이것만 알면 됩니다. 깃으로 관리하는 폴더는 Auto, 아닌 폴더는 읽기 전용으로 시작하라는 것이 공식 권장입니다. 챗GPT 앱에서는 같은 것이 Ask for approval(=Auto) · Approve for me(자동 검토) · Full access(전체 허용)라는 이름으로 보입니다. 10월 개정

⚠️ 이름 주의 — 코덱스의 「Auto」는 클로드 코드의 「오토 모드」와 다릅니다 10월 개정
코덱스 Auto는 작업 폴더 안의 일(고치기·지우기·명령 실행)을 아무 검토 없이 하고, 폴더 밖이나 인터넷이 필요할 때만 사람에게 묻습니다. 클로드 오토 모드처럼 AI가 대신 판단하는 것은 아래 「자동 검토(Approve for me)」입니다. 앱 이름 ‘Ask for approval’도 매번 묻는다는 뜻이 아닙니다.

코덱스 — /permissions 프리셋 (재현)

/permissions

코덱스가 묻지 않고 할 수 있는 범위를 정하세요

Auto (기본)

작업 폴더 안에서는 묻지 않고 읽기·고치기·지우기·명령 실행까지(검토 없음). 폴더 밖이나 인터넷이 필요할 때만 물어봅니다.

= 출입증 workspace-write × 결재선 on-request

눌러서 프리셋의 차이를 비교해 보세요

⚠️ 공식 문서 기준 재현 — 프리셋 구성(read-only·workspace-write·danger-full-access × on-request·never)은 [사실], 피커의 화면 문구는 버전에 따라 다를 수 있습니다. 공식 문서상 터미널 /permissions의 기본 선택지는 Auto·Read Only이고, 자동 검토는 앱 메뉴(Approve for me)나 codex --approve-for-me로 켭니다. 옛 값 untrusted는 폐지됐습니다(B-5).

자동 검토Approve for me · auto-review10월 개정

한 줄로 출입증(샌드박스)은 그대로 두고, 경계를 넘을 때의 결재만 사람 대신 별도의 검토 AI가 하는 방식.

비유 팀장 결재를 ‘결재 전담 비서’에게 맡기는 것 — 비서는 결재만 대신할 뿐, 출입 구역을 넓혀주지는 않습니다.

나한테 왜 필요한가 승인 창이 너무 자주 떠서 지칠 때 씁니다. 폴더 밖으로 나가는 요청 중 비밀정보 내보내기·인증정보 캐내기·보안 약화·되돌릴 수 없는 삭제처럼 위험해 보이는 것은 거절하도록 만들어져 있습니다 — 작업 폴더 안의 지우기·고치기는 원래 묻지 않으므로 검토하지 않습니다.

켜는 법 — 챗GPT 앱: 설정 > General > Permissions에서 ‘Auto-review’를 켜면 메뉴에 「Approve for me」가 생깁니다(켜기만 해서는 선택되지 않음). 터미널: codex --approve-for-me로 시작하거나 설정 파일에 approvals_reviewer = "auto_review". 검토 AI도 모델을 쓰므로 사용량이 조금 더 듭니다. 검토 AI가 막은 일을 이번 한 번 내가 허락해 다시 시키려면 /approve — 막힌 이유를 읽고 납득될 때만 쓰세요.

클로드 코드와 비교 — 클로드 코드는 ‘오토 모드’가 기본으로 켜져 있어 심사관이 명령 실행 등 대부분의 행동을 실행 전에 검토합니다(작업 폴더 안 읽기·수정은 바로 통과). 코덱스는 기본(Auto)이 폴더 안은 묻지 않고 진행, 폴더 밖만 사람이 승인이고, 자동 검토는 골라서 켜며 그 ‘폴더 밖 승인’만 검토 AI가 대신합니다.

⚠️ 틀리기 쉬운 지점 검토 AI도 실수할 수 있습니다 — 그래서 출입증(샌드박스)을 넓혀주지 않습니다. 컴퓨터 사용(Computer Use — 코덱스가 내 화면의 다른 프로그램을 직접 눌러 조작하는 기능)의 앱 승인은 자동 검토로 넘어가지 않고 계속 사람이 직접 합니다.

📎 Permissions · Auto-review · Approvals & security

정정 — 명령 이름은 /permissions입니다
인터넷 자료(작년 글 다수)에 /approvals로 소개돼 있지만, 현행 공식 명령 목록에는 없습니다. 지금은 /permissions가 “묻지 않고 할 수 있는 것”을 정하는 명령입니다. 옛 이름을 입력해 안 되더라도 당황하지 마세요. 📎 Slash commands (CLI)

기억할 원칙 한 문장 (공식 문서 원문)
“누가 결재하느냐를 바꿔도, 출입증의 범위는 넓어지지 않는다.” — 원문 “Changing who reviews a request doesn't expand the sandbox.” 자동 검토를 켜도 코덱스가 닿을 수 있는 구역 자체는 그대로라는 뜻입니다. 두 자물쇠가 따로 노는 이유입니다. 📎 Permissions

A-7. 플랜 모드 — /plan

2강의 핵심이던 ‘시키기 전에 계획서를 받는다’ — 코덱스에도 있습니다.

플랜 모드/plan

한 줄로 파일을 건드리기 전에, 저장소를 둘러보고 단계별 계획서를 먼저 가져오게 하는 모드.

비유 에이스의 복명복창 — “이렇게 진행하겠습니다. 맞습니까?” 확인 후 착수.

나한테 왜 필요한가 코덱스에는 자동 저장(체크포인트)이 없기 때문에(다음 절), 플랜 모드의 가치가 클로드 코드보다 더 큽니다.

켜는 법 — /plan을 입력합니다. /plan 회원 가입 화면을 고쳐줘처럼 의뢰문을 같은 줄에 붙여도 됩니다.

계획서를 읽는 법은 2강 그대로 — 동사·숫자·저장 위치 세 가지만 확인해도 사고를 막습니다.

⚠️ 틀리기 쉬운 지점 공식 안내는 “/plan 또는 Shift+Tab으로 켜고 끈다”입니다. 다만 터미널·키보드 설정에 따라 단축키가 안 먹을 수 있으니 /plan 타이핑을 1순위 습관으로 삼으세요. 코덱스가 일하는 도중에는 /plan을 잠시 쓸 수 없습니다. 10월 개정

📎 Slash commands (CLI) · Best practices

코덱스 — 플랜 모드 흐름 (재현)

/plan 문의 접수 페이지에 ‘연락 가능 시간’ 칸을 추가해줘

폴더를 읽는 중… index.html · style.css 확인

계획서

1. index.html의 입력 폼에 칸 1개 추가 (삭제 없음)

2. 저장 위치: 지금 이 폴더 (밖으로 안 나감)

3. 완료 후 /diff로 바뀐 부분을 보여드림

이대로 진행할까요? [승인] [수정 요청]

동사(추가)·숫자(1개)·저장 위치 — 2강의 검사법 그대로

⚠️ 공식 문서 기준 재현 — “계획을 먼저 제시하고 승인 후 실행”이 플랜 모드의 [사실]이고, 계획서의 생김새는 의뢰 내용에 따라 매번 다릅니다.

A-8. 되돌리기가 없다 — 안전벨트 3단

이 책에서 가장 중요한 경고입니다. 클로드 코드의 자동 세이브(/rewind)에 해당하는 기능이 코덱스에는 없습니다.

[사실] 체크포인트·리와인드 기능이 공식 문서에 존재하지 않습니다 (2026-10-01 재확인 10월 개정).
공식 CLI 문서도 “작업 전후로 깃 체크포인트를 만들어 되돌릴 수 있게 하라”고 안내합니다. 클로드 코드는 지시할 때마다 코드 상태를 자동 저장하고 /rewind로 되돌립니다(클로드 코드 정석 A-6). 코덱스 공식 문서에는 이에 해당하는 기능이 없고, 사용자들이 기능 요청을 올려둔 상태입니다. “잘못되면 되감으면 돼요”가 코덱스에서는 통하지 않습니다.

그래서 — 안전벨트를 직접 맵니다 (3단)

① 시작 전 저장 — 작업 시작 전에 “지금 상태를 깃(Git)으로 저장해줘”라고 시키세요. 게임의 수동 세이브입니다. 깃을 몰라도 됩니다 — 시키면 코덱스가 합니다(저장할 때 승인 창이 뜰 수 있어요 — .git 폴더는 기본으로 보호돼 있어서입니다. 내용을 보고 승인하세요).
② 계획 먼저 — 큰 작업은 /plan으로 계획서부터. 방향이 틀리면 실행 전에 잡는 게 가장 쌉니다.
③ 끝나면 /diff — “무엇이 바뀌었나”를 한 화면으로 확인. 이상하면 “아까 저장한 지점으로 되돌려줘”라고 시키면 됩니다.

📎 Slash commands — /diff · Best practices

그래도 손에 쥘 수 있는 것 — 파일 되돌리기 1개 · 대화 되돌리기 1개 10월 개정
① (파일) 앱의 변경 확인(Review) 화면 — Revert all(전부)·파일별·덩어리별로 되돌리는 버튼이 있습니다(깃으로 관리하는 폴더에서). ⚠️ 단 이 화면은 처음에 ‘커밋 안 된 모든 변경’ — 내가 직접 고친 것까지 — 을 보여줍니다. 그대로 Revert all을 누르면 내 수정도 지워지니, 먼저 범위를 「Last turn」으로 바꿔 방금 코덱스가 바꾼 것만 보고 되돌리세요. ② (대화만) 터미널에서 입력창이 빈 상태로 Esc 두 번 — 직전 내 메시지를 고쳐 그 지점부터 대화를 다시 시작할 뿐, 파일은 그대로입니다. 클로드 코드의 Esc 두 번(파일까지 되감기)과 다르니, 파일은 ①이나 깃으로 되돌리세요. 📎 Code review (app) · Developer commands — shortcuts

한 줄로 기억하기
“클로드 코드는 자동 세이브가 있는 게임, 코덱스는 세이브를 직접 눌러야 하는 게임 — 저장(커밋) → 계획(/plan) → 확인(/diff).”

A-9. /import — 배운 게 하나도 안 아깝다

클로드 코드에서 만들어 둔 살림을 명령 하나로 코덱스에 옮겨 옵니다.

/importImport from another agent10월 개정

한 줄로 클로드 코드·커서에서 만든 설정·지시문·확장 기능·최근 대화를 코덱스 형식으로 옮겨 오는 공식 이사 서비스.

비유 이직할 때 짐센터가 와서 책상 서랍째 옮겨주는 것 — 벽보·매뉴얼·연장통까지.

나한테 왜 필요한가 이 시리즈에서 클로드 코드로 배운 것이 전부 자산으로 이어집니다. 회사가 챗GPT를 쓴다고 처음부터 다시 배울 필요가 없습니다.

어디서 가져오나 — 터미널: /import → 클로드 코드 또는 커서를 고름(최근 30일 대화 최대 50개). 챗GPT 앱: 설정 > Import에서 클로드 코드·Claude Cowork·커서까지, 자동 동기화도 켤 수 있습니다. 원래 도구의 설정은 바뀌거나 지워지지 않습니다.

공식 문서가 밝힌 변환 목록 — 지시문 → AGENTS.md · settings.json → config.toml · 스킬·슬래시 명령 → 코덱스 스킬 · 서브에이전트 → 코덱스 서브에이전트 · 플러그인 · MCP 연결 · 훅 · 클로드 코드 프로젝트 메모리 → Memories · 기존 프로젝트 폴더 · 최근 30일 대화.

📎 Import from another agent

코덱스 — /import 진행 (재현)

/import

가져올 곳: ● Claude Code ○ Cursor — 클로드 코드 설정을 찾았습니다

✔ CLAUDE.md → AGENTS.md

✔ settings.json → config.toml

✔ 스킬 3개 → 코덱스 스킬

✔ MCP 연결 1개 · 최근 대화 목록

완료 — 어제까지의 살림 그대로, 오늘부터 코덱스에서.

변환 항목 목록은 공식 문서의 매핑표 기준

⚠️ 공식 문서 기준 재현 — 가져올 곳 선택(Claude Code·Cursor)과 변환 항목 목록은 [사실], 진행 화면의 문구·순서는 연출입니다. 가져온 뒤에는 AGENTS.md를 열어 한 번 검수하세요(자동 변환도 초안입니다).

정석 코스

PART B · 공식 매뉴얼 정석 — 개인 사용자 전영역

오픈AI 공식 문서(learn.chatgpt.com)를 개인 사용자에게 필요한 범위에서 순서대로 훑습니다. 회사 관리자용(엔터프라이즈 통제·보안 정책)은 뺐습니다.

B-1. 다섯 개의 창구 — 어디서 쓰나

같은 코덱스를 여는 문이 다섯 개입니다. 어느 문으로 들어가도 같은 직원을 만납니다.

코덱스의 다섯 창구

창구	무엇	이런 분에게
챗GPT 데스크톱 앱	챗GPT 앱 안에서 폴더를 지정해 작업 (2026-07-09 병합) · 맥·윈도우, 리눅스는 미리보기	터미널 없이 화면으로 쓰고 싶은 분
터미널 (CLI)	`codex` 명령 — 이 시리즈의 기본 코스	클로드 코드에서 넘어오는 분 (조작감 비슷 — Esc 두 번 등 일부 다름)
IDE 확장	VS Code 등 편집기 안의 사이드바 (확장 ID `openai.chatgpt`)	편집기를 이미 쓰는 분
클라우드	chatgpt.com/codex — 내 컴퓨터 밖 격리 환경에서 병렬 작업 · Plus 이상(무료·Go 제외) · 깃허브 저장소 연결 필요 · 이메일로 로그인했다면 2단계 인증(MFA) 필수	여러 일을 동시에 맡기고 싶을 때
모바일/웹	챗GPT 앱·웹에서 진행 상황 확인·이어받기	이동 중 확인용

📎 IDE extension · Codex cloud · What's new

터미널 ↔ 클라우드 왕복 10월 개정 — 터미널에서 codex cloud(실험 기능)로 클라우드에 일을 맡기고 목록을 보며, codex apply로 클라우드 작업의 결과(바뀐 내용)를 내 폴더에 적용합니다. “클라우드에 맡겨두고 나중에 터미널로 돌아오는” 사용법이 공식 문서의 대표 예시입니다. 지금 대화를 챗GPT 앱으로 옮기려면 /app. (초판의 /cloud·/local은 터미널 명령 목록에는 없고 IDE 확장에만 있습니다.) 📎 Codex CLI · Developer commands

B-2. 설치와 로그인 — 윈도우 상세

윈도우 기준 — 처음 한 번만 (5분)

PowerShell을 열고 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" 실행 (또는 npm install -g @openai/codex) 10월 개정
처음 실행해 샌드박스를 설정할 때 관리자 승인(UAC) 창이 뜨면 — 코덱스 설정 중 뜬 창인지 확인하고 승인(안전 샌드박스 구성용)
작업할 폴더로 이동해 codex 입력
브라우저가 열리면 챗GPT 계정으로 로그인 (codex login) — 끝

로그인 두 방식 — 뭐가 다른가

	챗GPT 계정 (권장)	API 키
비용	요금제에 포함된 한도로 사용	쓴 만큼 별도 과금(종량제)
기능	전체 (클라우드·플러그인 포함)	클라우드 사용 불가(공식) — 터미널·IDE만
누구	개인 사용자 대부분	자동화·서버 등 특수 용도

📎 Authentication

WSL을 이미 쓰고 있다면 (클로드 코드 초기 수강생 해당)
코덱스는 WSL 없이 네이티브가 기본입니다. 굳이 WSL로 쓸 경우 WSL2만 지원됩니다(구형 WSL1은 지원 종료). 두 경우를 구분하세요 — ① 윈도우 앱(기본 모드)에서 \\wsl$ 경로의 폴더를 열면 깃이 인식되지 않을 수 있으니, 이때는 프로젝트를 윈도우 드라이브 쪽에 두세요. ② 코덱스 자체를 WSL 안에서 돌린다면 공식 권장은 반대로 리눅스 홈 폴더(~/code)입니다(/mnt/c는 피하기). 10월 개정 📎 Windows app · WSL

미리 깔아두면 좋은 것 — 공식 문서 권장: 깃(Git, 변경 비교·안전벨트용)과 Node.js. 둘 다 “코덱스에게 깔아달라고” 시켜도 됩니다. 📎 Windows app

B-3. 터미널에서 실제로 쓰는 조작

터미널 명령은 ‘시작할 때 한 번’ 쓰는 것과, 대화 중 쓰는 슬래시 명령(다음 절)으로 나뉩니다.

시작 명령 — 이 여섯이면 충분

명령	하는 일
`codex`	대화형으로 시작 (기본)
`codex resume`	지난 대화 이어서 (`--last`는 이 폴더의 직전 것)
`codex "의뢰문"`	의뢰문과 함께 바로 시작
`codex review`	바뀐 내용 검토를 맡김
`codex doctor`	뭔가 이상할 때 자가 진단
`codex update`	새 버전으로 업데이트

📎 CLI reference

자주 보게 될 옵션(플래그)

옵션	뜻
`-m 모델이름`	이번 실행만 다른 모델로
`-i 그림.png`	이미지 첨부 (화면 스크린샷 보여주며 의뢰)
`--search`	실시간(라이브) 웹 검색으로 전환 — 기본은 ‘캐시 검색’(미리 모아둔 색인)이 켜져 있음 10월 개정
`-C 폴더경로`	다른 폴더를 작업장으로 지정
`--yolo`	샌드박스·승인 전부 해제 — 공식 문서가 ‘비추천’ 명시. 쓰지 마세요

📎 CLI reference · Web search

B-4. 슬래시 명령 — 비개발자용 27선

대화 중 /로 시작하는 명령입니다. 전체는 수십 개지만, 이 27줄이면 일상 사용의 대부분을 덮습니다. /goal·/approve·/personality가 새로 들어왔습니다. 10월 개정

① 시작·설정

명령	하는 일
`/init`	AGENTS.md(벽보) 초안 생성
`/status`	지금 세션의 설정·토큰 사용량
`/usage`	계정 사용량·한도 확인
`/model`	모델 + 추론 깊이 선택
`/permissions`	묻지 않고 할 수 있는 범위 설정
`/approve`	자동 검토가 막은 일을 이번 한 번 내가 허락해 다시 시도 — 막힌 이유를 읽고 납득될 때만 🆕
`/plan`	플랜 모드 — 계획서 먼저
`/goal`	목표를 걸어두면 끝날 때까지 계속 — 보기·고치기·일시정지·해제 🆕
`/fast`	빠른 모드 켜고 끄기 — 같은 일에 사용량 2.5배(초고속과는 다른 기능)
`/personality`	말투 고르기 — friendly(친근)·pragmatic(실용)·none 🆕

② 대화 관리

명령	하는 일
`/new`	같은 창에서 새 대화 시작 (주제 바뀔 때)
`/clear`	화면 지우고 새 대화
`/compact`	대화를 요약해 토큰(책상) 비우기
`/resume`	저장된 대화 목록에서 이어받기
`/fork`	지금 대화를 복제해 갈림길 만들기
`/side` · `/btw`	본 작업 흐름 밖에서 잠깐 곁가지 질문 (두 이름 모두 같은 명령)
`/rename` · `/archive` · `/delete`	대화 이름 바꾸기·보관·영구 삭제(/delete는 되돌릴 수 없고, /archive·/delete 모두 실행 후 종료)

③ 결과 확인 (안전벨트)

명령	하는 일
`/diff`	무엇이 바뀌었나 한 화면으로
`/review`	바뀐 내용을 코덱스에게 재검토시키기
`/mention`	특정 파일을 대화에 첨부

④ 확장·이동

명령	하는 일
`/skills`	스킬(레시피 카드) 목록·사용
`/mcp`	연결된 외부 도구(MCP) 확인
`/memories`	이 대화가 ‘기억’을 쓰고·만들지 켜고 끄기 (기억 기능은 기본 꺼짐 — 앱은 설정 > Personalization에서 먼저 켬) 10월 개정
`/agent` · `/subagents`	서브에이전트(팀원) 스레드 전환
`/import`	클로드 코드·커서 설정·프로젝트·대화 가져오기
`/app`	이 대화를 챗GPT 앱에서 이어서
`/feedback` · `/exit`	의견 보내기 · 종료

📎 Slash commands (CLI) — 현행 전체 목록

재미로 하나 — /pets(또는 /pet)를 입력하면 터미널에 작은 펫이 등장합니다. 공식 기능입니다. 수업 분위기 환기용으로 좋습니다. 📎 Slash commands

B-5. 권한·샌드박스 정석 — 2축 상세

A-6의 프리셋으로 충분하지만, “그 밑이 어떻게 생겼나”를 아는 분을 위한 심화입니다.

축 ① 출입증 — sandbox_mode (공식 문서 원문 취지)

값	뜻
`read-only`	파일을 살펴볼 수만 있음 — 수정·명령 실행은 승인 필요
`workspace-write`	작업 폴더 안에서 읽기·수정·통상 명령 가능 — 로컬 작업 기본값. 네트워크는 기본 차단
`danger-full-access`	샌드박스 제한 없음 — 이름부터 danger입니다

축 ② 결재선 — approval_policy

값	뜻
`untrusted`	폐지 10월 개정 — 설정 파일에 남아 있으면 코덱스가 아예 안 켜질 수 있으니 지우세요. 깐깐하게 쓰려면 `read-only` × `on-request`.
`on-request`	샌드박스 안에서는 알아서, 경계를 넘을 때만 물어봄
`never`	승인 질문으로 멈추지 않음

📎 Sandboxing · Config reference · Approvals & security

프리셋 대응 — Auto(기본) = workspace-write × on-request / 읽기 전용 = read-only × on-request / 자동 검토 = Auto + 결재자 검토 AI / 전체 허용 = 샌드박스·승인 해제(--yolo와 같음, 비추천).
결재자 바꾸기 10월 개정 — approvals_reviewer = "user"(기본, 사람) / "auto_review"(검토 AI). 결재선이 on-request처럼 ‘묻는’ 설정일 때만 의미가 있습니다(never면 검토할 것이 없음).
윈도우 샌드박스는 저권한 사용자·방화벽 규칙으로 구현됩니다(처음 샌드박스 설정 때 UAC 승인이 필요한 이유). 📎 Windows sandbox
웹 검색 결과는 믿을 수 없는 내용으로 다루라는 것이 공식 안내입니다(사람에게 하는 주의). 웹 글에 숨은 지시를 코덱스가 따라 할 위험(프롬프트 인젝션)은 공식 문서도 경고하며, 기본인 ‘캐시 검색’(오픈AI가 미리 모아둔 색인)은 그 위험을 줄일 뿐 없애지 못합니다. 10월 개정 📎 Web search

B-6. 설정 파일 — config.toml

config.toml~/.codex/config.toml

한 줄로 코덱스의 기본값(모델·깊이·권한 등)을 적어두는 설정 파일 — 클로드 코드의 settings.json 자리.

비유 가게의 기본 운영 수칙 대장 — 벽보(AGENTS.md)가 ‘일하는 법’이라면, 이건 ‘가게 설비 세팅’.

나한테 왜 필요한가 매번 /model을 고르는 게 귀찮아지면, 여기 한 줄 적어 기본값으로 굳힙니다.

위치 — 내 계정 전체: ~/.codex/config.toml (윈도우는 C:\Users\내이름\.codex\config.toml). 프로젝트별 .codex/config.toml도 가능하지만 그 프로젝트를 ‘신뢰함’으로 지정했을 때만 읽힙니다.

자주 쓰는 키 세 줄이면 충분합니다:

📎 Config basics · Config reference

~/.codex/config.toml — 비개발자 표준 세 줄 (예시)

model = "gpt-6.1-sol" # 기본은 실무 에이스(공식 권장)

model_reasoning_effort = "medium" # 이 줄을 빼면 모델 기본값

approval_policy = "on-request" # 경계 넘을 때만 물어봐

⚠️ 키 이름·허용값은 공식 설정 문서의 [사실], 조합 예시는 이 책의 권장안입니다. 6.1 Sol이 계정에 아직 안 보이면 gpt-6-sol로 쓰세요(무료·Go는 6.1 Sol 미포함). 10월 개정 파일을 직접 만들기 어려우면 코덱스에게 “config.toml에 이 세 줄 넣어줘”라고 시키세요.

B-7. 확장 — 스킬 · 서브에이전트 · 훅 · MCP

클로드 코드 정석 A-4·B-6에서 본 확장 기능 4종이 코덱스에도 전부 있습니다. 개념은 같으니 표로 압축합니다.

확장 기능 4종 — 개념은 같고 놓는 곳만 다르다

기능	비유 (시리즈 공통)	코덱스에서는
스킬	레시피 카드 — 필요할 때만 펴본다	같은 `SKILL.md` 형식 · `/skills`로 목록 · `$이름`으로 호출. 공개 표준(agentskills.io) 기반이라 클로드 코드 스킬과 호환 계열
서브에이전트	팀원 — 일을 나눠 맡긴다	`~/.codex/agents/`에 TOML 파일로 정의 · `/agent`로 전환. 팀원은 부모의 출입증(샌드박스)을 물려받음
훅	정해진 시점의 자동 동작 (출퇴근 도장)	`hooks.json` 또는 config.toml에 정의 · 처음 보는 훅은 `/hooks`에서 검토·신뢰해야 실행 10월 개정. 비개발자는 ‘있다’ 정도만
MCP	외부 도구 연결 규격 (USB-C)	`codex mcp add 이름 -- 실행명령` 한 줄 · `/mcp`로 확인. 클로드 코드와 같은 MCP 규격

📎 Skills · Subagents · Hooks · MCP

MCP 주의는 여기서도 동일 — 외부 MCP 서버는 제공사가 일일이 보안 감사를 해주지 않습니다. 신뢰하는 제공자의 것만 연결하세요. 클로드 코드 정석 A-5의 경고 그대로입니다.

B-8. 세션 · 컨텍스트 · 비용 (셋은 한 몸)

책상(컨텍스트) 관리 — 대화가 길어지면 느려지고 비싸지는 원리는 동일합니다. 주제가 바뀌면 /new, 대화가 무거워지면 /compact(요약해서 책상 비우기). 사용량은 /status로 봅니다.
이어서 하기 — 어제 대화는 codex resume --last(이 폴더 직전 것) 또는 /resume(목록에서 선택).
한도 10월 개정 — Plus·Business는 5시간마다 다시 채워지는 사용량(+주간 한도), Pro는 5시간 한도는 없음(모델별 한도는 있음). /usage·/status로 남은 양을 확인하고, 부족하면 크레딧 충전으로 이어 씁니다. Plus 5시간 추정치(공식, 터미널 메시지 기준): Astra 5~45개 · 6.1 Sol 15~160개 · Luna 350~3,000개 — 가장 강력한 모델일수록 금방 닳습니다.
빠른 모드 — /fast를 켜면 응답이 빨라지는 대신 같은 일에 포함 한도를 2.5배 씁니다(산 크레딧은 2배). 평소엔 끄고, 급할 때만.
초고속(Ultrafast) — Pro 500(과 일부 기업·교육 요금제)에서 GPT-6 Astra의 답이 최대 8배 빨리 나오는 모드(작업 전체 시간이 8배 줄진 않음). 이와 별개로 같은 일에 요금제 사용량 8배(산 크레딧은 6배)가 듭니다. 위의 빠른 모드(/fast)와는 다른 기능입니다. 10월 개정

📎 Pricing · Speed (fast tier) · Slash commands

절약 습관은 시리즈 공통 — “주제 바뀌면 새 대화, 무거우면 요약, 간단한 일은 막내(luna)에게.” 클로드 코드에서 배운 세 습관이 여기서도 가장 큰 절약입니다.

B-9. 잘 쓰는 습관 (공식 모범 사례)

공식 Best practices에서 비개발자에게 필요한 것만

큰 일은 계획부터 — /plan으로 계획서를 받고, 동사·숫자·저장 위치를 확인한 뒤 승인.
하나에 하나씩 — 한 대화에 한 가지 일. 여러 일이면 쪼개서 순서대로(1강의 쪼개기 그대로).
끝나면 /diff — “다 됐습니다”는 선언이고, 확인은 내 눈으로. 실제로 열어보고 눌러보기.
벽보를 다듬는다 — 같은 지적을 두 번 했다면 AGENTS.md에 적을 때가 된 것.
웹에서 가져온 내용은 의심 — 공식 문서도 “웹 결과는 믿을 수 없는 내용으로 다루라”고 안내합니다. 웹 글에 숨은 지시를 코덱스가 따라 할 수도 있으니, 결과를 내 눈으로 확인하세요. 10월 개정

📎 Best practices · Web search

나란히 보기

PART C · 클로드 코드와 나란히

두 도구에 우열을 매기지 않습니다. 구조가 같다는 것을 확인하고, 다른 것만 정확히 짚고, ‘내 상황에서의 선택 기준’으로 끝냅니다. 가격·모델명 등은 수시로 바뀌므로 ‘변동’ 전제로 읽으세요.

C-1. 공식 대응표 — 이름만 다른 것들

벽보·설정·스킬·서브에이전트·MCP·훅·기억 행은 오픈AI가 /import 문서에 실어둔 공식 변환표이고, 나머지 행은 이 책이 두 회사 공식 문서를 대조해 정리한 것입니다. 10월 개정

클로드 코드 ↔ 코덱스 대응표

개념	클로드 코드	코덱스
벽보(상시 지시문)	CLAUDE.md	AGENTS.md
벽보 초안 생성	`/init`	`/init` (동일)
설정 파일	settings.json	config.toml
계획 먼저	`/plan` · Shift+Tab	`/plan` · Shift+Tab
권한 10월 개정	권한 모드 1축 (6종) — 기본은 오토 모드(심사관이 검토)	2축(출입증 × 결재선) + 프리셋 — 기본(Auto)은 폴더 안은 묻지 않고, 폴더 밖만 사람이 승인. AI 검토(자동 검토)는 골라서
AI가 대신 판단	오토 모드의 심사관(기본)	자동 검토의 검토 AI(선택)
모델 바꾸기	`/model`	`/model` (동일)
추론 깊이(클로드의 에포트)	`/effort` 또는 `/model`에서 ←→	`/model` 안에서 함께 선택 (Low~Ultra)
새 대화·요약	`/clear` · `/compact`	`/new`·`/clear` · `/compact`
자동 세이브·되감기	체크포인트 + `/rewind`	없음 → 깃 커밋 + /plan + /diff (앱은 변경 확인 화면의 Revert — 깃 폴더, 「Last turn」 범위로)
스킬	SKILL.md · `/스킬이름`	SKILL.md · `$스킬이름`
서브에이전트	agents (마크다운)	agents (TOML) · `/agent`
외부 도구 연결	MCP	MCP (같은 규격)
기억	자동 메모리(기본 켜짐) · `/memory`	Memories(기본 꺼짐) · `/memories`
이어서 하기	`claude --continue/--resume` · `/resume`	`codex resume` · `/resume`
목표까지 계속	`/goal`	`/goal` (동일)
곁질문	`/btw`	`/side` · `/btw`
결과물 위주 작업 모드	Cowork (데스크톱 앱 탭)	ChatGPT Work
웹/클라우드 작업	Claude Code 웹	Codex 클라우드 (`codex cloud`)
이사 도구 10월 개정	`/import` (코덱스·제미나이·커서 → 클로드 코드)	`/import` (클로드 코드·커서 → 코덱스)

📎 Import from another agent (공식 매핑) · Claude Code 공식 문서 · Claude Code — Commands · Claude Code — Permission modes

C-2. 결정적으로 다른 점 5가지

비개발자 기준 — 체감 차이 큰 순서

#	차이	무슨 뜻인가
1	되돌리기 유무	클로드 코드는 자동 세이브(`/rewind`), 코덱스는 없음 — 안전벨트 3단(A-8)을 스스로 맵니다(앱은 Revert 버튼, 단 범위 주의). 단 클로드도 명령어로 지운·옮긴 파일은 되감기로 못 살리니, 깃 저장은 양쪽 공통 안전벨트입니다. 10월 개정
2	권한 구조	클로드 코드는 손잡이 1개(모드 6종), 코덱스는 자물쇠 2개(출입증×결재선)+프리셋. 둘 다 ‘AI가 대신 판단하는 장치’가 생겼지만 — 클로드는 기본으로 켜져 있고(오토 모드의 심사관), 코덱스는 골라서 켭니다(Approve for me의 검토 AI, 샌드박스는 그대로) 10월 개정
3	윈도우 안전 칸막이	설치는 이제 둘 다 PowerShell 한 줄·데스크톱 앱이 있음. 차이는 샌드박스 — 코덱스는 윈도우에서도 기본으로 작동, 클로드 코드는 WSL 없이 윈도우에서 바로 쓰면 샌드박스 미지원(WSL2에서만) 10월 개정
4	요금 문턱	클로드 코드는 유료 플랜 필요, 코덱스는 무료·Go 요금제부터 포함(맛보기 수준, 클라우드 제외) — 개인 최상위는 Pro 500(월 500달러). 실무는 양쪽 다 유료 전제 10월 개정
5	모델 집안	안은 서로 다른 회사 모델 — 클로드(Anthropic) vs GPT(OpenAI). 같은 의뢰에도 결과 스타일이 다를 수 있음

📎 각 항목의 근거는 A-2·A-6·A-8 및 Pricing · Claude Code Authentication

관찰·주장 “어느 쪽이 더 낫나요?”에 대한 이 책의 답 — 결과물의 우열은 작업 종류·시점에 따라 갈리고, 몇 달 단위로 뒤집힙니다. 비개발자에게 진짜 중요한 차이는 위 표의 1·3·4번 같은 운영 환경 차이이지 모델 성능 순위가 아닙니다. 순위 기사에 시간을 쓰지 마세요.

C-3. 그래서 뭘 쓰나 — 판단 기준

상황별 선택 기준

내 상황	권장	이유
회사·팀이 챗GPT를 쓴다	코덱스	같은 계정·같은 요금제 안에서 해결
이미 클로드 유료 구독 중	클로드 코드	배운 것 그대로, 자동 세이브 안전장치 포함
실수 복구 안전장치가 최우선	클로드 코드	`/rewind` 유무는 초보에게 체감이 큽니다
이미 챗GPT 앱을 쓰고 있다	코덱스	쓰던 앱 안에서 바로 시작(설치 부담은 이제 둘 다 비슷) 10월 개정
일단 무료로 개념만 체험	코덱스(챗GPT 데스크톱 앱)	무료·Go도 포함 — 데스크톱 앱에서 GPT-6 Luna(터미널 코스는 Plus부터 공식 명시)
결론	구조가 같으니 갈아타기가 쉽습니다. 하나를 제대로 배우면(이 시리즈), 나머지는 이 책 한 권 + `/import`로 따라옵니다

1강의 약속, 회수 — “코덱스는 따로 배울 것 없습니다. 같은 부류의 다른 회사 제품이고, 규칙 파일 이름만 다릅니다.” (1강 FAQ) — 이 책이 그 약속의 증명입니다. 접수표 다섯 칸도, 벽보 장치도, 계획 먼저 원칙도 그대로 통했습니다. 단 되돌리기(A-8)와 권한(A-6)은 따로 익히세요.

바로 꺼내 쓰기

부록 · 치트시트 · 자주 묻는 질문

인쇄해서 옆에 두고 바로 꺼내 쓰는 것들입니다.

부록 1. 한 장 치트시트

① 매일 쓰는 명령 10개

명령	언제
`codex`	작업 폴더에서 시작
`codex resume --last`	어제 것 이어서
`/init`	새 폴더에서 처음 (벽보 초안)
`/plan`	큰 작업 시작 전
`/model`	어려운 일 앞두고 (깊이도 여기서)
`/permissions`	맡기는 범위 조정
`/diff`	끝나고 확인
`/new`	주제가 바뀔 때
`/compact`	느려졌다 싶을 때
`/usage`	얼마 썼나

📎 Slash commands (CLI)

② 위치·경로 한 장

무엇	어디
설치 (윈도우)	`powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \| iex"`
벽보 (전역)	`~/.codex/AGENTS.md`
벽보 (프로젝트)	작업 폴더의 `AGENTS.md`
설정 파일	`~/.codex/config.toml`
클라우드	chatgpt.com/codex · 터미널에서 `codex cloud`

📎 AGENTS.md · Config basics

③ 판단 기준

상황	선택
대답이 필요하다	챗GPT
결과물(파일)이 필요하다	코덱스
항상 지킬 규칙	AGENTS.md
가끔 하는 긴 절차	스킬
큰 작업 시작 전	깃 저장 + `/plan`
끝난 직후	`/diff`로 확인
오탈자·색 바꾸기	Luna(깊이는 권장값 High 그대로)
처음 짓는 것·중요한 설계	6.1 Sol 처음 설정 그대로 → 얕으면 한 칸씩 (Astra는 Low부터) 10월 개정
클로드 코드에서 이사	`/import`

부록 2. 자주 묻는 질문 23개

코드를 하나도 모르는데 정말 되나요?

됩니다. 무엇을 맡기고, 무엇이 완성인지 정하고, 결과를 확인하는 건 사람 몫 — 이건 도구가 클로드 코드든 코덱스든 같습니다. 그 최소 지식이 이 시리즈입니다.

무료로 쓸 수 있나요?

네, 코덱스는 챗GPT 무료·Go 요금제에도 포함됩니다(데스크톱 앱에서 GPT-6 Luna — 계정마다 차례로 열리는 중). 다만 무료 한도는 맛보기 수준이고 클라우드 작업은 Plus부터라, 업무용이라면 Plus 이상을 전제하세요. 이 시리즈의 터미널 실습도 Plus 이상을 전제로 합니다.

📎 Pricing · Using Codex with your ChatGPT plan

챗GPT 계정과 코덱스 계정이 따로인가요?

하나입니다. codex login에서 쓰던 챗GPT 계정으로 로그인하면 끝이고, 사용량도 같은 요금제 한도에서 나갑니다.

📎 Authentication

윈도우인데 WSL을 깔아야 하나요?

아니요. 코덱스는 윈도우 PowerShell에서 네이티브로 돌아갑니다. WSL은 리눅스 전용 도구가 꼭 필요한 분만 선택하는 옵션이고, 그 경우에도 WSL2만 지원됩니다.

📎 WSL

설치 중 관리자 승인 창이 떴어요. 눌러도 되나요?

코덱스가 안전 샌드박스(작업 폴더 밖 쓰기 차단·무승인 네트워크 차단)를 처음 구성할 때 뜨는 창이면 정상입니다 — 코덱스 설정 중 뜬 창인지 확인하고 승인하세요. 회사 PC라 관리자 권한이 없다면 약한 방식(unelevated)으로 대신 돌아가는데, 보호가 약해지니 IT팀에 정식 설정을 요청하세요. 10월 개정

📎 Windows sandbox

뭔가 이상해요. 제일 먼저 뭘 하죠?

codex doctor를 실행하세요 — 설치 상태를 자가 진단하는 공식 명령입니다. 로그인 문제면 codex logout 후 다시 로그인, 버전 문제면 codex update.

📎 CLI reference

AGENTS.md는 꼭 만들어야 하나요?

없어도 동작합니다. 같은 설명을 매번 반복하고 있다면 그때가 만들 시점 — /init으로 초안을 받아 내 규칙으로 고치세요.

📎 AGENTS.md

클로드 코드에서 쓰던 CLAUDE.md를 그대로 복사해도 되나요?

됩니다 — 둘 다 자유 형식 마크다운이라 내용이 그대로 통합니다. 다만 손으로 복사하는 것보다 /import가 설정·스킬·MCP까지 한 번에 옮겨줘서 편합니다.

📎 Import from another agent

AGENTS.md에 뭘 적어야 하죠?

클로드 코드 때와 같습니다 — 역할(이 폴더는 무엇을 하는 곳), 기준(지우지 마라·큰 결정은 물어봐라), 말투·형식. 읽는 총량에 32KiB 상한이 있으니 짧고 명확하게, 긴 절차는 스킬로 빼세요.

📎 AGENTS.md

잘못됐을 때 되돌릴 수 있나요?

클로드 코드의 /rewind 같은 자동 되감기는 없습니다. 그래서 시작 전에 “지금 상태를 깃으로 저장해줘”라고 시키는 습관(수동 세이브)이 필수입니다(저장할 때 승인 창이 뜰 수 있어요 — 정상입니다). 이상하면 “아까 저장 지점으로 되돌려줘”라고 시키면 됩니다. 챗GPT 앱이라면 변경 확인 화면의 Revert로도 되돌릴 수 있는데, 범위를 「Last turn」으로 바꾼 뒤 누르세요(그대로 Revert all을 누르면 내가 고친 것까지 지워짐). 10월 개정

인터넷에서 본 /approvals 명령이 안 돼요.

옛 자료입니다. 현행 명령은 /permissions입니다 — 코덱스가 묻지 않고 할 수 있는 범위를 정합니다.

📎 Slash commands (CLI)

어떤 모델을 골라야 하나요?

공식 권장은 복잡한 일엔 GPT-6.1 Sol, 반복 작업엔 GPT-6 Luna입니다. 가장 강력한 Astra는 정말 어려운 일에만 — 한도가 빨리 닳습니다(Plus 5시간 기준 메시지 5~45개). 이름은 계속 바뀌니 ‘수석/에이스/막내’ 급으로 기억하는 게 오래갑니다.

📎 Models

추론 깊이를 항상 최고로 두면 안 되나요?

결과가 늘 좋아지진 않고 느리고 비쌉니다. 간단한 일에는 오히려 과하게 생각해 돌아갑니다. Max·Ultra는 공식 단계지만 “대부분의 일엔 필요 없다”는 게 공식 안내입니다. 기본값에서 시작해(Luna는 High, Astra는 Low 권장 — 앱에선 Light) 얕다 싶을 때 한 칸씩 올리세요.

📎 Models — Max·Ultra

Shift+Tab을 눌렀는데 반응이 없어요.

공식 안내는 /plan 또는 Shift+Tab입니다. 터미널·키보드 설정에 따라 단축키가 안 먹을 수 있으니, 확실한 방법인 /plan 직접 입력을 1순위로 — 단 코덱스가 일하는 도중에는 /plan을 잠시 못 씁니다.

📎 Best practices

한국어로 시켜도 되나요?

됩니다. 접수표(의뢰문)를 한국어로 쓰면 한국어로 일하고 한국어로 보고합니다. AGENTS.md도 한국어로 적어도 됩니다.

터미널이 무서운데 다른 방법 없나요?

챗GPT 데스크톱 앱에서 폴더를 지정하면 터미널 없이 화면으로 쓸 수 있습니다. 2026년 7월부터 코덱스가 챗GPT 앱에 병합돼서, 이미 쓰던 앱이 곧 입구입니다.

📎 What's new

회사 파일로 써도 되나요? 파일이 어디로 올라가나요?

작업 자체는 내 컴퓨터의 폴더에서 일어나지만, AI가 판단하는 과정은 오픈AI 서버를 거칩니다. 회사 데이터라면 회사의 AI 사용 정책을 먼저 확인하세요 — 이건 클로드 코드를 포함한 모든 AI 도구 공통의 원칙입니다. 또 개인 Plus·Pro는 설정의 데이터 제어에서 ‘모델 개선’을 끄지 않으면 대화가 학습에 쓰일 수 있습니다(Business·Enterprise는 기본적으로 학습에 안 씀). 클라우드 작업은 오픈AI 환경에서 처리됩니다. 10월 개정

📎 Using Codex with your ChatGPT plan

클로드 코드와 코덱스를 같이 써도 되나요?

됩니다. 같은 폴더에 CLAUDE.md와 AGENTS.md가 나란히 있으면 각자 자기 것을 읽고, AGENTS.md만 있으면 클로드 코드도 그걸 읽습니다(v2.1.277부터). 실제로 두 도구를 번갈아 쓰며 결과를 비교하는 사용자도 많습니다.

📎 Claude Code — AGENTS.md

코드 아닌 일에도 쓸 수 있나요?

됩니다. 폴더 안의 문서 정리·이름 바꾸기·표 만들기 같은 파일 작업 전반에 쓸 수 있습니다. ‘내 컴퓨터에서 일하는 직원’이라는 본질은 코딩에 한정되지 않습니다.

이거 배우면 개발자가 되는 건가요?

아닙니다. ‘일을 맡길 줄 아는 사람’이 되는 겁니다. 그리고 그 능력은 도구를 갈아타도 남습니다 — 이 책이 증명하듯, 클로드 코드에서 배운 것이 코덱스에서 그대로 통했으니까요.

월 500달러 「Pro 500」은 뭐가 다른가요? 10월 개정

챗GPT Pro는 월 100·200·500달러 세 단계입니다. Pro 500은 셋 중 사용량이 가장 많고, GPT-6 Astra의 답이 최대 8배 빨리 나오는 초고속(Ultrafast)을 쓸 수 있는 유일한 개인 요금제입니다. 대신 초고속으로 시킨 일은 같은 일이라도 사용량이 평소의 8배 깎입니다. 업무량이 많지 않다면 Plus로 시작하고, 부족할 때 크레딧 충전이나 상위 요금제를 검토하세요(자세히는 A-2 요금제 표).

📎 About ChatGPT Pro tiers · Pricing

GPT-5.5를 쓰고 있었는데요? 10월 개정

GPT-5.5는 2026년 10월 14일 챗GPT·Work·코덱스에서 은퇴합니다(OpenAI API는 영향 없음). Plus 이상은 GPT-6 Sol(가능하면 권장 모델인 6.1 Sol), 무료·Go는 데스크톱 앱의 GPT-6 Luna로 바꾸세요. config.toml·예약 작업·스크립트에 gpt-5.5가 적혀 있으면 미리 고쳐두세요.

📎 Models — GPT-5.5 retirement

「Approve for me」가 뭔가요? 10월 개정

폴더 밖으로 나가는 요청에 승인 창이 뜰 때, 사람 대신 검토 AI가 결재하는 방식입니다(폴더 안의 일은 원래 묻지 않아 검토 대상이 아님). 출입증(샌드박스)은 그대로라 코덱스가 닿는 범위는 넓어지지 않습니다. 챗GPT 앱 설정 > General > Permissions의 ‘Auto-review’를 켜야 메뉴에 보이고, 터미널은 codex --approve-for-me. 막힌 일을 한 번 허락해 다시 시키려면 /approve.

📎 Auto-review