AI 코딩 도구에 의존하는 워크플로우에서 가장 위험한 순간은 도구가 멈추는 때입니다. 최근 Claude 중단사태에서 봤듯이, 어떤 서비스든 다운될 수 있습니다. Codex도 예외가 아닙니다. 이 글은 Codex 장애 시 Claude Code와 Gemini CLI로 즉시 전환하는 실전 가이드입니다.

Codex 장애 확인하는 법

작업 중 Codex가 응답하지 않으면, 내 환경 문제인지 서비스 장애인지 먼저 확인해야 합니다.

• 공식 상태 페이지: status.openai.com — Codex Web, Codex App, Codex API, Codex CLI 각각 별도 추적
• 서드파티 모니터링: StatusGator, IncidentHub에서도 Codex 상태를 추적합니다
• 빠른 판단: 같은 네트워크에서 ChatGPT 웹이 정상이면 Codex CLI 쪽 문제, 둘 다 안 되면 OpenAI 전체 장애

백업 1: Claude Code CLI

설치

[code lang="bash"]

네이티브 설치 (권장 — 의존성 없음)

curl -fsSL https://claude.ai/install.sh | bash

Homebrew (안정 채널, ~1주 지연)

brew install --cask claude-code [/code]

macOS 13+, Ubuntu 20.04+, Windows 10+(WSL) 지원. RAM 4GB 이상(8GB 권장). Anthropic 계정 필요(Pro $20/월 이상).

첫 실행

[code lang="bash"] cd /내-프로젝트 claude

브라우저에서 인증 후 바로 사용 가능

[/code]

프로젝트 루트에 CLAUDE.md가 있으면 자동으로 프로젝트 컨텍스트를 읽습니다.

Codex 장애 시 Claude Code 강점

• 멀티파일 리팩토링과 의존성 추적에 강합니다
• 프론트엔드/React 작업에서 Codex보다 나은 결과물을 보입니다
• 대화형으로 질문을 하면서 작업하므로, 복잡한 디버깅에 적합합니다

백업 2: Gemini CLI

설치

[code lang="bash"] npm install -g @google/gemini-cli [/code]

Node.js 20+ 필요. 개인 Google 계정으로 Gemini 2.5 Pro를 무료로 사용할 수 있습니다.

첫 실행

[code lang="bash"] cd /내-프로젝트 gemini

Google 계정 인증 후 사용

[/code]

Gemini CLI 특징

• 100만 토큰 컨텍스트 윈도우 — 대규모 코드베이스에 유리
• Google Search 그라운딩 내장 — 최신 문서를 실시간 참조
• Apache 2.0 오픈소스 — github.com/google-gemini/gemini-cli
• MCP 지원으로 외부 도구 연동 가능

3가지 CLI 빠른 비교

항목	Codex CLI	Claude Code	Gemini CLI
설치	npm i -g @openai/codex	네이티브 설치	npm i -g @google/gemini-cli
Node 필요	22+	불필요	20+
인증	ChatGPT 계정	Anthropic 계정	Google 계정
무료 티어	없음 (Plus 이상)	없음 (Pro 이상)	있음 (개인 계정)
오픈소스	Yes	Yes	Yes (Apache 2.0)
상태 페이지	status.openai.com	status.anthropic.com	—

Codex 장애 시 전환 실전 팁

전환 전 준비

Codex 장애가 발생하기 전에 미리 해두면 좋은 것들입니다.

• Claude Code와 Gemini CLI를 미리 설치하고 인증해 두세요. 장애 중에 설치하면 시간이 더 걸립니다
• 각 도구의 프로젝트 컨텍스트 파일을 만들어 두세요 — Claude Code는 CLAUDE.md, Gemini CLI는 GEMINI.md
• 현재 작업 상태를 git commit으로 저장하는 습관을 들이세요. 도구 전환 시 깨끗한 시작점이 됩니다

전환 시 주의사항

• 대화 이력은 도구 간 이전되지 않습니다 — 새 도구에서 처음부터 컨텍스트를 설명해야 합니다
• 동작 방식이 다릅니다 — Codex는 자율 실행형(지시 후 알아서 작업), Claude Code는 대화형(중간중간 질문), Gemini CLI는 그 사이
• 같은 브랜치에서 두 도구를 동시에 돌리지 마세요 — git 충돌이 발생합니다. 전환 시 현재 작업을 commit하고 넘어가세요

Codex 장애, 정리

단일 도구 의존은 리스크입니다. Codex 장애가 발생하면 Claude Code나 Gemini CLI로 전환해서 작업을 이어갈 수 있고, 미리 설치와 인증을 해두면 전환 시간은 1분 이내입니다. 다음 글에서는 Codex와 Claude Code를 평소에 병행하는 워크플로우를 다룹니다.