Codex Agent는 OpenAI의 AI 코딩 에이전트로, 주로 Codex CLI(터미널), Desktop App, VS Code Extension 형태로 사용됩니다. 아래에 각 설치 방법

Codex Agent는 OpenAI의 AI 코딩 에이전트로, 주로 Codex CLI(터미널), Desktop App, VS Code Extension 형태로 사용

작성자:

Codex Agent는 OpenAI의 AI 코딩 에이전트로, 주로 Codex CLI(터미널), Desktop App, VS Code Extension 형태로 사용됩니다. 아래에 각 설치 방법을 정리했습니다. (2026년 5월 기준 최신 정보)

1. Codex CLI (터미널용, 가장 가벼움)

터미널에서 직접 코딩 에이전트를 실행할 때 추천.

필수 조건:

  • Node.js 22+ (LTS 권장)
  • OpenAI ChatGPT 계정 (Plus/Pro 이상) 또는 API Key

설치 방법:

Bash

# 1. Node.js 설치 후
npm install -g @openai/codex

# 또는 Homebrew (macOS)
brew install --cask codex

실행 및 로그인:

Bash

codex
  • 처음 실행 시 ChatGPT 계정으로 로그인하거나 API Key 입력.
  • codex –help 또는 codex로 TUI(터미널 UI) 시작.

업데이트:

Bash

npm install -g @openai/codex@latest

Windows 사용자: WSL2 추천 또는 PowerShell + Windows Sandbox 사용.

2. Codex Desktop App (GUI 추천)

Codex Agent는 OpenAI의 AI 코딩 에이전트로, 주로 Codex CLI(터미널), Desktop App, VS Code Extension 형태로 사용됩니다. 아래에 각 설치 방법

가장 편리한 풀 GUI 버전.

macOS:

  • 공식 다운로드 페이지 또는 Codex CLI 설치 후 codex app 명령어로 설치.
  • DMG 파일 다운로드 → Applications 폴더로 드래그.

Windows:

  • Microsoft Store에서 “Codex” 검색 후 설치 (가장 간단).
  • 또는 직접 다운로드 링크 사용.

설치 후 앱 실행 → ChatGPT 계정 로그인 → 작업 폴더 선택.

3. VS Code Extension

VS Code / Cursor 등에서 사용.

  1. VS Code 열기.
  2. Extensions (Ctrl+Shift+X) → “Codex” 또는 “OpenAI Codex” 검색.
  3. 공식 OpenAI 버전 설치.
  4. ChatGPT 로그인.

공통 팁

  • ChatGPT Plus/Pro 이상 구독이 필요합니다 (일부 기능 제한될 수 있음).
  • 처음 사용 시 작업할 프로젝트 폴더를 선택하고, AGENTS.md 파일로 커스텀 지침을 줄 수 있습니다.
  • 보안: Codex는 sandboxed 환경에서 동작하며, 승인 모드(Approval Mode)를 설정 가능.
  • GitHub 연동, Subagents, Web Search 등 고급 기능 활용 가능.