Part I: 왜, 무엇이 다른가

Chapter 1: 서론 — 왜 지금 Codex로 넘어가는가

집필일: 2026-04-28 최종수정일: 2026-04-28

1.1 시작점: 24시간의 간격

2026년 4월 23일, OpenAI가 GPT-5.5를 발표했다. 다음 날 24일, 나는 포스트 #46 "Claude Code에서 Codex로 넘어가는 길"을 썼다 [Um, 2026]. 그 24시간의 간격이 이 책의 출발점이다.

발표 직전까지만 해도 Claude Code는 확실히 강세였다. 2026년 3월, Claude Code는 전체 공개 GitHub 커밋의 약 4%를 혼자 만들어냈다 [DEV Community, 2026]. The Pragmatic Engineer가 906명의 엔지니어를 대상으로 실시한 설문에서 46%가 "가장 좋아하는 AI 코딩 도구"로 Claude Code를 꼽았다 — 같은 설문에서 가장 높은 수치였다.

그런데 왜 Codex로 넘어가는가?

이 질문의 답은 단순히 "GPT-5.5가 더 좋아서"가 아니다. 정확히는 GPT-5.5가 처음에 API가 아닌 Codex를 통해 출시되었기 때문이다 [Willison, 2026]. OpenAI의 가장 최신 frontier 모델이 하네스 제품 안에 먼저 들어왔다. 모델보다 하네스가 앞선 순간이었다.

Figure 1.1: Claude Code 우세에서 GPT-5.5의 Codex 탑재, 그리고 24시간 후 마이그레이션 포스트까지 — 하네스가 API보다 먼저 배달 채널이 된 순간. illustration by author Gemini assisted
Figure 1.1: Claude Code 우세에서 GPT-5.5의 Codex 탑재, 그리고 24시간 후 마이그레이션 포스트까지 — 하네스가 API보다 먼저 배달 채널이 된 순간. illustration by author Gemini assisted

1.2 하네스가 곧 제품이다

이 책의 핵심 주장은 하나다: 하네스(harness)가 곧 제품이다.

"하네스"라는 단어가 낯설 수 있다. 2장부터 상세히 다루지만, 지금 단계에서는 이렇게 이해하면 충분하다 — 모델에게 무엇을 알려주고, 어떤 맥락을 저장하며, 어떤 도구를 쓸 수 있게 할지를 결정하는 코드와 설정의 묶음이 하네스다.

Claude Code는 이 하네스를 외부화한다. 사용자가 CLAUDE.md를 작성하고, subagents를 설정하고, hooks를 달고, skills를 만든다. 하네스가 사용자의 손에 있다.

Codex는 이 하네스를 내재화한다. AGENTS.md와 ~/.codex/config.toml이라는 단순한 인터페이스 뒤에서, 하네스 로직이 제품 안에 녹아 있다.

GPT-5.5를 Codex에 먼저 넣은 OpenAI의 결정은 이 철학의 극단적 표현이다. 모델을 API로 먼저 푸는 대신, 하네스 제품 안에 먼저 탑재한 것이다. Simon Willison이 Codex 구독을 통해 우회 호출로 GPT-5.5에 접근했을 때, 그것은 단순한 편법이 아니었다 — 모델 배포의 단위가 API가 아니라 하네스 제품이 되었음을 확인하는 순간이었다 [Willison, 2026].

1.3 패러다임 전환

Andrej Karpathy는 AI 코딩 에이전트의 등장을 "상전이(phase change)"라고 표현했다 [Karpathy and Patel, 2025]. 물이 100도에서 갑자기 수증기가 되듯, 어느 시점에서 코딩 방식의 본질이 바뀐다는 것이다.

Claude→Codex 이동은 그 상전이의 다음 단계다. 단순히 도구를 교체하는 것이 아니다. 사고 방식의 전환이다:

  • 이전: "Claude에게 이번 대화에서 무엇을 하라고 말할까?" → 외부에서 지시하는 방식
  • 이후: "AGENTS.md에 규칙을 써두면 Codex가 그걸 따라 움직인다" → 규칙을 외부화하고 자율성을 부여하는 방식

이 전환의 진짜 비용은 코드 변경이 아니다. 지식의 외부화다.

포스트 #46의 핵심 레슨을 옮기면 이렇다 [Um, 2026]: Claude→Codex 전환이 가능한 조건은 프로젝트의 규칙·상태·다음 할 일이 대화 내부나 도구 전용 메모리가 아닌 평문(plain text) 파일로 외부화되어 있을 때다. AGENTS.md이든 HANDOFF.md이든 TASKS.md이든, 그 파일들이 존재하면 전환은 기계적이다. 그 파일들이 없으면 — 즉 지식이 Claude와의 대화 속에만 있으면 — 전환은 처음부터 다시 시작이다.

Figure 1.2: 지식 외부화의 의미 — AGENTS.md·HANDOFF.md·TASKS.md처럼 평문으로 외부화된 것만 마이그레이션을 통과한다. 도구 전용 메모리와 대화 속 맥락은 다시 쌓아야 한다. illustration by author Gemini assisted
Figure 1.2: 지식 외부화의 의미 — AGENTS.md·HANDOFF.md·TASKS.md처럼 평문으로 외부화된 것만 마이그레이션을 통과한다. 도구 전용 메모리와 대화 속 맥락은 다시 쌓아야 한다. illustration by author Gemini assisted

