Codex vs Claude Code — 과금과 연결 방식 비교

Codex와 Claude Code를 비교하는 글은 많고, 대부분 기능과 사용감만 비교합니다. 이 페이지는 과금과 연결 방식만 비교합니다. 이유는 간단합니다. 이미 어느 한쪽에 비용을 지불하는 사람이 전환을 결정할 때 실제로 영향을 미치는 요소가 바로 이것이기 때문입니다. 성능 순위는 매기지 않습니다. 뒤에서 설명하듯 자신의 리포지토리에서 30분이면 판단할 수 있습니다.

먼저, 같은 점

둘 다 터미널에서 실행되며 리포지토리 파일을 읽고 쓰고, 테스트를 실행하고, 커밋까지 수행합니다. 둘 다 「구독 사용 한도」 또는 「API 키 종량제」라는 이중 과금 구조를 가지며, 두 항목은 합산되지 않습니다. 할 수 있는 일의 범위는 세대가 바뀔 때마다 가까워지고 있어 기능 목록으로 우열을 가릴 단계는 이미 지났습니다.

차이 1: 연결 대상을 변경하는 방법(실무에서 가장 큰 차이)

~/.zshrc

# Claude Code — Anthropic 形状の環境変数で向き先を変える
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Claude Code の既定モデルと opus / sonnet エイリアスは Anthropic の最新モデルを指すので、
# Kunavo がまだ提供していなくても 404 にならないようモデルを固定する。
# sonnet エイリアスの指す Sonnet 5.5 は Kunavo では提供していないため、固定しないと /model sonnet、
# opusplan の実行フェーズ、sonnet 指定のサブエージェントが 404 になる。
# opus は Opus 5.5 に固定 (Claude Code v2.1.280 以降が必要。古ければ claude update)。
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claude

# Codex CLI — OpenAI 形状。ただし受け付けるのは Responses API だけ
export OPENAI_BASE_URL=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...
codex

Claude Code는 ANTHROPIC_BASE_URL와 ANTHROPIC_AUTH_TOKEN 두 줄로 연결 대상을 변경합니다. Codex CLI도 비슷해 보이지만 한 가지 제약이 있습니다. 커스텀 프로바이더로 허용되는 것은 POST /v1/responses(Responses API)뿐이며, chat completions만 구현한 엔드포인트에서는 작동하지 않습니다.

전환하거나 함께 사용할 대상을 선택할 때 가격표보다 먼저 확인해야 할 것은 이 한 가지입니다. 설정 절차는 각각 Codex CLI API 키 설정과 Claude Code API 키 설정에 있습니다.

차이 2: 토큰 단가

요금은 카탈로그에서 불러옵니다. 1M 토큰당:

모델	입력 / 출력
Claude Sonnet 5(Claude Code 기본값)	$1.40 / $7.00
GPT-5.6 Sol(Codex 기본값)	$2.00 / $12.00

다만 단가는 청구액의 절반만 설명합니다. 실제 금액을 결정하는 것은 한 단계에서 전송하는 컨텍스트의 양이며, 이는 도구 설계와 리포지토리 크기에 따라 달라집니다. 양쪽에서 같은 작업을 한 번씩 실행하고 응답의 usage를 비교하세요. 30분이면 어떤 비교 글보다 자신의 용도에 맞는 답을 얻을 수 있습니다.

각각의 종량제 과금 실제 금액과 손익분기점은 Codex 가격과 Claude Code 가격에서 별도로 계산합니다.

차이 3: 사용 한도에 도달했을 때의 대안

양쪽 모두 구독 한도는 롤링 윈도우 방식입니다. Codex 측에서 한도에 도달했을 때 선택할 수 있는 방법으로 OpenAI 도움말은 크레딧 추가, 리셋 적용, 업그레이드, 리셋 대기를 제시합니다. 한도는 별도로 계산되므로 한쪽의 사용 한도에 도달하면 다른 쪽으로 전환하는 것도 현실적인 우회책입니다. 하나의 키로 양쪽을 모두 사용할 수도 있습니다. 동일한 엔드포인트와 Anthropic 형식과 Responses 형식이라는 서로 다른 프로토콜로 통신할 뿐입니다.

Claude 측 윈도우의 작동 방식과 한도에 도달했을 때의 선택지는 Claude Pro 제한에 정리되어 있습니다.

