코덱스(Codex) CLI 설치 방법과 사용법: 윈도우 한 줄 설치

코덱스 CLI(Codex CLI)는 터미널에서 한국어로 요청하면 파일을 읽고 수정하거나 명령을 실행하는 OpenAI의 도구입니다.

이 글에서는 설치 후 연습 폴더에 메모 하나를 만들어 직접 확인하고, 같은 폴더에서 해 볼 만한 간단한 일 세 가지까지 해 봅니다. 웹사이트 제작이나 프로그램 개발은 아직 하지 않습니다. 맥을 쓴다면 맥 설치 안내로 이동합니다. 기능과 요금 설명은 2026년 10월 4일 공식 안내 기준입니다.

터미널에서 AI 도구를 쓰면 달라지는 세 가지

터미널은 글자로 명령을 입력해 컴퓨터를 조작하는 프로그램입니다. 윈도우에서는 PowerShell이 이 역할을 합니다. 윈도우 11의 터미널 앱을 열면 그 안에서 PowerShell이 실행되기도 합니다. 폴더를 만들거나 파일 내용을 볼 때 마우스로 하던 일을 한 줄 명령으로 처리합니다. CLI(Command Line Interface)는 이렇게 터미널에서 실행하는 프로그램을 말합니다. Codex도 CLI 프로그램입니다.

AI가 글을 읽고 분석하고 쓰는 능력은 웹 채팅과 같습니다. 달라지는 것은 자료가 들어가는 길, 결과가 남는 곳, AI가 실행할 수 있는 일입니다.

웹 채팅도 드라이브 같은 서비스를 연결하면 파일을 다룹니다. 그래서 웹은 대화만 되고 터미널은 실행까지 된다고 나누기보다, 무엇이 연결되고 어디까지 허용됐는지로 구분하는 편이 정확합니다. 터미널 도구는 내 컴퓨터의 폴더 하나를 작업 공간으로 정하고 그 안에서 일한다는 점이 가장 큰 차이입니다.

요청 한 번이 진행되는 순서

1. 요청: 사람이 할 일을 평소 말로 적습니다. 명령어를 외울 필요는 없습니다.
2. 읽기: AI가 작업 폴더에서 필요한 파일을 엽니다.
3. 작업과 저장: AI가 내용을 정리해 파일을 만들거나 고칩니다. 권한 설정에 따라 저장 전에 승인을 묻거나, 작업 폴더 안의 파일은 바로 저장합니다.
4. 완료 보고: AI가 무엇을 읽고 어떤 파일을 만들었는지 알려 줍니다.
5. 사람의 확인: 완료라는 답만 보고 끝내지 않고 실제 파일을 열어 내용을 대조합니다.

마지막 단계가 빠지면 AI가 다른 폴더에 저장했거나 요청과 다르게 쓴 경우를 놓칩니다. 아래 실습에서도 단계마다 결과 파일을 직접 열어 확인합니다.

입력하는 곳이 두 군데입니다

AI에게 할 요청을 PowerShell 명령 입력줄에 넣거나, 터미널 명령을 Codex 입력칸에 넣으면 의도와 다르게 동작합니다. 이 글의 각 단계에는 어디에 입력하는지 함께 적었습니다.

한눈에 보는 순서

먼저 계정과 연습 목표를 확인합니다

ChatGPT 계정으로 CLI를 쓰려면 공식 요금 안내에서 CLI가 포함된 Plus 이상의 지원 플랜이 필요합니다. API 키로도 사용할 수 있지만 API 비용은 구독과 별도입니다. Free와 Go의 데스크톱 앱 제공 범위를 CLI 제공으로 혼동하지 마세요. 회사 계정은 관리자 설정도 확인합니다. 자세한 조건은 공식 요금 안내에 있습니다.

이번 목표는 codex-note.md에 두 줄을 만들고, 그중 한 줄만 수정하는 것입니다. AI의 완료 답변을 보는 것에서 끝내지 않고 파일 탐색기와 PowerShell에서 실제 결과를 확인합니다.

1. PowerShell을 열고 설치합니다

Windows 키를 누르고 PowerShell을 검색해 일반 실행으로 엽니다. PowerShell은 명령을 입력하는 프로그램입니다. PS C:\Users\사용자이름> 같은 줄이 보이면 준비된 것입니다. 설치 프로그램은 사용자 폴더에 설치하므로 처음부터 관리자 창을 열 필요는 없습니다.

