코덱스 CLI 윈도우 설치 방법: PowerShell 한 줄이면 끝

"codex 윈도우 설치"라고 검색해 보신 적 있으신가요? WSL(윈도우용 리눅스 서브시스템)부터 깔아야 한다는 글과 바로 된다는 글이 섞여 나옵니다. 결론부터 말하면 지금은 WSL 없이 됩니다. PowerShell에 아래 한 줄을 치면 끝입니다.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

PowerShell을 한 번도 안 열어보셨어도 괜찮습니다. 이 글은 다섯 단계를 그대로 따라 하도록 만들었습니다. PowerShell 실행, 설치 명령어 입력, 설치 확인, 로그인, 첫 부탁까지입니다.

단계마다 "이렇게 보이면 성공"을 함께 적어 두었으니 화면과 비교하며 내려가시면 됩니다. 설치 명령어는 유통기한이 짧은 정보라서 막히면 공식 문서를 한 번 더 확인하시길 권합니다.

Codex CLI

Codex CLI(코덱스 CLI)란 명령어 창에서 말로 일을 시키는 OpenAI(오픈AI)의 AI 도구입니다. 내 컴퓨터 안의 파일을 직접 읽고 정리하고 고쳐 줍니다.

준비물: 계정과 윈도우 11

준비물은 두 가지입니다. ChatGPT(챗지피티) 계정, 그리고 윈도우 버전 확인입니다.

공식 요금 안내는 Codex(코덱스)가 무료(Free) 플랜을 포함해 ChatGPT 전 플랜에 들어 있다고 명시합니다.

다만 터미널용 Codex CLI는 사정이 다릅니다. 같은 문서의 기능표에서 CLI가 표시되는 것은 Plus 플랜부터이고 Free와 Go 카드에는 나열돼 있지 않습니다. 설치는 명령어 한 줄이고 되돌리기도 쉬우니 직접 로그인해 보시는 편이 빠릅니다. 막힌다면 Plus가 확실한 진입선입니다.

공식 문서는 윈도우 11을 권장합니다. 윈도우 10이라면 최신 업데이트를 먼저 받아 두세요.

맥을 쓰고 계시다면 설치 명령어가 다릅니다. 코덱스 CLI 맥 설치 방법에 따로 정리해 두었습니다.

스텝 1: PowerShell 실행

시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 터미널을 선택합니다. 윈도우 10에서는 시작 메뉴 검색창에 PowerShell을 입력하고 Windows PowerShell을 실행합니다.

이렇게 보이면 성공입니다. 까만(또는 파란) 창이 뜨고 첫 줄이 PS로 시작합니다. 이 창이 오늘 작업대입니다.

스텝 2: 설치 명령어 입력

아래 한 줄을 그대로 복사해 PowerShell 창에 붙여넣고 Enter를 누릅니다.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

이미 PowerShell을 열어 뒀는데 명령어가 또 powershell로 시작합니다. 앞부분은 이 한 번의 설치에만 스크립트 실행을 허용한다는 뜻이고 컴퓨터 설정을 바꾸지는 않습니다.

나머지가 하는 일은 하나입니다. OpenAI의 공식 설치 스크립트를 내려받아 실행합니다. 스크립트는 codex 실행 파일을 정해진 폴더(%LOCALAPPDATA%\Programs\OpenAI\Codex\bin)에 넣고 그 위치를 내 계정에 등록(PATH 등록)까지 해 줍니다. 이사할 때 짐만 옮기는 게 아니라 주소 이전 신고까지 마쳐 주는 셈입니다.

이렇게 보이면 성공입니다. ==>로 시작하는 진행 줄이 몇 개 지나간 뒤 Codex CLI 0.153.4 installed successfully. 같은 완료 안내가 뜹니다.

진행률 막대는 나오지 않으니 화면이 조용해도 정상입니다. 이어서 Start Codex now? [y/N]:이라고 물어보면 그냥 Enter를 눌러 넘어갑니다. 다음 스텝에서 새 창을 열어 확인할 차례입니다.

바탕화면에 아이콘은 생기지 않습니다. 터미널에서만 쓰는 도구라 원래 없습니다.

여기서 설치가 멈추거나 백신 경고가 뜨면 아래 「막히면 여기부터」로 가시면 됩니다.

스텝 3: 새 창에서 설치 확인

지금 열려 있는 PowerShell 창을 완전히 닫고 스텝 1과 같은 방법으로 새 창을 엽니다. 방금 한 등록이 새로 여는 창부터 적용되기 때문입니다. 새 창에 아래를 입력합니다.

