Codex CLI: OpenAI의 로컬 코딩 AI 에이전트
Codex CLI란 무엇인가요?
Codex CLI는 Openai가 출시한 경량 명령줄 도구로, 터미널 사용자에게 ChatGPT와 유사한 추론 능력을 제공하며, 실제로 코드를 실행하고 파일을 조작하며 반복 작업을 수행할 수 있고, 모든 작업은 버전 관리하에서 완료됩니다. 멀티모달 입력을 지원하여 사용자가 자연어 명령을 통해 코드 생성, 편집 및 실행 등의 작업을 수행할 수 있습니다.

Codex CLI 주요 기능
코드 생성 및 편집: 사용자는 간단한 영어 명령으로 Codex CLI가 코드를 생성하도록 할 수 있습니다. 예를 들어 "CSV 파일을 읽고 특정 열의 평균값을 출력하는 Python 스크립트를 생성해 줘"와 같은 명령이 가능합니다.
파일 관리: "모든 .txt 파일을 notes라는 폴더로 이동해 줘"와 같은 파일 작업 실행을 지원합니다.
디버깅 지원: 사용자가 오류 메시지를 붙여넣으면 Codex CLI가 수정 제안을 제공합니다.
프로젝트 구축: "기본적인 Node.js 서버를 구축해 줘"와 같이 프로젝트 템플릿을 빠르게 생성할 수 있습니다.
멀티모달 지원: 스크린샷이나 차트 입력을 통한 기능 구현을 지원합니다.
로컬 실행: Codex CLI는 로컬에서 실행되며, 모든 파일 읽기, 쓰기 및 명령 실행은 로컬에서 완료됩니다. 사용자가主动적으로 공유를 선택하지 않는 한 소스 코드는 로컬 환경을 떠나지 않습니다.
Codex CLI 특징
오픈소스 및 무료: Codex CLI는 완전한 오픈소스이며, 사용자는 자유롭게 코드를 확인하고 수정하며 개발에 기여할 수 있습니다.
로컬 실행: 이 도구는 로컬 터미널에서 실행되어 코드 실행 및 파일 작업이 사용자 시스템 내에서 완료되도록 보장하여 데이터 프라이버시를 보호합니다.
모델 비의존성: 기본적으로 OpenAI의 GPT-4-turbo 모델을 사용하지만, 사용자는 o3 및 o4-mini와 같은 다른 호환 가능한 API 엔드포인트로 전환할 수 있습니다.
유연한 구성: .codex YAML 파일을 통해 구성되며, 사용자 정의 변수 및 템플릿을 지원합니다.
보안 모델 및 권한
Codex CLI는 세 가지 승인 모드를 제공하며, 사용자는 --approval-mode 매개변수를 통해 선택할 수 있습니다:
제안 모드(기본값): 리포지토리의 모든 파일을 읽을 수 있지만, 모든 파일 쓰기 및 Shell 명령에 대해 사용자 승인이 필요합니다.
자동 편집 모드: 파일을 읽고 패치를 적용하여 쓸 수 있지만, 모든 Shell 명령에 대해 사용자 승인이 필요합니다.
완전 자동 모드: 사용자 승인 없이 파일을 읽고 쓸 수 있으며 Shell 명령을 실행할 수 있습니다.
Codex CLI 사용 시나리오
Codex CLI는 주로 터미널 환경에서 작업하는 개발자를 대상으로 하며, 일상적인 개발 작업을 보다 효율적으로 완료할 수 있도록 도와줍니다. 이는 완전히 자동화된 코딩 어시스턴트가 아니라,常规 작업을 지원하고 가속화하는 데 사용됩니다.
Codex CLI 설치 방법
npm을 통한 설치(권장):
npm install -g @openai/codex
소스 코드에서 빌드:
리포지토리를 클론하고 CLI 패키지 디렉토리로 이동합니다:
git clone https://github.com/openai/codex.git cd codex/codex-cli
종속성을 설치하고 빌드합니다:
npm install npm run build
로컬에서 빌드된 CLI를 실행하거나 npm link를 통해 전역적으로 링크합니다.
구성
Codex CLI는 ~/.codex/ 디렉토리에서 구성 파일을 찾습니다:
config.yaml: 기본 모델 등 구성 항목을 설정할 수 있습니다.
instructions.md: 사용자 정의 명령을 정의할 수 있습니다.
사용
대화형 실행:
codex
특정 명령 실행:
codex "explain this codebase to me"
완전 자동 모드:
codex --approval-mode full-auto "create the fanciest todo-list app"
비대화형 모드 / CI 모드
CI/CD 파이프라인에서 Codex CLI를 헤드리스 모드로 실행할 수 있습니다. 예시:
- name: Update changelog via Codex
run: |
npm install -g @openai/codex
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
codex -a auto-edit --quiet "update CHANGELOG for next release"github 주소:https://github.com/openai/codex
자세한 내용:https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started
대본 기획 도우미▸
AI 앱
AI 뉴스 