Codex vs Claude Code 2026: 도구 선택 방법

모델 작업에 관한 자세한 내용은 Ailoot 문서를 참고하세요.

Codex와 Claude Code를 간단히 살펴보기#

In April 2025, OpenAI released a new product, Codex CLI, together with the o3 and o4-mini models. 이것이 오픈 소스 도구인 Codex의 시작이었습니다. 처음에는 o3/o4-mini를 감싼 래퍼였고, 이후 독립형 모델 GPT-5-Codex가 나왔으며, 2026년에는 minimal부터 xhigh까지 추론 수준을 전환할 수 있는 GPT-5.3-Codex, GPT-5.4, GPT-5.5 라인업으로 발전했습니다.

Anthropic은 그보다 앞선 2025년 여름, Claude Pro 구독의 일부로 Claude Code를 출시했습니다. 2026년에는 VS Code 확장 프로그램, 웹 버전, 모바일 알림, 플러그인 마켓플레이스, 세션 간 메모리를 가진 관리형 에이전트까지 갖춘 완전한 생태계가 되었습니다.

기술적으로 두 도구는 다음과 같은 기본 기능을 갖춘 에이전트입니다.

• 프로젝트의 파일을 읽고 편집하기,
• 터미널에서 명령 실행하기,
• 브라우저 제어하기(Computer Use),
• 외부 시스템 작업을 위해 MCP 서버(Model Context Protocol)에 연결하기,
• 프로젝트 지침을 특수 파일에 저장하기(Anthropic은 CLAUDE.md, Codex는 AGENTS.md),
• 하위 에이전트를 실행해 병렬로 작업하기.

철학의 차이는 여기서부터 드러납니다. 기본적으로 Claude Code는 변경하기 전에 권한을 요청하고, 결정의 장단점을 설명하며, 추론 과정을 보여줍니다. 반면 Codex는 기본적으로 격리된 샌드박스에서 작업하며, 바로 처리하지 못한 내용은 TODO에 남기고 작업을 끝까지 진행합니다. OpenAI 공식 문서에서 격리 모드 설명을 확인하세요.

인터페이스에서도 이런 차이를 느낄 수 있습니다. Claude Code를 쓰면 Claude가 대화 상대처럼 느껴집니다. Codex는 실행자처럼 느껴집니다.

사람들이 주목하는 곳에 선택의 기준이 있는 것은 아니다#

Codex와 Claude Code의 기능을 비교하기 전에 한 걸음 물러나 보겠습니다. 설명된 시나리오에서 주목받는 바이브 코딩용 클라우드 IDE 대부분을 사용해 보았습니다. Bolt, Lovable, Replit Agent, v0, Emergent가 그 대상입니다. 매번 같은 결론에 도달했습니다.

클라우드 IDE는 샌드박스입니다. 훌륭하고 편리하며 보기 좋은 샌드박스입니다. 하지만 결국 샌드박스입니다. 코드를 볼 수 없습니다. 아키텍처를 제어할 수 없습니다. Anthropic이나 OpenAI 위에 자체 요금 체계를 얹어 운영하기 때문에 제대로 된 스택을 쓸 때보다 토큰을 10–20배 더 빨리 소모합니다. 무엇보다 서비스를 떠나기로 해도 프로젝트를 가져갈 수 없습니다.

저자는 Claude Code 구독료 3개월분에 맞먹는 비용이 들었다고 설명합니다. 구독에는 프로젝트 두 개를 더 진행할 수 있을 만큼의 리소스가 아직 남아 있습니다.

바이브 코딩을 하는 창업자가 흔히 밟는 과정입니다.

1. 1단계: 샌드박스

   Bolt나 Lovable에 들어가 저녁 한나절 만에 프로토타입을 만들었습니다. 신이 납니다.

2. 2단계: 확장을 시도함

   프로토타입을 실제 운영 프로젝트로 바꾸고 싶어졌습니다. 코드에 대한 제어권, 자체 데이터베이스, 자체 인증, 제대로 된 Git이 필요했습니다. 샌드박스에서는 불가능합니다.

3. 3단계: 한계에 부딪힘

   예산을 계획보다 10배 빨리 소진했습니다. 프로젝트를 자체 스택으로 옮기는 것도 더는 불가능합니다. 템플릿, 데이터베이스, 파일이 모두 서비스 안에 잠겨 있습니다.