codex --version

이렇게 보이면 성공입니다.

codex-cli 0.153.4

버전 숫자는 설치 시점마다 다르게 나옵니다. 숫자보다 codex-cli라는 문구가 뜨는지가 중요합니다. 그게 뜨면 설치는 정상입니다.

스텝 4: ChatGPT 계정 로그인

같은 창에 이번엔 이렇게만 입력합니다.

codex

로그인 방법을 고르는 화면이 뜹니다. 여기서는 마우스 클릭이 안 됩니다. 위아래 화살표 키로 Sign in with ChatGPT에 커서를 옮기고 Enter를 누릅니다.

브라우저가 자동으로 열립니다. 평소 쓰는 ChatGPT 계정으로 로그인하면 창이 다시 PowerShell로 이어집니다. 한 번 로그인하면 컴퓨터에 저장되니 다음부터는 이 단계가 없습니다.

이렇게 보이면 성공입니다. PowerShell 안에 Codex의 대화 입력창이 뜹니다.

스텝 5: 첫 부탁 한 문장

입력창에 코드가 아니라 그냥 말을 적으면 됩니다. 이렇게 물어보세요.

이 폴더에 어떤 파일이 있는지 정리해 줘

Codex는 지금 창이 열려 있는 폴더를 읽습니다. 따로 고른 적이 없다면 보통 내 사용자 폴더입니다.

이렇게 보이면 성공입니다. 파일 이름 목록이 나오고 그 아래에 무슨 파일인지 정리한 설명이 붙습니다. 여기까지 오셨으면 오늘 할 일은 끝났습니다.

나중에 버전을 올리고 싶을 때는 codex update 한 줄이면 됩니다. 터미널과 PowerShell 환경 자체를 기초부터 쌓고 싶으시면 AI CLI 트랙이 여섯 편으로 준비돼 있습니다.

막히면 여기부터: is not recognized와 실행 정책, 백신

증상별로 정리했습니다. 화면에 뜬 문구와 같은 줄을 찾아 그 아래만 보시면 됩니다.

codex를 쳤는데 "is not recognized"가 뜹니다. 대부분 창 때문입니다. 등록은 새로 여는 창부터 적용되므로 설치할 때 쓰던 창에서는 못 찾습니다. PowerShell을 완전히 닫고 새 창을 열어 다시 쳐보세요.

"running scripts is disabled on this system"이 뜹니다. 이 글의 공식 설치 스크립트로 설치했다면 만나지 않는 오류입니다. 예전에 npm이라는 개발 도구로 Codex를 설치한 적이 있는 컴퓨터에서 나옵니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser를 실행하면 해결됩니다. 이 글의 설치 명령어로 다시 설치해도 됩니다.

백신이 설치를 막습니다. 개발사 공식 저장소의 한 이슈에 맥아피 사례가 있습니다. 설치 스크립트를 파일 없는 악성코드로 오판해 격리한 기록입니다. 같은 저장소에는 노턴과 비트디펜더가 Codex 실행 중 PowerShell을 막았다는 보고도 있습니다.

개인 PC라면 백신 프로그램의 설정에서 실시간 검사를 잠깐 끄고 설치한 뒤 다시 켭니다. 회사 PC라면 IT 담당자에게 예외 처리를 요청해야 합니다.

The property 'OSArchitecture' cannot be found on this object가 뜹니다. 윈도우 10 기본 PowerShell인 5.1에서 컴퓨터 구조를 확인하는 단계에 걸린 것입니다. 같은 저장소의 다른 이슈에 보고돼 있고 스크립트에는 아직 고쳐지지 않았습니다.

이때는 PowerShell 7이 필요합니다. 스텝 1에서 연 창과는 다른 프로그램이라 따로 받아야 합니다. 시작 메뉴에서 Microsoft Store를 열고 PowerShell을 검색해 설치하면 됩니다. 설치 후 시작 메뉴에서 PowerShell 7을 열고 같은 설치 명령을 다시 실행하면 지나간다는 보고가 있습니다.

설치가 두 번 된 것 같습니다. npm으로 설치한 적이 있는 컴퓨터에서 이 글의 방법으로 또 설치하면 같은 이름의 codex가 두 개가 됩니다. Get-Command codex를 치면 지금 실행되는 쪽의 위치가 나옵니다. npm 쪽을 지우려면 npm uninstall -g @openai/codex를 실행하면 됩니다.

원인을 모르겠습니다. codex doctor를 치면 설치, 설정, 로그인 상태를 점검해 줍니다.