Codex 대 Claude Code 비교: 어떤 CLI가 어떤 코딩 작업에 적합할까

Codex와 Claude Code는 개발자들이 가장 많이 비교하는 두 가지 코딩 에이전트입니다. 둘 다 터미널에서 실행되고, 사용자의 저장소를 읽고 수정하며, 명령과 테스트를 실행하고, 소비자 구독 서비스에 포함되어 있습니다. 기능 목록만 보면 거의 동일해 보입니다. 차이점은 각 에이전트가 무엇을 할 수 있도록 결정하는 방식, 프로젝트 지침을 읽는 방식, 그리고 사용량 측정(metered) 방식에서 나타납니다.

이 가이드는 개발자들의 일상 업무에 변화를 주는 요소들을 기준으로 Codex와 Claude Code를 비교하고, 대부분의 사람들이 실제로 궁금해하는 질문에 대한 실질적인 답변으로 마무리합니다. 즉, 둘 중 하나를 선택해야 할까요?

각 CLI 소개

Codex는 OpenAI의 코딩 에이전트입니다. CLI, IDE 확장 기능, 데스크톱 앱, 그리고 ChatGPT 내 클라우드 에이전트로 실행되며, 사용자는 ChatGPT 플랜 또는 API 키로 로그인합니다. Codex CLI 문서에는 설치 방법과 인터랙티브 및 비인터랙티브 모드가 설명되어 있습니다.

Claude Code는 Anthropic의 코딩 에이전트입니다. 터미널, VS Code와 JetBrains, 데스크톱 앱, 웹에서 실행되며, 사용자는 Claude 구독 또는 콘솔 API 키로 로그인합니다. Claude Code 개요에는 메모리 파일(memory files), 스킬(skills), 훅(hooks), 서브에이전트(subagents) 및 스크립트를 위한 헤드리스 모드(claude -p)와 같은 표면적 기능과 그 위에 구축된 기능을 나열하고 있습니다.

둘 다 완전한 의미의 에이전트입니다. 사용자가 결과(outcome)를 설명하면, 에이전트는 계획을 세우고, 파일을 읽고, 수정하며, 명령을 실행하고, 결과를 보고합니다. 어느 쪽도 자동 완성 도구는 아닙니다.

승인 및 샌드박싱

이것이 가장 큰 실질적인 차이점이며, 사용자가 각 에이전트를 얼마나 많이 '돌봐야' 하는지를 결정합니다.

Codex: 샌드박스가 경계이다

Codex는 에이전트가 기술적으로 접근할 수 있는 범위(샌드박스)와 사용자에게 승인을 요청해야 하는 시점을 분리합니다. 2026년 9월 기준으로 sandboxing documentation에는 세 가지 샌드박스 모드가 나열되어 있습니다:

• read-only: 에이전트가 파일을 검사할 수는 있지만, 승인 없이는 편집하거나 명령을 실행할 수 없습니다.
• workspace-write: 에이전트가 작업 공간 내부를 편집하고 일상적인 로컬 명령을 실행할 수 있습니다(기본값).
• danger-full-access: 파일 시스템이나 네트워크 경계가 없습니다.

승인 정책은 on-request와 never 두 가지입니다. on-request에서는 에이전트가 샌드박스 내부에서 작업하며, 그 범위를 벗어나야 할 때 요청합니다. 사용자는 이 둘을 명령줄에서 설정할 수 있습니다:

codex --sandbox workspace-write --ask-for-approval on-request

이 효과는 Codex가 기본적으로 중단 없이 프로젝트 내부를 편집하고 테스트하며, 박스의 경계에 도달했을 때만 사용자에게 개입한다는 것입니다.

Claude Code: 권한이 경계를 만듭니다

Claude Code는 권한 모드를 통해 작동합니다. 기본 모드에서는 파일 편집이나 셸 명령 실행 전에 요청하며, 사용자는 한 번 답변하거나 세션 동안 특정 종류의 행동을 허용할 수 있습니다. 설정에서 '허용(Allow)' 및 '거부(Deny)' 규칙을 지정하여 테스트 러너와 같은 안전한 명령을 사전에 승인하고 위험한 명령은 차단할 수 있습니다. Shift+Tab 또는 claude --permission-mode plan으로 진입하는 플랜 모드(Plan mode)는 사용자가 계획을 승인할 때까지 세션을 읽기 전용 상태로 유지합니다. permission modes documentation에서 각 모드를 다룹니다.

