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

> Clean Markdown view of GeekNews topic #20374. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=20374](https://news.hada.io/topic?id=20374)
- GeekNews Markdown: [https://news.hada.io/topic/20374.md](https://news.hada.io/topic/20374.md)
- Type: GN+
- Author: [neo](https://news.hada.io/@neo)
- Published: 2025-04-17T09:55:53+09:00
- Updated: 2025-04-17T09:55:53+09:00
- Original source: [github.com/openai](https://github.com/openai/codex)
- Points: 17
- Comments: 1

## Summary

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

## Topic Body

- 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 라이선스임

## Comments



### Comment 37262

- Author: neo
- Created: 2025-04-17T09:55:53+09:00
- Points: 1

###### [Hacker News 의견](https://news.ycombinator.com/item?id=43708025) 
* 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을 사용한다고 믿음