4. 4단계: 제대로 된 스택으로 이동함

   VS Code를 열고 Claude Code나 Codex를 설치한 뒤, 며칠 동안 사용법을 익혔습니다. 마침내 전문가처럼 일하는 것 같다는 느낌을 받았습니다.

같은 논리는 Cursor에도 적용됩니다. Cursor는 AI 기능을 덧붙인 VS Code 복제품입니다. Google의 Antigravity는 멀티 에이전트 기능을 덧붙인 Cursor 복제품입니다. 포크가 원본에서 멀어질수록 다른 사람의 생태계에 더 깊이 묶입니다.

실제 선택지는 다음과 같습니다.

1. 클라우드 IDE(Bolt, Lovable, Replit Agent, v0): 프로토타입 제작에 편리하지만 플랫폼에 종속됩니다. 주말 동안 아이디어를 시험하기에 적합합니다.
2. 세미 IDE(Cursor, Antigravity, Trae): 개발 환경이지만 VS Code 포크이므로 다른 사람의 생태계에 종속됩니다. Cursor는 자체 요금 체계를 제공자 API 위에 적용합니다. 즉, 연결한 Claude와 GPT는 직접 실행되는 것이 아니라 Cursor의 토큰을 통해 사용됩니다.
3. 개방형 스택(VS Code + Codex / VS Code + Claude Code): 익숙한 에디터, 기본 GitHub, 파일 트리, 확장 프로그램을 유지하면서 그 위에 완전한 에이전트를 추가합니다.

세 번째 단계에 있다면 Codex와 Claude Code의 차이는 전술적인 문제가 됩니다. 두 도구를 동시에 사용할 수도 있습니다. 한 worktree에서는 Codex를, 다른 worktree에서는 Claude Code를 실행하면 git worktree가 이들을 서로 다른 브랜치로 분리해 줍니다.

여기서 두 번째 규칙이 나옵니다. 도구는 속도를 높여 주지만, 방법론이 없으면 그 속도가 오히려 방해가 됩니다. 아이디어를 다듬지 않고, 아키텍처를 정리하지 않으며, Plan Mode와 CLAUDE.md를 통해 프로젝트에 접근하지 않는 사람이 최신 Opus 4.7을 사용하면 평소보다 더 빠르게 엉망인 결과를 만듭니다. 바이브 코딩 프로젝트의 99%가 초기에 버려지는 것은 아이디어를 충분히 다듬지 않았기 때문입니다.

Claude나 Codex의 신뢰성을 높여 주는 스택을 구성하고 싶으신가요? 도구 하나는 빌딩 블록일 뿐입니다. 신뢰할 수 있는 작업에는 스택이 중요합니다. AI 클론 + Second Brain + Context Engineering이 어떤 에이전트든 “환각을 일으키는 보조자”에서 신뢰할 수 있는 실행자로 바꿔 줍니다.

2026년 Codex와 Claude Code의 실제 비용#

사람들이 가장 먼저 묻는 것은 한 달에 얼마가 드느냐입니다. 유의 사항과 함께 가격을 살펴보겠습니다.

확인용 출처: Codex 가격 및 Claude 가격.

한도에 대해 알아야 할 점은 다음과 같습니다.

• 5시간 단위 한도는 5시간마다 초기화되는 소규모 메시지 “바구니”입니다. 한 주기 동안 Plus 사용자는 Codex에서 GPT-5.5로 로컬 메시지를 1580개 보낼 수 있습니다. Pro 20x에서는 3001,600개입니다. 정확한 수치는 사용하는 모델에 따라 달라집니다.
• 주간 한도는 5시간 단위 한도에 더해지는 주간 상한입니다. 2026년 5월 Anthropic은 7월 13일까지 이를 50% 높였습니다. 이제 모든 Pro, Max, Team 및 좌석 기반 Enterprise 사용자에게 적용됩니다. Max 20x 사용자의 경우 기존 주당 200시간 대신 Opus 4.7을 약 300시간 사용할 수 있습니다.

