코덱스(Codex)는 OpenAI가 만든 AI 코딩 에이전트입니다. 여러분이 "이 버그 고쳐줘"라고 말하면, 코덱스가 직접 코드를 읽고, 수정하고, 테스트까지 돌려서 결과를 가져옵니다. 챗봇에게 코드를 물어보고 복사해서 붙여넣던 시대에서, 개발 실무를 통째로 맡기는 시대로 넘어온 것이죠.
비유하자면 이렇습니다. ChatGPT가 "요리법을 알려주는 셰프"라면, 코덱스는 "주방에 직접 들어와서 요리해 주는 셰프"입니다. 레시피만 받는 게 아니라, 완성된 요리(수정된 코드와 테스트 결과)를 받습니다.
코덱스는 하나가 아니라 세트입니다
코덱스라는 이름 아래에 여러 개의 입구가 있습니다. 어디서 쓰든 같은 에이전트, 같은 계정, 같은 설정을 공유합니다.
- 코덱스 CLI: 터미널에서 실행하는 기본 형태. 코드 읽기, 파일 수정, 명령어 실행을 모두 합니다.
- IDE 확장: VS Code, Cursor 같은 편집기 안에서 코덱스를 부르는 확장 프로그램입니다.
- 클라우드(Codex Web): 작업을 OpenAI의 클라우드 샌드박스에 맡겨 두고, 나는 다른 일을 하는 방식입니다.
- GitHub 연동: 이슈나 PR에서 @codex를 멘션하면 코덱스가 알아서 작업을 시작합니다.
Claude Code와 뭐가 다른가요?
가장 많이 비교되는 도구가 앤트로픽의 Claude Code입니다. 둘 다 훌륭한 코딩 에이전트지만, 성격이 다릅니다. Claude Code는 "옆자리에 앉아 실시간으로 함께 일하는 페어 프로그래머"에 가깝고, 코덱스는 "업무를 맡기고 결과 보고를 받는 팀원"에 가깝습니다.
| 구분 | 코덱스 (Codex) | Claude Code |
|---|---|---|
| 만든 회사 | OpenAI | Anthropic(앤트로픽) |
| 기본 성격 | 비동기 위임에 강함 (맡기고 다른 일 하기) | 실시간 협업에 강함 (대화하며 함께 작업) |
| 규칙 파일 | AGENTS.md | CLAUDE.md |
| 클라우드 작업 | 핵심 기능 (샌드박스에서 실행 후 PR 생성) | 보조 기능 (로컬 중심) |
| 승인 방식 | Read Only / Auto / Full Access 모드 | 단계별 승인 + 권한 설정 |
| 요금 | ChatGPT Plus/Pro 요금제에 포함 | Claude Pro/Max 요금제에 포함 |
둘 중 하나만 골라야 하는 건 아닙니다. 실무에서는 "실시간으로 붙어서 하는 작업은 Claude Code, 맡겨 두고 잊어도 되는 작업은 코덱스"처럼 병행하는 개발자가 많습니다.
이 코스에서는 설치부터 시작해서, 첫 작업 시키기, 클라우드 위임, GitHub PR 워크플로우, AGENTS.md 설정, 그리고 실전 버그 수정까지 차례로 배웁니다. 터미널이 처음이어도 따라올 수 있도록 하나씩 설명하겠습니다.
과거에 "Codex"는 2021년 GitHub Copilot의 기반이 된 옛날 모델 이름이기도 했습니다. 검색하다가 오래된 문서를 만나면 헷갈릴 수 있어요. 지금 배우는 코덱스는 2025년 이후의 코딩 에이전트 제품을 말합니다.