Windows용 Codex 다운로드

Windows에서는 새 PowerShell 창에서 chatgpt.com의 공식 한 줄 설치 프로그램으로 Codex CLI를 설치합니다. 데스크톱 앱을 원하면 Microsoft Store에서 ChatGPT 데스크톱 앱을 설치하거나 winget install --id 9PLM9XGG6VKS -s msstore를 실행하세요. 데스크톱 앱은 Windows 샌드박스와 함께 PowerShell에서 Codex를 네이티브로 실행하며, 설정을 바꾸면 WSL2 안에서 실행할 수도 있습니다.

적용 대상: Windows 11, Codex CLI, ChatGPT 데스크톱 앱

이 페이지는 영어 가이드의 번역본입니다. 명령어와 파일 이름은 그대로 두었습니다. 두 내용이 다르면 영어 페이지와 공식 출처가 우선합니다.

방법 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를 통해 배포합니다:

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는 이로 인해 파괴적인 작업과 데이터 손실이 발생할 수 있다고 경고합니다. 특별한 이유가 없다면 샌드박스를 켜 두세요.

자주 묻는 질문

Windows에서 Codex를 쓰려면 WSL이 필요한가요?

아니요. ChatGPT 데스크톱 앱과 독립 실행형 CLI 설치 프로그램 모두 네이티브 Windows를 지원하며, 명령어는 PowerShell에서 실행됩니다. WSL2는 선택 사항입니다. 프로젝트와 도구가 이미 Linux에 있다면 사용하세요.

Codex는 WSL1을 지원하나요?

아니요. OpenAI의 Windows 문서에 따르면 WSL1은 Codex 0.114까지 지원되었습니다. 0.115부터 Linux 샌드박스가 bubblewrap으로 바뀌었으므로 WSL2가 필요합니다.

PowerShell에서 스크립트 실행이 비활성화되어 있다고 나오는 이유는 무엇인가요?

PowerShell 실행 정책 때문입니다. 시스템 설정을 바꾸기 전에 'cannot be loaded because running scripts is disabled' 오류 해결 방법을 먼저 확인하세요.

출처

이 페이지의 모든 안내에는 공식 출처 링크를 달았습니다. 이 페이지의 내용이 공식 출처와 다르면 공식 출처를 따르시고 저희에게 알려 주세요.