오픈AI 코덱스 PC버전 다운로드 및 설치방법 (CLI·VS Code·ChatGPT 앱)

2026년 10월 7일 · AI 도구 · 오픈AI 코덱스 공식 다운로드 안내

설치 전에 어떤 형태로 쓸지 정하기

오픈AI 코덱스는 설치 파일 하나로 끝나는 프로그램이 아니라 여러 형태로 제공됩니다. 터미널에서 쓰는 Codex CLI, VS Code 계열 에디터에 붙는 IDE 확장, ChatGPT 데스크톱 앱과 웹의 Codex 모드가 있고, 모두 같은 ChatGPT 계정으로 로그인합니다. 먼저 평소 작업 방식에 맞는 형태를 고르면 설치가 훨씬 간단해집니다.

계정도 미리 준비하세요. ChatGPT 계정으로 로그인하면 요금제에 포함된 사용량을 쓰고, OpenAI API 키로 로그인하면 API 사용량만큼 따로 과금됩니다. 무료 요금제에서는 제공 범위가 제한적이므로 요금제별 사용 가능 범위는 공식 요금 페이지에서 확인하세요.

터미널 중심으로 일한다면: Codex CLI
VS Code·Cursor·Windsurf 를 쓴다면: Codex IDE 확장
설치 없이 가볍게, 또는 여러 작업을 한 화면에서 관리하려면: ChatGPT 앱·웹의 Codex 모드
권장 준비물: Git(작업 전후 되돌리기용), 안정적인 인터넷 연결, 관리자 권한이 필요 없는 사용자 폴더

⚠ 주의검색 광고에 뜨는 'Codex 무료 다운로드', 'Codex PC버전 exe' 같은 파일은 공식이 아닙니다. Codex는 OpenAI 공식 페이지, 공식 설치 명령, npm 의 @openai/codex, Homebrew, GitHub openai/codex 릴리스로만 배포됩니다.

맥·리눅스에서 Codex CLI 설치하기

맥과 리눅스는 공식 설치 스크립트를 쓰는 방법이 가장 간단합니다. 설치 명령은 공식 문서의 CLI 설치 항목에 그대로 나와 있으니 복사해서 터미널에 붙여넣으세요. Homebrew 나 npm 을 이미 쓰고 있다면 패키지 관리자로 설치해도 됩니다.

터미널을 엽니다(맥은 응용 프로그램 > 유틸리티 > 터미널).
공식 문서의 맥·리눅스용 설치 스크립트 명령을 실행하거나, Homebrew 사용자는 brew install --cask codex 를 입력합니다.
npm 을 쓰는 경우 Node.js 가 설치된 상태에서 npm install -g @openai/codex 를 실행합니다.
설치가 끝나면 codex --version 으로 버전이 표시되는지 확인합니다.
작업할 프로젝트 폴더로 이동(cd 폴더경로)한 뒤 codex 를 실행합니다.

💡 팁npm 으로 설치할 때 권한 오류가 난다면 sudo 를 붙이기보다 Node 버전 관리자(nvm 등)로 사용자 폴더에 Node.js 를 설치해 쓰는 편이 안전합니다.

윈도우에서 Codex CLI 설치하기

윈도우는 공식 PowerShell 설치 명령을 제공합니다. 공식 문서의 Windows 항목에 있는 한 줄 명령을 PowerShell 에 붙여넣으면 설치가 진행됩니다. npm 설치도 가능하며, 리눅스 도구 위주로 개발한다면 WSL 안에서 리눅스용으로 설치해 쓰는 방법도 있습니다.

시작 메뉴에서 Windows PowerShell 또는 터미널 을 엽니다.
공식 문서의 윈도우용 설치 명령을 붙여넣고 실행합니다. npm 사용자는 npm install -g @openai/codex 를 실행해도 됩니다.
새 터미널 창을 열고 codex --version 으로 설치를 확인합니다.
프로젝트 폴더로 이동해 codex 를 실행합니다.
처음 실행 시 윈도우 샌드박스 설정 안내가 나오면 따르고, 나중에 다시 설정하려면 세션 안에서 /setup-default-sandbox 를 사용합니다.