API를 통해 자동화를 많이 수행하면(예를 들어 서버에서 백그라운드 에이전트를 실행하는 경우) 실제 청구액은 월 $500를 쉽게 넘을 수 있습니다. masturbyte.com의 설명처럼 $5,000에 이르기도 합니다. 이는 API를 많이 사용하는 경우에 해당하며, 일반적인 CLI 사용은 아닙니다.

상황별 요금제 추천:

• 하루 30건 미만의 요청, 일반적인 편집: 둘 중 어떤 서비스든 Plus 또는 Pro $20이면 충분할 가능성이 큽니다.
• 하루 30–100건의 요청, 에이전트 세션이 길게 이어지는 경우: Codex Pro $100 또는 Claude Max 5x $100.
• 하루 100건 초과의 요청, 여러 시간 동안 자율적으로 진행되는 작업: Claude Max 20x $200(5월의 +50% 증가로 안정적인 사용 시간을 제공) 또는 Codex Pro $200(병렬 실행과 Computer Use에 더 강력함).

Bolt나 Replit Agent에서는 같은 예산이 한 자릿수 배 더 빠르게 사라집니다.

누가 더 오래 생각할까: Codex와 Claude Code의 추론 수준#

추론 강도는 에이전트가 작업을 얼마나 깊이 검토할지 조절하는 수단입니다. minimal에서 Codex는 간단한 코드 조각 생성기처럼 빠르고 저렴하게 처리하며, 깊은 추론을 수행하지 않습니다. xhigh에서는 몇 배 더 많은 토큰을 사용하고, 선택지의 트리를 정리하고, 경계 사례를 점검하며, 자신의 작업을 검증합니다.

Codex 수준(출처: 공식 프롬프팅 가이드):

재시작하지 않고 TUI에서 /effort high 명령으로 전환하거나 ~/.codex/config.toml에 model_reasoning_effort = "high" 행을 추가하세요.

Claude Code에도 같은 수준이 있지만, 2026년 4월에 도입된 대화형 /effort 슬라이더(16주차 변경 기록)로 전환합니다. 또한 2.1.x부터 훅에서 effort.level 값과 $CLAUDE_EFFORT 변수를 확인할 수 있어, 추론 수준이 높은 작업에는 다른 훅을 자동으로 실행할 수 있습니다.

실용적인 조언: “모든 작업을 최대로 돌리려” 하지 마세요. 기본값은 medium으로 두고, 새 기능, 아키텍처, 대규모 리팩터링처럼 작업이 정말 복잡할 때만 수동으로 xhigh로 바꾸세요. 토큰 절약에 관한 자세한 내용은 Claude Code 사용 한도 가이드를 참고하세요.

CLAUDE.md와 AGENTS.md: 차이점과 둘 다 필요한 이유#

이 두 파일은 프로젝트에서 “에이전트에게 주는 지침” 역할을 합니다. 둘 다 일반적인 Markdown 파일이며 저장소 루트나 하위 폴더에 둘 수 있습니다. 차이는 어떤 도구가 파일을 읽는지입니다.

CLAUDE.md는 Anthropic의 형식으로, Claude Code에서만 사용합니다.

• @import 구문을 지원합니다: @AGENTS.md, @.claude/rules.md.
• 경로별 규칙을 이해합니다(하위 폴더의 CLAUDE.md는 해당 폴더의 코드에만 적용됨).
• 권한 수준, 하위 에이전트 위임, 세션을 인식합니다.
• 하위 에이전트 위임과 훅은 CLAUDE.md의 참조를 통해 설정합니다.

AGENTS.md는 agents.md에서 발표된 개방형 표준입니다.

Codex는 전역 ~/.codex/AGENTS.md에서 저장소 루트까지, 이어서 각 하위 폴더까지 AGENTS.md 계층을 읽습니다. 가장 가까운 파일이 우선합니다. Amp, Google의 Jules, Cursor, Factory도 같은 형식을 지원하므로 프로젝트에서 어떤 에이전트를 사용하든 파일 하나로 공통 컨텍스트를 제공할 수 있습니다.

