Codex CLI 설치와 실행 파일 확인
CLI 설치와 프로젝트 의존성 설치는 별개입니다. Codex 실행 파일을 준비했다고 프로젝트가 바로 빌드되지는 않습니다. 또한 기존 설치가 있다면 같은 이름의 실행 파일이 여러 경로에 생기지 않도록 현재 경로부터 확인하세요.
이 글은 공식 문서를 바탕으로 작성한 비공식 해설입니다. 아래 설치 명령은 이 검수에서 실행하지 않았습니다. 명령을 복사하기 전 설치 대상·관리자 권한·조직 정책을 확인하세요.
설치 방법은 하나만 선택하세요
2026-11-08에 대조한 공식 CLI 안내에는 macOS/Linux·Windows 설치 스크립트와 패키지 매니저 방식이 나와 있습니다. 설치 스크립트를 내려받자마자 실행하는 방식을 여기서는 기본 실습으로 쓰지 않습니다. 원문과 배포 주체를 검토한 뒤 조직에서 승인한 방법을 선택하세요.
macOS에서 Homebrew를 사용하는 경우 공식 안내의 CLI 설치 명령은 다음과 같습니다. 이 명령은 로컬 소프트웨어를 설치하므로 실제 실행은 사용자가 결정해야 합니다.
brew install --cask codex
이 저장소는 의존성 관리에 pnpm만 사용합니다. 공식 문서에 소개된 다른 패키지 매니저 명령을 이 프로젝트의 설치 절차로 혼용하지 않습니다. Homebrew를 쓰지 않는 환경에서는 공식 설치 안내에서 해당 운영체제의 방식을 선택하세요.
Windows는 PowerShell의 네이티브 실행과 WSL2 환경을 구분합니다. WSL2 안에 설치한 실행 파일과 Windows 쪽 실행 파일은 같은 설치라고 볼 수 없습니다. Windows를 무조건 미지원으로 가정하거나 WSL2가 모든 환경의 필수 조건이라고 단정하지 마세요.
설치 후에는 조회 명령부터
아래 두 명령은 버전과 사용법을 출력합니다. AI 작업을 시작하는 codex 단독 실행과 구분하세요.
codex --version
codex --help
이번 문서 준비 중 기존 macOS 설치에서 codex-cli 0.167.0과 도움말 출력을 확인했습니다. 신규 설치·업데이트 성공을 검증한 것은 아닙니다. 이 번호가 앱·IDE·클라우드 전체의 버전이나 현재 최신 버전이라는 뜻도 아닙니다.
macOS/Linux에서 명령을 찾지 못하거나 예상 버전과 다르면 다음으로 실행 파일 위치를 확인할 수 있습니다.
command -v codex
PowerShell에서는 다음을 사용합니다. Windows 실행은 이번 검수에서 확인하지 않았습니다.
Get-Command codex
다른 설치 방식으로 계속 덮어쓰기 전에 PATH와 기존 설치 경로를 확인하세요. 공유하는 출력에는 사용자 홈 경로 등 개인 정보가 들어갈 수 있습니다.
실행 파일 다음에는 샌드박스 환경
공식 문서는 macOS, Linux/WSL2, 네이티브 Windows의 샌드박스 구현을 구분합니다. Linux/WSL2에서는 배포판의 bubblewrap 준비 상태도 확인하도록 안내합니다. 실행 파일이 보인다고 샌드박스가 정상이라고 단정하지 않습니다.
시작 시 샌드박스 경고가 나타나면 해당 운영체제의 공식 사전 조건을 읽으세요. 해결을 위해 OS 보호 기능을 전역 해제하거나 전체 접근 모드를 켜는 것을 기본 대응으로 삼지 않습니다. 조직 관리 장비라면 관리자에게 필요한 조건을 먼저 문의합니다.
다음 단계
연습용 프로젝트에서 시작할 준비가 되었다면 인증 방식을 고릅니다. 아직 로그인하지 않아도 버전·도움말 출력 여부는 별도로 확인할 수 있습니다. 업데이트가 필요할 때도 최초에 선택한 설치 경로를 기준으로 공식 절차를 따르세요. 설치 방식 변경과 모델 실행 권한 변경을 한 번에 처리하지 않는 편이 원인 파악에 도움이 됩니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며, 계정 조건과 요금은 공식 안내를 우선합니다.