수록 현황:264 건의 뉴스/100 개의 AI 도구/374 개의 오픈소스 프로젝트/64 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / codex

codex

Codex는 구성 가능한 샌드박싱 및 승인 컨트롤을 통해 프로젝트의 코드를 읽고, 편집하고, 실행하는 OpenAI의 오픈소스 터미널 코딩 에이전트입니다.

RustApache-2.0Agent
⭐ GitHubhttps://github.com/openai/codex
102,186
스타 수
+0
스타 증가율
2026년 7월 29일
최근 업데이트
7
클릭 수

1. 프로젝트 개요

Codex는 터미널에서 로컬로 실행되는 OpenAI의 오픈소스 코딩 에이전트로, 개발자가 코드베이스를 읽고 파일을 편집하며 샌드박스 내에서 명령어를 실행하고 커맨드 라인에서 벗어나지 않고도 변경 사항을 반복할 수 있는 AI와 대화할 수 있게 해줍니다.

2. 배경 및 포지셔닝

Codex는 클라우드 IDE나 채팅 창에 제한하는 대신, OpenAI의 에이전트형 코딩 기능을 개발자의 로컬 머신에 직접 가져오기 위해 구축되었습니다. 핵심 임무는 미숙련한 코드 읽기, 패치 초안 작성, 테스트 실행, 실패 디버깅 등 실제 엔지니어링 작업을 인간 개발자가 사용하는 것과 동일한 터미널과 파일 시스템으로 작동하는 AI 에이전트에 위임할 수 있도록, 빠르고 스크립트 가능하며 프라이버시를 존중하는 방법을 제공하는 것입니다.

다른 AI 코딩 어시스턴트와 비교했을 때, Codex는 세 가지 방식으로 차별화됩니다:

  • 로컬 우선 실행: 에이전트는 세션마다 호스팅 컨테이너를 요구하는 대신, 개발자 머신에서 경량 바이너리 형태로 실행됩니다(원래 TypeScript로 작성되었으나 성능과 안정성을 위해 현재 Rust로 재작성됨).
  • 구성 가능한 샌드박싱 및 승인: 에이전트가 실행하려는 모든 명령은 명시적인 샌드박스 및 승인 정책을 거치므로, 사용자는 '모든 작업 전 확인'부터 '완전 자율 실행'까지 자율성과 감독 사이의 균형을 자유롭게 조절할 수 있습니다.
  • 다양한 진입점, 하나의 에이전트: 동일한 Codex 엔진은 터미널 CLI, IDE 확장 프로그램(VS Code, Cursor, Windsurf), 데스크톱 앱으로 제공되므로 팀이 단일 워크플로우에 묶이지 않습니다.

3. 기능 카테고리

🖥️ 터미널 에이전트 — 핵심 인터랙티브 경험

  • codex — 현재 저장소에서 인터랙티브 세션 시작
  • codex exec "<프롬프트>" — 일회성 비인터랙티브 작업 실행(스크립트/CI에서 유용)
  • 작업 디렉토리의 전체 컨텍스트를 반영한 다중 턴 대화
  • 인라인 diff 및 명령어 출력을 터미널에 직접 스트리밍
  • 목적: 개발자가 셸을 벗어나지 않고도 실제 코드 변경을 주도할 수 있도록 지원

🛡️ 샌드박싱 및 승인 — 안전 제어

  • 읽기 전용 모드: 에이전트가 파일을 검사할 수는 있지만 수정하거나 임의 명령을 실행하지는 않음
  • 워크스페이스 쓰기 / 자동 모드: 에이전트가 프로젝트 디렉토리 내에서만 파일 편집 및 명령 실행 가능
  • 완전 자동 모드: 샌드박스 내에서 매 명령 확인 없이 다단계 계획 실행
  • 플랫폼 네이티브 샌드박싱(macOS Seatbelt, Linux 컨테이너/네임스페이스 등)을 통한 파일시스템 및 네트워크 접근 제한
  • 목적: 사용자가 에이전트에 부여할 자율성의 정확한 수준을 선택할 수 있도록 함

