
OpenAI Codex CLI
OpenAI Codex CLI는 터미널에서 실행되는 경량 오픈 소스 코딩 에이전트로, 개발자가 자연어를 코드 실행으로 변환하고 코드 실행, 파일 조작, 버전 제어 하에서 반복 작업을 수행할 수 있는 ChatGPT 수준의 추론 기능을 제공합니다.
https://github.com/openai/codex?ref=aipure&utm_source=aipure

제품 정보
업데이트됨:May 9, 2025
OpenAI Codex CLI이란?
OpenAI Codex CLI는 주로 터미널 환경에서 작업하는 개발자를 위해 설계된 실험적인 명령줄 도구입니다. OpenAI에서 출시했으며, 개발자의 로컬 워크플로우에 직접 통합되는 AI 페어 프로그래머 역할을 합니다. 이전 버전(2023년 3월에 지원이 중단된 2021년의 원래 Codex 모델)과 달리, 이 새로운 CLI 도구는 샌드박스 환경을 통해 보안을 유지하면서 실용적인 코딩 지원을 제공하는 데 중점을 둡니다. 이 도구를 시작하는 데는 OpenAI API 키만 있으면 되며, o3 및 o4-mini를 포함한 다양한 OpenAI 모델과 함께 작동할 수 있습니다.
OpenAI Codex CLI의 주요 기능
OpenAI Codex CLI는 터미널에서 직접 실행되는 경량 오픈 소스 코딩 에이전트로서, ChatGPT 수준의 추론 능력과 코드 실행, 파일 조작, 버전 관리 하에서의 반복 작업을 결합합니다. 개발자가 자연어 명령을 통해 코드와 상호 작용할 수 있도록 지원하며, 스크린샷 및 다이어그램을 포함한 멀티모달 입력을 지원하고, 구성 가능한 자동화 수준을 갖춘 안전한 샌드박스 환경에서 실행됩니다.
안전한 샌드박스 실행: 다양한 수준의 자동화를 위해 세 가지 구성 가능한 승인 모드(제안, 자동 편집, 완전 자동)를 통해 네트워크 비활성화 및 디렉터리 샌드박스 환경에서 명령을 실행합니다.
멀티모달 입력 지원: 기능을 구현하고 코드를 이해하기 위해 텍스트 명령, 스크린샷 및 다이어그램을 포함한 다양한 입력 형식을 허용합니다.
버전 관리 통합: 변경 사항 추적, 커밋 생성 및 내장된 PR 도우미를 사용하여 코드 수정 관리를 위해 Git과 원활하게 통합됩니다.
프로젝트 메모리 및 문서화: 전역 및 프로젝트별 지침 파일을 통해 컨텍스트를 유지하여 다양한 프로젝트에서 사용자 정의된 동작을 허용합니다.
OpenAI Codex CLI의 사용 사례
코드 리팩토링: 기능을 유지하고 테스트를 실행하면서 클래스 컴포넌트를 React Hooks로 변환하는 등 코드 컴포넌트를 자동으로 리팩토링합니다.
테스트 생성: 기존 코드에 대한 단위 테스트를 생성하고 실행하여 모든 테스트가 성공적으로 통과할 때까지 반복합니다.
보안 검토: 코드베이스에서 취약점을 분석하고 자세한 보안 검토 보고서를 생성합니다.
데이터베이스 마이그레이션: 원하는 변경 사항에 대한 자연어 설명을 기반으로 SQL 마이그레이션을 생성하고 실행합니다.
장점
OpenAI API 키만으로 즉시 작동하며 설정이 필요 없음
활발한 커뮤니티 개발이 이루어지는 완전한 오픈 소스
샌드박스 실행을 통한 강력한 보안 모델
다양한 수준의 자동화를 위한 유연한 승인 모드
단점
잠재적인 버그가 있는 개발 중인 실험적인 기술
Windows에서 직접 지원되지 않음(WSL2 필요)
ZDR(Zero Data Retention)이 활성화된 조직은 지원하지 않음
Node.js 22 이상 필요
OpenAI Codex CLI 사용 방법
Codex CLI를 전역적으로 설치: 터미널에서 'npm install -g @openai/codex'를 실행하여 패키지를 전역적으로 설치합니다.
OpenAI API 키 설정: 'export OPENAI_API_KEY=\"your-api-key-here\"'를 실행하여 OpenAI API 키를 환경 변수로 내보냅니다. 영구적으로 설정하려면 이 줄을 셸 구성 파일(예: ~/.zshrc)에 추가합니다.
기본 사용법 - 대화형 모드: 터미널에 'codex'를 입력하여 Codex와 대화할 수 있는 대화형 REPL 모드를 시작합니다.
기본 사용법 - 직접 프롬프트: 'codex \"여기에 프롬프트 입력\"'을 실행하여 Codex에 특정 작업을 지정합니다. 예를 들어 'codex \"이 코드베이스를 설명해줘\"'와 같이 입력할 수 있습니다.
승인 모드 구성: --approval-mode 플래그를 사용하여 Codex의 자율성을 설정합니다. 'suggest'(기본값, 모든 변경 사항에 대한 승인 필요), 'auto-edit'(파일을 편집할 수 있지만 명령에 대한 승인 필요) 또는 'full-auto'(명령을 실행하고 파일을 편집할 수 있음) 중 하나를 선택할 수 있습니다.
사용자 정의 지침 설정: Codex가 어떻게 작동해야 하는지에 대한 개인적인 글로벌 지침을 추가하려면 ~/.codex/instructions.md 파일을 만듭니다.
프로젝트별 설정: 프로젝트 루트 디렉토리에 codex.md를 만들어 다른 개발자와 공유할 프로젝트별 지침을 추가합니다.
비대화형 모드로 실행: CI/CD 파이프라인 또는 자동화된 스크립트의 경우 -q 또는 --quiet 플래그를 사용합니다. 예: 'codex -q \"작업 내용\"'
AI 모델 변경: --model 플래그를 사용하거나 구성에서 설정하여 AI 모델을 변경합니다. 예: 'codex --model o4-mini \"프롬프트 내용\"'
도움말 얻기: 'codex --help'를 실행하여 사용 가능한 모든 명령 및 옵션을 확인합니다.
OpenAI Codex CLI 자주 묻는 질문
Codex CLI는 터미널에서 실행되는 경량 코딩 에이전트입니다. ChatGPT 수준의 추론과 코드 실행, 파일 조작, 반복 작업을 버전 관리 하에 수행하려는 개발자를 위해 제작되었습니다. 기본적으로 저장소를 이해하고 실행하는 채팅 기반 개발입니다.