Windows에서 쓰는 Codex: 앱이나 CLI를 설치하고 샌드박스나 WSL2 고르기

Windows에 어떤 Codex를 설치할까

• 창으로 쓰고 싶다면 ChatGPT 데스크톱 앱. Codex에는 Chat, Work와 나란히 자체 코딩 화면이 있고, worktree, 예약 작업, Git, 내장 브라우저, 파일 미리 보기, 플러그인, 스킬을 갖추고 있어요. 앱은 Free를 포함한 모든 ChatGPT 요금제에서 쓸 수 있어요.
• 터미널에서 작업한다면 Codex CLI. PowerShell 스크립트나 npm으로 네이티브 설치돼요.
• 에디터에서 작업한다면 IDE 확장. OpenAI는 앱, CLI와 함께 Windows에서 Codex를 네이티브로 쓰는 방법으로 이것을 꼽아요.
• Windows 11을 권장해요. 업데이트를 모두 마친 최신 Windows 10도 보장 없이 지원되며, ConPTY 때문에 버전 1809 이상이 필요해요. 그보다 오래된 Windows 10은 권장하지 않아요. winget을 쓸 수 있어야 해요.

Windows에서 Codex 다운로드하고 설치하는 법

1. ChatGPT 데스크톱 앱 다운로드하기

   OpenAI의 Windows 앱 페이지에 있는 Microsoft Store 링크로 받거나, PowerShell에서 winget으로 설치하세요. ChatGPT를 열고 로그인한 뒤 Codex를 선택하세요.

   winget install --id 9PLM9XGG6VKS -s msstore

2. 또는 Codex CLI 설치하기

   새 PowerShell 창을 열고 OpenAI의 설치 프로그램을 실행하세요. 다시 실행하면 Codex가 업데이트돼요. Node.js가 설치돼 있다면 npm을 써도 돼요. CLI에서 codex app은 데스크톱 앱을 열고(필요하면 설치하고), /app은 현재 세션을 앱으로 옮겨요.

   # Native Windows installer (run it in a new PowerShell window)
   powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
   
   # Or with npm, if Node.js is installed
   npm install -g @openai/codex
   
   # Start Codex and sign in
   codex

3. 로그인하기

   처음 실행할 때 Sign in with ChatGPT를 골라 내 요금제를 쓰거나, API 키로 로그인하세요. API 키는 표준 API 요금으로 청구돼요. Codex cloud에는 ChatGPT 로그인이 필요해요. 로그인되면 codex login status가 0으로 종료돼요.

4. Codex가 호출할 도구 설치하기

   Codex는 PC에 설치된 것을 써요. OpenAI는 Git, Node.js, Python, .NET SDK, GitHub CLI를 모두 winget으로 설치한 뒤 GitHub에 로그인하라고 제안해요.

   winget install --id Git.Git
   winget install --id OpenJS.NodeJS.LTS
   winget install --id Python.Python.3.14
   winget install --id Microsoft.DotNet.SDK.10
   winget install --id GitHub.cli
   gh auth login

5. 에이전트 실행 위치 고르기

   기본적으로 에이전트는 Windows 샌드박스 아래 PowerShell에서 네이티브로 실행돼요. 대신 WSL2에서 실행하려면 Settings를 열어 에이전트를 Windows native에서 WSL로 바꾸고 앱을 다시 시작하세요. 어느 모드든 입력창 아래에서 Ask for approval을 선택해야 샌드박스 보호를 받아요. 관리자 권한이 필요한 명령에는 Run as administrator로 앱을 시작하세요. 에이전트가 그 권한을 물려받아요. 통합 터미널로는 PowerShell, Command Prompt, Git Bash, WSL을 쓸 수 있어요.

출처: OpenAI의 Codex 문서, Windows 앱

네이티브 PowerShell이냐 WSL2냐?

OpenAI는 기본적으로 네이티브 샌드박스를 쓰고, Linux 네이티브 도구가 필요하거나, 이미 WSL2에서 일하고 있거나, 네이티브 옵션이 내 환경에 맞지 않을 때 WSL2를 고르라고 권해요. WSL1은 더 이상 지원되지 않아요. Codex 0.114까지는 작동했지만, 0.115부터 Linux 샌드박스가 bubblewrap을 쓰면서 WSL1 지원이 끝났어요.

WSL2에서 Codex 실행하는 법

1. WSL2를 설치하고 그 안에 Codex 설치하기

   관리자 권한 PowerShell에서 wsl --install을 실행한 다음 wsl로 Linux 셸을 여세요. 그 안에서 샌드박스용 bubblewrap을 설치하고(sudo apt install bubblewrap 또는 sudo dnf install bubblewrap), Linux 설치 스크립트를 실행한 뒤 codex를 시작하세요.

   # In PowerShell, run as administrator
   wsl --install
   wsl
   
   # Inside WSL: the sandbox needs bubblewrap (apt or dnf), then install Codex
   sudo apt install bubblewrap
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   codex

