Codex CLI와 Claude Code는 모두 터미널 기반 에이전틱 코딩 도구이지만, 서로 다른 워크플로를 대상으로 합니다. Codex CLI는 가볍고 오픈소스인 에이전트로, 완전한 OpenAI 호환 API 유연성과 깔끔한 샌드박스 모델을 제공합니다. Claude Code는 더 풍부한 기능을 갖춘 플랫폼으로, 멀티 서피스 지원, 더 나은 세션 관리, CLI, IDE, 데스크톱, 브라우저 전반의 긴밀한 통합을 제공합니다. 올바른 선택은 최대한의 모델 유연성이 필요한지, 아니면 한 공급자의 API를 기반으로 구축된 통합 코딩 환경이 필요한지에 달려 있습니다.
Codex CLI란?
Codex CLI는 OpenAI의 오픈소스 터미널 코딩 에이전트입니다. 로컬에서 실행되며, OpenAI 호환 API 백엔드로 요청을 보내고, 머신의 샌드박스 디렉토리 내에서 파일을 읽고, 코드를 편집하고, 명령어를 실행할 수 있습니다.
Codex CLI의 핵심 설계 선택은 공급자 유연성입니다. 이 도구는 OpenAI Chat Completions 와이어 포맷을 사용하므로, OpenAI 호환 엔드포인트를 제공하는 모든 공급자를 TOML 설정 파일을 통해 연결할 수 있습니다. 여기에는 OpenAI 자체 모델(GPT-4o, o3, o4-mini)은 물론 Novita AI와 같은 타사 공급자도 포함됩니다.
Codex CLI의 보안 모델은 명시적으로 설계되었습니다. 실행된 코드의 네트워크 접근은 기본적으로 비활성화되어 있으며, 파일 쓰기는 설정된 디렉토리로 제한됩니다. 세 가지 승인 모드가 에이전트의 자율성을 제어합니다:
- Suggest 모드 (기본값): 모든 단계에서 승인 요청
- Auto edit 모드: 파일을 자동으로 편집하지만 명령어 실행 전에 확인
- Full auto 모드: 프롬프트 없이 실행
이 프로젝트는 MIT 라이선스로 제공되며 GitHub의 openai/codex에서 활발히 유지보수되고 있습니다.
Claude Code란?
Claude Code는 Anthropic의 에이전틱 코딩 도구입니다. CLI, VS Code 확장, JetBrains 플러그인, 데스크톱 앱, 그리고 claude.ai/code의 브라우저 인터페이스로 제공됩니다. 모든 표면은 동일한 에이전트 엔진을 실행하며, 프로젝트를 읽고, 파일을 편집하고, 명령어를 실행하고, 테스트 작성, 파일 간 리팩토링, git 관리와 같은 다단계 작업을 처리합니다.
내부적으로 Claude Code는 Anthropic 호환 API 엔드포인트로 요청을 보냅니다. 기본값은 Anthropic 자체 api.anthropic.com이지만, 단일 환경 변수(ANTHROPIC_BASE_URL)를 통해 호환되는 모든 공급자로 리디렉션할 수 있습니다.
Claude Code는 Codex CLI에는 없는 세션 연속성 기능을 추가로 제공합니다: 명명된 세션, 브랜치 스타일 대화 포크, 되감기 체크포인트, 그리고 긴 작업에서 사용 가능한 컨텍스트 윈도우를 확장하기 위해 컨텍스트를 요약하는 /compact 명령어. 프로젝트 수준의 지침은 에이전트가 모든 세션 시작 시 읽는 CLAUDE.md 파일에 저장됩니다.
Codex CLI vs Claude Code: 상세 비교
| 기능 | Codex CLI | Claude Code |
|---|---|---|
| 공급자 | OpenAI | Anthropic |
| 라이선스 | 오픈소스 (MIT) | 독점 (API 접근) |
| 와이어 API | OpenAI Chat Completions | Anthropic Messages API |
| 타사 공급자 | 모든 OpenAI 호환 | 모든 Anthropic 호환 |
| 표면 | 터미널 전용 | CLI, VS Code, JetBrains, 데스크톱, 브라우저 |
| 프로젝트 설정 | TOML 설정 파일 | CLAUDE.md + settings.json |
| 세션 연속성 | 세션별 | 명명된 세션, 재개, 브랜치, 되감기 |
| 승인 모드 | Suggest / Auto Edit / Full Auto | default, plan, auto, acceptEdits, bypassPermissions |
| MCP 지원 | 아니요 | 예 |
| 컨텍스트 관리 | 세션별 컨텍스트 | /compact, /context, /branch |
| 샌드박스 보안 | 네트워크 비활성화, 디렉토리 범위 제한 | 권한 모드 범위 지정 |
모델 지원 및 API 유연성
이 부분이 실제로 두 도구가 가장 크게 차별화되는 지점입니다.
Codex CLI 는 OpenAI Chat Completions 형식을 사용하는 모든 모델을 수용합니다. 기본적으로 GPT-4o, o3, o4-mini 등 OpenAI의 모델 라인업과 작동하지만, TOML 설정의 model_providers를 통해 공급자를 설정할 수 있으므로 도구 자체를 수정하지 않고도 Novita AI, Azure OpenAI 또는 기타 호환 엔드포인트로 연결할 수 있습니다.
Claude Code 는 Anthropic Messages API 형식을 사용합니다. 기본적으로 Anthropic으로 라우팅되며 Claude 모델(Sonnet, Opus, Haiku)을 사용합니다. ANTHROPIC_BASE_URL 환경 변수를 통해 공급자를 변경할 수 있으므로 Novita AI를 포함한 모든 Anthropic 호환 엔드포인트를 즉시 사용할 수 있습니다.
실제로 이는 다음을 의미합니다:
- 선호하는 모델이 OpenAI 형식(DeepSeek, Qwen Coder, OpenAI 호환 엔드포인트를 통한 Kimi K2)을 사용한다면 Codex CLI가 더 자연스러운 선택입니다.
- 선호하는 모델이 Anthropic 형식을 사용하거나 CLI와 IDE 표면에서 동일한 설정을 사용하려면 Claude Code가 더 일관된 동작을 제공합니다.
두 도구 모두 Novita AI의 모델을 지원합니다. 설정 방법(Codex는 TOML, Claude Code는 환경 변수)은 다르지만, DeepSeek V3, Qwen3-Coder, Kimi K2를 포함한 Novita AI의 모델 라이브러리는 둘 다에서 접근 가능합니다.
오픈소스 vs 독점 아키텍처
Codex CLI의 오픈소스 특성은 특정 상황에서 중요합니다: 에이전트 루프를 감사할 수 있고, 내부 도구로 포크할 수 있으며, 별도의 라이선싱 논의 없이 CI 파이프라인에 벤더할 수 있습니다. 커뮤니티는 공급자 통합, 버그 수정, 기능 확장에 기여할 수 있습니다(실제로 기여하고 있습니다).
Claude Code의 핵심은 독점입니다. Anthropic은 CLI를 소스 공개가 아닌 API 접근이 포함된 배포 바이너리로 제공합니다. 장점은 직접적인 Anthropic 지원과 함께 더 일관되고 잘 유지보수된 릴리스 주기입니다. 단점은 설정 파일, 환경 변수, 확장 API를 통해 도구가 노출하는 기능으로만 사용자 정의가 제한된다는 점입니다.
대부분의 개발자에게 오픈소스 여부는 코드 수준에서 에이전트 동작을 수정해야 하는 경우에만 관련이 있습니다. 워크플로 통합(CI 파이프라인, 자동화된 작업, 스크립트 기반 코드 생성)의 경우 두 도구 모두 일반적인 사례를 다루기에 충분한 CLI 플래그와 스크립팅 모드를 제공합니다.
설치 및 설정
Codex CLI 는 npm으로 설치합니다:
npm install -g @openai/codex
공급자 설정은 ~/.codex/config.toml에 저장됩니다:
model = "deepseek/deepseek-v3.1"
model_provider = "novitaai"
[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"
Claude Code 는 네이티브 설치 프로그램(macOS/Linux/WSL)으로 설치합니다:
curl -fsSL https://claude.ai/install.sh | bash
또는 npm으로 설치합니다(Node.js 18+):
npm install -g @anthropic-ai/claude-code
사용자 정의 공급자로 리디렉션:
export ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
export ANTHROPIC_API_KEY=YOUR_NOVITA_API_KEY
claude --model deepseek/deepseek-v3.1
Claude Code는 프로젝트에서 /init을 실행하여 세션 간 프로젝트별 지침을 유지하는 starter CLAUDE.md를 생성합니다.
플랫폼 및 표면 지원
이것이 일상적인 사용에서 가장 눈에 띄는 차이점입니다.
Codex CLI는 터미널에서 실행됩니다. 이것이 유일한 표면입니다. 워크플로가 전적으로 터미널 기반(SSH 세션, 헤드리스 CI, 개발자 컨테이너)이라면 문제없습니다. VS Code 내에서 인라인 제안이나 데스크톱 GUI를 원한다면 Codex CLI는 이를 제공하지 않습니다.
Claude Code는 다섯 가지 표면에서 실행됩니다: CLI, VS Code 확장, JetBrains 플러그인, 데스크톱 앱, 그리고 브라우저의 claude.ai/code. 모든 표면은 동일한 에이전트 엔진을 공유하며, 대부분의 경우 동일한 세션 상태를 공유합니다. 터미널에서 시작된 작업을 VS Code에서 이어받을 수 있습니다.
팀에 IDE 통합이 중요하다면 Claude Code가 확실히 앞섭니다. 더 큰 자동화 시스템의 일부로 에이전트를 헤드리스로 실행하는 파이프라인을 구축 중이라면 두 도구 모두 동등하게 잘 작동하며, Codex CLI의 더 간단한 설치 공간이 관리하기 더 쉬울 수 있습니다.
설정 및 프로젝트 컨텍스트
Codex CLI 설정은 공급자/모델 설정(TOML)과 프로젝트별 지침(있는 경우 에이전트가 읽는 AGENTS.md 또는 유사 파일)으로 나뉩니다. 이는 의도적으로 최소화되어 있습니다.
Claude Code 는 계층화된 설정을 제공합니다:
CLAUDE.md파일(프로젝트 수준, 디렉토리 수준, 사용자 수준) for 지속적인 지침.claude/settings.jsonfor 권한 규칙, 훅 정의, 도구 설정- 세션 중 지침을 편집하기 위한
/memory같은 슬래시 명령어 - API 라우팅 및 인증을 위한 환경 변수
CLAUDE.md 접근 방식은 모든 에이전트 세션이 코드베이스 규칙, 리뷰 체크리스트, 허용된 라이브러리에 대한 공유된 이해로 시작하도록 하려는 팀에 유용합니다. Codex CLI에는 이에 해당하는 내장 메커니즘이 없지만, 각 프롬프트에 지침을 앞에 추가하는 방식으로 유사하게 구현할 수 있습니다.
승인 모드 및 보안 제어
두 도구 모두 에이전트가 묻지 않고 수행할 수 있는 작업을 제어할 수 있습니다.
Codex CLI의 세 가지 모드는 간단하고 명확합니다:
- Suggest: 변경 사항을 표시하고 적용 전에 확인
- Auto edit: 묻지 않고 파일을 쓰지만 셸 명령어 실행 전 승인 필요
- Full auto: 묻지 않고 실행, 신뢰할 수 있는 파이프라인에 유용
Claude Code의 권한 모드는 더 세분화된 유사한 개념과 매핑됩니다:
- default: 파일 편집 및 셸 명령어에 대한 승인 요청
- acceptEdits: 파일 편집 자동 승인, 셸 명령어는 승인 요청
- auto: 묻지 않고 실행(Codex full auto와 동일)
- plan: 실행 전 계획 표시, 다단계 작업을 실행 전에 검토하는 데 유용
- bypassPermissions: 모든 검사 건너뛰기(신뢰할 수 있는 자동화 컨텍스트용)
Claude Code는 또한 settings.json에서 세분화된 허용/거부/확인 규칙 시스템을 지원하여 전체 권한 모드를 변경하지 않고도 특정 명령어를 영구적으로 승인할 수 있습니다.
엄격한 변경 제어 요구사항이 있는 팀에게는 Claude Code의 계층화된 권한 시스템이 더 많은 제어를 제공합니다. 명확한 켜기/끄기 동작만 원하는 개인 개발자에게는 Codex CLI의 세 가지 모드 시스템이 이해하기 더 쉽습니다.
세션 및 컨텍스트 관리
긴 코딩 세션은 컨텍스트 제한에 도달합니다. 두 도구 모두 이를 처리하지만 방식이 다릅니다.
Codex CLI는 세션별로 컨텍스트를 관리합니다. 세션이 종료되면 컨텍스트가 사라집니다. 다음 호출 시 새로 시작합니다.
Claude Code는 영구적인 세션 관리를 추가합니다:
claude -r "session-name"으로 재개할 수 있는 명명된 세션- 현재 대화를 요약하고 토큰 사용량을 줄이면서 계속 진행하는
/compact - 원래 대화를 잃지 않고 다른 접근 방식을 시도하기 위해 대화를 포크하는
/branch - 변경이 잘못된 경우 체크포인트로 롤백하는
/rewind - 윈도우 사용량과 위치를 시각화하는
/context
짧고 집중된 작업(이 버그 수정, 이 함수 작성, 이 테스트 추가)의 경우 차이는 중요하지 않습니다. 여러 교환에 걸쳐 발전하는 긴 리팩토링 세션이나 작업의 경우 Claude Code의 세션 연속성이 컨텍스트 손실의 마찰을 줄여줍니다.
Codex CLI를 사용해야 하는 경우
다음과 같은 경우 Codex CLI를 사용하세요:
- OpenAI 호환 모델(GPT-4o, o3, o4-mini 또는 OpenAI 형식 엔드포인트를 가진 타사 공급자)에 직접 연결해야 하는 경우
- 소스 수준에서 에이전트 동작을 감사하거나 수정하려는 경우
- 워크플로가 IDE 통합 없이 순수 터미널 기반인 경우
- CI 파이프라인 또는 내부 도구에 코딩 에이전트를 포함시키고 최소한의 감사 가능한 종속성을 원하는 경우
- 보안 요구사항이 기본적으로 명시적인 네트워크 비활성화 샌드박싱을 요구하는 경우
Claude Code를 사용해야 하는 경우
다음과 같은 경우 Claude Code를 사용하세요:
- 터미널, VS Code, JetBrains, 데스크톱 전반에서 일관된 동작을 원하는 경우
- 팀이 세션 간 공유
CLAUDE.md프로젝트 컨텍스트의 이점을 누리는 경우 - 세션 연속성(명명된 세션 재개, 대화 브랜칭, 변경 되감기)이 필요한 경우
- MCP 서버 통합이 워크플로의 일부인 경우
- Anthropic 형식 API를 선호하고 Anthropic 호환 공급자(Novita AI 포함)로 라우팅하려는 경우
Novita AI를 두 도구와 함께 사용하기
두 도구 모두 Novita AI를 즉시 사용 가능한 LLM 백엔드로 수용합니다. 이는 도구의 기본 공급자를 통해 사용할 수 없는 모델에 접근하려거나 비용이 제약 조건일 때 중요합니다. Novita AI의 DeepSeek V3, Qwen3-Coder, Kimi K2와 같은 모델은 Anthropic이나 OpenAI의 자체 플래그십 모델보다 상당히 낮은 토큰당 요금으로 실행됩니다.
Codex CLI with Novita AI: ~/.codex/config.toml에서 model_provider를 https://api.novita.ai/openai로 설정하세요. 전체 모델 목록과 설정 단계는 Codex를 Novita AI 모델과 사용하는 방법에서 확인하세요.
Claude Code with Novita AI: ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic을 설정하고 Novita API 키를 전달하세요. --model 플래그 또는 ANTHROPIC_MODEL 환경 변수로 특정 모델을 선택합니다. 전체 CLI 참조는 Claude Code CLI 문서를 참조하세요.
여기서 Novita AI의 역할은 IDE 레이어가 아닌 추론 백엔드입니다. 환경 변수가 설정되면 Codex CLI와 Claude Code는 기본 공급자를 사용할 때와 정확히 동일하게 동작합니다. 모델이 변경될 뿐 도구 인터페이스는 변경되지 않습니다. 따라서 다양한 모델(추론이 많은 작업에는 DeepSeek, 코드 생성에는 Qwen3-Coder, 도구 중심 에이전틱 작업에는 GLM-4.7)을 도구나 워크플로를 전환하지 않고 테스트하기가 간단합니다.
자체 에이전틱 파이프라인이나 코딩 플랫폼을 구축하는 팀을 위해 Novita AI는 에이전트 실행을 위한 격리된 샌드박스 환경도 제공합니다. 로컬 머신과 분리되고, 범위가 지정된 파일 접근과 제어된 실행이 가능합니다.
FAQ
Codex는 원래 OpenAI Codex 모델과 같은가요?
아닙니다. 원래 Codex는 2021년 OpenAI가 출시하고 이후에 deprecate된 코드 생성 모델이었습니다. Codex CLI는 별개의 제품입니다. 2025년에 출시된 오픈소스 터미널 에이전트로, Chat Completions API를 통해 현재 OpenAI 모델(GPT-4o, o3 등)을 사용합니다. 이름은 비슷하지만 제품은 관련이 없습니다.
Codex CLI와 함께 GPT-4o 또는 최신 OpenAI 모델을 사용할 수 있나요?
네. Codex CLI의 TOML 설정에 있는 model 필드는 설정된 공급자가 지원하는 모든 모델 ID를 허용합니다. OpenAI 엔드포인트로 연결하면 gpt-4o, o3, o4-mini 및 기타 최신 모델이 모두 작동합니다.
Claude Code는 OpenAI 호환 엔드포인트를 지원하나요?
직접적으로는 아닙니다. Claude Code는 Anthropic Messages API 형식을 사용하므로 Anthropic 호환 엔드포인트를 제공하는 공급자가 필요합니다. Novita AI는 이를 지원합니다. OpenAI의 엔드포인트는 다른 형식을 사용하며 호환되지 않습니다.
어떤 도구가 더 저렴하게 실행되나요?
두 도구 모두 API 요청을 보내므로 비용은 도구 자체가 아니라 연결하는 모델과 공급자에 따라 달라집니다. 두 도구 모두 Novita AI를 통해 DeepSeek V3 또는 Qwen3-Coder와 같은 저비용 모델로 전환하는 것이 주요 비용 절감 수단입니다. 현재 가격은 Novita AI 모델 라이브러리에서 확인하세요.
두 도구를 함께 사용할 수 있나요?
일부 팀은 그렇게 합니다. Codex CLI는 CI 또는 스크립트 컨텍스트에 포함시키기에 충분히 가벼운 반면, Claude Code는 VS Code에서 대화형 개발 세션을 처리합니다. 두 도구는 세션을 공유하지 않으므로 함께 사용하려면 별도의 설정을 유지 관리해야 합니다. 관리 가능하지만 의도적으로 접근할 가치가 있습니다.
추천 자료