아래는 OpenAI 공식 저장소가 안내하는 설치 명령입니다. PowerShell에 한 줄로 붙여 넣고 Enter를 누릅니다.

irm은 스크립트를 내려받고 iex는 그 내용을 실행합니다. -ExecutionPolicy ByPass는 이때 시작하는 PowerShell 프로세스의 실행 정책을 지정합니다. 시스템 전체 정책을 영구 변경하는 명령은 아니며, 회사의 관리 정책을 해제하지도 않습니다. Node.js를 별도로 설치할 필요는 없습니다.

기본 실행 파일 위치는 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin입니다. %LOCALAPPDATA%는 사용자별 앱 데이터 폴더를 뜻합니다. 설치 후 시작 메뉴에서 PowerShell을 새로 열고 아래 명령을 입력합니다. 다른 작업 중인 창을 모두 닫을 필요는 없습니다.

버전 번호가 나오면 설치 파일을 실행할 수 있는 상태입니다. 과거 만화의 번호와 같을 필요는 없습니다. 명령을 찾지 못한다면 아래 오류 해결 절에서 파일 경로부터 확인합니다.

이미 npm으로 Codex를 관리한다면 기존 설치 방식을 유지할 수 있습니다. 두 설치 방법을 연달아 실행할 필요는 없습니다. 공식 설치 명령은 업데이트에도 사용할 수 있고, 자체 갱신이 가능한 설치본에서는 codex update도 지원합니다.

2. 연습 폴더를 만든 뒤 로그인합니다

아래 명령을 한 줄씩 실행합니다. 첫 줄은 연습 폴더를 만들고, 둘째 줄은 그 위치로 이동하며, 셋째 줄은 현재 위치를 보여 줍니다.

$HOME은 사용자 홈 폴더입니다. 결과 경로 끝이 Projects\codex-practice인지 확인합니다. 폴더 이동에 오류가 나면 다음 단계로 넘어가지 말고 오류와 경로를 확인합니다.

같은 PowerShell에서 아래 명령으로 파일 탐색기를 엽니다.

이 폴더에 중요한 자료나 같은 이름의 연습 파일이 있다면 다른 새 폴더를 사용합니다. 준비됐으면 입력합니다.

처음에는 Sign in with ChatGPT를 선택하고 브라우저에서 로그인합니다. 터미널로 돌아온 뒤 표시된 작업 폴더를 확인합니다. 브라우저가 열리지 않으면 화면이 안내하는 주소를 직접 열 수 있습니다. 로그인 코드와 인증 주소는 공유하지 않습니다.

설치와 샌드박스 설정은 다른 단계입니다

샌드박스는 AI가 실행하는 명령의 파일 접근과 네트워크 사용 범위를 제한하는 기능입니다. CLI 설치는 일반 사용자로 할 수 있지만, 권장 Windows 샌드박스의 초기 설정에는 관리자 승인이 필요할 수 있습니다. 자신이 시작한 Codex 설정 과정인지 확인한 뒤 권한이 있는 환경에서 진행합니다.

회사 PC에서 승인이 막힌다면 담당자에게 오류와 설정 요구를 확인합니다. 기본 설정을 사용할 수 없는 환경을 위한 unelevated 방식도 있지만 보호 방식이 다르고 조직 정책에서 금지할 수 있습니다. Full Access는 파일과 명령 실행의 제한을 크게 푸는 권한입니다. 설정 오류를 해결하려고 곧바로 이 모드로 바꾸지는 않습니다. 현재 상태와 허용된 설정은 공식 Windows 샌드박스 안내를 참고합니다.

3. AI 대화 입력칸에 메모 생성을 요청합니다

이제부터는 일반 터미널 명령 대신 Codex의 대화 입력칸에 한국어 요청을 넣습니다.

작업 전 권한을 묻는다면 대상 파일과 실행 내용을 읽습니다. 권한 설정에 따라 일부 동작은 매번 묻지 않고 진행할 수 있으므로 화면의 /permissions에서 현재 범위를 확인할 수 있습니다. 첫 연습을 위해 권한을 더 넓힐 필요는 없습니다.

