OpenAI Codex CLI를 설치하고 실제 개발 작업에 쓰기 위해 알아야 할 내용을 한국어로 정리한 문서 저장소입니다.
기준일: 2026-05-26
기준 출처: OpenAI 공식 Codex 문서, openai/codex GitHub 최신 릴리스
| 문서 | 내용 |
|---|---|
| 01-installation.md | 설치 및 인증 |
| 02-basic-usage.md | 기본 사용법 |
| 03-slash-commands.md | 슬래시 커맨드 목록 |
| 04-agents-md.md | AGENTS.md 작성 가이드 |
| 05-config.md | config.toml 레퍼런스 |
| 06-approval-sandbox.md | 승인 모드 & 샌드박스 |
| 07-mcp-integration.md | MCP 연동 |
| 08-tips-and-tricks.md | 실전 팁 & 단축키 |
| 09-sample-workflows.md | 예제 워크플로 |
- OpenAI Codex CLI 완전 정리 가이드
- 추론 수준(Reasoning Effort)
- PLANS.md를 사용하여 몇 시간씩 걸리는 문제 해결
- 스킬과 서브에이전트
- Codex CLI Subagent:
docs_researcher,reviewer,worker완벽 가이드 - MCP
npm i -g @openai/codex
codexWindows에서 PowerShell 실행 정책 때문에 codex.ps1이 막히면 다음처럼 실행합니다.
codex.cmdCodex CLI 환경에서 Claude Code의 Auto mode처럼 자꾸 뜨는 권한 확인 창을 없애고 스스로 알아서 파일 수정 및 명령어 실행을 완료하게 만드는 방법은 3가지가 있습니다.
단일 세션을 열 때 아래의 플래그를 붙여 실행하면 Claude Code의 Auto mode 및 완벽한 자율 모드로 구동됩니다. [1, 2]
- Claude Code의 Auto mode와 가장 유사한 수준 (동일 워크스페이스 내 자율 작업) 작업 디렉토리 내부의 파일 수정 및 명령어는 승인 없이 실행하되, 외부 파일 접근이나 네트워크 요청이 있을 때만 최소한으로 물어봅니다.
codex --approval-mode full-auto
- 권한 요청을 완전히 끄는 모드 (YOLO 모드)
샌드박스 제한을 풀고 시스템 전체 접근 및 네트워크, 모든 명령어 실행 권한을 묻지 않고 100% 자동 승인합니다.
codex --yolo
매번 플래그를 입력하지 않고, codex를 실행할 때마다 항상 자동 승인 모드로 켜지게 만들 수 있습니다.
- 사용자 홈 디렉토리의 설정 파일인 ~/.codex/config.toml 파일을 엽니다 (없다면 생성).
- 아래와 같이 기본 승인 모드를 추가하고 저장합니다.
# 기본 승인 정책을 무조건 자동 실행으로 설정
approval_mode = "full-auto"
# 또는 완전히 승인을 패스하려면 아래 설정을 사용 (YOLO 모드와 동일)# approval_policy = "never"
이미 대화형 터미널 UI(TUI)를 실행 중인 상태라면, 대화창 입력란에 슬래시 명령어를 입력하여 즉시 모드를 전환할 수 있습니다.
- 입력창에 /permissions를 입력합니다.
- 화면에 뜨는 모드 브라우저 중에서 Full Access 또는 Auto 모드를 선택해 주시면 그 순간부터 팝업 없이 작업을 이어갑니다.