From dc4aceeec4b50af2c280bb22c1870690c8e741a4 Mon Sep 17 00:00:00 2001
From: Jerry Chae <mcchae@JMBA15.local>
Date: Tue, 2 Jun 2026 11:35:41 +0900
Subject: [PATCH] =?UTF-8?q?codex=20cli=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md             | 36 +++++++++++++++++++++-
 install-codex-cli.ps1 | 71 +++++++++++++++++++++++++++++++++++++++++++
 install-codex-cli.sh  | 44 +++++++++++++++++++++++++++
 3 files changed, 150 insertions(+), 1 deletion(-)
 create mode 100644 install-codex-cli.ps1
 create mode 100644 install-codex-cli.sh

diff --git a/README.md b/README.md
index 58a1c05..034fcec 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@
 ### 🤖 4. AI 개발 에이전트 (AI Agents)
 * **[Antigravity CLI (agy)](https://antigravity.google)** - Antigravity 2.0 플랫폼의 경량화 터미널 코딩 에이전트 CLI
 * **[Claude Code](https://code.claude.com/)** - Anthropic의 차세대 터미널 기반 대화형 AI 코딩 어시스턴트 CLI
+* **[Codex CLI](https://developers.openai.com/codex/cli)** - OpenAI의 공식 터미널 기반 로컬 대화형 코딩 에이전트 CLI
 * **[pi](https://pi.dev/)** - 대화형 CLI AI 코딩 어시스턴트 및 추천 플러그인 패키지 일괄 설치 도구
 
 ---
@@ -106,6 +107,11 @@
   curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash
   ```
 
+* **Codex CLI:**
+  ```bash
+  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash
+  ```
+
 * **pi (Pi Coding Agent + 추천 패키지):**
   ```bash
   curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
@@ -242,6 +248,16 @@
     $t="$env:TEMP\install-claude-code.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
     ```
 
+* **Codex CLI:**
+  * **CMD 창에서 설치 시:**
+    ```cmd
+    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-codex-cli.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.ps1' -OutFile $t; & $t"
+    ```
+  * **파워쉘 창에서 설치 시:**
+    ```powershell
+    $t="$env:TEMP\install-codex-cli.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
+    ```
+
 * **pi (Pi Coding Agent + 추천 패키지):**
   * **CMD 창에서 설치 시:**
     ```cmd
@@ -498,7 +514,25 @@ claude -p "질문/작업"   # 터미널 창을 열지 않고 즉시 지시 수
 claude --help           # 도움말 및 사용법 로드
 ```
 
-#### 4.3. Pi Coding Agent
+#### 4.3. Codex CLI
+OpenAI사에서 개발한 공식 터미널 기반 대화형 로컬 코딩 에이전트 CLI입니다. Rust 기반으로 제작되어 높은 성능을 자랑하며, npm 없이도 단일 실행(curl) 및 PowerShell(Windows) 공식 인스톨러 방식을 활용해 네이티브하게 작동 가능합니다.
+
+* **강력한 시스템 통합** — 터미널 로컬 환경에서 사용자의 지시 하에 파일 편집, 아키텍처 리서치 및 CLI 빌드 실행 지원
+* **다양한 모델 스왑** — 세션 내에서 GPT-5.4, GPT-5.3-Codex 등으로 자유롭게 두뇌 변경 및 추론 조작 지원
+* **멀티모달 시각 분석** — 스크린샷이나 와이어프레임 설계도를 입력받아 UI 코드를 고속으로 구현 및 피드백
+
+```bash
+codex # 가동 명령어
+```
+
+##### [Codex CLI 기본 사용법]
+```bash
+codex auth              # OpenAI ChatGPT 또는 API 계정 연동 로그인
+codex                   # 대화형 코딩 TUI 세션 시작
+codex -p "작업명령"     # 로컬 파일 시스템 변경 및 빌드 직접 지시 (단발)
+```
+
+#### 4.4. Pi Coding Agent
 CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 `install-pi` 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다.
 
 ##### [일괄 설치되는 추천 패키지 리스트]
diff --git a/install-codex-cli.ps1 b/install-codex-cli.ps1
new file mode 100644
index 0000000..9645ddc
--- /dev/null
+++ b/install-codex-cli.ps1
@@ -0,0 +1,71 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Installs OpenAI Codex CLI on Windows using PowerShell.
+
+.DESCRIPTION
+    Installs OpenAI Codex CLI natively by invoking the official install.ps1 script.
+    This native installation method is recommended for Windows.
+    Official Guide: https://developers.openai.com/codex/cli
+
+.EXAMPLE
+    .\install-codex-cli.ps1
+
+    # One-liner install from remote (works on Windows 10+):
+    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-codex-cli.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.ps1' -OutFile $t; & $t"
+
+.NOTES
+    If execution policy error occurs:
+      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+#>
+
+[CmdletBinding()]
+param()
+
+# 최신 윈도우 환경 및 에러 발생 시 즉시 중단 설정
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+# HTTPS 다운로드를 위한 TLS 1.2 강제 (PowerShell 5.1 호환성 보장)
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+
+# ────────────────────────────────────────────
+# 유틸리티 함수 정의 (모든 안내 문구는 영문으로 작성)
+# ────────────────────────────────────────────
+function Write-Info    { param([string]$msg) Write-Host "[INFO]  $msg" -ForegroundColor Cyan }
+    # 정보 출력
+function Write-Warn    { param([string]$msg) Write-Host "[WARN]  $msg" -ForegroundColor Yellow }
+    # 경고 출력
+function Write-Success { param([string]$msg) Write-Host "[OK]    $msg" -ForegroundColor Green }
+    # 성공 출력
+function Write-Err     { param([string]$msg) Write-Host "[ERROR] $msg" -ForegroundColor Red; exit 1 }
+    # 에러 출력 및 스크립트 강제 종료
+
+# ────────────────────────────────────────────
+# 메인 설치 프로세스
+# ────────────────────────────────────────────
+function Main {
+    Write-Info "===== Codex CLI install script (Windows PowerShell) ====="
+    Write-Info "Installing OpenAI Codex CLI natively..."
+
+    try {
+        Write-Info "Fetching and executing official installer from: https://chatgpt.com/codex/install.ps1"
+        
+        # 공식 설치 ps1 스크립트를 다운로드 및 메모리 상에서 직접 호출 가동
+        $installerScript = Invoke-RestMethod -Uri "https://chatgpt.com/codex/install.ps1" -UseBasicParsing
+        Invoke-Expression $installerScript
+
+        Write-Success "Codex CLI has been successfully installed!"
+        Write-Info "Please restart your terminal window or refresh your PATH environment variable."
+        Write-Info "Run command: codex auth (to log in) and then 'codex' to start."
+    } catch {
+        Write-Err "Failed to install Codex CLI: $_"
+    }
+}
+
+# 예기치 못한 전체 프로세스 에러 감지를 위한 Trap 설정
+trap {
+    Write-Err "An unexpected error occurred during installation: $_"
+}
+
+Main
diff --git a/install-codex-cli.sh b/install-codex-cli.sh
new file mode 100644
index 0000000..c473fe4
--- /dev/null
+++ b/install-codex-cli.sh
@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# shellcheck disable=SC2086
+
+# OpenAI Codex CLI 네이티브 설치 스크립트
+#
+# macOS, Linux 환경에서 curl을 사용하여 공식 설치 스크립트를 다운로드하고 sh로 실행합니다.
+# 공식 가이드: https://developers.openai.com/codex/cli
+
+set -euo pipefail
+
+# ────────────────────────────────────────────
+# 유틸리티 함수 (모두 stderr 출력)
+# ────────────────────────────────────────────
+info()    { echo "[INFO]  $*" >&2; }
+warn()    { echo "[WARN]  $*" >&2; }
+error()   { echo "[ERROR] $*" >&2; exit 1; }
+success() { echo "[OK]    $*" >&2; }
+
+# ────────────────────────────────────────────
+# 필수 명령어 확인
+# ────────────────────────────────────────────
+if ! command -v curl &>/dev/null; then
+    error "'curl' 명령어가 필요합니다. 먼저 설치해 주세요."
+fi
+
+# ────────────────────────────────────────────
+# 메인 설치 로직
+# ────────────────────────────────────────────
+main() {
+    info "OpenAI Codex CLI 네이티브 설치를 시작합니다..."
+    info "공식 설치 스크립트 실행 중: curl -fsSL https://chatgpt.com/codex/install.sh | sh"
+
+    # OpenAI 공식 스크립트 호출 실행
+    if curl -fsSL https://chatgpt.com/codex/install.sh | sh; then
+        success "Codex CLI 설치가 성공적으로 완료되었습니다!"
+        info "새로운 터미널 창을 열거나 환경 변수를 반영한 뒤 아래 명령어를 가동하세요:"
+        info "  codex auth  # 인증 진행"
+        info "  codex       # 에이전트 실행"
+    else
+        error "Codex CLI 공식 설치 스크립트 가동 중 에러가 발생했습니다."
+    fi
+}
+
+main "$@"