OpenAI Codex CLI, 터미널에서 쓰는 코딩 에이전트 도구

왜 중요한가

• 실제 업무에서는 모델 자체보다 어떤 작업 환경과 안전 장치 위에서 돌릴 수 있는지가 더 중요하다.
• Codex CLI는 sandbox, approval, MCP, cloud task, review, resume/fork까지 갖춰 단순 데모를 넘어선 사용 환경을 보여준다.
• 대화형 사용과 자동 실행을 함께 지원해 사람이 옆에서 쓰는 흐름과 반복 작업 자동화 모두에 연결된다.

핵심 관찰

• 공개 저장소와 공식 문서를 함께 확인해 전체 구조를 살폈다.
• README 기준 설치 경로는 npm i -g @openai/codex 또는 brew install --cask codex였다.
• npm view @openai/codex 기준 최신 버전은 0.121.0, 실행 bin은 codex였다.
• npx @openai/codex --help를 직접 실행했더니 exec, review, login, mcp, mcp-server, app-server, sandbox, resume, fork, cloud, features 같은 하위 명령이 실제로 노출됐다.
• 전역 옵션에도 --sandbox, --ask-for-approval, --full-auto, --search, --oss, --local-provider, --remote 등이 있었다.
• npx @openai/codex exec --help까지 확인해보니 비대화형 실행에서도 --json, --output-schema, --ephemeral, --skip-git-repo-check, --output-last-message처럼 자동화에 맞는 옵션이 준비돼 있었다.
• docs/install.md 기준 공식 시스템 요구사항은 Windows 11도 WSL2를 전제로 적고 있었다.
• repo 구조도 codex-cli, codex-rs, sdk 등으로 나뉘어 있어 단일 스크립트보다 제품형 CLI 스택에 가깝다.
• 실제 agent run은 로그인/API 키 없이 진행하지 않았고, help와 설치 표면, 실행 옵션까지만 검증했다.

해석

OpenAI Codex CLI는 대화형 화면과 비대화형 실행을 함께 제공해, 터미널에서 코딩 작업을 돕는 도구로 설계된 모습이다.

누구에게 도움이 되나

• 개발팀: 로컬 코드베이스 작업용 coding agent CLI
• 플랫폼팀: 비대화형 agent 실행을 CI나 스크립트에 연결하는 실험
• 파워유저: interactive TUI와 batch exec를 함께 쓰는 개인 개발 흐름

어디에 바로 써볼 수 있나

• coding agent CLI가 sandbox, approval, MCP, cloud task를 어떻게 한 표면에 묶는지 분석
• 반복 작업은 exec 모드로 자동화하고 수동 작업은 TUI로 수행하는 혼합형 흐름 실험
• approval policy, session resume/fork, MCP server 표면 설계 참고
• 로컬 코드베이스 작업용 coding agent CLI
• 비대화형 agent 실행을 CI나 스크립트에 연결하는 실험
• interactive TUI와 batch exec를 함께 쓰는 개인 개발 흐름

주요 출처

• repo
• README
• docs
• npm

공식 repo / docs

• repo
• README
• docs

주의점

• Windows 지원은 언급되지만 공식 문서는 WSL2를 전제로 설명한다.
• 실제 활용도는 로그인, provider 설정, sandbox 정책까지 갖춰야 제대로 드러난다.
• 실행 권한이 강한 만큼 승인 정책과 외부 샌드박스 구성이 중요하다.
• 가볍게 체험하는 도구라기보다 실제 작업에 투입할 수 있는 도구에 가깝고, 그에 맞는 운영 습관이 필요하다.

다음에 볼 포인트

• 세션 메모리와 장기 메모리의 구분이 제품 기본값으로 더 분명해지는지 지켜볼 필요가 있다.
• skills, orchestration, writable memory를 어떤 정책 경계로 나누는지 계속 비교해볼 만하다.