이 효과는 반대되는 기본값입니다: Claude Code가 처음부터 더 자주 확인하며, 사용자가 신뢰하는 행동을 알게 될수록 이를 완화할 수 있습니다.

실제 의미

어느 쪽의 기본값이 더 좋다고 할 수는 없습니다. Codex의 샌드박스는 혼자 맡겨두고 싶은 장기적인 기계적 작업에 적합합니다. Claude Code의 프롬프트는 접근 방식이 형성되는 과정을 지켜보고 싶은 작업에 적합합니다. 둘 다 상대방 방향으로 조정될 수 있습니다: Codex는 read-only로 실행할 수 있고, Claude Code는 대부분의 행동을 사전에 승인할 수 있습니다.

프로젝트 지침: AGENTS.md 및 CLAUDE.md

두 에이전트 모두 세션 시작 시 프로젝트 지침을 담은 Markdown 파일을 읽습니다. 여기에는 빌드 명령어, 컨벤션, 피해야 할 디렉터리가 포함됩니다.

• Codex는 다른 에이전트들도 사용하는 형식인 AGENTS.md를 읽습니다.
• Claude Code는 메모리 문서에 설명된 CLAUDE.md 파일을 읽으며, AGENTS.md도 가져올 수 있습니다.

두 가지를 모두 사용한다면, 공유 규칙은 한 곳에 보관하는 것이 좋습니다. 일반적인 패턴은 모든 것을 AGENTS.md에 넣고 CLAUDE.md는 짧게 유지하며 그곳을 가리키도록 하는 것입니다. 이렇게 하면 두 에이전트가 동일한 리포지터리에 대해 서로 다른 지침을 따르는 일이 없습니다.

좋은 지침 파일은 짧고 구체적입니다. '완료하기 전에 pnpm test를 실행하세요'와 같은 것이 유용합니다. 스타일 철학에 대한 한 페이지는 대부분 컨텍스트 비용만 발생시킵니다.

제한 사항 및 요금, 날짜 기준

두 도구 모두 소비자 플랜에 포함되며, 고정된 메시지 수로 측정하는 대신 롤링(rolling) 창을 기준으로 사용량을 측정합니다.

2026년 9월 현재, Claude 가격 페이지에 따르면 Claude Code는 Pro 및 Max 플랜과 Team 및 Enterprise 좌석에 포함됩니다. 모든 플랜은 롤링 5시간 창에서 초기화되는 사용량 제한을 가지며, 유료 플랜에는 주간 제한이 추가됩니다. 창의 지속 기간은 대화 길이, 모델, 그리고 사용하는 기능에 따라 달라집니다.

2026년 9월 현재, Codex 가격 페이지는 Free부터 Plus, Pro, Business 및 Enterprise까지 모든 ChatGPT 플랜에 Codex를 나열합니다. 로컬 작업과 클라우드 작업은 플랜의 할당량을 공유하며, Plus와 표준 Business 사용량은 5시간 창으로 측정되고, 일부 기능은 주간 제한이 있으며, Pro는 5시간 제한이 없습니다.

두 모델 모두 API 키를 허용하여 토큰당 비용을 지불하는 방식으로 전환할 수 있습니다. 이는 CI 파이프라인 및 공유 자동화에 일반적으로 사용되는 방식입니다. Codex의 경우, codex exec와 codex resume 가이드에서 스크립트 실행과 저장된 세션 가져오기를 다루고 있습니다.

제한 사항은 자주 변경되므로, 특정 숫자를 기준으로 계획하기 전에 공식 페이지를 확인하세요. 만약 제한에 정기적으로 도달한다면, Claude Code 속도 제한 및 Codex 속도 제한 페이지에서 이러한 제약을 고려하여 작업을 계획하는 방법을 다루고 있습니다.

어떤 작업에 적합한가

