이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.
TL;DR
Codex CLI는 ChatGPT에서 사용하던 AI 코딩 지원을 로컬 저장소, Shell, 테스트와 연결하는 Coding Agent로, Windows·macOS·Linux에서 운영체제별 설치 명령 하나로 설치할 수 있습니다. 첫 실행에서는 프로젝트 폴더를 먼저 지정하고 ChatGPT, Device Code, API key 중 인증 방식을 선택해야 하며, ChatGPT 구독 사용량과 API key 과금은 서로 다르게 처리됩니다. 이후 신뢰할 디렉터리와 Windows Sandbox 권한을 확인해야 하는데, 잘못된 경로를 승인하면 프로젝트 로컬 설정과 실행 정책이 의도하지 않은 위치에서 로드될 수 있습니다. 설치가 끝난 뒤에는 파일을 바꾸지 않는 읽기 전용 프롬프트로 저장소 접근을 점검하고 /status, /permissions, /review 같은 명령으로 모델과 권한, 변경사항을 관리하는 방식이 권장됩니다.
섹션별 상세
Codex CLI는 ChatGPT 안에서 사용하던 Codex 기능을 로컬 개발 환경으로 가져와 저장소, Shell, 테스트와 연결하는 Coding Agent입니다. 설치 자체는 운영체제별 한 줄 명령으로 끝나지만, 실행 위치와 권한을 잘못 선택하면 작업 범위를 벗어난 파일이나 명령이 영향을 받을 수 있습니다. 따라서 standalone installer를 사용하기 전 신뢰할 수 있는 프로젝트 폴더와 ChatGPT 계정 또는 OpenAI Platform API key를 준비해야 합니다.
macOS와 Linux에서는 curl 설치 스크립트를 실행하고, Windows에서는 PowerShell 설치 스크립트를 실행하면 Codex가 설치되며 Windows에서는 PATH에도 추가됩니다. Homebrew나 npm을 이미 사용하는 개발자는 brew install --cask codex 또는 npm install -g @openai/codex를 대안으로 선택할 수 있습니다. Windows 설치 직후 시작 여부를 묻는 화면에서는 터미널이 프로젝트 폴더에 있지 않다면 N을 눌러 System32 같은 잘못된 기본 위치에서 실행하지 않는 편이 안전합니다.
bash
curl -fsSL https://chatgpt.com/codex/install.sh | shmacOS와 Linux에서 standalone installer를 내려받아 Codex CLI를 설치합니다.
powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Windows PowerShell에서 Codex CLI 설치 스크립트를 실행합니다.
첫 실행은 작업할 저장소로 이동한 뒤 codex를 호출하는 순서가 핵심입니다. Codex는 현재 디렉터리를 시작 Workspace로 취급하므로, Windows에서는 C:\Users\you\code\my-project처럼 프로젝트 경로를 먼저 지정해야 합니다. 로그인은 ChatGPT 요금제의 Codex 사용량을 공유하는 방식, 브라우저가 없는 환경을 위한 Device Code 방식, OpenAI Platform에서 별도 과금되는 API key 방식으로 나뉩니다.
powershell
cd C:\Users\you\code\my-project
codex작업할 프로젝트 디렉터리로 이동한 뒤 Codex CLI를 실행합니다.
ChatGPT 로그인을 고르면 Codex가 인증 URL을 출력하고 브라우저를 열어 계정 인증을 진행합니다. 사용자는 확인 화면에서 올바른 ChatGPT 계정인지 점검한 뒤 성공 페이지를 닫고 터미널로 돌아오며, 브라우저가 자동으로 열리지 않으면 URL을 직접 복사해 사용할 수 있습니다. 구독 사용량은 웹 앱과 Codex 사이에서 공유되지만 API key 사용량은 연결된 OpenAI Platform 계정으로 별도 청구됩니다.
로그인 다음에는 Codex가 부여받을 자율성의 범위와 신뢰할 디렉터리를 차례로 확인합니다. 신뢰한 폴더에서는 프로젝트 로컬 configuration, hooks, execution policies가 로드되므로 화면에서 강조된 선택지만 보지 말고 실제 경로를 읽어야 하며, 경로가 틀리면 종료 후 올바른 저장소에서 다시 실행해야 합니다. 특히 문서의 시연 환경처럼 C:\WINDOWS\System32를 기본 Workspace로 승인하는 것은 피해야 합니다.
Windows Sandbox 설정에서는 관리자 권한을 승인할 수 있을 때 기본 Sandbox를 선택하는 것이 권장됩니다. 기본 방식은 낮은 권한의 Sandbox 사용자, 파일시스템 경계, 방화벽 규칙, 로컬 정책 변경을 함께 사용하며, 관리자 권한을 사용할 수 없는 환경에서는 보호 수준이 더 낮은 non-admin 방식을 선택할 수 있습니다. 이 선택은 Codex가 파일을 편집하고 명령을 실행할 수 있는 범위를 결정하므로 계정 로그인만큼 중요한 초기 설정입니다.
설정이 끝나면 저장소를 변경하지 않는 읽기 전용 프롬프트로 연결 상태를 점검하는 것이 안전합니다. 문서가 제시한 첫 요청은 저장소 구조를 설명하고 로컬 검증에 필요한 세 명령을 나열하되 파일은 변경하지 말라는 조건을 포함해, Codex가 프로젝트를 읽을 수 있는지와 변경 권한을 분리해 확인합니다. 이후 /status로 모델·디렉터리·계정·현재 설정을 확인하고, /permissions로 읽기·편집·실행 권한을 조정하며, /review로 커밋 전 변경사항을 검토할 수 있습니다.
Standalone 설치본은 기존 설치 명령을 다시 실행해 업데이트하고, Homebrew와 npm 설치본은 각각 같은 패키지 관리자로 업그레이드합니다. 업데이트 뒤 codex --version을 실행하면 설치된 빌드를 확인할 수 있으며, codex login status와 codex logout으로 저장된 로그인 상태를 조회하거나 지울 수 있습니다. 문서의 결론은 설치 명령보다 올바른 Workspace, Sandbox 경계 유지, 권한 확인과 읽기 전용 첫 요청이 실제 안전성을 좌우한다는 데 있습니다.
용어 해설
- Coding Agent
- — Coding Agent는 사용자의 지시에 따라 저장소의 파일을 읽고, Shell 명령을 실행하며, 코드를 수정하거나 테스트하는 AI 도구입니다. Codex CLI는 로컬 개발 환경에서 프로젝트 디렉터리와 실행 권한을 연결해 이러한 작업을 수행하며, 권한과 Sandbox 설정이 안전한 사용 범위를 결정합니다.
- Sandbox
- — Sandbox는 프로그램이 접근할 수 있는 파일, 네트워크, 실행 권한을 제한하는 격리 환경입니다. Codex CLI는 Windows에서 낮은 권한의 사용자, 파일시스템 경계, 방화벽 규칙, 로컬 정책을 조합해 코드 실행이 작업 공간 밖으로 확장되는 위험을 줄입니다.
- PATH 환경 변수(PATH Environment Variable)
- — PATH 환경 변수는 운영체제가 실행 파일을 찾는 디렉터리 목록입니다. Windows 설치 프로그램은 Codex를 PATH에 추가하므로 새 터미널에서 별도 경로를 입력하지 않고 codex 명령을 호출할 수 있으며, 설치 직후 현재 세션과 이후 세션의 동작 차이도 확인해야 합니다.
- Device Code 인증(Device Code Authentication)
- — Device Code 인증은 브라우저 콜백을 직접 받을 수 없는 SSH 호스트, 컨테이너, 원격 시스템에서 다른 기기의 브라우저를 이용해 로그인하는 방식입니다. Codex CLI는 첫 실행 때 ChatGPT 로그인, Device Code, API key 중 하나를 선택하게 하며, 선택한 방식에 따라 사용량과 인증 경로가 달라집니다.
- 프로젝트 로컬 설정(Project-local Configuration)
- — 프로젝트 로컬 설정은 특정 저장소 안에 두어 해당 프로젝트에서만 적용되는 지침과 실행 정책입니다. Codex CLI는 신뢰한 디렉터리에서 configuration, hooks, execution policies를 불러오므로, 잘못된 경로를 승인하면 의도하지 않은 코드나 명령이 로드될 수 있습니다.
기술
- Codex CLI
- ChatGPT
- OpenAI Platform
- PowerShell
- curl
- Homebrew
- npm
- Node.js
- WSL2
- Windows sandbox
- AGENTS.md
활용 사례
- 로컬 저장소의 구조와 개발 명령 확인
- Shell 명령 실행과 코드 편집
- 프로젝트별 AGENTS.md 지침 적용
- 커밋 전 변경사항 검토
- SSH·컨테이너 환경에서 Device Code 인증
언급된 리소스
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 08. 15.수집 2026. 08. 15.출처 타입 RSS
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
