Codex 앱 윈도우 직접 써봤습니다 — 막히는 곳

Published on

in

Codex 앱 윈도우 직접 써봤습니다 — 막히는 곳

2026.03.04 출시 기준
OpenAI Codex 앱 Windows
ChatGPT Plus/Pro/Business 필요

Codex 앱 윈도우 직접 써봤습니다 — 막히는 곳

결론부터 말씀드리면, Codex 앱이 Windows에 공식 상륙했지만 “그냥 설치하면 된다”는 생각과는 조금 달랐습니다. Free 플랜 무료 체험은 한시적 조건이 붙고, WSL로 전환하는 순간 sandbox 동작 방식이 바뀌는데 이걸 모르면 보안 설정이 예상과 다르게 작동합니다. 설치부터 실제로 걸리는 지점까지 공식 문서 기준으로 풀었습니다.

2026.03.04
Windows 출시일
Windows 10+
Build 19041.0 이상
$20/월~
최소 Plus 플랜 필요

Codex 앱 윈도우, 뭐가 달라진 건가요?

OpenAI는 2026년 2월 2일에 Codex 앱을 macOS용으로 먼저 출시했고, 딱 한 달 뒤인 3월 4일에 Windows 버전을 추가했습니다. 기존에 CLI나 IDE 익스텐션으로만 쓸 수 있었던 Codex를 데스크톱 앱 형태로 쓸 수 있게 된 거라, 터미널 없이도 여러 에이전트를 동시에 띄워두고 관리할 수 있는 환경이 생겼습니다. (출처: OpenAI ChatGPT Release Notes, 2026.03.04)

핵심 기능은 세 가지입니다. 첫째, 여러 에이전트를 병렬로 실행하면서 각각 독립된 worktree에서 작업하게 할 수 있습니다. 둘째, 에이전트가 만들어낸 코드 변경사항을 diff 형태로 보여줘서 직접 검토한 뒤 merge 여부를 결정할 수 있습니다. 셋째, 에이전트가 장시간 작업해도 컨텍스트가 유지됩니다. 이게 기존 보조도구들과 다른 점입니다. 단순히 코드 한 줄 완성해주는 게 아니라, 몇 시간짜리 작업을 배경에서 돌려두고 사람은 다른 일을 할 수 있는 구조입니다.

Windows에서는 PowerShell 기반의 네이티브 에이전트가 기본으로 실행되고, 필요하면 WSL로 전환할 수 있습니다. 그런데 이 전환이 단순하지 않다는 게 막상 써보면 느끼는 첫 번째 포인트입니다.

▲ 목차로 돌아가기

설치는 Microsoft Store에서, 그런데 이 조건 먼저 확인하세요

설치 자체는 간단합니다. Microsoft Store에서 “Codex”로 검색하거나, PowerShell에서 winget install Codex -s msstore 명령 하나로 끝납니다. (출처: OpenAI Developer Docs — Codex App Windows, 2026.03.04) 문제는 설치 후입니다.

앱을 열면 ChatGPT 계정으로 로그인해야 하는데, Codex는 ChatGPT Plus·Pro·Business·Enterprise·Edu 플랜이 있어야 씁니다. Windows 10 (Build 19041.0) 이상이 필요하고, Git이 없으면 리뷰 패널 자체가 안 열립니다. Node.js와 Python도 Codex 에이전트가 작업 효율을 높이기 위해 쓰는 도구라서 미리 깔아두지 않으면 첫 작업에서 막힙니다. 이 네 가지(Git, Node.js, Python, .NET SDK)는 공식 문서에서 권장하는 기본 개발 도구이고, winget install --id Git.Git 등으로 한 번에 설치할 수 있습니다.

💡 공식 발표문과 실제 설치 흐름을 같이 놓고 보니 이런 차이가 보였습니다.
PowerShell 실행 정책이 기본값으로 스크립트를 막아둔 환경에서는, 에이전트가 npm 스크립트를 실행하려다 npm.ps1 cannot be loaded 에러를 냅니다. 이걸 해결하려면 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned를 먼저 실행해야 합니다. — 공식 문서에 명시된 내용이지만, 설치 안내 화면에는 나오지 않아서 처음 막히는 지점입니다.

▲ 목차로 돌아가기

무료로 써볼 수 있다는데, 그 조건이 문제입니다

⚠ 많은 분들이 오해하는 부분: “Free 플랜으로도 Codex 써볼 수 있다”는 문구가 있는데, 이건 한시적 프로모션입니다. 영구 무료가 아닙니다.

