Claude Code vs Codex CLI — 실제 차이와 선택 방법

Claude Code와 Codex CLI는 같은 장소에서 같은 문제를 해결합니다. 저장소를 읽고, 편집을 제안하며, 명령어를 실행하고, 결과를 반복 개선하는 터미널 에이전트입니다. 차이는 기반 모델 제품군, 확장 기능, 구성 방식에 있으며 기본 작업 형태에는 없습니다.

이 페이지는 실제 차이를 비교하고, 단정 대신 선택 기준을 제시하며, 원하는 경우 하나의 키로 두 도구를 모두 실행해 자신의 코드에서 판단하는 방법을 보여 줍니다.

나란히 비교

둘 다 활발하게 개발되고 빠르게 변경되므로 이 목록을 포함한 모든 기능 목록은 특정 시점의 상태로 보세요. 구조적 차이(모델 제품군, API 범위, 구성 형식)는 안정적인 부분이지만 구체적인 기능은 그렇지 않습니다.

선택 방법

어느 쪽이 더 나은 코드를 만드는지에 대한 일반적인 답은 없습니다. 언어, 저장소, 작업에 따라 달라지며 공개된 일대일 벤치마크는 실제 코드베이스와 거의 일치하지 않습니다. 미리 결정할 수 있는 것은 자신의 작업 방식에 더 잘 맞는 도구입니다.

정직한 권장 사항은 다음과 같습니다. 둘 다 설치는 무료이므로 자신의 저장소에서 동일한 실제 작업을 각각 실행하고 변경 사항을 비교하세요. 이 작업에 한나절을 투자하면 이 글을 포함한 어떤 비교 글보다 많은 것을 알 수 있습니다.

각 도구의 실행 비용

비용은 CLI가 아니라 모델과 에이전트 단계 수에 의해 결정됩니다. 두 도구 모두 매 단계마다 시스템 프롬프트, 작업 기록, 새 파일 컨텍스트를 다시 전송하므로 토큰당 요금은 각각 동일하게 누적됩니다. 실제로 실행할 모델을 비교하세요. 아래 Claude 열은 Anthropic 공식 API 요금을 기준으로 하며, 모든 모델의 토큰당 요금과 일반적인 에이전트 단계의 계산 예시가 나와 있습니다.

일반적인 에이전트 작업 단계는 입력 토큰 약 25,000개와 출력 토큰 약 1,200개를 사용하므로, 이 요금 기준으로 claude-sonnet-4-6에서 20단계 작업을 수행하는 비용은 약 $1.30입니다. 하나의 계산 예시만 믿기보다는 비용 계산기에 직접 수치를 입력해 보세요. 이 모델들은 입력 요금보다 출력 요금의 차이가 더 크기 때문에, 출력 비중이 높은 작업에서는 비용 순위가 달라집니다.

사용자 지정 엔드포인트: 실제 비대칭

두 도구 모두 타사 엔드포인트를 지원하지만 동일하지는 않습니다. 이는 현재 두 도구의 가장 실용적인 차이입니다.

Claude Code는 ANTHROPIC_BASE_URL를 읽고 Anthropic Messages API를 사용하며, 많은 제공업체가 이를 제공합니다. 다른 곳을 지정하는 데는 환경 변수 세 개만 필요하고 추가 소프트웨어가 필요하지 않습니다(설정 가이드).

Codex CLI는 더 엄격합니다. model_providers 블록에는 wire_api 키가 있으며, 현재 구성 참조 문서에는 responses만 지원되는 값으로 나와 있습니다. 즉, 사용자 지정 제공업체는 훨씬 일반적인 /v1/chat/completions가 아니라 /v1/responses에서 OpenAI의 Responses API를 제공해야 합니다.

# ~/.codex/config.toml — wire_api accepts only "responses"
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"
wire_api = "responses"        # requires POST /v1/responses upstream

# A provider that serves only /v1/chat/completions still cannot be
# configured here, whatever base_url you give it.

따라서 대부분의 OpenAI 호환 게이트웨이는 사용할 수 없습니다. 이들은 /v1/chat/completions만 제공하고 다른 것은 제공하지 않습니다. 이것이 “모든 OpenAI 호환 엔드포인트에서 작동한다”고 홍보하는 많은 제공업체가 Codex CLI에서 조용히 실패하는 이유입니다. base URL은 허용되지만 모든 요청에서 404가 반환됩니다.