⚠️ 중요한 참고 사항: 2.1.277 버전(2026년 9월 18일 출시)부터 Claude Code는 AGENTS.md를 자동으로 읽습니다. 단, 작업 폴더나 상위 폴더에 CLAUDE.md, .claude/CLAUDE.md, CLAUDE.local.md가 없어야 합니다. CLAUDE.md가 있으면 Claude Code는 기본적으로 그것만 읽습니다. CLAUDE.md 안에 @AGENTS.md 행을 넣거나 ln -s AGENTS.md CLAUDE.md 심볼릭 링크를 만들어 AGENTS.md를 포함할 수 있습니다. @AGENTS.md 행은 파일을 두 번 읽게 하지 않습니다. /config의 Project instructions에서 이 동작을 바꿀 수 있습니다. 예를 들어 Claude Code가 두 파일을 동시에 읽도록 할 수 있습니다. 모든 선택지를 단계별로 설명한 내용은 한 프로젝트에서 AGENTS.md와 CLAUDE.md를 함께 사용하는 가이드를 참고하세요.

두 도구를 모두 사용하면서 Claude 전용 규칙이 필요하다면 다음 방식을 권장합니다.

# CLAUDE.md
@AGENTS.md

## Claude-specific
- Use sub-agent for security review
- Permission level: workspace-write

즉, AGENTS.md 하나를 기준으로 삼고, CLAUDE.md에서 @를 사용해 이를 가져오면서 Claude 전용 규칙을 얇게 덧붙입니다.

파일 간에 1:1로 옮길 수 있는 내용(출처: CLAUDE.md에서 AGENTS.md로의 마이그레이션 가이드):

• 명령(build, test, lint).
• 코드 스타일 규칙.
• 아키텍처 설명.
• 특정 패턴 사용 금지.
• 비즈니스 맥락.

CLAUDE.md에만 남는 내용:

• 하위 에이전트 위임 지침.
• @import 체인.
• 경로별 규칙(서로 다른 규칙이 있는 하위 폴더의 CLAUDE.md).
• 권한 수준.
• Output Style 설정(아래에서 설명).

이것은 프로젝트의 Second Brain에서 첫 번째 부분, 즉 에이전트에 컨텍스트를 제공하는 파일입니다. 두 번째 부분인 business/ 및 ai-clone/ 구조는 별도의 가이드에서 다룹니다.

2026년 5월 두 회사가 출시한 기능#

한 달 전의 “최근 개요”는 이미 오래된 정보입니다. 2026년 5월 두 도구의 변경 기록을 모아 중요한 내용을 정리했습니다.

Anthropic Claude Code(code.claude.com/docs/en/whats-new 기준):

• 20주차(5월 11–15일): Agent View: claude agents 명령으로 현재 Claude Code 세션 전체를 한 화면에서 확인할 수 있습니다. 무엇이 실행 중인지, 무엇이 막혔는지, 무엇이 완료됐는지 보여 줍니다. /goal: 지정한 조건에 도달할 때까지 에이전트가 여러 턴에 걸쳐 계속 작업합니다. fast mode의 기본 모델이 Opus 4.7로 바뀌었습니다. Rewind에서 “여기까지 요약”을 사용해 이전 컨텍스트를 압축할 수 있습니다.
• 19주차(5월 4–8일): Plugin Marketplace. 플러그인은 .zip 아카이브와 URL에서 불러옵니다. Anthropic은 claude-plugins-official 선별 카탈로그와 커뮤니티 카탈로그를 제공합니다.
• 18주차(4월 27일–5월 1일): CI용 claude ultrareview, claude project purge, /resume의 PR URL.
• 17주차(4월 20–24일): 공개 연구 프리뷰 /ultrareview, 세션 요약, 사용자 지정 테마.
• 16주차(4월 13–17일): Max/Team Premium의 기본 모델로 Opus 4.7 적용. /effort에 xhigh 수준 추가. 대화형 /effort 슬라이더. Claude Code Web의 Routines. 모바일 푸시 알림. /usage 명령.
• 5월 6일, 샌프란시스코 Code w/ Claude: Managed Agents 연구 프리뷰. Dreaming은 에이전트가 세션 간 메모리를 통합합니다. Outcomes는 “성공이란 무엇인지”를 정의하는 평가 기준을 작성하면 별도의 평가자가 결과를 판정합니다. Multiagent Orchestration. 장시간 실행되는 결과를 위한 웹훅. 출처: Anthropic 블로그.
• 5월 13일: Pro, Max, Team 및 좌석 기반 Enterprise의 주간 한도 +50%를 2026년 7월 13일까지 적용.