완료 답변을 받은 뒤 파일 탐색기에서 codex-note.md가 생겼는지 확인합니다. 기본 앱이 없어 내용을 열기 어렵다면 Codex 대화 입력칸에 /exit를 입력해 종료하고 같은 PowerShell에서 읽습니다.

독서: 10분, 산책: 20분이 각각 한 줄로 나와야 합니다. 파일이 없다는 오류가 나오면 Get-Location으로 현재 위치를 확인하고 파일 탐색기에서 실제 이름을 봅니다. 위 명령은 파일을 수정하지 않습니다. 한글이 깨진다면 파일이 존재하는지 확인한 뒤 notepad .\codex-note.md로 메모장에서 읽어 보고 저장 인코딩을 확인합니다. 이름이 헷갈리면 파일 탐색기에서 파일 확장자 표시를 켜 codex-note.md.txt처럼 저장되지 않았는지도 봅니다.

4. 한 줄만 수정하고 다시 확인합니다

Codex를 종료했다면 같은 연습 폴더에서 codex로 다시 실행합니다. 대화 입력칸에 아래 요청을 넣습니다.

완료 후 파일을 다시 열어 독서: 10분, 산책: 30분인지 봅니다. 독서 시간까지 바뀌었다면 “독서는 10분으로 복구하고 산책은 30분으로 유지해 줘.”라고 요청하고 확인합니다.

혼자 반복할 때는 독서만 15분으로 바꿔 보세요. 산책 30분이 유지되는지 확인하면 파일 생성, 일부 수정, 결과 대조를 한 번씩 경험한 것입니다. 이런 AI 요청에는 사용 중인 계정의 사용량이 적용됩니다.

작업 폴더에서 해 볼 만한 간단한 일 세 가지

첫 메모를 확인했다면 같은 연습 폴더에서 실제 업무에 조금 더 가까운 일을 맡겨 봅니다. 세 가지 모두 원문이 짧아서 AI의 결과가 맞는지 사람이 바로 대조할 수 있는 일입니다. 요청은 Codex 입력칸에 넣고, 확인 명령은 PowerShell에서 실행합니다. PowerShell 창을 하나 더 열고 Set-Location "$HOME\Projects\codex-practice"로 연습 폴더에 들어가면 Codex 화면을 닫지 않고도 결과를 확인할 수 있습니다. 요청마다 계정 사용량이 쓰입니다.

1. 회의 메모를 할 일 표로 정리하기

먼저 연습용 원문을 파일로 만듭니다. Codex 입력칸에 아래 요청을 넣습니다.

이어서 정리를 요청합니다.

PowerShell에서 결과를 엽니다.

표의 세 줄이 원문의 세 항목과 같은지 봅니다. 인쇄 업체 견적은 원문에 담당자와 날짜가 없으므로 둘 다 '미정'이어야 합니다. 여기에 이름이나 날짜가 채워져 있다면 AI가 원문에 없는 내용을 만든 것이므로 "견적 항목의 담당자와 마감은 원문에 없으니 미정으로 고쳐줘"라고 다시 요청합니다.

2. 두 파일을 비교해 바뀐 점만 정리하기

이번에는 사람이 직접 한 곳을 고치고, AI가 그 변화를 찾는지 확인합니다. Codex 입력칸에 요청합니다.

PowerShell에서 복사본을 메모장으로 엽니다.

10월 15일을 10월 17일로 직접 고치고 저장한 뒤 편집기를 닫습니다. 다시 Codex 입력칸에 요청합니다.

정답을 이미 알고 있는 비교입니다. 소식지 초안의 마감이 10월 15일에서 10월 17일로 바뀐 한 줄만 있어야 합니다. 다른 줄이 섞여 있거나 날짜가 다르면 그 부분을 짚어 다시 요청합니다. 실제 업무에서 공지나 계약서의 이전 판과 새 판을 비교할 때도 같은 방식으로 요청하고 확인합니다.

3. 폴더의 파일 목록 만들기

PowerShell에서 실제 파일 목록과 결과를 차례로 봅니다.

첫 명령이 보여 주는 파일 이름이 index.md에 모두 있는지 대조합니다. index.md 자신은 목록에 없어도 됩니다. 빠진 파일이 있거나 없는 파일이 들어 있으면 그 이름을 알려 주고 고쳐 달라고 합니다.

