코덱스 배우기, 공식 자료로 프롬프트 4요소부터 Academy 강좌 3개까지 익히는 3주 순서

코덱스 배우기, 공식 자료로 프롬프트 4요소부터 Academy 강좌 3개까지 익히는 3주 순서

코덱스: OpenAI가 만든 코딩 에이전트(사람 대신 파일을 읽고 고쳐 주는 AI 도우미)예요. ChatGPT 데스크톱 앱이나 CLI(명령어를 입력해서 쓰는 방식) 등에서 쓰고, 고른 폴더의 파일을 읽고 고쳐 줘요.

코덱스 배우기는 어떤 순서로 하면 되나요?

처음에는 영상이나 강의를 찾기보다 OpenAI가 직접 쓴 초보자용 가이드부터 보는 게 빨라요. OpenAI 공식 Best practices 가이드에 따르면 순서는 이렇게 이어져요. 작업에 맞는 맥락을 주고, 오래 쓸 지침은 AGENTS.md(Codex가 작업 전에 읽는 지침 문서)에 적고, 설정을 맞추고, MCP(AI를 외부 도구와 연결하는 공통 규격)로 바깥 시스템을 붙이고, 반복되는 일은 스킬(반복 작업의 방법을 묶어 둔 설명서)로 만들고, 안정된 일은 자동화해요. 단계는 모두 6개예요.

"Codex works best when you treat it less like a one-off assistant and more like a teammate you configure and improve over time."

한 번 쓰고 마는 도우미가 아니라, 설정하고 시간이 갈수록 다듬어 가는 팀 동료처럼 대할 때 가장 잘 작동한다는 뜻이에요.

이 글의 일정표는 위 6단계에 초보자가 먼저 겪는 일, 곧 권한과 결과 확인을 앞으로 당겨 놓은 제안이에요. 공식 문서가 정한 주차별 순서는 아니라는 점만 기억해 주세요.

코덱스는 무료로 시작할 수 있나요?

Codex 가격 페이지에는 Codex가 포함된 ChatGPT 요금제가 7개(Free, Go, Plus, Pro, Business, Edu, Enterprise) 나와 있어요. 개인이 고를 만한 앞쪽 네 가지만 정리하면 이래요(2026년 11월 4일 가격표 기준, 달러 표기).

Free는 "순차 적용"이라서 계정에 아직 안 열려 있을 수 있어요. 원화 가격은 확인하지 못해서 적지 않았고, Business 이상은 Codex 가격 페이지에서 직접 보세요.

사용량은 5시간 단위로 가늠해요. 같은 페이지에서 Plus의 5시간당 로컬 메시지 추정치는 GPT-6.1 Sol이 15-160개, GPT-6 Luna가 350-3,000개예요. 고정 한도가 아닌 추정치이고 주간 한도가 더해질 수 있어요. 처음에는 한도보다 첫 요청을 해 보는 게 먼저예요.

첫 요청은 어떻게 보내면 되나요?

시작은 데스크톱 앱이 가장 쉬워요. 설치 방법과 첫 로그인은 코덱스 사용법 2026: 앱 설치·로그인·첫 요청까지 15분 가이드에 따로 정리해 뒀고, 공식 안내는 4단계예요.

1. 데스크톱 앱을 설치하세요(macOS, Windows, Linux 지원). 앱 한 개로 시작해야 설정이 단순해서예요.
2. ChatGPT 계정으로 로그인하세요. 요금제와 사용량이 이 계정에 묶여서예요.
3. 작업할 폴더를 고르고, ChatGPT 드롭다운에서 Codex를 선택해 New chat을 여세요. Codex가 고른 폴더의 파일을 읽고 고치기 때문이에요.
4. 첫 메시지를 보내세요. 지금부터 보내는 문장이 곧 프롬프트라서예요.

공식 가이드는 프롬프트에 네 가지를 넣으라고 권해요.

• Goal: 무엇을 바꾸거나 만들고 싶은가요.
• Context: 어떤 파일, 폴더, 자료, 오류가 관련 있나요. 파일은 @로 불러서 맥락으로 줄 수 있어요.
• Constraints: 지켜야 할 기준이나 안전 조건은 무엇인가요.
• Done when: 무엇이 참이면 끝난 건가요.

"Codex is already strong enough to be useful even when your prompt isn't perfect."

