Claude Code vs Codex CLI: 개발 환경에 맞춰 고르는 법

Claude Code의 Agent Teams는 여러 Claude Code 세션이 함께 작업하는 실험 기능입니다. 기본적으로 비활성화되어 있으며 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 설정과 대화형 세션이 필요합니다. 팀원은 직접 메시지로 작업을 조율하고, Task 도구가 있는 경우에는 공동 작업 목록도 사용합니다. 세션 재개·작업 조율·종료에는 알려진 제한이 있으므로, 한 세션 안에서 일을 나누는 일반 subagent와 구분해 선택해야 합니다.

Codex의 subagents도 생성, 후속 지시, 대기, 종료, 결과 통합을 지원합니다. 현재 로컬 클라이언트에서는 사용자의 직접 요청이나 적용되는 프로젝트·스킬 지침에 따라 활용하며 부모 작업의 샌드박스와 승인 설정을 이어받습니다. 대화형 CLI에서는 /subagents로 실행 중인 하위 작업을 확인하고 전환할 수 있습니다. 두 도구 모두 하위 에이전트를 제공하므로 필요한 분담 방식과 권한을 구성할 수 있는지가 비교의 핵심입니다.

MCP 서버와 지침 파일의 위치를 확인합니다

외부 도구를 연결하는 MCP는 양쪽에서 지원합니다. Claude Code의 MCP 설정에서 local은 추가한 프로젝트에서만 쓰는 개인 설정이고, user는 여러 프로젝트에서 쓰는 개인 설정입니다. 두 범위의 서버 정의는 ~/.claude.json에 저장하며, 프로젝트 공유 범위는 저장소 루트 .mcp.json에 둡니다. 프로젝트 범위로 서버를 추가하려면 claude mcp add에 --scope project 옵션을 붙입니다.

Codex의 MCP 설정은 ~/.codex/config.toml 또는 신뢰한 프로젝트의 .codex/config.toml에 [mcp_servers.<server-name>] 형식으로 작성합니다. codex mcp로도 관리할 수 있습니다. 설정 파일을 공유하는 것과 각 사용자가 서비스에 인증하는 것은 별도이므로 팀에 배포할 때는 인증과 실행 환경도 확인해야 합니다.

프로젝트 규칙을 전달하는 기능도 둘 다 있습니다. Codex는 AGENTS.md를 읽고, 현재 Claude Code도 조건에 따라 AGENTS.md를 읽습니다. Claude Code의 지원에는 버전과 기존 지침 파일 유무 등의 조건이 있습니다. 프로젝트 지침, 자동 메모리, 이전 세션을 다시 여는 기능은 각각 목적이 다르며 지침 파일 자체가 보안 경계를 강제하는 것은 아닙니다.

모델 접근과 구독 비용은 따로 비교합니다

제품 이름만으로 사용 모델을 고정할 수 없습니다

Claude Code의 모델 설정 문서는 현재 Pro·Max·Team·Enterprise와 Anthropic API의 계정 유형 기본값으로 Claude Opus 5.5를 안내합니다. 다만 사용자나 관리자의 설정, 공급 경로, CLI 버전에 따라 달라질 수 있습니다. 실제 세션의 /model에서 선택할 수 있는 모델을 확인해야 합니다.

Codex의 모델 문서는 GPT-6.1 Sol 등을 안내하며 계정·클라이언트·조직 정책과 순차 제공 조건을 구분합니다. ChatGPT 로그인으로 제공되는 모델과 API 키로 접근하는 모델의 지원 기간도 같지 않을 수 있습니다. 따라서 특정 모델명이나 컨텍스트 크기를 Codex CLI의 영구 사양처럼 비교하기보다 해당 계정의 /model과 인증 방식을 먼저 확인하는 것이 정확합니다.

월 구독료와 사용량, API 청구는 다른 단위입니다

아래는 확인일 기준 개인용 요금제의 웹 월 결제 표시 가격입니다. Claude 가격 안내, Max 요금제 설명, Codex 가격 안내를 기준으로 정리했습니다. 연 결제 할인·모바일 결제·세금·환율을 반영한 최종 결제액과는 구분합니다.

Claude Pro·Max의 Claude Code 이용 안내에 따르면 Claude와 Claude Code는 5시간·주간 구독 사용량 한도를 공유합니다. Max의 5x·20x는 Pro 대비 세션 사용량을 나타내며, 처리할 수 있는 작업 건수를 그 배수로 보장하는 표시는 아닙니다. 추가 사용을 위한 usage credits와 Console API 청구도 구분해야 합니다. Max에 포함된 월 API 크레딧은 Claude Code나 Claude 앱의 초과 사용에 쓸 수 없습니다.

