OpenAI Codex CLI 소개
OpenAI가 터미널에서 직접 실행되는 경량 코딩 에이전트 Codex CLI를 오픈소스로 공개했습니다. Codex CLI는 ‘채팅 기반 개발(chat-driven development)’이라는 콘셉트로 만들어진 도구로, ChatGPT 수준의 코드 이해력과 함께 실제 코드 실행, 파일 조작, 반복 작업까지 가능한 터미널 도구입니다. 자연어 프롬프트를 입력하면 그에 맞는 코드를 생성하고, 실제로 실행해보며 필요한 의존성을 설치하고 결과도 확인할 수 있는 것이 특징입니다. 특히, Git 저장소를 인식해서 변경사항을 안전하게 적용하고 관리할 수 있습니다.
Node.js와 OpenAI API 키만 있으면 바로 설치하여 시작할 수 있고, macOS, Linux, WSL2 기반 Windows까지 지원합니다. 또한, "전체 자동 모드(full-auto)"를 선택하면 프롬프트 하나만으로 코드 생성 → 실행 → 결과 확인 → Git 커밋까지 논스톱으로 처리할 수 있습니다.
Codex CLI는 일반적인 ChatGPT 사용과 가장 큰 차이를 보입니다. ChatGPT는 코드에 대한 설명이나 제안을 해줄 뿐이지만, Codex CLI는 실제 코드를 작성하고 실행, 수정까지 자동으로 진행합니다. GitHub Copilot과 비교하면, Copilot은 코드 작성 보조에 초점이 맞춰져 있다면 Codex CLI는 전체 워크플로우를 자연어로 제어할 수 있는 느낌입니다.
또한 비슷한 도구인 Continue, Cursor, Smol Developer 같은 에이전트 기반 개발 도구들과 비교해도 Codex CLI는 터미널 중심, CLI 친화적이라는 점에서 독특한 포지셔닝을 갖고 있습니다.
OpenAI Codex CLI의 주요 특징
- 프롬프트 기반 코드 생성:
"todo 앱 만들어줘"같은 자연어 명령을 통해 실제 프로젝트 구조를 생성 - 파일 및 명령어 실행 지원: 파일을 읽고 수정하며, 필요시 쉘 명령어도 실행 가능
- 보안 샌드박스 환경 제공: 네트워크 차단 및 디렉터리 제한으로 안전한 실행
- 멀티모달 지원: 스크린샷이나 다이어그램을 입력으로 받아 기능 구현 가능 (곧 지원 예정)
- 완전 자동화 옵션:
--approval-mode full-auto를 통해 사용자 승인 없이 전체 프로세스 자동 실행 - Git 통합: Git 저장소 내에서 변경사항 추적 및 커밋 처리
- CI/CD에서 사용 가능: GitHub Actions 등에서도 비대화식 모드로 사용 가능
사용 방법
설치
# 패키지 설치
npm install -g @openai/codex
# OpenAI API Key 설정
export OPENAI_API_KEY="your-api-key-here"
사용 예시
codex "이 코드베이스 설명해줘"
codex --approval-mode full-auto "가장 화려한 todo 리스트 앱 만들어줘"
Codex는 입력된 프롬프트에 따라 필요한 파일을 만들고, 의존성을 설치한 후, 샌드박스 환경에서 실행까지 해줍니다. 결과가 괜찮다면 승인하여 작업 디렉터리에 적용할 수 있습니다.
실행 모드
- Suggest (기본): 읽기 전용, 파일 수정이나 쉘 명령은 사용자 승인 필요
- Auto Edit: 파일 수정은 자동, 쉘 명령은 승인 필요
- Full Auto: 파일 수정 및 쉘 명령 자동 실행 (단, 네트워크 차단 및 디렉터리 제한 환경에서)
macOS에서는 sandbox-exec, Linux에서는 Docker 기반 샌드박스를 통해 보안성을 확보합니다.
라이선스
OpenAI의 Codex CLI 프로젝트는 Apache-2.0 License로 공개 및 배포되고 있습니다.
Codex CLI GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 