20장. Codex 시작하기

지난 장에서 우리는 Claude Code를 어떻게 처음 만나야 하는지 살펴봤습니다. 그때의 핵심 감각은 이랬습니다. Claude Code는 옆자리에 앉아 함께 화면을 보고, 설명하고, 중간중간 확인을 받으며 일하는 조수에 가깝다는 점입니다.

이번 장의 주인공인 Codex는 결이 조금 다릅니다.

같은 AI 코딩 도구이지만, Codex는 대체로 함께 한 줄씩 의논하며 가는 도구라기보다 일감을 맡기고 결과를 검토하기 좋은 도구로 느껴집니다. 그래서 어떤 사람은 Claude Code를 더 편하게 느끼고, 어떤 사람은 Codex를 더 시원하게 느낍니다.

초보자에게 중요한 것은 둘 중 누가 더 세냐를 따지는 일이 아닙니다. 지금 내 작업에 누가 더 잘 맞느냐를 아는 일입니다. 이 장에서는 바로 그 감각을 잡아보겠습니다.

Codex를 한 문장으로 이해하기

Codex는 코드를 대신 써주는 채팅창이 아니라, 프로젝트를 읽고 수정하고 실행하고 검증하는 AI 코딩 에이전트입니다. 공식 가이드에서도 Codex는 앱, CLI, IDE 확장 같은 여러 방식으로 쓰일 수 있고, 파일 편집, 명령 실행, 테스트 확인, 작업 검증까지 포함한 실제 개발 흐름을 돕는 도구로 설명됩니다.¹

쉽게 말하면 이런 느낌입니다.

브라우저 속 일반 AI가 아이디어를 말로 잘 풀어주는 상담원이라면, Codex는 일감이 담긴 작업 지시서를 받아 실제로 손을 움직이는 실행 담당자에 가깝습니다.

여기서 중요한 차이가 하나 있습니다. Codex는 단순히 코드 한 조각을 던져주는 데서 끝나지 않고, 작업 단위를 기준으로 움직이기 좋습니다. 예를 들어 특정 기능 초안 만들기, 테스트 생성하기, 린트 오류 정리하기, PR 설명문 쓰기 같은 식으로 끝이 있는 일을 맡기기에 잘 맞습니다.¹²

Codex의 첫인상은 왜 Claude Code와 다를까

많은 비교 글이 공통으로 말하는 점이 있습니다. Claude Code는 협업형, Codex는 자율 실행형에 더 가깝다는 것입니다.³⁴

이 말을 너무 어렵게 받아들일 필요는 없습니다. 체감으로 바꾸면 이렇습니다.

Claude Code가 옆에서 계속 상의하는 선배라면, Codex는 일을 맡기면 한동안 조용히 집중했다가 결과물을 들고 오는 동료에 가깝습니다.

물론 두 도구 모두 코드를 읽고 수정하고 실행할 수 있습니다. 둘 다 비슷한 일을 어느 정도는 해냅니다. 하지만 일하는 리듬이 다릅니다. 이 차이를 먼저 이해하면 훨씬 덜 헷갈립니다.

이 표를 시험 문제처럼 외울 필요는 없습니다. 다만 한 문장만 기억하면 좋습니다.

Claude Code는 대화하면서 밀고 가기 좋고, Codex는 작업을 맡기고 결과를 점검하기 좋다.

Codex가 특히 잘 맞는 순간

Codex의 장점은 일을 잘게 쪼갠 뒤, 그중 하나를 붙잡고 끝까지 밀어붙이는 감각에서 잘 드러납니다. 그래서 다음 같은 상황에서 특히 편합니다.

첫째, 명확한 초안 만들기입니다. 예를 들어 글 목록 페이지 초안 만들기, 검색 입력창 붙이기, 기본 API 라우트 뼈대 만들기처럼 결과물이 비교적 선명한 작업에 잘 맞습니다.³⁵

둘째, 반복 작업입니다. 테스트 생성, 린트 오류 수정, 비슷한 패턴의 파일 정리, 작은 마이그레이션처럼 사람이 하면 조금 지루한 일을 맡기기 좋습니다.⁴⁵

셋째, 병렬로 굴리기 좋은 작업입니다. Codex는 작업 스레드나 워크트리, 분리된 작업 단위 중심의 흐름과 잘 맞아서, 서로 크게 부딪히지 않는 일을 나누어 돌리기 좋습니다.²⁴

넷째, GitHub와 이어지는 정리 작업입니다. 변경 요약 작성, PR 단위 정리, CI 실패 확인 같은 흐름에도 Codex가 잘 어울린다는 평가가 많습니다.⁴⁵

초보자 눈높이로 바꾸면 이렇습니다.

Codex는 설명형 AI라기보다 처리형 AI로 쓰면 만족도가 올라갑니다. 뭔가를 오래 상담하기보다, 분명한 일을 맡기고 결과를 보는 쪽에 더 강점이 있다는 뜻입니다.

반대로 Claude Code가 더 편한 순간도 있다