OpenAI Codex(developers.openai.com/codex/changelog 기준):

• 5월 14일: Codex Mobile. Mac에서 Codex CLI를 실행하고 ChatGPT 모바일에서 QR 코드를 스캔한 뒤, 휴대폰으로 에이전트를 제어합니다.
• 5월 21일, v26.519: Goal Mode GA, Remote computer use, 플러그인 공유.
• 5월 7일: Codex for Chrome. 에이전트가 브라우저에서 열려 있는 내용을 확인하게 해 주는 확장 프로그램입니다.
• 4월 9일: Codex가 Business 및 신규 Enterprise 요금제에서 메시지 기반 대신 토큰 기반 요금제로 전환했습니다.

이것이 선택에 의미하는 바는 다음과 같습니다.

• 모바일 작업이 중요하다면 Codex Mobile이 더 성숙합니다(Mac에 QR 코드 하나로 연결). Claude Code Web도 있지만 인터페이스는 데스크톱 전체 화면에 맞춰 설계되었습니다.
• 세션 간 메모리가 중요하다면 Dreaming이 포함된 Anthropic의 Managed Agents는 연구 프리뷰 단계입니다. Codex에는 이와 유사한 기능이 없습니다.
• 대규모 자율 프로세스의 가격이 중요하다면 Codex가 더 저렴하고 Goal Mode는 이미 정식 제공 중입니다. Claude의 /goal은 일주일 먼저 나왔지만 초기 연구 접근 단계입니다.

⚠️ 중요한 점: Anthropic은 Claude Code의 Output Styles를 종료하고 플러그인, 훅 또는 하위 에이전트로 이전할 것을 권장했습니다(공식 문서 참고). Output Styles에 관한 오래된 글을 읽는다면 그 기능을 새로운 플러그인 / 훅 / 하위 에이전트 스택으로 옮겨 생각하세요.

서비스 이용 가능 여부와 대체 도구#

선택지를 살펴보겠습니다.

Codex CLI나 Claude Code는 일반적인 npm 방식이나 공식 설치 프로그램으로 설치할 수 있습니다. 대안 #1: DeepSeek

DeepSeek V4(2026년 4월 24일 출시)는 중국 모델이며, 표시된 결제 방식은 Alipay(QR 코드)입니다.

토큰 가격은 100만 개당 약 0.27 / 1.10달러입니다. 비교 가능한 벤치마크에서 Sonnet 4.6보다 10배 저렴합니다.

대안 #2: GLM-5.1(Zhipu AI / z.ai)

GLM-5.1은 744B MoE 모델로 MIT 라이선스가 적용되어 있으며, 8시간 넘게 지속되는 자율 작업을 수행할 수 있습니다. z.ai는 Anthropic 호환 API 엔드포인트를 제공하므로 기술적으로 직접 대체 모델처럼 연결할 수 있습니다. 가격: NVIDIA NIM을 통한 무료 등급 또는 z.ai를 통한 유료 이용.

대안 #3: VS Code의 Cline

Cline은 VS Code 확장 프로그램이자 자율 코딩 에이전트입니다. Cline API, ChatGPT, Claude, Gemini, DeepSeek를 지원합니다.

Cline 형식의 .clinerules 파일로 설정합니다. CLAUDE.md나 AGENTS.md와 비슷한 역할을 합니다.

대안 #4: Yandex GPT / Sber의 GigaChat

코드 품질은 Codex나 Claude보다 낮지만, 일반적인 작업(SQL 생성, 간단한 스크립트)에는 충분합니다. 컨텍스트 창이 더 작고 완전한 에이전트 하네스는 없습니다.

실제로 사용할 스택:

어떤 도구를 선택하든 아키텍처, Second Brain, 검증 주기라는 방법론은 같습니다.

실제 리뷰: 누가 옮겨 갔고 그 이유는 무엇인가#

아래에는 두 도구를 모두 사용하고 공개 리뷰를 남긴 사람들의 주요 인용문 네 개가 있습니다.

1. HN 토론 “Is Codex really on Par with Claude Code?” (2025년 12월):

네 출처의 요약:

