방법 1: 공식 설치 프로그램으로 Codex CLI 설치
새 PowerShell 창을 열고 다음을 실행하세요:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
나중에 업데이트하려면 같은 명령어를 실행하세요. 새 터미널을 열고 프로젝트 폴더로 이동한 다음 codex를 실행하세요. 처음에는 Sign in with ChatGPT(ChatGPT로 로그인)를 선택하세요.
Windows에서 이미 Node.js를 사용한다면 npm으로 설치할 수도 있습니다(npm install -g @openai/codex).
방법 2: Microsoft Store의 ChatGPT 데스크톱 앱
OpenAI는 Windows 데스크톱 앱을 Microsoft Store를 통해 배포합니다:
- Microsoft Store 페이지를 열거나,
- PowerShell에서 다음을 실행하세요:
winget install --id 9PLM9XGG6VKS -s msstore
그런 다음 앱을 열고 로그인한 뒤, 프로젝트를 추가하고 Codex를 선택하세요.
네이티브 Windows와 WSL2 중 무엇을 쓸까요?
데스크톱 앱은 기본적으로 Windows 네이티브 Codex 에이전트를 사용합니다. 명령어는 PowerShell에서 실행되며, 입력창 아래에서 Ask for approval(승인 요청)을 선택하면 네이티브 Windows 샌드박스로 보호됩니다. 에이전트를 Linux에서 실행하고 싶다면 Settings(설정)를 열고 에이전트를 Windows 네이티브에서 WSL로 바꾼 다음 앱을 다시 시작하세요.
네이티브 에이전트에 대한 OpenAI의 권장 사항은 프로젝트를 Windows 파일 시스템에 두고 WSL에서는 /mnt/<drive>/...로 접근하는 것입니다. \\wsl$\에서 프로젝트를 직접 여는 방식은 안정성이 떨어집니다. 전체 안내: WSL2에서 Codex 사용하기.
먼저 설치해 두면 좋은 도구
Codex는 몇 가지 개발 도구가 이미 설치되어 있을 때 가장 잘 작동합니다. OpenAI의 Windows 문서는 다음을 권장합니다:
winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id GitHub.cli
Git은 리뷰 창을 구동합니다. Node.js와 Python은 에이전트가 효율적으로 작업하는 데 도움이 됩니다. GitHub CLI를 설치한 뒤에는 gh auth login을 실행해 GitHub 기능을 활성화하세요.
Codex를 전체 접근 모드로 실행하면 프로젝트 폴더로 제한되지 않습니다. OpenAI는 이로 인해 파괴적인 작업과 데이터 손실이 발생할 수 있다고 경고합니다. 특별한 이유가 없다면 샌드박스를 켜 두세요.