그렇다고 Codex가 모든 상황에서 더 편한 것은 아닙니다. 어떤 일은 여전히 Claude Code 쪽이 더 자연스럽습니다.

예를 들어 기능 요구가 아직 흐릿할 때가 그렇습니다. 로그인 흐름을 어떻게 잡아야 할지, 프론트엔드와 백엔드 경계를 어디서 나눠야 할지, 데이터 흐름이 어디서 꼬였는지처럼 생각하면서 구조를 잡아야 하는 문제는 Claude Code의 대화형 리듬이 잘 맞습니다.³⁵

또 여러 파일에 걸친 복잡한 수정, 애매한 버그 추적, 코드베이스 이해가 먼저 필요한 작업도 Claude Code 쪽이 편하다고 느끼는 사람이 많습니다.³⁵

이 차이를 실감나게 표현하면 이렇습니다.

• 무엇을 만들지 아직 흐리면 Claude Code가 편합니다.

• 무엇을 만들지 이미 선명하면 Codex가 편합니다.

• 어디가 문제인지 모르면 Claude Code가 편합니다.

• 무엇을 고쳐야 하는지 알면 Codex가 편합니다.

둘 중 하나가 절대 우위라는 뜻이 아닙니다. 질문의 상태가 다르면 잘 맞는 도구도 달라진다는 뜻입니다.

Codex를 처음 쓸 때 가져야 할 마음가짐

초보자가 Codex를 처음 만날 때 가장 흔히 하는 실수가 있습니다. 바로 처음부터 너무 큰 일을 한 번에 맡기는 것입니다.

예를 들면 이런 식입니다.

서비스 전체를 다 만들어줘.

회원가입, 로그인, 글 작성, 검색, 관리자 기능, 배포까지 한 번에 해줘.

이런 요청은 사람에게도 무겁고, AI에게도 무겁습니다. Codex가 실행형 도구라고 해서 큰 덩어리의 불명확한 일을 자동으로 완벽하게 처리해주는 마법상자는 아닙니다.

오히려 Codex는 이런 식으로 시작할수록 좋습니다.

• 글 목록 화면 초안을 만들어줘.

• 게시글 작성 폼에 제목과 내용 검증을 붙여줘.

• 현재 테스트가 실패하는 이유를 찾고 고쳐줘.

• 변경 내용을 커밋 전 검토용으로 요약해줘.

이런 요청은 범위가 보입니다. 어디서 시작하고 어디서 끝나는지도 보입니다. Codex의 실행력이 살아나는 구간은 바로 이런 곳입니다.¹²

Codex에게 처음 시켜보면 좋은 일들

처음부터 대단한 기능을 맡기지 않아도 됩니다. 오히려 아래 같은 요청으로 시작하면 Codex의 성격을 빨리 파악할 수 있습니다.

• 이 저장소를 실행하는 데 필요한 명령을 정리해줘.

• 게시글 목록 화면 초안을 만들고, 필요한 파일을 생성해줘.

• 현재 린트 에러를 모두 찾아서 고쳐줘.

• 로그인 관련 테스트가 깨지는 이유를 찾고 수정해줘.

• 방금 바뀐 내용을 PR 설명문처럼 요약해줘.

이 요청들의 공통점은 간단합니다. 끝이 있다는 점입니다.

Codex는 끝이 보이는 일에서 특히 시원합니다. 그래서 초보자일수록 Codex에게는 긴 소설 같은 요구보다, 검토 가능한 작업 카드 한 장처럼 말하는 편이 좋습니다.

AGENTS.md와 스킬은 왜 중요한가

Codex를 조금 더 본격적으로 쓰기 시작하면 AGENTS.md나 스킬 같은 말을 만나게 됩니다. 처음에는 이름만 들어도 살짝 어렵게 느껴질 수 있습니다. 하지만 개념은 단순합니다.

AGENTS.md는 이 프로젝트에서 AI가 따라야 할 작업 안내문입니다. 예를 들어 어떤 명령으로 테스트를 돌리는지, 어떤 폴더 구조를 지켜야 하는지, 어떤 방식으로 PR을 써야 하는지 같은 규칙을 적어두는 문서입니다.²

이 파일이 있으면 매번 같은 설명을 반복하지 않아도 됩니다. 마치 새 팀원이 들어왔을 때 짧은 온보딩 문서를 주는 것과 비슷합니다.

스킬은 자주 반복하는 작업을 묶어두는 장치로 이해하면 쉽습니다. 예를 들어 테스트하기, CI 확인하기, 특정 형식으로 계획 세우기 같은 흐름을 재사용 가능하게 만드는 것입니다.¹

지금 단계에서 중요한 것은 설정법을 모두 외우는 일이 아닙니다. Codex는 말만 잘 알아듣는 도구가 아니라, 규칙을 주면 더 안정적으로 움직이는 도구라는 점을 아는 것입니다.

어떤 작업에 어떤 도구를 고를까

이 장의 핵심은 바로 여기입니다. 이제 실제 선택 기준을 잡아보겠습니다.

작업을 시작하기 전에 아래 세 가지를 먼저 물어보세요.

