Codex CLI 시작하기 — Fire-and-Forget 자율 코딩의 시작

"JIRA 티켓 3개 처리해두고 PR 올려놔." 팀장님이 후배에게 할 법한 지시다. 그런데 이제 이 지시를 터미널 창에 입력하고 나는 퇴근하면 된다. OpenAI의 Codex CLI가 지향하는 궁극적인 목표가 바로 이것이다.

Gemini CLI가 '초대형 문서 분석기'고 Claude Code가 '신중한 페어 프로그래머'라면, 2026년의 Codex CLI는 '스스로 움직이는 자동화 공장'에 가깝다.

6편에서는 "시켜놓고 잊어버리는(Fire-and-forget)" 워크플로우에 최적화된 Codex CLI의 설치와 기본 개념을 다룬다.

1. Codex CLI의 철학과 설치

Codex CLI는 속도와 병렬 처리에 극도로 최적화되어 있다. 그래서 Node.js나 Python 기반이 아닌 Rust로 작성된 단일 바이너리 형태로 제공되며, 매우 빠르고 가볍게 동작한다.

설치하기

ChatGPT Plus, Pro, Business 계정이 있다면 공식 배포판을 바로 설치할 수 있다.

# macOS / Linux
curl -sSf https://codex.openai.com/install.sh | sh

계정 연동

설치 후 첫 명령어 codex login을 입력하여 OpenAI 계정과 연동한다.

codex login

이 과정에서 로컬 워크스페이스(코드 폴더)와 OpenAI 클라우드 환경이 연결되며, 언제든 모바일 ChatGPT 앱으로 작업 진행 상황을 알림으로 받을 수 있는 상태가 된다.

2. 자율성 레벨(Autonomy Levels) 설정

Codex CLI의 가장 중요한 개념은 에이전트의 "고삐"를 얼마나 풀어줄 것인가를 결정하는 자율성 레벨이다. 프로젝트 루트의 codex.toml (또는 실행 시 플래그)을 통해 설정한다.

1단계: Suggest (제안 모드)

동작: 코드를 직접 수정하지 않고, 터미널 화면에 Diff(변경 사항)만 출력한다.
용도: 위험한 변경이나, Codex의 의도를 100% 신뢰할 수 없는 낯선 태스크.

2단계: Auto-Edit (수정 모드)

동작: 로컬 파일 시스템을 직접 수정하지만, Git 커밋이나 외부 네트워크 요청(예: 빌드 배포) 전에는 멈춰서 사람의 승인을 기다린다.
용도: 일상적인 버그 수정이나 기능 추가.

3단계: Full-Auto (완전 자율 모드)

동작: 코드 수정 → 테스트 실행 → 실패 시 디버깅 → Git 커밋 → PR 생성까지 사람의 개입 없이 논스톱으로 진행한다.
용도: 믿을 수 있는 CI/CD 환경, 반복적인 보일러플레이트 작업, 명확한 JIRA 티켓 해결.

[!WARNING] Full-Auto의 전제 조건 Full-Auto 모드를 돌리려면 프로젝트에 탄탄한 테스트 스위트(Test Suite) 가 반드시 존재해야 한다. Codex는 "테스트 통과" 여부를 작업 완료의 기준으로 삼기 때문이다.

3. 핵심 명령어: /goal

Codex CLI를 관통하는 단 하나의 마법 주문은 /goal이다. 단순한 대화가 아니라, "명확한 목표를 부여하고 달성할 때까지 알아서 뛰어라"라는 선언이다.

> /goal "src/components 폴더에 있는 모든 클래스 컴포넌트를
         React 18 함수형 컴포넌트와 Hooks로 마이그레이션해.
         작업이 끝나면 'refactor-components' 브랜치로 PR을 생성해." --level=full-auto

이 명령을 입력하면 터미널에는 작업 프로그레스 바와 함께 현재 어떤 파일을 건드리고 있는지 실시간 로그만 간략하게 올라온다. 에이전트는 알아서 계획을 짜고, 수십 개의 파일을 고치고, 에러를 잡는다.

안전망: 로컬 샌드박스 (Sandbox)

"저렇게 멋대로 움직이게 뒀다가 내 컴퓨터를 포맷해버리면 어쩌지?" 이 걱정을 해결하기 위해 Codex CLI는 기본적으로 로컬 샌드박스(컨테이너 기반 격리) 환경에서 위험한 셸 명령어(ex. 패키지 설치, 스크립트 실행)를 실행한다.

시스템 코어나 워크스페이스 밖의 폴더에는 접근할 수 없도록 철저히 차단되므로, 안심하고 에이전트에게 셸 실행 권한을 줄 수 있다.

📝 정리

[x] Rust 기반의 속도: 가볍고 빠른 네이티브 바이너리로, 딜레이 없는 에이전트 구동이 가능하다.
[x] 자율성 컨트롤: 프로젝트 성격에 맞춰 제안(Suggest)부터 완전 자율(Full-Auto)까지 에이전트의 권한을 통제할 수 있다.
[x] /goal 지향적: "이거 해줘"가 아니라 "이 목표를 달성해"라고 던져두는 파이어 앤 포겟(Fire-and-forget) 방식에 특화되어 있다.
[x] 샌드박싱 보안: 에이전트의 무분별한 시스템 접근을 막아주는 안전망이 기본 탑재되어 있다.

Codex CLI의 기본을 세팅했다. 하지만 이 도구의 진짜 괴물 같은 면모는 '병렬 처리'와 '클라우드 샌드박스'에서 나온다. 이어지는 7편에서 Codex로 대규모 백로그를 한 번에 쓸어버리는 실전 자동화를 파헤쳐 보자.