VS Code·Cursor 에 IDE 확장 설치하기

에디터 안에서 쓰려면 확장만 설치하면 됩니다. VS Code, Cursor, Windsurf 는 같은 Codex 확장을 쓰고, JetBrains IDE 와 Xcode 는 각 IDE 가 제공하는 통합 기능에서 Codex를 선택합니다. 비주얼 스튜디오 코드 나 커서 를 이미 쓰고 있다면 가장 빠른 방법입니다.

에디터 왼쪽의 확장(Extensions) 보기를 엽니다(Ctrl+Shift+X, 맥은 Cmd+Shift+X).
Codex 를 검색해 게시자가 OpenAI 이고 식별자가 openai.chatgpt 인 확장을 설치합니다.
사이드바의 Codex 아이콘을 누릅니다. 보이지 않으면 명령 팔레트에서 Codex: Open Codex Sidebar 를 실행합니다.
Sign in with ChatGPT 를 눌러 브라우저에서 로그인하거나, API 키를 쓸 경우 Use API Key 를 선택합니다.

첫 로그인과 첫 작업

CLI를 처음 실행하면 로그인 방법을 묻습니다. Sign in with ChatGPT 를 고르면 브라우저가 열리고, 로그인을 마치면 터미널로 자동으로 돌아옵니다. 로그인 정보는 CLI와 IDE 확장이 함께 사용하므로 한쪽에서만 로그인해도 됩니다.

첫 요청은 파일을 바꾸지 않는 가벼운 것으로 시작하세요. "이 프로젝트 구조를 설명해 줘" 같은 질문으로 동작을 확인한 뒤, 작업 전후로 Git 커밋을 남겨 두면 결과가 마음에 들지 않을 때 쉽게 되돌릴 수 있습니다.

💡 팁원격 서버처럼 브라우저가 없는 환경에서는 codex login --device-auth 로 기기 코드 로그인을 사용할 수 있습니다. 이 방식은 ChatGPT 보안 설정에서 기기 코드 로그인을 허용해야 합니다.

설치가 안 될 때 확인할 것

설치 문제는 대부분 경로(PATH), 권한, 네트워크 중 하나입니다. 아래 항목을 차례로 점검하고, 해결되지 않으면 이 프로그램의 오류 해결 가이드를 참고하세요.

codex 명령을 찾을 수 없다고 나오면 터미널을 새로 열고, npm 설치라면 전역 설치 폴더가 PATH 에 포함돼 있는지 확인합니다.
회사 네트워크의 TLS 프록시 때문에 로그인이 실패하면 CODEX_CA_CERTIFICATE 환경 변수에 회사 루트 인증서 파일을 지정합니다.
설치 상태가 의심되면 codex doctor 로 설치·설정·인증 상태 진단 보고서를 받아 봅니다.
IDE 확장이 보이지 않으면 에디터를 다시 시작하고 확장 식별자가 openai.chatgpt 인지 확인합니다.

⬇ 공식 사이트에서 코덱스 다운로드

openai.com 공식 페이지로 이동합니다 · 무료(부분 유료) · Windows · macOS · Linux · 웹 · iOS

자주 묻는 질문

Q. Codex를 쓰려면 ChatGPT 유료 요금제가 꼭 필요한가요?

무료 요금제에서도 제한적으로 체험할 수 있지만, CLI·IDE 확장·클라우드 기능을 꾸준히 쓰려면 유료 요금제나 API 키가 필요합니다. 제공 범위는 수시로 바뀌므로 공식 요금 페이지를 확인하세요.

Q. npm 설치와 공식 설치 스크립트 중 무엇이 좋나요?

둘 다 공식 배포 경로입니다. Node.js 를 따로 관리하고 싶지 않다면 공식 설치 스크립트나 Homebrew 가 간단하고, 이미 npm 으로 개발 도구를 관리한다면 npm install -g @openai/codex 가 편합니다.

작성·관리 공식유틸 다운로드 운영자 · 작성 기준과 정정 절차 · 오류 제보