실제 리뷰에서 얻을 수 있는 핵심 결론은 어느 쪽도 “더 낫지” 않다는 점입니다. 두 도구는 서로 다른 상황에 맞게 최적화되어 있습니다. 두 도구를 2주 이상 사용해 본 사람 대부분은 결국 병행해서 사용합니다. Codex에 대한 의견이 크게 엇갈리는 이유와 일상적인 작업에서의 성능은 Codex 리뷰와 사용 경험 기사에서 다룹니다.

상황에 맞는 선택 방법: 대표적인 5가지 사례#

아래에 다섯 가지 유형과 각 유형에 맞는 구체적인 권장 사항을 소개합니다.

1. 코드를 한 번도 작성해 본 적이 없고 첫 작동 프로토타입을 만들고 싶은 완전 초보자.

권장: Claude Code Pro $20.

• Claude는 기본적으로 코드를 변경하기 전에 확인 질문을 합니다. 초보자에게 중요한 점입니다. 무슨 일이 일어나는지 배울 수 있습니다.
• Codex는 기본적으로 자율적으로 움직입니다. 초보자에게는 문제가 생겼을 때 고칠 방법을 모르는 코드를 얻게 된다는 뜻입니다.

2. 콘텐츠 공장(메일 발송, 파싱, 서식 지정)을 만드는 마케터.

권장: Codex Plus $20.

• 대부분의 작업은 템플릿형 로직을 사용하는 반복 업무입니다(스크립트 생성, RSS 파싱, 서식 지정, 데이터 전송).
• Codex는 토큰을 적게 사용하므로 반복적이고 비슷한 작업에서 더 저렴합니다.
• Skills + Hooks를 사용해 반복 가능한 워크플로 템플릿을 만들 수 있습니다.
• 콘텐츠 프로젝트 저장소의 AGENTS.md를 통해 여러 AI 도구를 동시에 연결할 수 있습니다.

3. 문서(계약서, 체크리스트 기반 검토)를 자동화하는 변호사.

권장: Claude Code Pro $20 또는 Max 5x $100.

• Claude는 긴 컨텍스트와 세부 사항(PDF 파싱, 계약서 요약)을 더 잘 처리합니다.
• Managed Agents의 Outcomes는 “이 계약서를 30개 항목 체크리스트에 따라 확인”하는 데 이상적인 패턴입니다.
• 법률 오류는 구독료보다 더 큰 비용을 초래하므로 추론 품질이 가격보다 중요합니다.

4. 제품 하나(간단한 CRUD 프로토타입, 비즈니스 로직)를 만드는 창업자.

권장: 시작은 Claude Code Pro $20, 하루 요청이 30건을 넘으면 Max 5x $100.

• Claude는 확인 질문을 합니다. 비프로그래머에게 중요한 점입니다.
• 코드 품질이 더 높아 초기에 버그가 줄고 나중에 유지 관리하기도 더 쉽습니다.
• 프로젝트가 커지면 5월의 +50% 증가가 적용된 Max 5x로 중단 없이 안정적인 사용 시간을 확보할 수 있습니다.

5. 숙련된 개발자 또는 기술 책임자(일상 작업 + 복잡한 아키텍처 결정).

권장: 두 도구를 병행해서 사용.

• 일상적인 작업, 리팩터링, 코드 리뷰에는 Codex Pro $100.
• 아키텍처, 보안에 민감한 작업, 프런트엔드 작업에는 Claude Code Max 5x $100.
• AGENTS.md를 단일 기준으로 두고 CLAUDE.md에서 @AGENTS.md를 가져옵니다.

⚠️ 이 표는 절대적인 규칙이 아닙니다. 출발점일 뿐입니다. 실제로 선택하려면 자신의 작업에서 두 도구를 병렬로 테스트해야 합니다.

예산을 다 쓰지 않고 주말 동안 두 도구를 테스트하는 방법#

공정하게 선택하려면 병렬 테스트를 실행하는 것이 가장 좋습니다. 단계는 아래와 같습니다.

