OpenAI Codex CLI - 터미널에서 실행되는 경량 코딩 에이전트

2 days ago 3

OpenAI Codex는 터미널에서 실행되는 경량 코딩 에이전트로, 개발자들이 터미널 환경에서 ChatGPT 수준의 추론과 코드 실행, 파일 조작, 버전 관리 기능을 활용할 수 있게 함
Codex는 설정이 필요 없으며, 네트워크 비활성화 및 디렉토리 샌드박스를 통해 안전하게 실행됨
멀티모달 기능을 지원하여 스크린샷이나 다이어그램을 통해 기능을 구현할 수 있음
Codex는 완전한 오픈 소스로, 개발자들이 직접 기여하고 발전시킬 수 있는 장점이 있음
다양한 운영 체제에서 실행 가능하며, macOS, Linux, Windows WSL2를 지원함

OpenAI Codex 소개

OpenAI Codex는 터미널에서 실행되는 경량 코딩 에이전트임
개발자들이 터미널 환경에서 ChatGPT 수준의 추론과 코드 실행, 파일 조작, 버전 관리 기능을 활용할 수 있음
설정이 필요 없으며, 네트워크 비활성화 및 디렉토리 샌드박스를 통해 안전하게 실행됨
멀티모달 기능을 지원하여 스크린샷이나 다이어그램을 통해 기능을 구현할 수 있음
완전한 오픈 소스로, 개발자들이 직접 기여하고 발전시킬 수 있음

Codex의 보안 모델 및 권한

Codex는 에이전트의 자율성을 결정할 수 있는 --approval-mode 플래그를 제공함
Suggest 모드에서는 파일 읽기만 가능하며, 모든 파일 쓰기/패치 및 쉘 명령은 승인 필요
Auto Edit 모드에서는 파일 읽기 및 패치 쓰기가 가능하며, 쉘 명령은 승인 필요
Full Auto 모드에서는 파일 읽기/쓰기 및 쉘 명령 실행이 가능하며, 네트워크 비활성화 및 현재 작업 디렉토리로 제한됨

플랫폼 샌드박싱 세부사항

macOS 12+ 에서는 Apple Seatbelt를 사용하여 명령어를 래핑함
Linux에서는 Docker를 사용하여 최소 컨테이너 이미지 내에서 Codex를 실행함
두 접근 방식 모두 일상적인 사용에 투명하게 작동함

시스템 요구 사항

운영 체제: macOS 12+, Ubuntu 20.04+/Debian 10+, Windows 11 (WSL2)
Node.js: 22 이상 (LTS 권장)
Git: 2.23+ (PR 도우미 기능을 위해 권장)
RAM: 최소 4GB (권장 8GB)

CLI 참조

codex: 대화형 REPL 실행
codex "…": 대화형 REPL의 초기 프롬프트
codex -q "…": 비대화형 "조용한 모드"
주요 플래그: --model/-m, --approval-mode/-a, --quiet/-q

메모리 및 프로젝트 문서

Codex는 Markdown 지침을 다음 순서로 병합함: ~/.codex/instructions.md, codex.md (저장소 루트), codex.md (현재 작업 디렉토리)
--no-project-doc 또는 CODEX_DISABLE_PROJECT_DOC=1로 비활성화 가능

비대화형 / CI 모드

Codex를 파이프라인에서 헤드리스로 실행 가능
CODEX_QUIET_MODE=1로 대화형 UI 소음을 제거 가능

레시피

codex "Refactor the Dashboard component to React Hooks": 클래스 컴포넌트를 리팩토링하고 테스트 실행
codex "Generate SQL migrations for adding a users table": ORM을 추론하고 마이그레이션 파일 생성 및 실행
codex "Write unit tests for utils/date.ts": 테스트 생성 및 실행
codex "Bulk‑rename *.jpeg → *.jpg with git mv": 파일 안전하게 이름 변경 및 사용 업데이트
codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$": 정규 표현식 설명
codex "Carefully review this repo, and propose 3 high impact well-scoped PRs": 영향력 있는 PR 제안
codex "Look for vulnerabilities and create a security review report": 보안 버그 찾기 및 설명

설치

npm을 통한 설치 (권장): npm install -g @openai/codex
소스에서 빌드: 저장소 클론 후 CLI 패키지로 이동하여 의존성 설치 및 빌드

구성

Codex는 ~/.codex/에서 구성 파일을 찾음
사용자 정의 지침 정의 가능: ~/.codex/instructions.md

FAQ

OpenAI는 2021년에 Codex라는 모델을 출시했으며, 이는 자연어 프롬프트에서 코드를 생성하는 AI 시스템임
Codex는 항상 샌드박스에서 실행되며, 의심스러운 명령이나 파일 변경 제안 시 n을 입력하여 작업 트리에 영향을 주지 않음
Windows에서는 직접 실행되지 않으며, Windows Subsystem for Linux (WSL2)가 필요함
지원되는 모델: Responses API를 통해 사용 가능한 모든 모델

기여

이 프로젝트는 활발히 개발 중이며, 코드가 상당히 변경될 가능성이 있음
기여를 환영하며, 신뢰성과 장기적인 유지보수를 중요시함
개발 워크플로우, 고품질 코드 변경 작성, PR 열기, 리뷰 프로세스, 커뮤니티 가치, 도움 받기 등의 가이드라인 제공

라이선스

이 저장소는 Apache-2.0 라이선스임

Read Entire Article