OpenAI 공식 공지에 따르면 Free·Go 플랜의 Codex 무료 체험은 “limited time”으로 명시돼 있습니다. (출처: OpenAI Help Center — Using Codex with your ChatGPT plan) 실제로 Codex가 처음 출시됐을 때(2025년 5월)는 Free 플랜에서 전혀 안 됐고, 이후 단계적으로 체험 범위가 조금씩 열린 구조입니다. 프로모션 종료 시점은 공식 문서에 명시되어 있지 않아 “확인 필요” 상태입니다.

플랜별로 어떻게 다른지 직접 따져보면 이렇습니다.

Codex 플랜별 비교 (2026.03 기준, 출처: OpenAI 공식 문서)
플랜 월 요금 Codex 접근 특이 조건
Free $0 한시적 체험만 프로모션 종료 미정
Go $8~ 한시적 체험만 프로모션 종료 미정
Plus $20/월 정식 포함 현재 2x 사용량 프로모션 적용 중 (~3/27)
Pro $200/월 정식 포함 사용 한도 Plus보다 높음
Business $30/인/월 정식 포함 팀 단위 워크스페이스 제어 가능

※ “현재 2x 사용량 프로모션”은 2026년 3월 13일~27일 한시 적용으로, 이 기간이 지나면 기존 한도로 돌아옵니다.

결국 Windows 앱을 제대로 쓰려면 최소 Plus($20/월)가 필요합니다. 이 수치가 의미하는 건, “그냥 한번 써보자”는 마음으로 Windows 앱을 받아서 로그인하면 Free 플랜이라도 지금은 열리지만, 프로모션이 끝나면 곧장 막힌다는 겁니다.

▲ 목차로 돌아가기

WSL로 바꾸면 sandbox가 달라집니다

Windows 앱의 기본 에이전트는 PowerShell에서 실행되고, 이때 Windows 네이티브 sandbox가 작동합니다. 이 sandbox는 파일 시스템 ACL과 전용 sandbox 사용자 계정을 써서 에이전트가 작업 폴더 밖의 파일에 접근하거나 네트워크 요청을 마음대로 보내지 못하게 막습니다. (출처: OpenAI Developer Docs — Codex App Windows)

💡 “WSL이 더 안전하다”고 생각하기 쉽지만, 실제로는 반대로 봐야 할 상황이 생깁니다.
공식 문서에 따르면, 에이전트를 WSL로 전환하면 Linux sandboxing이 적용되는데, Windows 네이티브 sandbox와 동작 방식이 다릅니다. OpenAI 자신도 “WSL sandbox 동작은 구성에 따라 달라질 수 있으니 각 팀이 직접 검증해야 한다”고 명시했습니다. 즉, 기본값으로 두면 네이티브 PowerShell 쪽이 더 예측 가능한 보안 경계를 제공합니다. (출처: OpenAI Developer Docs — Codex App Windows)

