▲

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

 (github.com/openai)
16P by GN⁺ 3일전 | ★ favorite | 댓글 1개
  • 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 라이선스임
▲
GN⁺ 3일전  [-]
Hacker News 의견

  • Codex o4-mini와 Claude Code를 비교하여 중간 규모 코드베이스의 문서화를 시도했음

    • Claude Code는 훌륭한 문서를 작성했음
    • Codex는 코드에 없는 내용을 상상하고 잘못된 아키텍처를 설명했음
    • Codex의 문제는 올바른 컨텍스트를 로딩하고 주의를 기울이는 데 어려움이 있는 것 같음
    • o3와 o4-mini 모델에 대한 기대가 높으며, 다른 테스트에서 더 나은 결과가 나오길 바람

  • gemini에 전체 또는 일부 저장소를 붙여넣고, 작성한 스크립트를 사용하여 코드에 변경 사항을 적용함

    • aider, copilot, continue 등을 시도했으나 각각의 단점이 있었음

  • Claude Code가 매우 훌륭하며, 다른 코딩 에이전트에 실망했던 경험이 있음

    • Claude Code를 사용하면서 긍정적인 결과를 얻었고, $15의 비용이 정당화될 수 있음
    • 경쟁이 좋은 결과를 가져오길 바람

  • 관련 데모 및 소개 비디오가 있으며, Claude Code에 대한 직접적인 답변임

    • 오픈 소스가 아니며, DMCA 관련 언급이 있음
    • Claude Code 인터뷰가 곧 공개될 예정이며, 코드 에이전트 CLI의 중요성을 다룸
    • Claude Code 및 OAI Codex의 파워 유저 사례를 모집 중임

  • Claude Code보다 현재는 성능이 떨어지지만, 오픈 소스이므로 빠르게 개선되길 바람

  • Codex는 Windows에서 직접 작동하지 않으며, WSL2가 필요함

    • Windows에서 네이티브 개발의 범위가 줄어드는 경향이 있음

  • Codex 사용 초기 경험이 좋지 않았음

    • 기본 모델이 작동하지 않으며, 모델을 변경해야 함
    • NodeJS 오류로 처음에 충돌했음
    • 초기 문제를 해결한 후 Claude Code와 비교 중임

  • OpenAI API 키를 환경 변수로 설정하는 방법이 있음

    • 다른 3rd party 유틸리티가 API 키에 접근할 수 있는 가능성에 대한 우려가 있음

  • Amazon Q 개발자 CLI에서 좋은 결과를 얻었으며, claude-3.7-sonnet을 사용한다고 믿음

답변달기