두 모델을 모두 사용하는 사람들은 보통 다음과 같이 역할을 분담하는 경향이 있습니다. 이는 시작점으로 간주하고, 모델과 기본 설정은 몇 달마다 변경되므로 자신의 코드베이스에서 테스트해 보세요.

하나의 프로젝트에서 두 모델 사용하기

두 에이전트를 동일한 저장소에서 실행하는 것은 명확한 역할을 부여하면 잘 작동합니다.

계획 교차 검토(Cross review the plan)

코드가 존재하기 전에 한 에이전트가 계획을 작성하고 다른 에이전트가 이를 비평하도록 합니다:

1. Claude Code에게 파일, 단계, 테스트 및 위험을 포함하는 계획을 세우도록 '계획 모드(plan mode)'로 요청합니다.
2. 그 계획을 읽기 전용(read-only) 샌드박스에 Codex에 제공하고, 간극, 잘못된 가정 및 누락된 테스트를 찾아달라고 요청합니다.
3. 비평 내용을 첫 번째 에이전트에게 다시 보내 수정하도록 합니다.
4. 수정된 계획을 승인하고 한 에이전트가 이를 구현하도록 합니다.

이는 몇 분 정도 걸리며, 코드를 작성한 후에야 발견될 수 있는 가장 비용이 많이 드는 종류의 실수, 즉 잘못된 접근 방식을 잡아냅니다. 계획을 비판적으로 읽는 방법에 대해서는 AI 생성 코드 검토하기 가이드와 Claude Code 플랜 모드 워크스루를 참고하세요.

파일별이 아닌 작업별로 분리하기

두 에이전트가 동시에 작동할 때는 각각의 작업을 부여하고, 이상적으로는 각각의 git worktree를 할당하여 같은 체크아웃을 편집하지 않도록 해야 합니다. 하나의 작업 디렉터리에 쓰는 두 에이전트는 결국 충돌하게 됩니다. 여러 Claude Code 세션 실행하기 가이드에서 설정 방법을 보여줍니다.

남은 할당량에 따라 경로 지정하기

제한 사항이 분리되어 있기 때문에, 한 제공업체에서 사용량이 소진되었다고 해서 하루 전체가 멈출 필요는 없습니다. 공간이 있는 어느 제공업체의 기계적인 작업을 대기열화하고, 다른 하나는 계획 및 검토에 남겨둘 수 있습니다.

VibeiDE의 역할

VibeiDE는 사용자가 이미 설치한 Codex, Claude Code, OpenCode CLI를 조정하는 데스크톱 앱입니다. Codex와 Claude Code는 원래의 CLI 인터페이스를 보여주는 임베디드 터미널에서 실행되며, 각 사용자는 자신의 제공업체 계정에 로그인하므로 구독 및 사용량이 VibeiDE 라이선스와 분리되어 유지됩니다. 플랜 카운슬(Plan council) 기능은 위의 교차 검토 과정을 자동화합니다. 한 제공업체가 계획을 초안 작성하고, 다른 제공업체가 이를 비판적으로 검토하며, 저자가 수정하여 사용자가 구현할지 결정하게 합니다. Codex 사용자와 Claude Code 사용자를 위한 더 자세한 내용이 있습니다.

요약하자면

• Codex는 별도의 요청 없이 샌드박스(sandbox) 내에서 작업하는 것을 기본으로 합니다. Claude Code는 편집 및 명령을 실행하기 전에 사용자에게 먼저 질문합니다.
• Codex는 AGENTS.md 파일을 읽습니다. 반면, Claude Code는 CLAUDE.md 파일을 읽으며 AGENTS.md 파일도 읽을 수 있어, 하나의 공유 파일로 두 가지를 일관되게 유지할 수 있습니다.
• 2026년 9월 기준으로 둘 다 소비자 플랜(consumer plans)에 속하며 사용량 창(usage windows)이 순환됩니다. 또한, 자동화를 위해 API 키를 모두 지원합니다.
• 따라서 하나만 선택할 필요가 없습니다. 하나는 계획을 세우는 데 사용하고 다른 하나는 검토하는 데 사용하여, 나란히 실행될 때 각각 고유한 작업을 부여해 보세요.

원문 출처: https://vibeide.dev/blog/codex-vs-claude-code/