2. 저장소는 Linux 홈에 두기

   /mnt/c 아래는 더 느리니 ~/code 같은 폴더에 클론하세요. WSL의 VS Code가 Codex를 찾지 못하면 which codex로 위치를 확인하세요.

3. Windows 앱과 설정 공유하기

   Windows 앱은 Codex 홈을 %USERPROFILE%\.codex에 두고, WSL 안의 CLI는 Linux 홈을 써요. 하나로 공유하려면 WSL에서 CODEX_HOME을 Windows 폴더로 설정하세요.

   export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

4. 데스크톱 앱에서 WSL 프로젝트 열기

   Add new project를 선택하고(또는 Ctrl+O를 누르고) \\wsl$\를 입력하세요. 에이전트가 네이티브로 남아 있다면, 프로젝트를 Windows 드라이브에 두고 WSL에서 /mnt/<drive>/...로 접근하는 편이 더 안정적이에요.

출처: OpenAI의 Codex 문서, Windows와 WSL

Codex Windows 샌드박스: MXC, elevated, unelevated

Windows 샌드박스 덕분에 Codex는 WSL이나 가상 머신 없이 PowerShell에서 네이티브로 실행되면서도, 명령과 그 하위 프로세스가 디스크와 네트워크에서 건드릴 수 있는 범위를 제한해요. 구현은 세 가지예요. 데스크톱 앱은 지원되는 기기의 개인용 계정에서 MXC를 자동으로 골라요.

Codex Windows 샌드박스 설정

1. 내 PC에서 MXC가 되는지 확인하기

   Codex CLI 0.162.0 이상에서 이 테스트를 실행하세요. MXC_OK가 출력되고 종료 코드 0으로 끝나야 해요.

   codex -c windows.sandbox=mxc sandbox --include-managed-config --permission-profile :workspace -- cmd.exe /d /c echo MXC_OK

2. CLI에서 MXC 우선 사용하기

   데스크톱 앱은 개인용 계정에서 이미 MXC를 우선해요. CLI에서나 기업 환경에서는 Codex 홈의 config.toml에서 켜세요.

   # config.toml in your Codex home (%USERPROFILE%\.codex)
   [features]
   prefer_mxc = true

3. 또는 레거시 샌드박스 고르기

   MXC를 쓸 수 없다면 elevated를, 마지막 대안으로 unelevated를 설정하세요. elevated 샌드박스는 설정에 관리자 승인이 필요해요. CLI에서는 /setup-default-sandbox 명령이 그 설정을 실행해요. 이 명령은 Windows에서, Codex가 기능이 제한된 restricted-token 샌드박스를 쓰고 있을 때만 나타나요.

   # config.toml in your Codex home (%USERPROFILE%\.codex)
   [windows]
   sandbox = "elevated"   # or "unelevated"

4. 또는 IT가 미리 설정하게 하기

   관리자는 다른 사용자를 위해 elevated 샌드박스를 프로비저닝할 수 있어요. 나중에 레거시 샌드박스를 제거하려면 관리자 권한으로 codex sandbox uninstall을 실행하세요.

   codex sandbox setup --elevated --user 'DOMAIN\alice' --codex-home 'C:\Users\alice\.codex'

출처: OpenAI의 Codex 문서, Windows 샌드박스

Codex Windows 샌드박스 설정이 실패했나요? 문서에 나온 해결법

OpenAI의 Windows 샌드박스 페이지에 문제 해결 목록이 있어요. 거기서 다루는 내용을 문서의 제목 그대로 정리했어요.

• “My legacy sandbox setup failed”: 흔한 원인은 UAC나 관리자 확인 창을 거절한 경우, 또는 로컬 사용자와 그룹 만들기, 방화벽 변경, 샌드박스 사용자에게 로그온 권한 부여를 막는 정책이나 그 밖의 정책이에요. 다시 시도해 확인 창을 승인하거나, IT에 문의하거나, 그동안 unelevated 샌드박스를 쓰세요.
• “I see Windows error 1385”: Windows가 샌드박스 사용자에게 필요한 로그온 유형을 거부한 거예요. 샌드박스 사용자의 로그온 권한은 정책이 막을 수 있는 항목 중 하나라서, 관리되는 PC라면 IT에 문의하세요. MXC는 추가 Windows 계정을 만들지 않으므로, Windows 11 24H2나 25H2에서는 샌드박스 사용자에 의존하지 않아요.
• “Codex switched me to the unelevated sandbox”, “Codex warns that some folders are writable by Everyone”, “Sandboxed commands cannot reach the network”, “Sandboxing worked before and then stopped”은 그 페이지에 각각 별도 항목이 있어요.
• 진단하려면 CODEX_HOME/.sandbox/sandbox.log를 읽으세요. CODEX_HOME/.sandbox-secrets/ 폴더는 절대 다른 사람에게 보내지 마세요.
• “setup didn't finish”를 검색하셨나요? OpenAI 문서에는 그 문구로 된 항목이 없어요. 문서에 나온 가장 가까운 사례는 “My legacy sandbox setup failed”예요.
• PowerShell이 npm을 실행하지 않고 npm.ps1 cannot be loaded because running scripts is disabled on this system.이라고 나오면, 흔한 해결법은 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned예요.