ChatGPT Work와 Codex도 사용량을 공유합니다. 가격 페이지의 메시지 수는 작업 크기와 모델 등에 따라 달라지는 추정치입니다. 구독으로 처리할 수 있는 고정 작업 건수로 계산해서는 안 됩니다. Free·Go의 가격 카드에는 데스크톱 앱 제공과 순차 적용 조건이 있으므로 해당 계정의 CLI·Cloud 접근은 별도로 확인해야 합니다. 이번 확인에서는 Free·Go 실제 계정의 CLI 접근을 시험하지 않았습니다.

API 키로 쓰는 경우에는 구독 포함 사용량과 별도의 API 청구 조건을 확인해야 합니다. API 비용은 선택한 모델의 입력·캐시 입력·출력 단가를 구분해서 계산합니다. Anthropic API 가격표처럼 캐시 쓰기와 읽기를 따로 과금하는 경우도 있습니다. 월 구독료인 USD/월, 사용량 크레딧, API의 USD/100만 토큰은 서로 다른 단위입니다. 과금 경로와 단위를 맞춘 뒤 실제 사용량을 적용해야 비용을 비교할 수 있습니다.

검토 기능과 실제 작업 결과를 확인합니다

Codex CLI의 codex resume --last는 최근 세션을 이어 가는 명령입니다. 코드 변경을 검토할 때는 로컬 /review에서 기준 브랜치와의 차이, 커밋하지 않은 변경, 특정 커밋 등을 대상으로 선택할 수 있습니다. GitHub에서의 PR 검토는 별도 연결 경로이며, 저장소 연결과 리뷰 설정·권한을 확인해야 합니다. 로컬 리뷰를 실행한 것과 GitHub의 자동 PR 리뷰를 설정한 것은 다른 작업입니다.

Claude Code에서도 프로젝트의 명령과 테스트 도구를 이용해 작업할 수 있습니다. hooks로 파일 수정 뒤 포맷 검사 같은 절차를 실행하거나 subagent로 업무를 나눌 수 있습니다. 어느 도구를 쓰든 수정안이 요구사항을 충족하는지는 저장소의 테스트와 실제 변경 내용을 확인해 판단해야 합니다.

성능을 비교하려면 같은 저장소의 같은 시작 커밋에서 같은 요구사항을 주고, 모델·추론 설정·권한·사용 도구·재시도 조건을 기록하는 방법이 적절합니다. 테스트 통과 여부, 누락된 요구사항, 사람이 수정한 범위, 실제 경과 시간과 청구 내역을 함께 보면 선택에 필요한 근거가 됩니다. 이는 비교 실험을 위한 제안이며 이 글에서 얻은 측정 결과는 아닙니다. 서로 다른 문제 집합의 벤치마크 숫자를 나란히 놓거나 토큰 출력 속도만으로 작업 완료 시간을 판단해서는 안 됩니다.

기존 구독과 필요한 실행 환경으로 선택합니다

이미 Claude Pro·Max를 사용하고 있다면 포함된 Claude Code 사용량으로 대표 작업을 확인하는 데서 시작할 수 있습니다. 프로젝트에 정해 둔 hooks와 subagent 설정이 있거나 Agent Teams의 조율 방식이 필요하다면 해당 구성의 지원 조건을 함께 확인하면 됩니다. 네이티브 Windows에서 셸 명령 격리가 필수인 환경이라면 앞서 설명한 제한을 먼저 검토해야 합니다.

ChatGPT 구독을 사용하고 있거나 네이티브 Windows 샌드박스, 로컬 /review, 원격 Cloud 작업이 필요하다면 Codex의 해당 접근 권한과 설정을 확인할 이유가 있습니다. Codex CLI의 소스 공개도 구현을 살펴보려는 팀의 선택 기준이 될 수 있습니다. 이 공개 범위를 Codex Cloud·IDE 확장 전체나 모델 가중치의 공개로 확대해서는 안 됩니다.

로컬 코드 수정과 MCP 연결이 주된 목적이라면 두 도구의 공통 기능이 많습니다. 먼저 현재 구독과 개발 환경에서 대표 작업 하나를 수행하고, 필요한 권한과 실제 검토 부담·사용량을 기록해 판단하면 됩니다. 추가 도구가 해결할 구체적인 문제가 확인될 때 병용 여부를 결정할 수 있습니다.