<aside> ✅

검증 상태 — 2026-09-10, Windows 10 / PowerShell 5.1

이 문서의 설정은 실제로 설치·실행해서 확인했습니다.

방법 A: 설치 완료. claude 2.1.267 · 플러그인 codex@openai-codex 1.0.6 (user scope) · codex-cli 0.154.0 · ChatGPT 로그인 완료

방법 B: 2026-09-14 — BoomPG(Unity) 프로젝트에 적용 완료. Edit/Write 가드 + Bash/PowerShell 우회 차단 가드 2종 운영 중, 회귀 테스트 25케이스 전부 통과 (2026-09-17 기준). 핸드오프 e2e 검증 완료(Codex가 계획서만 받아 가드 스크립트를 실제로 고쳐 보고까지). Unity MCP 연동도 검증 완료 — 아래 전용 섹션 참고.

설치하면서 막힌 지점은 아래 이 PC 설치 기록 섹션에 정리했습니다.

</aside>

Claude Code는 심층 아키텍처 추론과 설계에 강하고, Codex는 빠르고 지치지 않는 물량 구현에 강합니다. 이 문서는 두 에이전트를 "기획 → 구현"으로 나눠 쓰는 실제로 동작하는 두 가지 방법을 다룹니다.

방법 A는 설치 10분이면 되는 가벼운 방식, 방법 B는 Claude가 코드를 못 만지도록 시스템 레벨에서 강제하는 방식입니다. 둘은 충돌하지 않으니 같이 써도 됩니다.


0. 사전 준비

항목 확인 명령 비고
Node.js 18.18+ node --version 방법 A 플러그인에 필요
Codex CLI codex --version 두 방법 모두 필요
Codex 로그인 codex login ChatGPT 구독 또는 OpenAI API 키
git git --version Codex 결과 확인·되돌리기에 사실상 필수

Codex 설치는 둘 중 하나:

winget install OpenAI.Codex
npm install -g @openai/codex

그다음 로그인. 계정 인증이라 자동화할 수 없고 사람이 직접 해야 합니다.

codex login

<aside> ⚠️

Codex는 기본적으로 읽기 전용 샌드박스로 실행됩니다. 파일을 쓰게 하려면 --sandbox workspace-write를 명시해야 합니다. 아래 스크립트에는 이미 들어 있습니다.

단 이 샌드박스는 .git/ 쓰기도 막습니다. Codex는 커밋할 수 없습니다 — 커밋은 사람이 합니다.

</aside>

<aside> 🪟

winget이 없는 Windows 10 환경도 있습니다. App Installer가 구버전 스텁이면 winget.exe 자체가 존재하지 않으니 npm으로 설치하세요. 실제로 이 케이스를 겪었고, 아래 이 PC 설치 기록에 정리했습니다.

</aside>


방법 A — codex-plugin-cc 플러그인

OpenAI가 Claude Code 전용으로 낸 공식 플러그인입니다. Claude Code가 메인 빌더로 구현하고, Codex를 검토자·구원투수로 부르는 구조입니다. 가장 빠르게 효과를 봅니다.

A-1. 설치

터미널에서 Claude Code를 띄운 뒤 순서대로 입력합니다.

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup