Codex CLI 다 알려드릴게요. 그래도 메인은 Claude Code입니다

요즘 OpenAI Codex CLI에 대한 관심이 많습니다. "Claude Code에서 갈아타야 하는가"라는 질문도 자주 보이고요. 결론부터 말씀드리면, 갈아탈 필요 없습니다. 코덱스 CLI는 잘 만든 도구이지만, 메인 도구를 바꿀 정도는 아닙니다. 메인은 여전히 Claude Code입니다.

이 글에서는 두 가지를 다룹니다. 먼저 Codex CLI의 핵심 활용법을 정리하고, 그 다음 왜 여전히 Claude Code가 메인이어야 하는지 다섯 가지 근거로 분석합니다.

"Claude Code 품질 저하" 논란부터 정리합니다

코덱스로 옮겨가려는 분들 대부분이 한 번쯤 겪으셨을 이슈입니다. 한동안 Claude Code 품질이 떨어진다는 체감이 분명히 있었습니다. Anthropic이 공식적으로 원인을 밝혔고, 세 가지가 함께 작용했다고 발표했습니다.

1. 추론 난이도 설정이 중간에서 높음으로 변경됐던 시기
2. 캐싱 동작 변경
3. 시스템 프롬프트 변경

이 세 가지 모두 원상 복구가 완료된 상태입니다. 즉, 많은 사용자가 "코덱스로 갈아타야 하나" 고민할 무렵 Claude Code는 이미 정상화되어 있었습니다. 일시적 이슈에 끌려 메인 도구를 바꾸는 의사결정은 신중해야 합니다.

Codex CLI 핵심 활용법

설치와 첫 실행

설치는 npm 한 줄로 끝납니다.

npm install -g @openai/codex

터미널에서 codex를 입력하면 실행됩니다. UI는 Claude Code와 거의 흡사해서 적응 비용은 낮은 편입니다. 키보드 단축키 체계도 비슷하고, 인터랙티브 방식도 유사합니다.

권한 모드 3가지

/permissions 명령어로 권한 모드를 설정할 수 있습니다.

일상 작업은 Default나 Auto Review로 충분합니다. Full Access는 격리된 컨테이너나 가상머신에서만 사용을 권장합니다.

슬래시 명령어 정리

코덱스 CLI에서 자주 쓰게 되는 명령어들입니다.

• /statusline: 모델, 추론 단계, 컨텍스트, 패스트 모드 여부, 프로젝트명을 한 줄에 표시
• /copy (단축키 Ctrl+O): 마지막 응답을 클립보드로 복사
• /clear: 컨텍스트를 0%로 리셋
• /resume: 기존 세션 복원. /resume --all은 다른 프로젝트 세션까지 포함
• /fork: 현재 세션을 복제. 분기 작업할 때 유용
• /status: 컨텍스트 윈도우 사용량과 위클리 리밋 확인
• /model: 모델 변경 + 추론 단계(low/medium/high) 설정
• /fast: 패스트 모드 토글
• /plan (단축키 Shift+Tab): 계획 문서를 먼저 작성하고 코드는 나중
• /review: 4가지 리뷰 모드 (브랜치 비교, 커밋 직전 셀프 리뷰, 커스텀 인스트럭션 등)
• /compact: 대화 내역을 압축해 필요한 맥락만 새 컨텍스트로 추리기

단축키 정리

• Tab: 후속 작업을 큐에 적재. 현재 작업 진행 중에도 다음 작업을 미리 등록 가능
• Ctrl+R: 프롬프트 히스토리 검색
• Ctrl+C (작성 중): 프롬프트 임시 삭제. 위 방향키로 복원 가능
• Ctrl+C (대기 중): 코덱스 종료
• 위/아래 방향키: 프롬프트 히스토리 탐색
• ! 입력: 배시 모드. 셸 명령을 직접 실행
• $ 입력: 코덱스 스킬 호출 (예: $image)

Tab으로 큐를 쌓아두는 패턴이 의외로 편합니다. AI가 작업하는 동안 다음 단계를 미리 적어두는 식입니다.

모델 라인업

대부분의 작업은 5.4로 충분합니다. 5.5는 정말 어려운 작업에만 쓰는 게 효율적입니다.

$image 스킬로 이미지 생성

코덱스 CLI 안에서 $image 스킬을 호출하면 이미지를 생성할 수 있습니다. Image 2.0 모델을 쓰는데, 한글 텍스트 렌더링이 거의 완벽한 수준입니다. 코덱스 요금제에 포함이라 별도 결제는 필요 없습니다.

로고나 배너를 개발 워크플로우 안에서 빠르게 뽑을 때 활용도가 있습니다.

Plan 모드 워크플로우

Shift+Tab 또는 /plan으로 진입합니다. 흐름은 이렇습니다.

1. 계획 문서(plan)부터 작성합니다
2. 모호한 부분이 있으면 에이전트가 역질문합니다
3. 완성된 plan을 검토한 뒤 실행 옵션 3가지 중 선택합니다
   • 현재 세션에서 바로 실행
   • 컨텍스트를 초기화하고 plan만 가지고 실행 (권장)
   • plan을 더 수정

권장 패턴은 두 번째입니다. "feature 단위로 plan을 만들고, 컨텍스트를 초기화한 뒤 실행"하는 방식이 일관성과 품질 모두에서 가장 안정적이라는 게 정설입니다.

Review 모드

/review 명령어로 진입합니다.