WSL을 쓰고 싶다면 설정에서 에이전트를 WSL로 바꾸고 앱을 완전히 재시작해야 합니다. 재시작하지 않으면 변경이 적용되지 않고, 이걸 모르고 작업을 시작하면 기대한 환경이 아닌 상태에서 에이전트가 돌아갑니다. 실제로 출시 직후 GitHub Issues에도 WSL 전환 후 agent sandbox가 초기화되지 않는 문제가 여러 건 올라왔고(출처: openai/codex GitHub Issues #13699, 2026.03.05), 지금도 해당 이슈가 진행 중입니다.

Full access 모드로 설정을 열어두면 에이전트가 작업 폴더 바깥에서도 파일을 건드릴 수 있어서 의도치 않은 데이터 손실이 생길 수 있습니다. 이 부분은 공식 문서에 명시적으로 경고가 적혀 있는 내용입니다.

▲ 목차로 돌아가기

CLI와 설정 파일이 따로 노는 이유

기존에 Codex CLI를 WSL 안에서 써왔다면 이 부분이 특히 걸립니다. Windows 앱은 %USERPROFILE%\.codex를 홈 디렉토리로 씁니다. 반면 WSL 안의 Codex CLI는 Linux 홈 디렉토리인 ~/.codex를 씁니다. 두 경로가 물리적으로 다른 위치라서, 설정과 세션 기록, 인증 캐시가 공유되지 않습니다. (출처: OpenAI Developer Docs — Codex App Windows)

💡 공식 발표문만 봤을 때는 안 보이는 부분인데, 실제 설정을 맞춰보면 차이가 드러납니다.
두 환경의 설정을 공유하려면 WSL 쪽에서 환경변수를 export CODEX_HOME=/mnt/c/Users/<사용자명>/.codex로 잡아두고 shell 프로파일(~/.bashrc 등)에 저장해야 합니다. 이걸 안 하면 Windows 앱에서 한 인증이 WSL CLI에서는 만료된 것처럼 보여서 재로그인을 요구합니다.

마찬가지로, WSL 파일시스템(\\wsl$\)에 있는 프로젝트를 Windows 앱에서 열 수는 있지만, 네이티브 에이전트로 작업할 때는 Windows 드라이브에 프로젝트를 두고 WSL에서는 /mnt/<드라이브>/... 경로로 접근하는 게 공식 권장 방식입니다. Git 기능도 Windows 네이티브 Git이 설치돼 있지 않으면 WSL 경로 프로젝트에서 감지가 안 됩니다.

▲ 목차로 돌아가기

실제로 작동하는 것들, 그리고 지금 안 되는 것들

전반적인 작동 상황을 정리하면 이렇습니다.

✅ 지금 잘 되는 것

  • Microsoft Store에서 직접 설치
  • ChatGPT 계정으로 로그인
  • 병렬 에이전트 실행 (worktree 분리)
  • PowerShell 네이티브 sandbox
  • VS Code·Cursor·Windsurf에서 열기
  • GPT-5.4 포함 최신 모델 사용
  • GitHub CLI 연동 후 PR 자동 리뷰
  • Codex CLI 설정 파일 공유 (설정 시)

❌ 현재 제한 또는 미완성

  • WSL 에이전트 전환 후 sandbox 불안정 (GitHub Issues 진행 중)
  • WSL 경로 프로젝트의 Git 인식 불안정
  • Cmder 터미널 앱 연동 안 됨
  • WSL CLI와 설정 자동 동기화 없음
  • Free/Go 플랜 무료 체험 기간 미정
  • Codex CLI Windows 지원은 아직 “실험적” 상태

Harvey의 Mobile Lead Joey Wang은 Codex 도입 후 초기 반복 작업 시간이 30~50% 단축됐다고 밝혔고, Duolingo의 시니어 엔지니어 Aaron Wang은 Python 코드 리뷰 벤치마크에서 다른 도구가 놓친 버그를 Codex만 잡아냈다고 전했습니다. (출처: OpenAI Codex 공식 페이지) 이 수치가 의미하는 건, 실사용 환경에서 생산성 효과는 실제로 존재하지만, 앞서 말한 환경 설정 문제를 먼저 해결해야 그 이점을 누릴 수 있다는 겁니다.

개인적으로 보면, 지금 상태는 “완성된 제품”보다는 “빠르게 성장 중인 베타에 가깝다”는 인상을 받습니다. 핵심 기능 자체는 충분히 쓸 만하지만, WSL 관련 설정이나 sandbox 안정성은 아직 한두 단계 더 다듬어질 여지가 있습니다.

▲ 목차로 돌아가기

자주 나오는 질문 5가지

Q1. Codex 앱 Windows가 macOS 버전과 기능 차이가 있나요?
병렬 에이전트, worktree 분리, diff 리뷰 등 핵심 기능은 동일합니다. 다른 점은 sandbox 구현 방식입니다. macOS는 macOS 전용 sandbox를 쓰고, Windows는 PowerShell + Windows 네이티브 sandbox를 씁니다. WSL 환경에서는 Linux sandbox로 전환됩니다. 터미널 선택지도 다릅니다. Windows는 PowerShell·CMD·Git Bash·WSL 중에서 고를 수 있습니다.
Q2. GPT-4o를 Codex에서 쓸 수 있나요?
안 됩니다. 공식 문서에 명확히 “GPT-4o is not available in Codex”라고 적혀 있습니다. Codex는 현재 GPT-5.1-Codex 모델 패밀리(Max가 기본, Mini 선택 가능)를 사용합니다. GPT-4o를 포함한 레거시 모델은 복원하거나 별도 구매할 수 없습니다. (출처: OpenAI Help Center)
Q3. Pro 플랜이 아니면 Codex를 제대로 못 쓰나요?
Plus($20/월)로도 정식으로 쓸 수 있습니다. 다만 한 번에 처리할 수 있는 Codex 메시지 수(사용 한도)가 작업 크기와 복잡도에 따라 달라지고, Pro가 한도가 더 높습니다. 간단한 스크립트나 작은 기능 구현은 Plus로 충분하지만, 대규모 리팩토링이나 장시간 에이전트 작업을 자주 한다면 한도에 빨리 닿을 수 있습니다. 크레딧을 추가 구매하는 “Auto top-up” 기능도 있어서 한도 초과 시 자동으로 충전되도록 설정할 수 있습니다.
Q4. Codex가 내 코드를 학습에 쓰나요?
플랜에 따라 다릅니다. Business·Enterprise·Edu는 기본적으로 학습에 사용하지 않습니다. Plus·Pro는 ChatGPT 데이터 컨트롤 설정에서 학습 옵션을 끄지 않으면 대화 내용이 모델 개선에 사용될 수 있습니다. 민감한 코드베이스를 다룬다면 설정을 먼저 확인하거나 Business 플랜을 고려하는 게 낫습니다. (출처: OpenAI Help Center)
Q5. Cursor·Windsurf와 비교하면 Codex 앱을 따로 쓸 이유가 있나요?
핵심 차이는 “병렬 에이전트 + worktree 분리”입니다. Cursor나 Windsurf는 에디터 안에서 하나의 에이전트와 작업하는 데 최적화돼 있습니다. Codex 앱은 여러 에이전트를 동시에 돌리면서 각각 다른 기능을 탐색하게 하고, 사람은 diff만 보고 판단하는 구조입니다. 코드 완성 보조가 주 목적이라면 Cursor·Windsurf가 더 자연스럽고, 반복 작업 자동화나 여러 PR을 병렬로 처리할 때는 Codex 앱이 유리합니다.

▲ 목차로 돌아가기

마치며 — 쓸 만한가, 아직 이른가?

직접 확인해본 소감을 솔직히 말하면, Codex 앱 Windows 버전은 “방향은 맞지만 지금 당장 전사 도입은 이르다”는 인상입니다. 핵심 기능인 병렬 에이전트와 worktree 분리, 그리고 PowerShell 네이티브 sandbox는 실제로 작동하고 생산성 이점도 있습니다. 하지만 WSL 전환 관련 이슈와 CLI·앱 간 설정 분리 문제는 아직 GitHub에서 진행 중인 버그입니다.

지금 도입하기 좋은 상황은 세 가지입니다. 첫째, 민감하지 않은 공개 프로젝트를 먼저 파일럿으로 써보는 경우. 둘째, CI/CD 파이프라인이 갖춰져서 에이전트가 만든 코드를 자동 검증할 수 있는 환경이 이미 있는 경우. 셋째, Plus 이상 플랜이 이미 있어서 추가 비용 없이 시도해볼 수 있는 경우. 반면 WSL 기반 개발 환경이 메인이거나, 규제 산업에서 코드 보안이 중요한 팀이라면 몇 가지 이슈가 더 안정될 때까지 기다리는 편이 낫습니다.

이 글은 2026년 3월 20일 기준 공식 문서와 GitHub Issues를 바탕으로 작성했습니다. Codex는 업데이트가 빠르게 이루어지는 서비스라 설치 전 최신 릴리즈 노트를 한 번 더 확인하는 걸 권장합니다.

▲ 목차로 돌아가기

본 포스팅 참고 자료

  1. OpenAI Developer Docs — Codex App Windows: https://developers.openai.com/codex/app/windows/
  2. OpenAI Help Center — Using Codex with your ChatGPT plan: https://help.openai.com/en/articles/11369540
  3. OpenAI ChatGPT Release Notes: https://help.openai.com/en/articles/6825453
  4. OpenAI Codex 공식 페이지: https://openai.com/ko-KR/codex/
  5. openai/codex GitHub Issues — Codex Windows WSL crash #13699: https://github.com/openai/codex/issues/13699

본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. OpenAI Codex는 업데이트 주기가 빠른 서비스이므로, 실제 사용 전 공식 문서에서 최신 내용을 확인하시기 바랍니다. 본 포스팅은 2026년 3월 20일 기준 공개 자료를 바탕으로 작성되었으며, 정확성 향상을 위해 최선을 다했으나 오류가 있을 수 있습니다.

댓글 남기기


최신 글


아이테크 어른경제에서 더 알아보기

지금 구독하여 계속 읽고 전체 아카이브에 액세스하세요.

계속 읽기