• 지금 나는 함께 생각할 상대가 필요한가, 아니면 맡겨서 처리할 실행력이 필요한가

• 이 문제는 구조를 이해해야 풀리는가, 아니면 이미 범위가 선명한가

• 나는 과정을 옆에서 계속 볼 것인가, 결과를 나중에 검토할 것인가

이 세 질문에 대한 답이 대부분 방향을 정해줍니다.

예를 들어 여러분이 이런 상황이라고 해봅시다.

로그인 흐름이 자꾸 꼬여서 왜 그런지 모르겠고, 프론트엔드와 백엔드 중 어디가 문제인지도 아직 애매합니다. 이때는 Claude Code가 더 편합니다. 먼저 설명받고, 흐름을 정리하고, 수정 계획을 세우는 일이 중요하기 때문입니다.³⁵

반대로 로그인 화면은 이미 있고, 버튼 문구 수정과 에러 메시지 개선, 테스트 보강, 린트 정리처럼 해야 할 일이 뚜렷하다면 Codex가 더 잘 맞습니다. 작업을 항목별로 맡기고 검토하기 좋기 때문입니다.⁴⁵

즉, 도구 선택은 성능 비교표보다 작업의 모양을 먼저 보는 쪽이 실전적입니다.

둘 중 하나만 고르지 않아도 된다

실제로는 많은 사람이 두 도구를 함께 씁니다. 이 전략이 입문자에게도 꽤 유용합니다.³⁵

예를 들어 이 책에서 만들 서비스 기준으로 보면 이렇게 역할을 나눌 수 있습니다.

1. Claude Code로 로그인 흐름, 데이터 흐름, 파일 구조를 설명받습니다.

2. Codex로 글 목록 화면 초안이나 테스트 생성 같은 명확한 작업을 맡깁니다.

3. 다시 Claude Code로 결과를 읽어보며 왜 그렇게 구현되었는지 설명받습니다.

4. 마지막으로 Codex로 린트 정리, PR 요약, 반복 수정 같은 마감 작업을 맡깁니다.

이 흐름이 좋은 이유는 간단합니다. 한 도구에게 모든 역할을 강요하지 않기 때문입니다.

생각을 같이 정리할 때 강한 도구와, 처리량이 좋고 반복 작업에 강한 도구를 나누어 쓰면 초보자도 훨씬 덜 지칩니다. 서비스 개발은 원래 한 가지 능력만으로 끝나는 일이 아니니까요.

초보자에게 추천하는 Codex 첫 사용 원칙

마지막으로, 처음 며칠 동안은 아래 원칙만 지켜도 Codex를 훨씬 안정적으로 느낄 수 있습니다.

첫째, 작업을 작게 자르세요. Codex는 거대한 막연한 부탁보다 범위가 선명한 일에서 훨씬 잘 움직입니다.

둘째, 검토 기준을 같이 주세요. 단순히 만들어줘에서 끝내지 말고, 테스트를 돌리고, 실패하면 고치고, 무엇이 바뀌었는지 설명해달라고 하세요.¹

셋째, 결과를 믿기 전에 확인하세요. Codex가 실행형이라고 해서 항상 정답인 것은 아닙니다. AI가 잘 일하는 것과, 사람이 책임 있게 검토하는 것은 별개의 일입니다.

넷째, 반복 규칙은 문서로 남기세요. 같은 설명을 두 번 이상 하게 되면 AGENTS.md 같은 안내문으로 정리할 타이밍입니다.²

이 네 가지 원칙은 화려하지 않지만, 초보자를 꽤 오래 지켜줍니다.

이 장의 핵심: Codex는 잘 맡기면 강하다

Codex를 시작할 때 꼭 기억하면 좋은 문장이 있습니다.

Codex는 잘 물어보는 도구이기도 하지만, 더 정확히는 잘 맡기는 도구다.

Claude Code가 옆에서 같이 고민해주는 느낌이라면, Codex는 범위가 선명한 일을 받아 실제로 밀어주는 느낌에 가깝습니다. 그래서 둘의 차이는 능력의 높낮이보다 협업 방식의 차이로 이해하는 편이 훨씬 좋습니다.

• 구조를 이해하고 싶을 때는 Claude Code

• 범위가 선명한 작업을 맡기고 싶을 때는 Codex

• 애매한 문제를 같이 풀 때는 Claude Code

• 반복 작업과 마감 정리를 밀어붙일 때는 Codex

이 기준만 잡혀도 도구 선택이 훨씬 쉬워집니다.

다음 장에서는 한 걸음 더 나아가, 실제로 AI에게 파일 단위의 작업을 맡기고 결과를 검토하는 법을 다뤄보겠습니다. 그때부터는 Codex와 Claude Code를 더 실전적으로 다루게 될 것입니다.

참고

¹Best practices - Codex | OpenAI Developers

²OpenAI Codex: Workflows and Best Practices 2026

³Claude Code vs Codex CLI: Which AI Coding Agent Should You Use in 2026?

⁴Codex vs Claude Code: Which CLI Agent Wins for Your Workflow in 2026

⁵Best Tasks for Claude Code vs OpenAI Codex