Windows의 Computer Use는 화면을 차지해요

Computer Use를 쓰면 Codex가 포인터를 움직이고 입력해서 데스크톱 앱을 조작할 수 있어요. 데스크톱 앱에서는 macOS와 Windows에서, ChatGPT Work와 Codex로, 지원되는 지역에서 쓸 수 있어요. 켜려면 Settings > Computer use를 열고, Control 아래의 Any App을 찾아 Install을 선택하거나 스위치를 켜세요.

• 활성 데스크톱에서 실행되고 백그라운드에서는 작동하지 못해요. 작업이 돌아가는 동안 포인터를 움직이고, 입력하고, 창을 앞으로 가져오기 때문에 그동안 PC를 함께 쓸 수 없어요.
• 자리를 비운 동안 일하게 하려면 PC를 잠그지 말고 온라인으로 둔 채 휴대폰에서 원격 제어로 확인하거나, 데스크톱 앱을 Windows 가상 머신 안에서 실행해 Computer Use가 내 화면 대신 VM을 차지하게 하세요.
• 컴퓨터가 잠긴 뒤에도 작업을 계속하게 하는 잠금 상태 사용(locked use)은 macOS 전용이에요.
• 앱 승인을 저장하려면 $CODEX_HOME/config.toml의 [computer_use.windows] 아래에 앱을 나열하세요. 예: always_allowed_app_ids = ["mspaint.exe"].
• 어느 시스템에서든 Computer Use는 터미널 앱이나 ChatGPT 자체를 자동화하거나, 관리자로 로그인하거나, 보안·개인정보 보호 확인 창을 승인할 수 없어요.

휴대폰에서 Windows PC의 Codex 제어하기

Windows PC도 Mac처럼 원격 제어 호스트가 될 수 있어요. 휴대폰의 ChatGPT 앱은 프롬프트와 승인을 보내고, PC는 자기 프로젝트, 파일, 자격 증명, 도구로 명령을 실행해요. 전체 설정과 해결법은 Codex 원격 제어에 있어요.

• PC에서 ChatGPT 데스크톱 앱을 열고 Settings > Connections > Control this Mac or PC로 가서 Set up이나 Add를 선택하세요. 휴대폰(iOS 또는 Android)으로 QR 코드를 스캔하세요.
• 그러면 ChatGPT 앱의 Codex 아래에 PC가 나타나요. 이전 버전의 앱에서는 Remote라고 불러요.
• PC를 깨어 있고, 온라인이고, 로그인돼 있고, 데스크톱 앱이 실행 중인 상태로 두세요. 잠자기에 들어가거나 네트워크가 끊기면 다시 돌아올 때까지 원격 접근이 끊겨요. Computer Use를 쓰는 작업이라면 Windows 세션을 잠그지 마세요.
• OpenAI의 요금제 표에는 모바일 원격 제어가 Plus, Pro, Business, Enterprise에 있다고 나와 있고, API 키 로그인에는 없어요. ChatGPT 워크스페이스에서는 관리자가 먼저 Remote Control 접근을 켜야 할 수도 있어요.
• PC는 Linux 서버의 프로젝트를 SSH 호스트로 열 수도 있으니, 휴대폰으로 PC를 거쳐 서버의 Codex를 조종할 수 있어요. VPS에서 Codex 돌리기와 Linux에서 Codex 쓰기를 참고하세요. 대신 늘 켜져 있는 Mac을 쓰려면 Mac mini에서 Codex 돌리기를 참고하세요.

PC의 Codex에 고정 업무 맡기기

원격 제어와 Computer Use도 작업마다 내가 시작하길 기다려요. Crewmark는 Windows PC의 Codex 채팅을 직무, 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿔 줘요. 근무 시간 동안 macOS와 Linux뿐 아니라 Windows에서도 돌아가는 crewmark CLI가 직원을 깨워 공유 보드에서 다음 이슈를 가져가게 해요. 그러려면 PC가 계속 켜져 있어야 해요.

1. 직원 채용하기

   AI 직원 직무에서 소프트웨어 엔지니어 같은 직무를 고르고, 목표와 KPI를 적으세요.

2. PC의 Codex 채팅 연결하기

   crewmark CLI로 PC의 Codex 채팅을 직원과 연결하세요. 그 대화가 직원이 돼요. Claude Code도 쓸 수 있어요.

3. 근무 시간과 하트비트 정하기

   평일만 또는 매일로, 내 시간대에 맞춰 정하고, 근무 시간은 자정을 넘겨도 돼요. 그 시간 동안 CLI가 15, 30, 60, 120, 240분마다 직원을 깨워요. Codex 장시간 작업을 참고하세요.

4. 어디서든 이슈 배정하기

   어느 브라우저에서든 crewmark.ai 보드에서 이슈를 만들고 배정하세요. 배정하면 직원이 깨어나요. 리뷰나 결정이 필요하면 직원이 이슈를 Needs action으로 바꾸고 거기서 물어봐요. 맡길 만한 일은 Codex 활용 사례에 있어요.

FAQ