Claude Code 와 Codex의 결정적인 차이

둘은 설계 철학부터 다릅니다. Claude Code는 "개발자 옆에 앉아서 같이 생각하는 동료"를 목표로 설계됐습니다. Anthropic이 공식적으로 쓰는 표현도 "collaborative pair programmer"입니다. 사용자와 대화하면서 모호한 부분은 질문도 하고, 의도를 파악해서 움직입니다. Codex는 반대방향에서 출발했습니다. "지시를 받으면 사람 없이도 끝까지 처리하는 에이전트"입니다. 설계 철학이 다르다보니 각각에 맞는 프롬프트 전략도 다릅니다. 1. 모호한 요청을 어떻게 처리하느냐 단순한 예시지만, Claude Code에 "로그인 기능 만들어줘"라고 하면 소셜 로그인 넣을지 물어보고, 세션 처리 방식까지 알아서 고려합니다. Codex에 같은 말을 하면 가장 기본적인 아이디/비밀번호 폼만 딱 만들어줍니다. 틀린 게 아니라 지시한 그대로 한 거예요. 이렇게 설계된 이유가 있습니다. Claude Code는 대화형 인터페이스 안에서 작동하기 때문에 모호한 부분을 되물을 수 있습니다. 반면 Codex는 태스크를 비동기로 백그라운드에서 처리하는 구조라, 중간에 사용자에게 되물을 수 없습니다. 처음 받은 지시가 전부입니다. 그러니 명확하게 주지 않으면 가장 무난한 해석으로 실행해버리는거죠. 그래서 Codex에서는 "메타 프롬프트" 방식이 잘 맞습니다. "이 작업을 하려면 어떤 정보가 필요해?"라고 먼저 물어보고, Codex가 뽑아준 정보 리스트를 넣어주면서 프롬프트를 완성하는 거죠. AI가 스스로 좋은 질문을 만들게 유도하는 방식입니다. 이렇게 하면 내가 미처 생각 못한 예외 케이스까지 사전에 잡힙니다. 2. 실행 전 계획을 잡는 방식 Claude Code에는 planning mode가 있습니다. 이 모드를 켜면 파일을 수정하지 않고 코드베이스를 읽고 분석하는 데만 집중한 뒤, 계획안을 먼저 보여주고 승인을 기다립니다. 복잡한 작업일수록 "일단 짜줘" 보다 이 모드로 계획을 먼저 검토하는 게 훨씬 안전합니다. Codex는 별도 모드 전환 없이 처음부터 코드베이스를 탐색하면서 작업합니다. 대신 맥락을 충분히 전달할수록 결과가 좋아집니다. "우리 프로젝트는 이런 구조고, 이번에 하려는 게 이거야"라고 배경을 먼저 설명해주면, Codex가 그 위에서 스스로 방향을 잡아줍니다. 3. 요청의 단위 Claude Code는 "회원가입 전체 플로우 만들어줘"라고 해도 꽤 잘 됩니다. Codex에서 이걸 그대로 하면 중간에 어긋나기 시작합니다. 왜 그럴까요. Codex는 한 번 태스크를 받으면 중간 검증 없이 끝까지 실행하는 구조입니다. 범위가 크면 초반의 작은 방향 오류가 뒤로 갈수록 눈덩이처럼 커집니다. 반면 작업을 잘게 쪼개면 각 단계에서 방향을 바로잡을 수 있어요. 그래서 "입력 폼 만들기 → 유효성 검사 추가 → API 연결 → 에러 처리" 이렇게 단계마다 확인하면서 가는 방식이 훨씬 안정적입니다. 테스트 코드를 먼저 쓰고 구현하는 TDD 방식과 특히 잘 맞는 것도 같은 이유입니다. 각 단계가 테스트를 통과하는 걸 확인하면서 쌓아가니 중간에 방향이 틀어질 일이 없습니다. 4. 맥락 공유 Claude Code는 "인증 관련 라이브러리 찾아서 적용해줘"라고 해도 됩니다. Codex는 다릅니다. "NextAuth v5, app router 기준, src/lib/auth.ts 파일 참고해서 작업해줘"처럼 구체적으로 줄수록 결과물 품질이 올라갑니다. Codex가 여러 선택지 중에서 맥락 없이 하나를 고르다 보면 우리 프로젝트 스타일과 안 맞는 코드가 나올 수 있습니다. 반면 내가 방향을 미리 잡아주면 잘못된 과정을 줄일 수 있습니다. 처음엔 이게 번거롭게 느껴지는데, 이렇게 하면 부수적인 장점도 있습니다. 프롬프트를 구체적으로 쓰는 과정에서 작업 범위가 내 머릿속에서 먼저 명확해집니다. 코드를 짜기 전에 내가 뭘 만들려는지 한 번 더 정리되는 거죠. 그래서 둘 중 뭘 더 많이 사용하는가를 봤더니, 흥미로운 점이 있습니다. Claude Code가 코드 품질 블라인드 테스트에서 67% 승률을 기록하고, 개발자 커뮤니티 토론량도 Codex의 4배입니다. 그런데 실사용 선호도 조사에서는 Codex가 앞섭니다. 이유는 모두가 알고 계실 겁니다. 클로드의 미친 토큰 사용량 때문입니다. (ㅎㅎ) Claude Code는 같은 작업에 토큰을 4배 더 쓴다는 이야기가 있습니다. 복잡한 프롬프트 몇개면 하루 한도가 끝납니다. 품질이 아무리 높아도 못 쓰면 의미가 없으니까요. 그래서 두개를 함께 사용하는 방향으로도 많이 쓰고 있습니다. 설계와 방향은 Claude Code, 반복 실행과 코드 리뷰는 Codex로 역할을 나누는 겁니다. 클로드 맥스 $100 플랜 하나보다 $20 플랜 두 개를 병행하는 게 낫다는 평가가 나오는 이유입니다. Claude Code와 Codex를 섞어 쓴다면, AGENTS.md와 CLAUDE.md를 symlink로 연결해두면 한쪽 수정이 양쪽에 자동 반영됩니다. 작은 팁이지만 설정 꼬일 일이 없어서 편합니다. + 혹시 잘못된 부분이 있다면, 정정이나 보완 댓글은 언제든 환영입니다.