챗지피티로 작업방 만들기 — Codex 안내
— 클로드가 아니어도 하네스는 그대로 옮겨진다
배움터 글이 대부분 클로드 기준으로 쓰여 있다 보니, 이미 챗지피티를 쓰는 분들이 “나는 처음부터 다시 결제해야 하나” 하고 묻는다. 아니다. 챗지피티에도 클로드코드에 해당하는 물건이 있고, 이름은 Codex다. 이 글은 챗지피티 쓰는 분이 하네스 기본세팅 4종을 자기 도구에서 그대로 하게 돕는 안내다. 아래 내용은 공식 문서(learn.chatgpt.com/codex) 기준이다.
1. 먼저 정리 — 무엇이 무엇에 해당하나
우리가 배움터에서 다루는 것은 ‘클로드’라는 상표가 아니라 작업방 구조다. 내 폴더를 열어 파일을 직접 읽고 고치는 AI, 그 AI가 매번 읽는 안내문, 쌓이는 레슨과 메모리, 다음 사람에게 넘기는 인수인계. 이 구조는 도구를 갈아타도 그대로 선다.
| 배움터에서 부르는 이름 | 클로드 | 챗지피티 |
|---|---|---|
| 내 폴더에서 일하는 AI | Claude Code | Codex |
| 매번 읽는 안내문 | CLAUDE.md | AGENTS.md |
| 데스크탑 앱 | Claude 앱의 Code 탭 | ChatGPT 앱의 Codex 모드 |
| 터미널판 | claude | codex |
| 반복 작업 묶음 | 스킬 (/로 호출) | 스킬 ($로 호출) |
레슨·메모리·인수인계는 대응물을 찾을 것도 없다. 그냥 폴더 안의 마크다운 파일이라 도구와 무관하게 똑같이 쓰인다.
2. 내 요금제로 쓸 수 있나
쓸 수 있다. Codex는 무료(Free)부터 Go·Plus·Pro·Business·Enterprise까지 모든 요금제에서 열리고, 요금제에 따라 다른 것은 사용 한도뿐이다. 기능이 잠기는 구조가 아니다.
- 한도는 다섯 시간 단위로 계산되고, 고른 모델과 요금제에 따라 폭이 크다.
- Plus·Pro는 한도를 다 쓰면 요금제를 올리지 않고 크레딧을 더 사서 이어갈 수 있다.
- 무료로 먼저 감을 잡고, 손에 붙은 뒤에 올려도 늦지 않다.
3. 설치 — 앱으로 시작하는 게 맞다
공식 문서도 데스크탑 앱을 첫 선택으로 권한다. 프로젝트와 로컬 파일, 오래 걸리는 작업에 맞춰져 있다. 터미널은 나중에 필요해지면 그때 열면 된다.
| 운영체제 | 방법 |
|---|---|
| Windows | Microsoft Store에서 ChatGPT 앱 설치. 명령으로 하려면 winget install --id 9PLM9XGG6VKS -s msstore |
| macOS | ChatGPT 데스크탑 앱 설치 (Apple Silicon용 내려받기 제공) |
| Linux | 리눅스용 앱 별도 제공 |
Windows에서 하나 더: Git을 같이 깔아 두십시오. 앱의 변경 검토(review) 판이 Git 위에서 돌아가고, 고친 것을 되돌리려면 Git이 있어야 합니다. WSL은 필요 없습니다 — 기본 설정에서 AI는 PowerShell에서 윈도우 그대로 움직입니다. (PowerShell 실행 정책에 막히면 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned.)
설치하고 앱을 열어 챗지피티 계정으로 로그인하면 준비는 끝입니다.
4. 첫 세션 — 모드를 고르고 폴더를 연다
앱에는 대화 방식이 셋 있습니다.
| 모드 | 언제 |
|---|---|
| Chat | 그냥 물어보는 것. 내 파일과 무관 |
| Work | 문서·표·발표자료 같은 사무 작업 |
| Codex | 내 폴더의 파일을 직접 읽고 고치는 작업. 작업방은 여기 |
순서는 이렇습니다.
- 앱에서 새 대화를 열고 Codex 모드를 고른다.
- 폴더 열기(open a folder) — 작업방으로 쓸 폴더를 고른다. 처음엔 잘 아는 작은 폴더가 좋다.
- 하고 싶은 일을 평소 말로 적고 엔터. 첫 마디로 “이 폴더가 뭐 하는 곳인지 설명해줘” 정도가 무난하다.
승인 범위 정하기
Codex는 무엇을 물어보고 무엇을 알아서 할지 정할 수 있습니다. 앱과 CLI 모두 /permissions로 바꿉니다.
| 설정 | 동작 |
|---|---|
| on-request (기본, 권장) | 작업 폴더 안에서는 읽고 고치고 명령을 돌리되, 폴더 밖으로 나가거나 인터넷을 쓸 일이면 물어본다 |
| read-only | 읽기만. 남의 폴더나 되돌릴 수단이 없는 폴더를 살펴볼 때 |
| danger-full-access | 승인도 울타리도 없음. 쓰지 마십시오 |
기본값에서 작업 폴더는 쓰기가 되지만 .git 같은 관리용 폴더는 읽기 전용으로 보호되고, 인터넷 접근은 꺼져 있습니다. 되돌릴 수단(Git)이 없는 폴더에서 일할 때는 read-only로 두고 보는 편이 안전합니다.
5. 하네스 4종을 Codex에 세우기 — 실제로 할 일
하네스 기본세팅 지시문 4종을 그대로 쓰면 됩니다. 바꿀 곳은 딱 한 군데, 파일 이름입니다.
지시문 안의
CLAUDE.md를 전부AGENTS.md로 바꾸십시오. 나머지(레슨.md·메모리.md·인수인계.md)는 손댈 것이 없습니다.
바꿔 붙여넣기가 번거로우면, 지시문을 붙여넣기 전에 이 한 줄을 먼저 적어도 됩니다.
아래 지시문을 따를 건데, 지시문에 나오는 CLAUDE.md는 전부 AGENTS.md로 바꿔서 진행해줘.
너는 Codex고, 네가 매 대화 시작 때 읽는 파일 이름이 AGENTS.md이기 때문이다.
AGENTS.md에 대해 알아 둘 것
- 두는 자리가 둘이다. 모든 작업에 공통으로 적용할 것은
~/.codex/AGENTS.md(전역), 이 작업방에만 해당하는 것은 작업방 폴더 안의AGENTS.md. 가까운 파일이 먼 파일을 덮습니다. /init을 치면 Codex가 초안을 만들어 줍니다. 다만 초안은 폴더를 훑어본 요약이라, 우리 방식대로 “내가 누구고 어떤 원칙으로 일하는지”는 위 지시문으로 인터뷰해 채우는 편이 낫습니다.- 32KiB 넘게 쓰지 마십시오. 기본값이 그렇고, 넘치면 뒷부분이 잘려 읽히지 않습니다. 길어지면 잘라서 하위 폴더로 나눕니다. — 원칙은 우리 쪽과 같습니다. 안내문은 짧게, 상세는 레슨과 메모리로.
알아 두면 좋은 슬래시 명령
| 명령 | 하는 일 |
|---|---|
/init | AGENTS.md 초안 만들기 |
/status | 지금 세션이 어떤 설정으로 도는지 |
/permissions | 승인 범위 바꾸기 |
/model | 모델과 생각의 깊이 고르기 |
/review | 방금 고친 것을 스스로 훑어 문제를 찾기 |
6. Codex의 기억 기능과 우리 메모리 파일
Codex에는 지난 작업의 맥락을 다음 작업으로 넘겨주는 memories 기능이 따로 있습니다.
- 앱: 설정 → Personalization → Enable memories
- CLI·IDE:
config.toml에[features]아래memories = true - 쌓이는 곳:
~/.codex/memories/
쓸모는 있지만 우리 메모리.md를 대신하지는 않습니다. 공식 문서 스스로 그렇게 못박고 있습니다 — 반드시 지켜야 할 규칙은 AGENTS.md처럼 눈에 보이고 함께 고칠 수 있는 파일에 두고, memories는 거들어 주는 층으로만 여기라고. 우리가 메모리와 레슨을 폴더 안에 마크다운으로 두는 이유와 같습니다. 열어서 읽을 수 있어야 고칠 수 있고, 동료에게 건넬 수 있어야 조직의 자산이 됩니다.
7. 스킬 — 반복 작업을 묶어 두기
같은 일을 매번 설명하는 게 지겨워질 때쯤 스킬을 만듭니다. 만드는 법도 AI에게 맡깁니다.
- 매번 똑같이 하는 일 하나를 고른다 (예: 월말 정산표 만들기).
- 대화창에
$skill-creator를 부르고, 그 일을 처음부터 끝까지 말로 설명한다. (챗지피티 쪽에서는@skill-creator) - 초안이 나오면 한 번 돌려보고 고친다.
- 다음부터는
$로 불러 쓰고, 필요하면 동료에게 건넨다.
8. 터미널이 편해졌다면
앱으로 충분하지만, 터미널이 손에 붙은 분은 CLI판도 있습니다.
curl -fsSL https://chatgpt.com/codex/install.sh | sh작업 폴더로 들어가 codex를 치면 첫 실행 때 “Sign in with ChatGPT”로 로그인합니다. 슬래시 명령은 앱과 같습니다.
9. 두 도구를 한 컴퓨터에 같이 두기
클로드와 챗지피티를 같이 쓰는 경우, 작업방 폴더 하나에 CLAUDE.md와 AGENTS.md가 나란히 있어도 서로 부딪히지 않습니다. 각자 자기 이름의 파일만 읽습니다. 다만 두 벌을 따로 고치다 보면 내용이 어긋나니, 한쪽을 정본으로 삼고 다른 쪽에는 이렇게만 적어 두는 편이 편합니다.
이 작업방의 규칙 정본은 CLAUDE.md다. 작업을 시작하기 전에 CLAUDE.md를 읽고 그대로 따른다.
레슨·메모리·인수인계는 애초에 파일 이름이 같으니 두 도구가 같은 것을 읽고 같은 곳에 씁니다. 도구를 바꿔도 기록이 끊기지 않는다는 뜻입니다.
10. 막혔을 때
| 증상 | 처방 |
|---|---|
| 앱에 Codex 모드가 안 보임 | 로그아웃 후 재로그인, 앱 업데이트 확인 |
| 변경 내용을 되돌릴 수가 없음 | Git이 깔려 있는지 확인. 검토 판과 되돌리기가 Git 위에서 돈다 |
| Windows에서 명령이 막힘 | PowerShell 실행 정책. Set-ExecutionPolicy -ExecutionPolicy RemoteSigned |
| 안내문을 쓴 대로 안 움직임 | AGENTS.md가 32KiB를 넘지 않았는지, 파일 이름이 정확한지 확인 |
| 한도를 다 씀 | 다섯 시간 단위로 회복됩니다. 급하면 크레딧 추가 또는 가벼운 모델로 전환 |
| 자꾸 물어봐서 느림 / 너무 알아서 함 | /permissions로 범위 조정 |
다음 단계
- AI 작업방 만들기 — 하네스 기본세팅 지시문 4종 — 이 글 다음에 바로 할 것.
CLAUDE.md만AGENTS.md로 바꿔 쓰십시오 - 하네스 엔지니어링 — 왜 이렇게 하는지, 도구가 바뀌어도 남는 것은 무엇인지
- LLM 위키 구축 안내 — 작업방 다음, 지식을 위키로 쌓는 단계
- 클로드코드 데스크탑앱 안내 — 클로드 쪽 같은 안내. 둘을 나란히 두고 보면 대응이 보입니다