프롬프트가 완벽하지 않아도 쓸모 있을 만큼 이미 강하다는 뜻이에요. 다만 네 가지를 쓰면 결과가 더 믿을 만해진다고 가이드가 덧붙여요. 아래는 개발 지식 없이 해 볼 수 있는 연습 문장이에요. 폴더 하나를 골라 붙여 넣으세요.

목표: 이 폴더의 회의 메모 파일 이름을 "날짜_주제" 형식으로 바꾸는 계획을 세워 주세요.
맥락: 메모 파일이 여러 개 있고, 이름이 제각각이에요.
지킬 선: 파일 내용은 고치지 말고 이름만 바꿔요. 바꾸기 전에 목록을 먼저 보여 주세요.
끝나는 조건: 바뀐 이름 목록이 표로 나오고, 지워진 파일이 없어야 해요.

네 줄로 나눠 적은 이유는 빈칸을 Codex가 추측하는 일을 줄이기 위해서예요. 먼저 계획과 목록을 받는 형태라 파일이 바뀌기 전에 한 번 확인할 수 있어요.

어려운 일은 왜 Plan 모드부터 시작하나요?

복잡하거나 설명하기 애매한 일은 코드를 쓰기 전에 계획을 시키라고 공식 가이드가 말해요. 방법은 3개예요.

1. Plan 모드: Codex가 맥락을 모으고 질문한 뒤 계획을 세우는 모드예요. 슬래시 명령(/로 시작하는 단축 명령)인 /plan 또는 Shift+Tab으로 켜요. 가이드가 대부분의 사용자에게 가장 쉽고 효과적이라고 소개하는 방법이에요.
2. 인터뷰 요청: 막연한 생각을 구체화하고 싶을 때 "먼저 나에게 질문해 줘"라고 시켜요. 내 가정에 반박하게 할 수도 있어요.
3. PLANS.md 템플릿: 길고 여러 단계인 작업용 고급 방법이에요. 처음에는 건너뛰어도 돼요.

앞의 연습 문장을 한 단계 키우고 싶다면 이렇게 시작해 보세요. 일을 맡기기 전에 계획을 먼저 받는 문장이에요.

바로 시작하지 말고, 먼저 나에게 필요한 질문을 해서 계획부터 세워 주세요.

권한은 왜 처음에는 기본값 그대로 두나요?

공식 Best practices 가이드는 조절할 수 있는 손잡이를 2개로 설명해요. 승인 방식은 Codex가 명령을 실행하기 전에 언제 허락을 구할지를, 샌드박스(Codex가 건드릴 수 있는 범위를 가두는 울타리) 방식은 읽고 쓸 수 있는 폴더와 접근 파일 범위를 정해요.

"If you're new to coding agents, start with the default permissions."

코딩 에이전트가 처음이라면 기본 권한으로 시작하라는 뜻이에요. 공식 보안 문서에는 기본 상태로 네트워크가 꺼져 있고, 쓰기는 작업 폴더로 제한된다고 적혀 있어요. Auto 프리셋(CLI와 코드 편집기 기준)에서는 작업 폴더 안의 읽기, 수정, 명령 실행은 자동으로 하되, 폴더 밖 수정이나 네트워크가 필요한 명령은 승인을 물어요. 바꾸지 않고 대화와 계획만 하고 싶다면 CLI의 /permissions로 read-only를 고를 수 있어요. 필요가 분명해질 때만 하나씩 풀면 돼요.

결과가 맞는지는 어떻게 확인하나요?

결과를 받는 데서 멈추지 말고 확인까지 시키라는 게 공식 가이드의 요지예요. 필요하면 테스트를 만들고, 검사를 돌리고, 결과를 확인하고, 변경분을 검토하게 해요. 비개발자라면 "Done when"에 확인 방법을 적는 것으로 충분해요. 데스크톱 앱에서는 diff(바뀐 부분을 비교해서 보여 주는 화면) 패널을 열어 줄을 눌러 피드백을 남길 수 있고, 그 내용이 다음 요청의 맥락이 돼요.

CLI에서는 /review로 4개 방식의 검토를 시킬 수 있어요.

1. 기준 브랜치와 비교하는 방식
2. 아직 저장(커밋)하지 않은 변경을 보는 방식
3. 특정 커밋을 보는 방식
4. 내가 지시를 직접 쓰는 방식

AGENTS.md는 언제 만들면 되나요?

