TL;DR

이 저장소는 Codex의 설치·설정·실전 워크플로와 앱·CLI·IDE·웹 진입점별 사용법을 단계별로 정리한 비공식 실무 안내서이다. 설치 명령과 로그인 방법, 샌드박스 권한 모델, /plan·/diff·/review 같은 핵심 명령을 포함해 실습용 예제와 권장 작업 흐름을 제공한다. Codex는 프로젝트 디렉터리를 읽어 계획을 세운 뒤 파일을 수정하고 터미널 명령을 실행해 결과를 검증한 뒤 diff·PR 형태로 산출물을 만든다. 이 문서는 작은 단위 작업을 분할해 먼저 읽고 계획한 뒤 수정·테스트·검토하는 워크플로를 권장하며, 승인 기반 샌드박스와 Git 스냅샷을 통해 안전하게 운영하도록 권고한다. 결과적으로 Codex는 단순 코드 생성 도구가 아니라 '엔지니어링 태스크 실행기'로 사용될 때 효율을 발휘한다. 한편 권한·명령 실행 위험과 대규모 리팩터링의 실패 위험은 문서에서 반복적으로 경고되므로 민감 데이터·프로덕션 인프라·광범위 아키텍처 변경은 인간 승인이 전제되어야 한다. 따라서 실제 도입 전에는 샌드박스 설정·작업 분해·Git 백업 절차를 사전에 마련해야 한다.

주요 기능

• 프로젝트를 읽고 파일 구조·종속성을 파악한다
• 작업 계획을 수립한 뒤 코드 수정과 명령 실행으로 결과를 생성한다
• 테스트·빌드·git diff를 실행해 변경 내용을 검증하고 review 가능한 PR 산출물을 준비한다
• 앱·CLI·IDE 익스텐션·웹(Cloud) 등 여러 진입점으로 작업을 수행한다
• 권한·샌드박스·승인 흐름을 통해 위험한 명령 실행을 통제한다

어떻게 동작하는가

Codex는 선택한 프로젝트 디렉터리를 스캔해 진입점(package.json, README 등)을 파악한 뒤 작업 목표에 맞는 계획을 생성한다. 계획을 바탕으로 파일을 생성·수정하고 터미널 명령(npm run, git 등)을 실행해 결과를 검증한 뒤 diff와 PR 형태로 변경을 출력한다.

해결 문제

프로젝트 컨텍스트 전체를 이해하지 못하는 단발성 코드 보조 도구의 한계를 해결해, 파일 읽기·명령 실행·검증·PR 생성까지 이어지는 엔드투엔드 엔지니어링 작업을 자동화한다.

지금 주목받는 이유

Codex가 '프로젝트 실행형 코딩 에이전트'로 재부상하면서 App/CLI/IDE/Web를 연결해 실무 수준의 작업 자동화를 목표로 하기 때문에 주목받고 있다.

차별점

• 멀티 엔트리(Desktop App, CLI, IDE Extension, Web Cloud)를 통한 동일 에이전트의 다양한 작업 환경 지원
• 권한 기반 샌드박스와 승인(flow)으로 안전하게 터미널 명령 및 파일 수정을 수행
• 작업계획(plan) 모드·thread 단위 작업 분리·자동화(스킬·MCP 연동)로 엔지니어링 워크플로우에 깊게 통합

사용 사례

• 미지의 레포지토리 빠른 진단: 엔트리 파일·빌드 명령·핵심 모듈을 도출해 초기 온보딩 속도를 높인다
• 작업 단위 버그 픽스·기능 추가: 범위를 제한한 작은 작업을 계획하고 코드 변경·테스트·diff까지 자동화한다
• 테스트 보강과 리팩터링: 단위 테스트 추가·경계조건 보완·작은 리팩터링을 반복적으로 수행하여 품질을 개선한다
• GitHub 기반 PR 생성 워크플로우: Codex Web에서 변경을 만들고 PR로 제출해 리뷰 준비 산출물을 생성한다

시작하기

간단 설치 흐름: (1) Node.js가 있으면 `npm install -g @openai/codex`로 CLI 설치 또는 macOS는 `brew install --cask codex`로 설치한다. (2) 프로젝트 디렉터리로 이동해 `codex`를 실행하고 `codex login`으로 ChatGPT 계정 또는 API Key로 인증한다. (3) 작업 전 `git init`·`git add .`·`git commit -m "initial commit"`로 스냅샷을 만든 뒤 `/plan` 또는 간단한 작업을 입력해 시작한다.

요구사항

• 운영체제: macOS 또는 Windows(데스크톱 앱), CLI는 macOS/Windows/Linux 지원
• 기본 도구: Git, Node.js(CLI 설치 시), 브라우저(로그인 시)
• 계정: ChatGPT 계정 또는 OpenAI API Key
• 권한: 프로젝트 폴더에 대한 읽기/쓰기 권한(샌드박스 설정에 따라 추가 권한 필요)

이미지 분석