• 현재 브랜치 vs 베이스 브랜치 비교
• 커밋되지 않은 변경사항 셀프 리뷰
• 커스텀 리뷰 인스트럭션 적용

PR을 올리기 직전 셀프 리뷰 용도로 쓰면 한 번 더 점검하는 효과가 있습니다.

Codex Cloud로 PR 자동 리뷰

이게 코덱스에서 꽤 강력한 기능입니다.

chat.openai.com/codex → Connectors → GitHub 연결을 거쳐 코드 검토 옵션을 켭니다. 트리거는 세 가지 중 선택할 수 있습니다.

• PR이 열릴 때
• 푸시할 때
• 스마트 트리거 (변경 규모/유형에 따라)

PR에 코덱스 봇이 코멘트를 달고, 이슈 수정을 직접 요청하면 코덱스 클라우드가 자동으로 커밋해줍니다. 솔직히 이 부분은 편합니다.

그래서 왜 여전히 Claude Code가 메인인가

여기까지 보면 코덱스가 매력적으로 보일 수 있습니다. 하지만 다음 다섯 가지 이유로 메인은 여전히 Claude Code입니다.

1. 응답 속도가 빠릅니다

일상 개발에서 체감 응답 속도는 Claude Code가 더 빠릅니다. 코덱스는 패스트 모드를 켜야 비슷한 수준이 되는데, 패스트 모드는 크레딧을 2~2.5배 소비합니다. 즉, 같은 속도를 얻으려면 비용이 두 배 이상 들어가는 구조입니다.

코드 생산성은 결국 "한 번의 응답을 기다리는 시간"의 누적입니다. 하루에 수백 번 반복되는 인터랙션에서 0.5초 차이가 쌓이면 큰 차이가 됩니다.

2. 대규모 리팩토링에서 안정적입니다

코드베이스 전체를 이해하고 일관된 변경을 적용하는 능력에서 Claude Code가 한 발 앞섭니다. 흥미로운 점은, 코덱스를 적극 추천하는 분들도 "일상 개발과 대규모 리팩토링은 Claude Code를 쓴다"고 자주 인정한다는 겁니다.

이건 단순히 모델 성능 차이가 아니라 도구 설계 철학 차이입니다. Claude Code는 처음부터 코드베이스 단위 작업을 염두에 두고 만들어졌습니다.

3. 생태계가 압도적입니다

이게 결정적입니다.

• MCP 표준화: Anthropic이 만든 Model Context Protocol이 사실상 업계 표준이 됐습니다. 외부 툴 연동의 공통 언어 역할을 합니다
• 서브에이전트 / Agent Teams: 역할별 에이전트를 조합해 복잡한 워크플로우를 구성할 수 있습니다
• 스킬 시스템: 재사용 가능한 자동화 단위를 만들고 공유할 수 있습니다
• 훅(Hook): SessionStart, PreToolUse, PostToolUse 등 라이프사이클에 맞춰 자동화를 끼워 넣을 수 있습니다
• Claude Code Plugin 생태계가 빠르게 성장 중입니다

코덱스가 이 수준에 도달하려면 상당한 시간이 필요합니다.

4. 코덱스의 강점은 "보조 영역"입니다

코덱스를 추천할 때 자주 거론되는 두 가지 장점은 이렇습니다.

• 토큰 비용 절감
• 장기 자율 실행

그런데 두 가지 모두 Claude Code에서 충분히 대응됩니다.

• 토큰 절감: Claude Pro/Max 정액제는 사실상 무제한에 가까운 사용량을 제공합니다. 토큰 단위 과금 비교는 의미가 줄어듭니다
• 장기 자율 실행: Claude Code의 SDK, 헤드리스 모드, 백그라운드 작업으로 동일한 시나리오를 구현할 수 있습니다

결국 코덱스의 차별화 지점은 "second opinion"으로 좁아집니다. 다른 시각의 코드 분석, 다른 모델의 PR 리뷰가 필요할 때 보조로 쓰는 도구로 포지셔닝됩니다.

5. 도구를 늘리되 주축은 지켜야 합니다

여러 AI 도구를 동시에 쓰는 건 좋습니다. 하지만 메인 도구를 바꾸는 건 학습 비용, 워크플로우 재구성, 팀 동기화 비용을 동반합니다. "코덱스가 더 좋다고 들어서 옮겼더니 한 달 동안 적응만 하다 끝났다"는 사례가 드물지 않습니다.

지금 권장되는 구도는 명확합니다.

• 메인: Claude Code (일상 개발 + 리팩토링 + 자동화 파이프라인)
• 보조: Codex (특정 PR 리뷰, 가끔 다른 시각의 코드 분석)

권장 활용 시나리오

코덱스를 보조로 쓸 때 가장 효율적인 시점을 정리하면 다음과 같습니다.

이 구도가 현재 가장 합리적입니다.

결론

Codex CLI는 잘 만든 도구입니다. Plan 모드, Review 모드, Codex Cloud 모두 충분히 매력적입니다. 하지만 메인 도구를 바꿔야 할 만큼은 아닙니다.

Claude Code의 일시적 품질 저하 이슈는 이미 복구됐고, 응답 속도와 생태계는 여전히 한 단계 앞서 있습니다. 코덱스로 갈아타려는 시간을 Claude Code를 더 잘 쓰는 데 투자하는 쪽이 훨씬 더 큰 생산성 향상을 가져옵니다.

도구를 늘리되 주축은 흔들지 마세요. 그게 생산성을 지키는 가장 빠른 길입니다.