같은 요청을 반복해서 쓰게 될 때예요. 공식 가이드는 AGENTS.md를 에이전트용 README(설명서)처럼 쓰라고 해요. 자동으로 맥락에 불러와지고, 저장소(코드와 파일을 모아 둔 폴더)에서 어떻게 일해 달라는지를 적는 곳이에요. 실행 방법, 확인 방법, 하지 말 것, 끝났다는 기준을 적으면 돼요.

• 둘 수 있는 위치는 3개예요. 개인 기본값은 ~/.codex, 공유 기준은 저장소 루트, 세부 규칙은 하위 폴더예요. 현재 폴더에 가까운 파일의 지침이 이겨요.
• 초안은 직접 쓰거나 CLI의 /init으로 만들 수 있어요. 결과는 내 방식에 맞게 고쳐 써야 해요.
• AGENTS.md 문서 설명에는 합산 기본 상한이 32 KiB로 적혀 있어요. 넘으면 뒤 파일이 안 들어가요.

짧고 정확한 파일이 길고 모호한 파일보다 낫다고 가이드가 강조해요. Codex가 같은 실수를 두 번 하면 회고를 시키고 AGENTS.md를 고치는 식으로 키우면 돼요.

MCP, 스킬, 예약 작업은 언제 쓰나요?

기본기가 잡힌 뒤에 한두 개씩만 붙이세요. 가이드의 기준은 단순해요.

• MCP: 필요한 맥락이 저장소 밖에 있을 때 써요. 앱의 Settings > MCP servers에서 보고, 한두 개의 도구로 시작하라고 해요. 늘 하던 손작업을 확실히 줄여 주는 도구부터 붙이라는 뜻이에요.
• 스킬: 같은 프롬프트를 계속 쓰거나 같은 흐름을 고치고 있다면 스킬로 만들 때예요. 처음에는 구체적인 사용 사례 2~3개로 시작하고, 설명에 무엇을 하고 언제 쓰는지 적어요.
• 예약 작업: 데스크톱 앱의 Scheduled 페이지에서 프로젝트, 프롬프트, 주기, 실행 환경을 골라요. "스킬은 방법을 정하고 예약 작업은 일정을 정한다"는 게 공식 설명이에요.

"skills define the method and scheduled tasks define the schedule"

예약은 손으로 먼저 안정적으로 되는 일에만 걸어야 해요. 아직 계속 손봐야 하는 일은 스킬부터 만드세요.

OpenAI Academy 강좌는 어떻게 들으면 되나요?

OpenAI 도움말 센터 설명으로는 Codex 경로의 강좌가 3개이고, 모두 무료예요. ChatGPT 계정만 있으면 academy.openai.com에서 들을 수 있어요.

배지는 평가에서 80% 이상을 받아야 하고, 평가 없이 강좌만 들어도 돼요. 3개를 모두 마치고 각 평가에서 80% 이상이면 수료증이 나오지만, 둘 다 자격증(certification)은 아니라고 도움말이 밝혀요. 챗GPT 쪽 공식 자료가 궁금하면 챗GPT 배우기, OpenAI 공식 무료 자료로 일주일 안에 익히는 순서도 같은 방식으로 정리했어요.

제안 하나 드릴게요. 첫 강좌는 저장소 단위의 코딩 작업을 다루니, 앱으로 첫 요청을 몇 번 해 본 뒤 듣는 걸 권해요. 이 순서는 공식 순서가 아니라 제 제안이에요.

3주 동안 무엇을 어떤 순서로 하면 되나요?

위 내용을 3주로 묶으면 아래와 같아요. 공식 일정이 아니라 제안이니, 바쁜 주는 하루씩 밀어도 괜찮아요.

처음 하면 여기서 막힙니다

OpenAI 공식 문서가 직접 적어 둔 주의 사항 중에서 처음 쓰는 분이 걸릴 만한 것만 골랐어요.