성능 순위는 매기지 않습니다

공개 벤치마크는 작업 선택에 따라 결과가 달라지고, 모델 업데이트 주기에 비해 수명이 너무 짧습니다. 여기서 순위를 적더라도 독자가 읽을 때는 이미 다른 세대의 이야기가 되어 있을 가능성이 큽니다.

대신 확실한 절차를 제시합니다. 자신의 리포지토리에서 약간 까다로운 작업 하나를 선택하세요(기존 테스트를 깨뜨리지 않고 기능 하나 추가 등). 양쪽에 동일한 지시를 내리고 ① 성공 여부 ② 소비 토큰 ③ 재작업 횟수, 이 세 가지만 기록하세요. 이렇게 하면 자신의 용도에 맞는 순위를 얻을 수 있습니다. 영어판의 자세한 비교는 Claude Code vs Codex에 있습니다.

자주 묻는 질문

Codex와 Claude Code의 가장 큰 차이는 무엇인가요?

둘 다 터미널에서 리포지토리를 조작하는 에이전트이며, 할 수 있는 일의 범위도 비슷해지고 있습니다. 실무에서 가장 큰 차이는 과금과 연결 방식입니다. Claude Code는 ANTHROPIC_BASE_URL로 연결 대상을 변경할 수 있지만, Codex CLI는 커스텀 프로바이더로 Responses API만 허용합니다. 구독 사용량과 종량제 과금이라는 이중 구조는 양쪽 모두에 있지만, 한도 계산 방식이 다르므로 합산되지 않습니다.

어느 쪽이 더 저렴한가요?

정해진 답은 없으며 사용 방식에 따라 달라집니다. 토큰 단가로 비교하면 Kunavo를 통해 Claude Sonnet 5는 1M 토큰당 $1.40 / $7.00, GPT-5.6 Sol는 $2.00 / $12.00입니다. 다만 실제 청구액을 결정하는 것은 단가보다 한 단계에서 전송하는 컨텍스트의 양이므로, 동일한 작업을 양쪽에서 한 번씩 실행하고 usage의 실측값을 비교하는 것이 유일하게 확실한 방법입니다.

둘을 함께 사용할 수 있나요?

가능하며 실제로 그렇게 사용하는 사람도 많습니다. 한쪽의 사용 한도에 도달했을 때 다른 쪽으로 전환하는 방식이 현실적입니다. 두 한도는 별도로 계산되므로 서로 영향을 주지 않습니다. 하나의 API 키로 양쪽을 모두 사용할 수도 있습니다. Claude Code는 Anthropic 형식, Codex는 Responses 형식으로 동일한 엔드포인트에 서로 다른 프로토콜로 통신할 뿐입니다.

Codex CLI를 다른 회사의 엔드포인트로 연결할 수 있나요?

Responses API(POST /v1/responses)를 제공하는 엔드포인트라면 가능합니다. 실무상의 함정은 여기에 있습니다. chat completions만 구현한 게이트웨이에서는 Codex CLI가 작동하지 않습니다. 전환 대상을 검토할 때는 가격표보다 먼저 지원 프로토콜을 확인하세요. Claude Code에는 이 제약이 없으며 Anthropic 호환 /v1/messages가 있으면 작동합니다.

어느 쪽의 성능이 더 좋은가요?

이 페이지에서는 순위를 매기지 않습니다. 공개 벤치마크는 작업 선택에 따라 결과가 달라지고, 모델 업데이트 주기에 비해 수명이 너무 짧기 때문입니다. 확실한 판단 방법은 자신의 리포지토리에서 동일한 작업을 양쪽에 맡겨 성공 여부와 소비 토큰을 확인하는 것입니다. 수십 분이면 충분하며 어떤 벤치마크보다 자신의 용도에 맞는 답을 얻을 수 있습니다.

전환할 때 설정은 얼마나 바뀌나요?

각각 두 개의 환경 변수만 설정하면 되며, 양쪽 모두 몇 분이면 됩니다. 프로젝트 규칙 파일은 호환되지 않으므로 Claude Code의 CLAUDE.md에 해당하는 지침은 대상 형식에 맞게 다시 작성해야 합니다. 다시 말해 마이그레이션 비용의 대부분은 CLI 설정 자체가 아니라 이 규칙 파일을 다시 작성하는 데서 발생합니다.