1.4 이 책이 전제하는 독자

이 책은 두 가지를 전제한다:

  1. Claude Code는 써봤다. 터미널에서 claude 명령을 쳐봤고, CLAUDE.md가 뭔지 안다.
  2. 하네스 엔지니어링은 들어만 봤다. "하네스"라는 단어가 낯설거나, 써봤더라도 본격적으로 활용하지 않았다.

따라서 이 책의 Part II는 "마이그레이션 가이드"가 아니다. 신규 학습 가이드다. Codex라는 새로운 도구에서 하네스 엔지니어링을 처음부터 배운다. Claude Code에서 썼던 방식을 Codex로 1:1로 옮기는 것이 아니라, Codex의 방식으로 새로 셋업한다.

2025년 말~2026년 초의 Korean 개발자 커뮤니티를 보면 이 전제가 정확하다. "하네스 엔지니어링 40분 정복"이라는 제목의 강의가 나올 정도로, 하네스는 이미 한국 개발자들에게도 알려진 개념이 되었다 [Korean Dev Blog, 2026]. 하지만 실제로 자신의 워크플로우에 체계적으로 적용한 사람은 아직 소수다.

1.5 책의 지도

네 Part로 구성된다:

Part I: 왜, 무엇이 다른가 (Ch 1–3)

왜 Codex로 가는지, 두 도구가 어떻게 다른지, Codex를 처음 실행하는 방법.

Part II: Codex에서 하네스 엔지니어링 새로 배우기 (Ch 4–6)

하네스란 무엇인지, Codex에서 어떻게 짓는지, 멀티에이전트로 검증 가능한 코딩을 어떻게 하는지.

Part III: GPT-5.5 시대의 Codex 실전 가이드 (Ch 7–9)

67일 안에 벌어진 세 번의 모델 출시가 무엇을 바꿨는지, 커뮤니티가 한 달 만에 발견한 패턴, 고급 멀티에이전트와 메타하네스.

Part IV: LLM Wiki에서 AI Scientist로 (Ch 10–12)

Karpathy의 LLM Wiki 패러다임, 나의 활동을 AI 외장 메모리로 만드는 방법, 분야별 AI Scientist 실전 사례.

Figure 1.3: 책의 지도 — 4 Part × 12 챕터. Part I이 도입, Part II가 Codex에서의 신규 학습, Part III가 GPT-5.5 시대 실전, Part IV가 LLM Wiki에서 AI Scientist로의 확장. illustration by author Gemini assisted
Figure 1.3: 책의 지도 — 4 Part × 12 챕터. Part I이 도입, Part II가 Codex에서의 신규 학습, Part III가 GPT-5.5 시대 실전, Part IV가 LLM Wiki에서 AI Scientist로의 확장. illustration by author Gemini assisted

이 책은 어느 챕터에서든 독립적으로 읽을 수 있도록 썼다. 하지만 처음 읽는다면 Part I → Part II 순서를 권한다. Codex를 한 번도 써보지 않았다면 3장의 첫걸음 튜토리얼부터 시작해도 좋다.

1.6 2026년 초의 풍경 — "Before"

Karpathy는 2025년에 이미 "소프트웨어 개발에서 AI 에이전트가 전문가 수준의 코더를 대체하는 단계가 온다"고 예견했다 [Karpathy, 2025]. Jan-2026의 스냅샷을 찍어둔 뉴스레터 [Bizzotto, 2026]를 보면, 그 예견이 현실에 가까워지는 중이었다.

2026년 2월, Anthropic은 Claude Sonnet 4.6을 출시하며 SWE-bench Verified 79.6%를 기록했다 [Anthropic, 2026]. 같은 시기 Claude Code를 쓰는 사람들의 피드백: "instruction following이 더 좋고, over-engineering이 덜하다." 모델이 발전하면서 하네스의 중요성이 더 커지는 역설적 현상이 나타나기 시작했다 — 모델이 좋아질수록, 모델에게 "잘 던져주는" 방법이 더 중요해졌다.

그리고 4월 23일, GPT-5.5가 Codex에 탑재되어 나왔다.

이 책은 그 4월 23일 이후를 기록한다.

참고문헌

  1. terryum, "Claude Code에서 Codex로 넘어가는 길," terryum-ai posts, 2026-04-24. [Um, 2026]
  2. Dev.to, "Claude Code authored ~4% of all public GitHub commits in March 2026," 2026-03. [DEV Community, 2026]
  3. Willison, Simon, "GPT-5.5," simonwillison.net, 2026-04-23. [Willison, 2026]
  4. Karpathy, Andrej, Dwarkesh Patel Podcast — AI coding agents discussion, 2025. [Karpathy and Patel, 2025]
  5. Karpathy, Andrej, "Expert programmers and the future of software," 2025. [Karpathy, 2025]
  6. Code with Andrea, "Jan-2026 Newsletter," 2026-01. [Bizzotto, 2026]
  7. Korean Developer Blog, "하네스 엔지니어링 40분 정복," 2026. [Korean Developer Blog, 2026]
  8. Anthropic, "Introducing Claude Sonnet 4.6," 2026-02-17. [Anthropic, 2026]