세 가지 모두 원문을 주고, AI가 정리해 파일로 저장하고, 사람이 원문과 대조하는 순서입니다. 익숙해지면 실제 업무 자료의 복사본을 새 작업 폴더에 넣고 같은 방식으로 요청해 봅니다. 원본 대신 복사본으로 시작하면 요청이 잘못돼도 원본은 그대로 남습니다. 회사 자료라면 외부 AI 서비스에 넣어도 되는지 조직의 기준을 먼저 확인합니다.

모델과 추론 깊이는 첫 작업 뒤에 확인해도 됩니다

모델은 요청을 처리하는 AI의 종류이고, 추론 깊이는 답을 준비할 때 얼마나 많은 계산을 할지 조절하는 값입니다. 첫 메모 연습은 현재 선택된 설정으로 시작해도 됩니다.

Codex 대화 입력칸에서 /model을 입력하면 계정과 환경에서 쓸 수 있는 모델이 나옵니다. 2026년 10월 4일 문서의 주요 예시는 gpt-6.1-sol과 gpt-6-luna이며, 계정에 따라 Astra 등 다른 선택지도 있습니다. 특정 모델이 목록에 없다고 설치 실패는 아닙니다. 선택한 뒤 /status로 현재 모델을 확인합니다.

추론 깊이는 모델이 지원하는 항목 중에서 고릅니다. 기본값을 모든 계정에서 medium이라고 단정할 수는 없습니다. 어려운 작업에서 결과가 부족할 때 조정하고, 시간과 사용량이 얼마나 달라지는지 함께 봅니다. 처음부터 Max나 Ultra를 선택할 필요는 없습니다. 더 자세한 모델 선택은 공식 모델 안내를 참고합니다.

자주 묻는 질문

어떤 Windows 버전에서 시작하나요?

공식 안내는 Windows 11을 권장합니다. 최신 업데이트가 적용된 Windows 10은 제한적인 최선 노력 지원이며, 실제로는 1809 이상이 필요하다고 안내합니다. 모든 PC에서의 정상 동작을 보장하는 뜻은 아닙니다. PowerShell에서 winver를 입력하면 Windows 버전 창이 열립니다. 공식 안내가 전제하는 패키지 관리 프로그램은 winget --version으로 확인합니다. 이 명령을 찾지 못하면 Windows 업데이트나 Windows 패키지 관리자 설치 상태를 확인하고, 회사 PC에서는 담당자에게 문의합니다.

WSL도 설치해야 하나요?

이 글의 Windows 기본 설치에는 필요하지 않습니다. WSL은 Windows에서 Linux 환경을 쓰는 기능이며, Linux 도구가 필요한 프로젝트에서 별도로 선택할 수 있습니다.

유료 ChatGPT 구독이 꼭 필요한가요?

ChatGPT 로그인 방식으로 CLI를 사용하는 플랜과 API 키 방식은 별개입니다. 개인용 Plus는 월 20달러이고 Pro는 월 100, 200, 500달러 선택지가 안내돼 있습니다. 실제 결제 금액과 제공 모델은 계정과 지역, 세금, 관리자 설정에 따라 확인해야 합니다. 메모 연습을 위해 Pro로 바꿀 필요는 없습니다.

Claude Code와 함께 설치해도 되나요?

명령 이름이 claude와 codex로 다르고 설정도 따로 관리합니다. 같은 파일을 동시에 고치는 상황을 피하고, 작업을 넘길 때 결과를 먼저 확인합니다. 두 도구를 순서대로 사용하는 연습에 예시가 있습니다.

설치 중 막히면 이렇게 확인합니다

codex가 명령 이름으로 인식되지 않습니다

새 PowerShell 창에서 codex --version을 다시 실행합니다. 그래도 같으면 기본 설치 위치에 파일이 있는지 확인합니다.

True라면 전체 경로로 버전을 확인합니다. 앞의 &는 따옴표 안의 경로를 프로그램으로 실행하라는 뜻입니다.

전체 경로로는 실행된다면 PATH, 즉 명령을 찾는 폴더 목록을 확인할 차례입니다. 시작 메뉴에서 계정의 환경 변수 편집을 검색해 사용자 변수의 Path에 위 bin 폴더 경로가 있는지 봅니다. 없다면 새 항목에 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin을 추가합니다. 이 창에는 PowerShell의 $env: 표기를 넣지 않습니다. 기존 항목이나 전체 Path 값을 지우지 않습니다. 저장 후 새 PowerShell에서 다시 확인합니다.

