본문으로 건너뛰기
Codex DesignBETA

Codex 다운로드 및 설치 방법.

Codex는 OpenAI의 코딩 에이전트입니다. ChatGPT 데스크톱 앱, 터미널의 Codex CLI, 코드 에디터에서 쓸 수 있습니다. 이 가이드는 OpenAI의 공식 다운로드 링크만 안내하고 설치 과정을 하나씩 설명합니다. Codex Design은 Codex용 독립 플러그인이며, OpenAI 웹사이트가 아닙니다.

2026년 11월 6일 업데이트 · 6분 분량

어떤 Codex를 설치해야 할까?

옵션지원 환경추천 대상
ChatGPT 데스크톱 앱macOS, Windows, Linux(프리뷰)대부분의 사용자: 프로젝트, 로컬 파일, Codex를 앱 하나에서
Codex CLImacOS, Linux, Windows의 터미널터미널에서 작업하거나 작업을 자동화하는 개발자
Codex IDE 확장 프로그램VS Code, Cursor, Windsurf코드 옆에서 Codex와 함께 작업
웹 버전 ChatGPT모든 브라우저(chatgpt.com)설치 불필요, 클라우드 작업

Codex의 공식 페이지는 openai.com/codex와 chatgpt.com/codex입니다. 반드시 OpenAI에서만 다운로드하세요.

ChatGPT 데스크톱 앱 설치하기(Codex 포함)

Codex는 ChatGPT 데스크톱 앱 안에서 실행됩니다. OpenAI 공식 페이지 chatgpt.com/download에서 다운로드하세요.

  • Mac: Codex 페이지의 macOS 다운로드는 Apple Silicon용입니다. 다운로드한 파일을 열고 앱을 응용 프로그램 폴더로 드래그하세요.
  • Windows: Microsoft Store에서 ChatGPT 데스크톱 앱을 설치하세요. 명령줄이 편하다면 PowerShell에서 다음을 실행하세요.
winget install --id 9PLM9XGG6VKS -s msstore
  • Linux(프리뷰): OpenAI는 Ubuntu 24.04·26.04와 Debian 13용 .deb 패키지, Fedora 43·44용 .rpm 패키지, Arch Linux용 설치 스크립트를 x64와 ARM64용으로 각각 제공합니다. OpenAI의 Linux 데스크톱 앱 가이드를 따르세요.

그다음:

  1. 앱을 열고 ChatGPT 계정으로 로그인합니다. API 키로도 Codex를 쓸 수 있지만 일부 기능은 사용하지 못할 수 있습니다.
  2. ChatGPT 드롭다운에서 Codex를 선택해 코드 작업을 시작합니다. Codex가 파일을 읽고 수정할 수 있도록 프로젝트 폴더를 엽니다.
  3. 첫 작업을 보냅니다. 예: “이 프로젝트에 대해 설명해 줘.”

Codex CLI 설치하기

방법을 하나 고르세요. 방법마다 대응하는 업데이트 명령어가 있습니다.

macOS와 Linux(단독 설치 프로그램):

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows(새 PowerShell 창에서):

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

npm:

npm install -g @openai/codex

Homebrew:

brew install --cask codex

업데이트하려면 같은 설치 명령어를 다시 실행하세요. npm은 npm install -g @openai/codex를 다시 실행하고, Homebrew는 brew upgrade --cask codex를 실행합니다.

그다음 프로젝트 디렉터리를 열고 codex를 실행한 뒤 Sign in with ChatGPT(ChatGPT로 로그인)나 다른 로그인 방법을 고르세요.

cd my-project
codex

IDE 확장 프로그램 설치하기

  • VS Code, Cursor, Windsurf: VS Code Marketplace나 에디터의 확장 프로그램 화면에서 Codex 확장 프로그램을 설치한 다음 Codex 아이콘을 선택하세요. 아이콘이 보이지 않으면 명령 팔레트에서 Codex: Open Codex Sidebar를 실행하세요.
  • Xcode와 JetBrains IDE: 각각 자체 Codex 연동 기능이 있습니다. Xcode에서는 코딩 어시스턴트의 에이전트로 Codex를 고르고, JetBrains IDE에서는 AI Chat을 열어 Codex를 선택하세요.

문제 해결

  • CLI 설치 후 codex: command not found가 나올 때. 셸이 새 명령어를 인식하도록 새 터미널 창을 열고 다시 시도하세요.
  • Windows 설치 스크립트가 실행되지 않을 때. OpenAI 안내대로 새 PowerShell 창에서 실행하세요.
  • 제대로 설치됐는지 모르겠다면? 프로젝트 폴더에서 codex를 실행하고 “이 프로젝트에 대해 설명해 줘”라고 물어보세요. Codex가 답하면 준비가 끝난 것입니다.

설치한 다음: 디자인 캔버스 추가하기

Codex는 화면을 코딩할 뿐 아니라 디자인도 할 수 있습니다. Codex Design은 Codex에 비주얼 캔버스를 더하는 독립 플러그인입니다. 화면과 레퍼런스 이미지를 나란히 놓고 폰트, 색상, 간격을 시각적으로 수정할 수 있습니다. 프롬프트 하나로 설치되며(설치 가이드 참고), ChatGPT 데스크톱 앱과 Codex CLI에서 작동합니다.

자주 묻는 질문

Codex 공식 웹사이트는 어디인가요?

openai.com/codex와 chatgpt.com/codex입니다. 데스크톱 앱은 chatgpt.com/download에서 다운로드할 수 있습니다. codexdesign.io는 OpenAI와 관련이 없습니다.

Codex 앱과 ChatGPT는 같은 건가요?

Codex 앱은 이제 ChatGPT 데스크톱 앱의 일부입니다. ChatGPT를 설치해 로그인하고, 코딩 작업에는 Codex를 선택하세요.

데스크톱 앱이 있으면 CLI도 필요한가요?

아니요. 터미널에서 작업하는 편이 좋거나 스크립트에서 Codex를 실행하고 싶을 때 CLI를 쓰세요.

더 읽어 보기

Codex용 독립 플러그인입니다. OpenAI와 제휴하거나 OpenAI의 보증을 받은 제품이 아닙니다.