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, Kimi K2를 OpenAI 호환 엔드포인트를 통해), Codex CLI가 더 자연스러운 선택입니다.
- 선호하는 모델이 Anthropic 형식을 사용하거나 CLI와 IDE 서피스에서 동일한 구성을 사용하려는 경우, Claude Code가 더 일관된 동작을 제공합니다.
두 도구 모두 Novita AI의 모델을 지원합니다. 구성 방법은 다르지만(Codex는 TOML, Claude Code는 환경 변수), Novita AI 모델 라이브러리(DeepSeek V3, Qwen3-Coder, Kimi K2 포함)는 둘 다에서 액세스할 수 있습니다.
오픈소스 vs 독점 아키텍처
Codex CLI의 오픈소스 특성은 특정 맥락에서 중요합니다: 에이전트 루프를 감사하고, 내부 도구로 포크하거나, 별도의 라이선싱 논의 없이 CI 파이프라인에 벤더로 포함시킬 수 있습니다. 커뮤니티는 제공자 통합, 버그 수정, 기능 확장에 기여할 수 있습니다(실제로 기여하고 있습니다).
Claude Code의 핵심은 독점입니다. Anthropic은 소스 릴리스가 아닌 API 액세스가 있는 배포 바이너리로 CLI를 제공합니다. 장점은 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을 실행하여 시작용 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파일(프로젝트 수준, 디렉토리 수준, 사용자 수준) - 권한 규칙, 후크 정의 및 도구 설정을 위한
.claude/settings.json - 세션 중 지침을 편집하기 위한
/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와 Novita AI: ~/.codex/config.toml에서 model_provider를 https://api.novita.ai/openai로 구성하세요. 전체 모델 목록과 설정 단계는 Codex를 Novita AI 모델과 함께 사용하는 방법에서 확인하세요.
Claude Code와 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에서 출시하고 이후 사용 중단된 코드 생성 모델이었습니다. Codex CLI는 별도의 제품입니다. Chat Completions API를 통해 현재 OpenAI 모델(GPT-4o, o3 등)을 사용하는 2025년에 출시된 오픈소스 터미널 에이전트입니다. 이름은 비슷하지만 제품은 관련이 없습니다.
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에서 대화형 개발 세션을 처리합니다. 두 도구는 세션을 공유하지 않으므로 결합하려면 별도의 구성을 유지해야 합니다. 관리할 수 있지만 의도적으로 접근하는 것이 좋습니다.
추천 자료