False라면 PATH를 추가하지 말고 설치 마지막 오류와 실제 설치 위치부터 확인합니다. 설치할 때 경로를 따로 지정했다면 그 위치를 사용해야 합니다.

다른 버전의 Codex가 실행됩니다

여러 경로가 나오면 설치 방식이 둘 이상인지 확인합니다. 삭제 명령부터 실행하지 말고 어느 방식으로 관리할지 정한 뒤 해당 경로의 버전을 봅니다.

명령은 실행되지만 로그인이나 설정 오류가 납니다

Codex를 종료한 일반 PowerShell에서 다음을 실행합니다.

진단 결과 중 실패한 항목과 오류 문구를 확인합니다. 샌드박스 오류라면 Windows 버전, 관리자 승인 여부, 회사 정책을 구분해 확인합니다. 회사의 접속 제한은 임의로 우회하지 말고 담당자에게 허용된 방법을 확인합니다. 도움을 요청할 때 로그인 코드나 .sandbox-secrets 폴더 내용은 보내지 않습니다.

8컷 만화로 정리한 코덱스 CLI 설치 순서

이 만화는 2026년 9월 23일 당시 안내입니다. 현재 모델과 추론 기본값은 계정마다 다릅니다. 7컷의 진단 명령은 codex가 실행되는 상태에서 사용합니다. 명령을 못 찾는 상태라면 먼저 본문의 설치 파일과 경로 확인을 따릅니다. 작업 폴더 밖 접근과 승인 여부도 현재 권한 설정에 따라 달라집니다. 실제 실습은 본문처럼 연습 폴더를 먼저 연 다음 진행합니다.

그림은 DGX Spark에서 Qwen-Image-2.1로 그렸고, 대사는 글과 대조해 따로 얹었습니다. 명령어와 버전은 2026년 9월 23일, 코덱스 CLI 0.156.1 기준입니다. 초록 로봇은 코덱스를 사람처럼 그린 것입니다.

만화 대사 전문

1. (2026년 9월 23일, 코덱스 CLI 0.156.1 기준) 민준: 윈도우에 코덱스 CLI를 깔고 싶은데 PowerShell이 낯설어요. / 준이아빠: 클릭 대신 짧은 명령 한 줄로 일을 시킨다는 것만 달라요.
2. (관리자 권한도, Node.js도 필요 없다) 준이아빠: PowerShell에 설치 명령 한 줄만 붙여 넣으면 돼요. / 민준: 관리자 권한으로 열지 않아도 돼요? / 준이아빠: 사용자 폴더에만 설치해서 그럴 필요 없어요.
3. 준이아빠: 설치가 끝나면 창을 새로 열고 codex --version을 입력해 보세요. / 민준: 버전 번호가 나왔어요!
4. (CLI는 Plus 이상 플랜에 포함) 민준: codex를 실행하니까 브라우저가 열려요. / 준이아빠: 거기서 ChatGPT 계정으로 로그인하면 돼요.
5. (코덱스는 지금 있는 폴더 안에서 일한다) 민준: 이 폴더에 오늘 할 일을 적는 메모 파일을 하나 만들어 줘. / 코덱스: 파일을 만들어도 될까요? / 준이아빠: 한국어로 부탁하면 답도 한국어로 와요.
6. (추론 깊이 기본값은 medium) 준이아빠: 모델과 추론 깊이는 /model에서 고르면 돼요. / 민준: 추론 깊이는 늘 가장 깊게 두는 게 좋지 않아요? / 준이아빠: 그러면 답이 늦어지고 사용량도 빨리 줄어요.
7. (막히면 codex doctor부터) 민준: 그런데 codex가 인식되지 않는다고 나와요. / 준이아빠: 창을 모두 닫고 새로 열어 보세요. 그래도 안 되면 codex doctor를 돌려요.
8. (실제 업무 폴더보다 연습 폴더에서 먼저) 민준: 처음엔 연습 폴더에서 몇 번 써 볼게요. / 준이아빠: 그러면 어디까지 맡겨도 될지 감이 와요.

참고 자료

• 공식 설치 명령
• Codex CLI 시작
• 설치 경로
• Windows 샌드박스
• 명령과 진단 기능