🔌 통합 — Codex를 프로젝트 및 도구와 연결

  • AGENTS.md — 에이전트가 따라야 할 관행, 명령어, 컨텍스트를 설명하는 프로젝트 레벨 파일
  • 외부 도구를 통해 에이전트를 확장하기 위한 MCP(Model Context Protocol) 서버 지원
  • 재사용 가능하고 프로젝트 특화된 에이전트 기능을 위한 .codex/skills 하위 저장소
  • VS Code, Cursor, Windsurf용 IDE 확장 프로그램
  • 목적: Codex가 프로젝트별 규칙을 인식하고 사용자 정의 도구로 확장될 수 있도록 함

☁️ 멀티 에이전트 오케스트레이션 — 대규모 작업 조정

  • 여러 Codex 인스턴스 간 작업 분해
  • 에이전트 간 통신 및 공유 컨텍스트
  • 여러 에이전트가 중복된 코드를 수정할 때 충돌 해결
  • 목적: 에이전트를 단일 파일 편집에서 대규모 다부문 프로젝트 조정에 이르기까지 확장

⚙️ 엔터프라이즈 및 자동화 — 인간 터미널 외부에서 Codex 실행

  • 에이전트 프롬프트를 가로채거나 감사하거나 보완하기 위한 훅 시스템(예: 사용자 프롬프트 훅)
  • CI/자동화 친화적 비인터랙티브 모드
  • 공유 정책이 있는 팀을 위한 구성 프로필
  • 목적: 조직이 파이프라인에 Codex를 내장하고 거버넌스를 적용할 수 있도록 함

4. 주요 특징

  • Rust 기반 재작성: CLI 실행 엔진(codex-rs)은 Rust로 구현되어 빠른 시작 속도, 낮은 메모리 사용량, 장기 실행 에이전트 세션의 안정성을 최우선으로 합니다.
  • 구성 가능한 자율성: 샌드박스 및 승인 설정은 엄격한 읽기 전용부터 완전 자율 실행까지 다양하여, 신중한 초기 사용부터 방치형 자동화까지 동일한 도구가 모두 적합합니다.
  • 유연한 인증: 기존 ChatGPT Plus, Pro, Business, Edu 또는 Enterprise 플랜으로 로그인하거나 API 키로 인증하면 되며, 대부분의 사용자에게 별도 계정 생성이 필요 없습니다.
  • AGENTS.md를 통한 프로젝트 인식 컨텍스트: 팀이 AGENTS.md에 관행을 한 번 문서화하면 에이전트가 세션 전반에 걸쳐 일관되게 따릅니다.
  • MCP를 통한 확장성: Model Context Protocol을 통해 Codex는 로컬 파일시스템과 셸 외에도 외부 도구 및 데이터 소스에 연결할 수 있습니다.
  • 다양한 인터페이스, 하나의 엔진: 동일한 에이전트가 터미널 CLI, IDE 확장 프로그램, 데스크톱 앱으로 제공되므로 팀이 이미 사용하는 어떤 워크플로우에도 자연스럽게 통합됩니다.

5. 역할별 사용 사례

일반 개발자 — 미지의 코드베이스 탐색, 버그 수정 초안 작성, 테스트 생성, 새 기능 스케폴딩 등을 터미널에서 직접 수행하며, 변경 사항이 적용되기 전에 diff를 검토할 수 있습니다.

DevOps / SRE — CI 파이프라인이나 스크립트 내에서 비인터랙티브(codex exec) 모드로 Codex를 실행하여 승인 정책에 따라 정기 유지보수 작업, 설정 업데이트, 로그 기반 트리아지를 자동화합니다.

프로젝트 매니저 — 코드베이스 구조나 최근 변경 사항에 대한 요약을 빠르게 생성하여, 원본 diff를 읽지 않고도 기술적 진전을 이해하는 장벽을 낮춥니다.

6. 시작하기

필요한 항목 찾기

  • 저장소 및 문서 탐색: github.com/openai/codex
  • 새로운 이슈를 제기하기 전에 기존 이슈 및 토론 검색

설치 / 통합

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm 설치
npm install -g @openai/codex