1. 1단계: worktree 두 개 준비

   같은 원본 체크아웃에서 현재 HEAD를 기준으로 사용하지 않은 브랜치 이름 두 개를 만들어 worktree에 배치하세요. 두 명령을 실행하는 동안 원본 커밋을 유지하세요. 두 도구가 같은 지침으로 시작해야 한다면 먼저 원본에 지침을 커밋하세요. 이름이 이미 있으면 강제 초기화하지 말고 다른 미사용 이름을 고르세요.

   git worktree add -b feature-claude ../my-project-claude HEAD
   git worktree add -b feature-codex ../my-project-codex HEAD
   

   이제 서로 다른 디렉터리에 같은 코드의 작업 복사본 두 개가 있습니다. VS Code 창 두 개에서 열 수 있습니다.

2. 2단계: AGENTS.md와 CLAUDE.md 만들기

   에이전트를 시작하기 전에 명령, 스타일, 아키텍처 같은 동일한 AGENTS.md 공통 규칙을 두 worktree에 넣거나 1단계 전에 원본 체크아웃에 커밋하세요.

   CLAUDE.md에는 다음을 입력합니다.

   @AGENTS.md
   
   ## Claude-specific
   - Sub-agent for security review
   - Permission level: workspace-write
   

   이렇게 하면 두 에이전트가 같은 규칙을 사용할 수 있습니다.

3. 3단계: 실제 작업 하나 선택

   가이드에 나온 예시나 “팩토리얼 계산”이 아닙니다. 프로젝트에서 실제로 완료해야 하는 작업을 선택하세요. 데이터베이스 통합, 인증 또는 폼 처리와 관련된 작업이 적합합니다. 숙련된 개발자가 4–8시간 정도 걸릴 범위로 정하세요.

   두 에이전트에 동일한 형식으로 작업을 작성합니다. 요구 사항 목록, 인수 기준, 기존 코드 링크를 포함하세요.

4. 4단계: 병렬로 시작

   • 첫 번째 worktree에서 작업을 전달해 Claude Code를 시작합니다.
   • 두 번째 worktree에서 같은 작업을 전달해 Codex CLI를 시작합니다.
   • 처음 30분 동안은 개입하지 않습니다. 작업하도록 둡니다.
   • 에이전트가 확인 질문을 하면 두 창에서 같은 방식으로 답합니다.

5. 5단계: 네 가지 지표 측정

   • 첫 컴파일까지 걸린 시간 / 테스트 통과까지 걸린 시간.
   • 반복 횟수 — “그렇게 말고, 다시 해”라고 말한 횟수.
   • 코드 품질 — 자동 리뷰 후의 결과(npm test, lint, type-check).
   • 비용 — Codex에서는 /usage, Claude Code에서는 /usage 또는 관리자 대시보드를 통해 확인합니다.

6. 6단계: 작업 3–5개로 반복

   비교 한 번만으로 결론을 내리지 마세요. 변수가 너무 많습니다. 서로 다른 작업 유형을 최소 세 가지 포함하세요. 하나는 인터페이스, 하나는 비즈니스 로직, 하나는 외부 서비스 통합에 초점을 맞춥니다.

   병렬 테스트를 3–5회 진행하면 어떤 도구가 작업 속도를 높여 주는지 실제로 파악할 수 있습니다.

테스트 예산은 두 도구를 합쳐 약 $40–80입니다(이미 Plus와 Pro 구독이 있다면 추가 비용은 들지 않습니다).

문제없이 CLAUDE.md를 AGENTS.md로 마이그레이션하기#

이 시나리오에서는 하나의 기준 버전과 가져오기 구문을 사용합니다.

새 프로젝트에서의 단계:

1. 프로젝트 루트에 AGENTS.md를 바로 만듭니다. 공통으로 적용되는 내용을 모두 넣습니다.

   • 명령(build, test, lint).
   • 코드 스타일 규칙.
   • 아키텍처 설명(모델, 서비스, 라우트가 있는 위치).
   • 특정 패턴 사용 금지.
   • 비즈니스 맥락.

2. Claude 전용 규칙을 얇게 추가한 CLAUDE.md를 만듭니다.

# CLAUDE.md

@AGENTS.md

## Claude-specific
- Run a sub-agent for security review using the `Agent` tool
- Permission level: workspace-write
- @.claude/permissions.md
- @.claude/business-context.md

3. 500단어가 넘는 긴 작업 절차가 있다면 Skills로 옮깁니다.

   • Claude Code: .claude/skills/<name>/SKILL.md
   • Codex: .agents/skills/<name>/SKILL.md