1. 같은 규칙을 매번 프롬프트에 길게 적고 있어요. 공식 "흔한 실수 8가지"의 첫 번째예요. 오래 쓸 규칙은 AGENTS.md나 스킬로 옮기세요.
2. 결과가 맞는지 Codex가 스스로 확인하지 못해요. 빌드와 테스트 방법을 알려 주지 않은 경우예요. 확인 방법을 Done when에 적으세요.
3. 복잡한 일을 바로 시켰더니 엉뚱해요. 여러 단계의 일에서 계획을 건너뛴 경우예요. Plan 모드부터 쓰세요.
4. 전체 권한을 주고 싶어져요. 흐름을 이해하기 전에 컴퓨터 전체 권한을 주지 말라는 게 공식 경고예요. 네트워크는 기본으로 꺼져 있고, 폴더 밖 수정은 승인을 물어요.
5. 같은 파일에서 작업을 동시에 돌렸어요. Git(파일 변경 이력을 관리하는 도구)의 Git worktree(같은 저장소를 별도 폴더로 나눠 쓰는 기능) 없이 같은 파일을 건드리면 꼬여요. 한 프로젝트 전체를 채팅 하나로 끌고 가는 것도 공식 실수 목록에 있으니, 하나의 결과물마다 채팅을 나누세요.
6. 한도에 닿았어요. Codex 가격 페이지에는 한도에 닿아도 진행 중인 턴은 마무리된다고 적혀 있어요. 남은 사용량은 CLI의 /status나 사용량 대시보드에서 보고, Plus와 Pro는 크레딧을 추가로 살 수 있어요. 이미지 생성은 Free에서 안 되고, 비슷한 턴보다 평균 3-5배 빨리 사용량을 써요.
7. Academy 계정을 잘못 골랐어요. 진도와 배지는 로그인 이메일에 묶이고, 강좌를 시작한 뒤에는 계정을 연결하거나 합칠 수 없어요.

마무리

코덱스 배우기는 데스크톱 앱에서 4요소로 첫 요청을 보내고, 어려운 일은 Plan 모드로 계획부터 받고, 권한은 기본값으로 두고, 결과를 확인하는 습관을 들인 뒤에 AGENTS.md와 외부 연결로 넓혀 가는 순서면 충분해요. 오늘은 위 연습 문장에 폴더 하나를 골라 붙여 넣는 것만 해 보세요. 그다음 주에 Academy 강좌를 이어 가면 돼요.

자주 묻는 질문

코덱스 배우기를 무료로 시작할 수 있나요?

네, Free 요금제가 $0/월이고 데스크톱 앱에서 GPT-6 Luna를 쓸 수 있어요(2026년 11월 4일 가격표 기준). 다만 순차 적용이라 계정에 아직 안 열렸을 수 있어요. Academy 강좌 3개도 ChatGPT 계정만 있으면 무료예요.

코덱스는 어떤 순서로 배우는 게 좋나요?

공식 Best practices 가이드는 맥락, AGENTS.md, 설정, MCP, 스킬, 자동화의 6단계를 권해요. 초보자는 여기에 권한 확인과 결과 검토를 앞에 더해, 첫 요청, Plan 모드, 기본 권한, 확인, AGENTS.md 순으로 가면 덜 막혀요. 뒤쪽 순서는 제안이에요.

코덱스가 폴더 밖의 파일도 고치나요?

기본 설정에서는 쓰기가 작업 폴더로 제한되고 네트워크도 꺼져 있어요. Auto 프리셋에서는 폴더 밖 수정이나 네트워크가 필요한 명령을 실행하기 전에 승인을 물어요. 흐름을 이해하기 전에는 이 기본값을 그대로 두세요.

한도에 닿으면 하던 작업이 끊기나요?

Codex 가격 페이지에는 한도에 닿아도 진행 중인 턴은 공정 사용 범위 안에서 마무리된다고 나와 있어요. 남은 사용량은 CLI의 /status나 사용량 대시보드에서 볼 수 있어요.

Academy 강좌를 마치면 자격증을 받나요?

아니요. 평가 80% 이상이면 배지, Codex 경로의 강좌 3개를 모두 마치고 각 평가에서 80% 이상이면 수료증을 받지만, OpenAI는 둘 다 자격증이 아니라고 밝혀요.

관련 글

• 챗GPT 배우기, OpenAI 공식 무료 자료로 첫날부터…
• 클로드코드 배우기 3주 코스
• 코덱스 사용법 2026

참고 자료

• OpenAI 공식 Best practices 가이드
• Codex 가격 페이지
• Codex 퀵스타트
• ChatGPT 데스크톱 앱 안내
• 에이전트 승인과 보안
• AGENTS.md 설정 안내
• OpenAI 도움말 센터: OpenAI Academy courses