# Homebrew 설치
brew install --cask codex

# 프로젝트에서 세션 시작
codex

기여하기

git clone https://github.com/openai/codex.git
cd codex/codex-rs
cargo build

코딩 표준 및 풀 리퀘스트 프로세스는 저장소의 기여 가이드를 참조하세요.

7. 프로젝트 구조

codex/
├── codex-cli/    # CLI 래퍼 및 npm 패키징
├── codex-rs/     # 에이전트 엔진의 Rust 구현
├── sdk/          # 다른 도구에 Codex 내장을 위한 SDK
├── docs/         # 사용자 및 개발자 문서
└── tools/        # 유틸리티 및 릴리스 스크립트
  • codex-rs/에는 핵심 에이전트 루프, 샌드박싱 로직, 모델 상호작용 코드가 포함되어 있으며, 대부분의 엔지니어링 기여가 이곳에 이루어집니다.
  • codex-cli/는 npm을 통해 배포할 수 있도록 컴파일된 바이너리를 패키징합니다.
  • docs/에는 이 문서 전반에서 참조되는 구성, 샌드박싱, 사용 가이드가 포함되어 있습니다.

8. 관련 생태계

  • ChatGPT 플랜(Plus, Pro, Business, Edu, Enterprise) — 별도의 API 키 없이 Codex의 인증 및 사용 권한을 제공합니다.
  • OpenAI API — 키 기반 과금을 선호하는 사용자를 위한 대체 인증 경로입니다.
  • Model Context Protocol(MCP) — Codex가 외부 도구 및 데이터 소스에 연결하는 데 사용하는 오픈 프로토콜입니다.
  • IDE 통합 — 동일한 에이전트를 에디터 내부에 내장하는 VS Code, Cursor, Windsurf 확장 프로그램입니다.

9. 라이선스

Codex는 Apache-2.0 라이선스에 따라 출시됩니다.

  • ✅ 상업적 목적을 포함한 사용, 수정, 재배포가 무료
  • ✅ 프로젝트의 기여를 포함하는 특허권 부여 포함
  • ❌ 보증 없음; 사용은 본인의 책임 하에 이루어짐
  • ℹ️ 수정된 버전은 원래 라이선스 및 저작권 고지를 유지해야 하며, 주요 변경 사항을 명시해야 함

10. FAQ

Q: Codex 사용에 API 키가 필요한가요?
A: 아닙니다. 기존 ChatGPT Plus, Pro, Business, Edu 또는 Enterprise 플랜으로 로그인하거나, 원하시면 API 키를 사용할 수 있습니다.

Q: Codex가 제 파일에 묻지도 않고 수정하나요?
A: 사용자가 구성하지 않는 한 그렇지 않습니다. 샌드박스 및 승인 설정은 읽기 전용부터 완전 자동까지 다양하므로, 에이전트의 자율성 범위를 사용자가 직접 제어합니다.

Q: 어떤 플랫폼을 지원하나요?
A: 사전 빌드된 바이너리, npm, Homebrew를 통해 macOS, Linux, Windows를 지원합니다.

Q: 스크립트나 CI 파이프라인에서 Codex를 어떻게 실행하나요?
A: 비인터랙티브 명령어를 사용하세요. 예: codex exec "run the test suite and summarize failures".

Q: Codex는 프로젝트의 관행을 어떻게 학습하나요?
A: 저장소에 명령어, 스타일, 컨텍스트를 설명하는 AGENTS.md 파일을 추가하면, Codex가 매 세션마다 자동으로 읽어옵니다.

11. 빠른 링크

12. 요약

Codex는 구성 가능한 샌드박싱을 통해 팀이 에이전트에 부여할 자율성의 정확한 수준을 선택할 수 있도록, OpenAI의 코딩 에이전트를 모든 개발자의 터미널, IDE, CI 파이프라인으로 가져옵니다. 기존 커맨드라인 워크플로우를 벗어나지 않고 AI 보조 코딩을 원하는 개발자와 명확하고 감사 가능한 안전 제어 하에 일상적인 엔지니어링 작업을 자동화해야 하는 팀에 매우 적합합니다.