Codex와 Claude Code 차이점 정리
Codex와 Claude Code는 둘 다 코드를 다룰 수 있지만, 실제 작업에서는 맡기는 일이 조금 달랐습니다. 하나가 무조건 낫다기보다, 작업 크기에 따라 편한 쪽이 달랐습니다.
Daejin Lab을 만들면서 느낀 기준은 이렇습니다. 넓게 읽고 계획해야 하는 일은 Claude Code 계열이 편했고, 수정할 파일이 분명한 일은 Codex 계열이 빨랐습니다.
Codex가 편한 일
Codex는 범위가 작을 때 쓰기 좋았습니다.
특정 Markdown 글 보강
작은 컴포넌트 수정
빌드 에러 한 건 해결
반복되는 문장 구조 정리
명확한 조건이 있는 파일 수정
예를 들어 “이 글에서 일반론 문장을 줄이고, npm run build 검증 경험을 넣어줘”처럼 파일과 목표가 분명하면 빠르게 처리하기 좋습니다.
Claude Code가 편한 일
Claude Code는 프로젝트 전체 문맥을 읽어야 할 때 편했습니다.
프로젝트 구조 파악
어떤 파일을 수정해야 하는지 찾기
Search Console과 sitemap 흐름 정리
여러 파일을 함께 바꾸는 작업 계획
작업 결과 요약과 다음 단계 정리
카테고리 페이지를 추가할 때는 src/pages, src/content, src/lib, 레이아웃 파일 사이 관계를 먼저 봐야 했습니다. 이런 작업은 단일 파일 수정보다 문맥 파악이 중요합니다.
같이 쓸 때의 순서
개인 프로젝트에서는 아래 순서가 무난했습니다.
1. 전체 구조와 위험한 지점을 먼저 파악한다.
2. 수정 범위를 작게 자른다.
3. 파일 단위로 구현한다.
4. npm run build로 확인한다.
5. 변경 내용을 기록한다.
도구 이름보다 중요한 건 작업 크기입니다. 큰 문제를 큰 요청으로 던지면 어느 도구를 써도 결과가 흔들립니다.
비용도 같이 봐야 한다
긴 컨텍스트를 계속 읽히면 비용이 빨리 늘어납니다. 특히 같은 설명을 매번 반복하면 낭비가 큽니다.
Daejin Lab에서는 반복 설명을 줄이기 위해 프로젝트 운영 문서와 wiki 기록을 남겼습니다.
프로젝트는 Astro 기반이다.
배포는 Cloudflare Pages다.
출력 폴더는 dist다.
공개 주소는 pages.dev다.
API 키와 토큰은 커밋하지 않는다.
자동 발행은 하지 않는다.
이런 규칙을 파일로 남기면 다음 작업에서 다시 설명할 내용이 줄어듭니다.
마지막 기준은 빌드다
도구를 나눠 쓰더라도 마지막 확인은 같습니다.
npm run build
Daejin Lab에서는 글을 추가하거나 레이아웃을 바꾼 뒤 이 명령을 계속 돌렸습니다. 배포 후에는 공개 URL도 확인했습니다.
/blog/
/categories/
/sitemap.xml
설명이 그럴듯해도 빌드가 깨지면 운영 가능한 결과물이 아닙니다. 이 기준 하나를 고정해두면 도구를 바꿔도 품질이 덜 흔들립니다.
이번 작업에 적용한 구분
Daejin Lab 보강 작업에서는 계획과 실행을 나눠서 봤습니다.
계획 단계: sitemap은 멈추고, 콘텐츠·브랜딩·AdSense 준비도로 이동
파일 수정 단계: 약한 글 후보를 정하고 한 묶음씩 보강
검증 단계: npm run build, git diff, sitemap URL 수 확인
승인 단계: git push와 실제 배포 확인은 사용자 승인 후 진행
이 구분을 두면 도구 선택보다 작업 흐름이 먼저 보입니다. 어떤 도구를 쓰든, 마지막에 빌드와 diff로 확인할 수 있어야 운영 가능한 결과입니다.
이번 콘텐츠 보강에서 나눈 역할
이번 블로그 보강에서는 도구 선택보다 역할 분리가 더 중요했습니다. 기준은 아래처럼 잡았습니다.
사람: 어떤 글이 대표 글인지 결정하고, 공개/푸시 여부를 승인
Codex: 여러 Markdown 파일의 반복 수정, 빌드 검증, git 상태 확인
검토 단계: diff, 문장 톤, 내부 링크, sitemap 변경 여부 확인
이렇게 나누면 자동화가 글을 마음대로 발행하는 구조가 아니라, 운영자가 정한 방향을 빠르게 반영하는 구조가 됩니다. 초안을 만들어도 자동 발행하지 않는 이유와도 같은 원칙입니다. 작업 규칙은 개인 프로젝트에 AGENTS.md를 두는 이유에, 작은 구현 흐름은 Cursor로 작은 웹앱을 빠르게 만드는 흐름에 이어서 정리했습니다.
지금 쓰는 구분법
Codex는 작은 구현과 빠른 수정에, Claude Code는 넓은 문맥 파악과 작업 관리에 더 잘 맞았습니다. 개인 프로젝트에서는 둘 중 하나만 고르기보다, 계획·구현·검토 단계에 맞춰 나눠 쓰는 편이 현실적입니다.