Tech Insight

Codex 입문서: Claude Code와 어떻게 다르게 써야 할까

Codex 만의 정체성을 먼저 정리하고, 한국어 학습 자료 5선과 시작점별 학습 순서를 추천하는 글입니다.

2026년 5월 16일6분60042

먼저 결론부터 Claude Code 는 "한 세션을 깊게 같이 가는 프로그래머" 에 가깝고, Codex 는 "여러 작업을 맡겨두고 결과를 확인하는 툴" 에 가깝습니다. 처음 배우는 순서는 사람마다 다르지만, 이미 Claude Code 를 쓰고 있다면 Codex 는 완벽한 대체가 아닌 보조 툴로 이해하는 편이 가장 빠릅니다.

요즘 한국 vibe coder 커뮤니티에 한 가지 갑론을박이 돕니다. "기획과 프론트는 Claude Code, 오래 도는 백엔드 작업은 Codex" 라는 분업 패턴이 트위터·Threads·인프런 스토리에서 동시에 거론되고 있고, OpenAI 가 Claude Code 안에서 호출 가능한 Codex 플러그인까지 공개하면서 둘은 경쟁자보다는 다른 유형의 일을 잘하는 두 도구로 자리 잡는 흐름으로 보입니다.

그런데 Codex 를 처음 켜면 막히는 지점은 Claude Code 와 다릅니다. Claude Code 는 한 터미널 세션을 깊게 같이 가는 모델인데, Codex 는 같은 CLI 인 동시에 여러 환경에서 이어지는 에이전트입니다.

"지금 어디서 어떤 모드로 시작해야 하는가" 부터 선택지가 달라집니다.

Codex 의 정체성 — 네 가지 사용 경로

OpenAI 공식 가이드를 기준으로 보면, Codex는 하나의 도구라기보다 여러 환경에서 이어서 쓸 수 있는 개발 에이전트에 가깝습니다.

Codex CLI — 터미널에서 도는 자율 코딩 에이전트. AGENTS.md 컨텍스트, 승인 모드 3단계(제안 / 자동편집 / 전자동), 격리된 sandbox.
IDE 익스텐션 — VS Code · Cursor · Windsurf 에서 파일·diff·snippet 컨텍스트를 그대로 공유.
데스크톱 앱 — macOS · Windows. 최근 업데이트로 데스크톱 환경에서 커서를 직접 움직이는 컴퓨터 사용(computer-use) 기능까지.
Codex Cloud — 작업을 클라우드 작업 환경에 던지고, 다른 일을 하다가 결과를 받는 비동기 위임 모드.

Codex 는 ChatGPT Plus, Pro, Business, Edu, Enterprise 플랜에 포함되며, 현재는 Free 와 Go 플랜에서도 한시적으로 사용할 수 있습니다.

그래서 별도 결제 없이 먼저 만져볼 수 있다는 점도 Claude Code 와 차이가 나는 진입 장벽입니다.

코덱스 만의 메리트와 한계

메리트

작업을 맡겨두기 좋습니다 — "맡기고 떠나는" 작업 흐름이 가장 큰 차별점입니다. 긴 리팩토링 · 보일러플레이트 생성 · 반복 구현 같은 작업을 Codex Cloud 에 던지고 다른 화면을 보다가 결과를 받는 워크플로우가 자연스럽습니다.
여러 작업 환경을 오가는 구조 — CLI 만 쓰는 게 아니라 IDE · 앱 · 클라우드 어디서 시작하든 같은 에이전트가 이어집니다.
ChatGPT 구독 내장 — ChatGPT 본체와 Codex CLI 를 같은 구독으로 사용할 수 있고, Free 와 Go 플랜에서도 현재는 한시적으로 포함됩니다.
안전장치 확보 — 자율 에이전트의 보안 우려를 가장 명시적으로 다루는 도구로 보입니다.

한계

인터랙티브 페어 코딩 흐름 — 깊은 리팩토링이나 긴 대화형 페어 코딩에서는 Claude Code 가 더 자연스럽다는 사용자 후기가 많습니다. 다만 벤치마크 우열은 모델 버전과 측정 시점에 따라 빠르게 바뀌므로, 이 글에서는 "작업 흐름의 차이" 에 초점을 맞추겠습니다.
한국어 대표 가이드 부족 — Claude Code 는 한국어권에서도 비교적 널리 참조되는 가이드가 쌓여가고 있지만, Codex 는 아직 "이것부터 보면 된다" 고 말할 만한 대표 입문서가 부족합니다.
작업 진행 상황이 덜 보이는 점 — "지금 뭐 하고 있는지" 한 눈에 안 들어와서, 처음 켜면 답답하다는 후기가 자주 보입니다.

Codex 는 Claude Code 의 대체 수단이 아니라, 같은 책상 위에 둘 다 두고 작업 종류에 따라 나눠 쓰는 도구로 자리 잡는 시기로 해석할 수 있습니다.

한 줄로 정리한 다섯 자료

Codex 만 다룬 표준 입문서는 아직 자리 잡지 않아서, 위키독스의 Codex 챕터를 가진 책 두 권 + 검증된 한국어 long-form 자료 세 편을 묶었습니다.

1. 함께해요 바이브 코딩 — 에드윈

Codex CLI 단독 챕터를 한국어로 가진 거의 유일한 책입니다. 설치 · 승인 모드 3단계 · sandbox · 슬래시 명령어 · config.toml · AGENTS.md 까지 한 번에 정리해 줍니다. Claude Code · Aider · Cline · Gemini CLI 와 한 책에 묶여 있어서 "왜 Codex 인가" 가 자연스럽게 잡힙니다.

