Codex 데스크톱 앱 설치하기

OpenAI의 현재 문서는 Codex 데스크톱 환경을 ChatGPT 데스크톱 앱의 일부로 설명합니다. macOS에서는 chatgpt.com/download에서, Windows에서는 Microsoft Store에서, Linux에서는 OpenAI의 프리뷰 패키지로 설치하세요. 그런 다음 로그인하고 프로젝트 폴더를 추가한 뒤, 모드 메뉴에서 Codex를 선택해 코딩 채팅을 시작하세요.

적용 대상: ChatGPT 데스크톱 앱, macOS, Windows, Linux (프리뷰)

이 페이지는 영어 가이드의 번역본입니다. 명령어와 파일 이름은 그대로 두었습니다. 두 내용이 다르면 영어 페이지와 공식 출처가 우선합니다.

1. 다운로드

OS다운로드 위치
macOSchatgpt.com/download
WindowsMicrosoft Store 페이지 또는 winget install --id 9PLM9XGG6VKS -s msstore
Linux (프리뷰)OpenAI의 Linux 페이지의 .deb, .rpm 또는 Arch 스크립트

2. 로그인

앱을 열고 ChatGPT 계정으로 로그인하세요. 대신 API 키를 사용하려면 로그아웃 화면에서 Sign in another way(다른 방법으로 로그인)를 선택하세요. OpenAI에 따르면 API 키로 로그인하면 일부 기능을 사용할 수 없습니다.

3. Codex가 작업할 위치 선택

Add new project(새 프로젝트 추가) 또는 Cmd+O / Ctrl+O로 프로젝트 폴더를 추가하세요. Codex는 선택한 폴더의 파일을 읽고 변경할 수 있습니다. 변경 사항을 검토하고 되돌릴 수 있도록 프로젝트를 Git으로 관리하세요.

4. Codex 채팅 시작

모드 메뉴에서 Codex를 선택한 다음 New chat(새 채팅)을 시작하고 원하는 작업을 설명하세요. 예를 들면 다음과 같습니다:

Inspect this app, identify one high-impact usability improvement, implement it, update the relevant tests, and verify the result.

이 프롬프트는 OpenAI 빠른 시작에서 가져온 것입니다. 처음이라면 더 작은 작업부터 시작하세요. 첫 번째 작업을 참고하세요.

Windows: 네이티브 에이전트 또는 WSL

Windows에서 앱은 기본적으로 Codex 에이전트를 PowerShell에서 네이티브로 실행하며, Ask for approval(승인 요청)을 선택하면 Windows 샌드박스가 적용됩니다. 에이전트를 WSL2에서 실행하려면 Settings(설정)에서 전환한 뒤 앱을 다시 시작하세요. 자세한 내용: WSL2에서 Codex 사용하기.

Linux: 아직 지원되지 않는 기능

Linux 앱은 프리뷰입니다. OpenAI는 현재 Linux에서 Computer Use를 사용할 수 없으며, 네이티브 Wayland 지원은 실험적 기능이라고 안내합니다.

자주 묻는 질문

Codex 앱을 검색했는데 왜 ChatGPT라고 나오나요?

OpenAI 문서는 이제 Codex가 포함된 하나의 ChatGPT 데스크톱 앱을 안내합니다. macOS의 문제 해결 문서에는 여전히 Codex.app 호환성 번들 경로가 언급되어 있습니다. 두 이름 모두 코딩 작업을 위한 같은 데스크톱 환경을 가리킵니다.

데스크톱 앱은 CLI와 같은 설정을 사용하나요?

MCP 서버는 같은 Codex 호스트의 데스크톱 앱, CLI, IDE 확장 프로그램이 공유합니다. Windows에서는 앱이 %USERPROFILE%\.codex를 Codex 홈으로 사용하며, WSL 안에서 실행되는 CLI는 이를 자동으로 공유하지 않습니다.

출처

이 페이지의 모든 안내에는 공식 출처 링크를 달았습니다. 이 페이지의 내용이 공식 출처와 다르면 공식 출처를 따르시고 저희에게 알려 주세요.