4. 두 도구에서 Hooks를 설정합니다.

   • Claude Code: ~/.claude/hooks/ 또는 프로젝트의 .claude/hooks/.
   • Codex: ~/.codex/config.toml의 [hooks] 섹션.

5. MCP 서버는 표준이며 1:1로 옮길 수 있습니다. Claude에 이미 설정되어 있다면 codex mcp add를 사용해 Codex에 설정을 복사합니다.

자동으로 옮겨지지 않는 내용:

• Claude Code의 하위 에이전트 위임은 Codex의 하위 에이전트로 비슷하게 구현할 수 있지만 설정 형식이 다릅니다.
• @import 체인은 Claude 전용입니다. Codex에서는 디렉터리 트리로 AGENTS.md 계층을 구성합니다.
• Output Style은 레거시 방식입니다. 플러그인 / 훅 / 하위 에이전트가 이를 대체했습니다(위 내용 참고).

“CLAUDE.md를 설정하는 방법” 가이드를 따랐다면 마이그레이션에는 약 30분이 걸립니다. AGENTS.md를 만들고 공통 섹션을 복사한 다음, CLAUDE.md에는 Claude 전용 내용과 맨 위의 @AGENTS.md만 남기세요.

업계의 향후 방향과 1년 후의 의미#

1년 전에 이 가이드를 썼다면 여기서 언급한 도구의 절반은 존재하지 않았을 것입니다. 1년 뒤에도 마찬가지일 겁니다. 그러니 세 가지 규칙을 기억하는 것이 좋습니다.

규칙 1: 일주일 안에 전환할 수 있는 스택을 선택하세요.

Bolt에서 두 달 동안 30개 화면짜리 프로젝트를 코딩했다면 다른 곳으로 옮기기 어렵습니다. VS Code + Claude Code를 쓰다가 6개월 후 Codex를 시험하고 싶다면 전환하는 데 한 시간이면 됩니다(AGENTS.md를 만들고 CLAUDE.md에서 가져오기). 이것이 개방형 스택이 주는 자유입니다.

규칙 2: AGENTS.md는 한 플랫폼에 종속되지 않도록 해 주는 보험입니다.

이 개방형 표준은 Codex, Amp, Google의 Jules, Cursor, Factory, 그리고 2026년 9월부터 Claude Code가 읽습니다. 매달 지원 도구가 늘어납니다. 저장소의 파일 하나가 도구를 세 번 바꾸는 것보다 더 오래 남을 것입니다.

규칙 3: 바뀌지 말아야 하는 것은 방법론입니다.

모델, IDE, 가격, 한도, 기능은 바뀔 것입니다. 바뀌지 않는 것은 프로젝트 접근 방식, 사용하는 아키텍처, 에이전트에 컨텍스트를 제공하는 방식, 따르는 검증 주기입니다. 전문가처럼 바이브 코딩하기 = 방법론 위에 쌓은 스택. 방법론이 없으면 최신 모델도 평소보다 더 빠르게 엉망인 결과를 만듭니다.

2026년 5월 경쟁사에 일어난 변화와 그 변화가 판도를 바꾸는 이유:

• OpenAI: Codex Mobile(iPhone에서 제어), Codex for Chrome, Goal Mode GA, Business의 토큰 기반 요금제.
• Google: Gemini 3.5 Flash 기반 Antigravity 2.0(데스크톱 + CLI + SDK, 5월 19일). Jules는 2025년 8월부터 완전한 제품으로 제공되고 있습니다.
• Cursor: Kimi K2.5를 탑재한 Composer 2.5. Opus 4.7보다 10배 저렴합니다(5월 18일, Elon이 X에서 확산시킴).
• Anthropic: 5월 18일 SDK 생성기 Stainless 인수. Plugin Marketplace가 핵심 기능이 됨. Dreaming, Outcomes, Multiagent Orchestration을 갖춘 Managed Agents.

이들 중 어느 하나라도 6개월 뒤 선택의 기준을 바꿀 수 있습니다. 한 가지 도구에 모든 것을 걸지 마세요. 어떤 도구가 바뀌더라도 계속 사용할 수 있는 범용 스택에 투자하세요.

바이브 코딩 스택: AI 클론 + Second Brain + Context Engineering.

앞으로의 작업에는 Ailoot를 이용하세요.