무료 · 위키독스 web → 위키독스에서 보기

2. 생성 AI 활용기 2026 — 전뇌해커 · 채찍피티

Codex 를 ChatGPT · Claude · Grok · Gemini 와 나란히 놓고 비교하는 종합 가이드입니다. Codex 챕터가 최신 모델 상태 · 요금 구조 · Realtime API 와의 관계까지 따라가서, "Codex 만 따로 사야 하는지" 같은 결정에 가장 빠르게 답을 줍니다.

무료 · 위키독스 web → 위키독스에서 보기

3. 박재홍의 실리콘밸리 — Codex 시리즈

한국어 Codex 분석으로 가장 빠르게 따라가는 long-form 시리즈입니다. 마스터클래스(플러그인·서브 에이전트·자동화), 요금제 해부, Codex 가 Claude Code 안으로 들어왔다 세 편이 같이 읽혀야 그림이 잡힙니다.

무료 · 위키독스 블로그 시리즈 → 박재홍의 실리콘밸리 보기

4. 이랜서 — Codex CLI 사용법, 한 번에 (2026-01-28)

설치 · GPT-5.3 · GPT-5.5 모델 업데이트 · Git 통합 · CI/CD 워크플로 · 트러블슈팅 · 요금까지 한 글로 묶은 실무형 가이드입니다. 첫 한 시간에 Codex 를 자신의 레포에 연결하는 데 가장 직접적인 한국어 글로 보입니다.

무료 · 이랜서 블로그 → 글 보기

5. 인프런 Poco — 클로드 코드 vs 코덱스

"맡기고 싶은 일의 종류가 다르다" 라는 한 문장으로 두 도구를 갈라 놓는 비교 분석입니다. Codex Plus $20 · 데스크톱 자동화 · 90개 이상 플러그인 · 이미지 생성을 Claude Code 의 1M 컨텍스트와 나란히 두고 어느 쪽이 어떤 사람에게 맞는지 정리해 줍니다.

무료 · 인프런 스토리 → 글 보기

학습 순서 — 시작점에 따라

Codex 가 처음, 터미널도 어색한 분

함께해요 바이브 코딩(에드윈) → 이랜서 Codex CLI 사용법 이 가장 막힘이 적습니다. 첫 책으로 승인 모드 · sandbox · AGENTS.md 같은 개념을 잡고, 이랜서 글로 자신의 레포에 연결하는 실무 단계로 넘어가시면 됩니다.

ChatGPT 는 익숙한데 Codex CLI 가 처음

이랜서 Codex CLI 사용법 → 함께해요 바이브 코딩 Codex 챕터 두 글만 펴도 첫 한 주는 충분합니다. ChatGPT 본체와 Codex CLI 의 차이(터미널 기반, 위임 체계, 격리된 sandbox)가 양쪽에 정리되어 있어서, 숙지하기만 해도 툴 전환 비용이 거의 0 으로 줄어듭니다.

Claude Code 는 쓰고 있는데 Codex 도 같이 보고 싶은 분

인프런 Poco 글 → 박재홍 시리즈(Codex 가 Claude Code 안으로 들어왔다) 순서를 권합니다. 한국 vibe coder 들이 두 도구를 실제로 어떻게 나눠 쓰는지 + OpenAI 가 둘을 어떻게 결합하는 방향으로 가는지가 정리됩니다.

Codex 를 결정하기 전에 큰 그림이 필요한 분

생성 AI 활용기 2026 → 박재홍 요금제 해부 으로 들어가시면, ChatGPT · Claude · Grok · Gemini 의 자리 배치와 Codex 의 비용 구조까지 한 번에 잡힙니다.

Codex 의 자동화·커스텀 워크플로를 진심으로 운영하고 싶은 분

함께해요 바이브 코딩 → 박재홍 마스터클래스 으로, 서브 에이전트 · 플러그인 · 자동화 레이어까지 끌어 올리시면 됩니다. Codex Cloud 의 비동기 위임을 운영 패턴으로 굳히는 분들에게 가장 부담 없이 펼 수 있는 조합입니다.

정리

Codex 의 한국어 학습 자료는 아직 "이것만 보면 된다" 는 대표 입문서 한 권으로 정리된 리소스는 없습니다. 대신 위키독스 책 두 권과 한국어 long-form 글 몇 편을 시작점에 맞춰 조합하는 방식이 가장 현실적인 입문 경로로 보입니다.

Codex 의 차별점은 단순히 모델 성능 한 줄에 있지 않습니다. 터미널, IDE, 데스크톱 앱, 클라우드를 오가며 작업을 맡기고 이어받는 구조 자체가 핵심입니다. Claude Code 와 어느 쪽이 더 낫냐는 질문보다, 어떤 작업을 Claude Code 에 맡기고 어떤 작업을 Codex 에 위임할지 나누는 질문이 더 생산적입니다.

OpenAI 가 GPT-5.5 와 Codex CLI 업데이트를 빠르게 갱신하는 시기라, 버전 숫자는 매주 바뀔 수 있습니다.

AI 파도 속에서 휩쓸리지 마시고 그 파도를 타시길 바랍니다.

Lattice 의 Skills · 프롬프트 · MCP 카드도 빠른 호흡으로 매주 정리되고 있어서 북마크 하시고 참고하시길 바랍니다.