Kunavo는 두 API 범위 모두를 제공합니다. OpenAI 호환 채팅 엔드포인트와 /v1/responses의 Responses API를 모두 제공하므로 위 구성이 그대로 작동합니다. 또한 gpt-5-6-sol(1M당 $2.00 / $12.00)는 Codex CLI뿐 아니라 Cursor, Kilo Code, Cline에서도 실행됩니다. Codex가 키를 읽는 환경 변수까지 포함한 전체 안내는 Codex CLI API 키 가이드에 있습니다.

알아둘 점이 하나 있습니다. Codex는 모델 제품군이 아니라 프로토콜에 종속되므로 해당 엔드포인트 뒤의 모든 채팅 모델이 응답할 수 있으며 Claude도 포함됩니다. claude-opus-5를 대상으로 지정하면 Codex CLI는 도구 호출을 유지한 채 처음부터 끝까지 실행됩니다. 게이트웨이가 Responses와 Messages API 사이를 변환합니다. 다만 Codex의 불투명한 reasoning 항목은 GPT가 아닌 업스트림에 대응 항목이 없어 삭제됩니다. 따라서 모델은 턴 사이에 비공개 스크래치패드를 잃지만, 사용자에게 표시되는 기록에는 영향이 없습니다.

따라서 비대칭은 보이는 것보다 좁지만 사라지지는 않았습니다. Claude Code는 거의 모든 Messages API 제공업체에서 작동하는 반면, Codex CLI는 Responses를 구현한 소수의 제공업체에서만 작동합니다. 비용, 라우팅 또는 거버넌스를 위해 자체 엔드포인트를 사용하는 것이 선택 이유라면 여전히 고려할 만한 사항입니다. 비용이 결정 요인이라면 공식 Anthropic API 가격표에서 Anthropic이 공개한 요금을 기준으로 Claude 각 등급의 1M 토큰당 비용을 확인할 수 있습니다. 이 수치가 실제 에이전트 코딩 비용을 좌우합니다.

인접한 비교

이 페이지에서 다루지 않는 인접한 질문 두 가지입니다. Codex와 ChatGPT 비교는 어떤 CLI를 설치할지가 아니라 어떤 OpenAI 표면을 열지에 관한 내용입니다. 답은 공유 플랜의 허용량과 에이전트가 이를 얼마나 빠르게 소진하는지에 달려 있습니다. Cline과 Claude Code 비교는 터미널을 편집기 사이드바로 바꾸는 문제이며, 결정적인 차이는 프로토콜보다 청구 방식입니다.

서로의 모델을 실행할 수 있나요?

한 방향으로는 가능합니다. Codex CLI는 Claude 모델을 실행할 수 있습니다. Responses API를 제공하는 게이트웨이를 통해서입니다. 이 게이트웨이는 특정 모델 제품군이 아니라 와이어 프로토콜에 연결되므로, 위의 제공업체 블록에서 model = "claude-opus-5"을 설정하면 도구 호출을 포함해 처음부터 끝까지 작동합니다. 단점은 Codex의 불투명한 reasoning 항목이 비-GPT 업스트림으로 전달되는 과정에서 삭제되어, 모델이 턴 사이에 유지하던 비공개 작업 메모장을 잃는다는 점입니다.

반대 방향은 더 어렵습니다. Claude Code는 Messages API에서 Claude 제품군 슬러그를 요구하므로, 이를 통해 GPT에 접근하려면 로컬 라우터가 필요합니다. 이는 구성 요소가 하나 더 늘고 일부 기능이 손실된다는 뜻입니다. cache_control은 네이티브 경로에서만 번역 없이 그대로 전달되기 때문입니다. Claude Code 라우터 가이드에서는 이러한 구성이 설정할 가치가 있는 경우와 대신 기본 URL만 바꾸면 되는 경우를 설명합니다.

각 도구를 설계된 모델 제품군에서 실행하는 것이 여전히 가장 간단한 기본값입니다. 하지만 Claude를 뒤에 두고 Codex CLI의 샌드박싱을 사용하고 싶다면, 지금도 이 조합을 사용할 수 있습니다. Codex CLI API 키 가이드를 참조하세요.

자주 묻는 질문