ChatGPT 문서
한국어
문의 goolvyouyou@gmail.com

Windows용 ChatGPT 데스크톱 앱

프로젝트 사이드바, 활성 채팅 및 검토 창이 표시된 Windows용 ChatGPT 데스크톱 앱

네이티브 샌드박스와 PowerShell을 지원하는 Windows용 ChatGPT 데스크톱 앱을 사용하세요.

Windows용 ChatGPT 데스크톱 앱은 여러 프로젝트에서 작업하고, 채팅을 병렬로 실행하며, 결과를 검토할 수 있는 하나의 인터페이스를 제공합니다. Windows 앱은 worktree, 예약된 작업, Git 기능, 기본 제공 브라우저, 파일 미리 보기, 플러그인, 스킬과 같은 핵심 워크플로를 지원합니다. PowerShell과 Windows 샌드박스를 사용하여 Windows에서 네이티브로 실행하거나, Windows Subsystem for Linux 2 (WSL2)에서 실행하도록 구성할 수 있습니다.

ChatGPT 데스크톱 앱 다운로드

Windows용 ChatGPT 데스크톱 앱을 다운로드하세요.

그런 다음 빠른 시작을 따라 시작하세요.

엔터프라이즈 설치 및 업데이트 옵션은 Windows 앱 배포를 참조하세요.

명령줄을 통해 설치하려면 다음을 실행하세요.

winget install --id 9PLM9XGG6VKS -s msstore

네이티브 샌드박스

Windows용 ChatGPT 데스크톱 앱은 에이전트가 PowerShell에서 실행될 때 네이티브 Windows 샌드박스를 지원하며, 에이전트를 Windows Subsystem for Linux 2 (WSL2)에서 실행할 때는 Linux 샌드박스를 사용합니다. 어느 모드에서든 샌드박스 보호를 적용하려면 Codex에 메시지를 보내기 전에 작성기 아래에서 승인 요청을 선택하세요.

개발 환경에 맞게 사용자 지정

기본 편집기

Windows에서 기본 Open In 앱을 보여 주는 ChatGPT 데스크톱 앱 설정

Visual Studio, VS Code 또는 다른 편집기와 같이 열기에 사용할 기본 앱을 선택하세요. 프로젝트별로 이 선택을 재정의할 수 있습니다. 특정 프로젝트의 열기 메뉴에서 이미 다른 앱을 선택했다면 해당 프로젝트에 지정된 선택이 우선 적용됩니다.

통합 터미널

Windows에서 통합 터미널 선택 항목을 보여 주는 ChatGPT 데스크톱 앱 설정

기본 통합 터미널도 선택할 수 있습니다. 설치된 항목에 따라 다음 옵션을 사용할 수 있습니다.

  • PowerShell
  • 명령 프롬프트
  • Git Bash
  • WSL

이 변경 사항은 새 터미널 세션에만 적용됩니다. 통합 터미널이 이미 열려 있다면 앱을 다시 시작하거나 새 채팅을 시작해야 새 기본 터미널이 표시됩니다.

Windows Subsystem for Linux (WSL)

Windows 네이티브 및 WSL 옵션이 있는 에이전트 선택기를 보여 주는 ChatGPT 데스크톱 앱 설정

기본적으로 ChatGPT 데스크톱 앱은 Windows 네이티브 Codex 에이전트를 사용합니다. 즉, 에이전트는 PowerShell에서 명령을 실행합니다. 필요한 경우 wsl CLI를 사용하므로 앱은 Windows Subsystem for Linux 2 (WSL2)에 있는 프로젝트에서도 계속 작동할 수 있습니다.

WSL 파일 시스템에서 프로젝트를 추가하려면 새 프로젝트 추가를 클릭하거나 Ctrl+O를 누른 다음 파일 탐색기 창에 \\wsl$\을 입력하세요. 여기에서 Linux 배포판과 열려는 폴더를 선택합니다.

Windows 네이티브 에이전트를 계속 사용할 계획이라면 프로젝트를 Windows 파일 시스템에 저장하고 WSL에서 /mnt/<drive>/...을 통해 접근하는 것이 좋습니다. 이 구성은 WSL 파일 시스템에서 프로젝트를 직접 여는 것보다 안정적입니다.

에이전트 자체를 WSL2에서 실행하려면 **설정**을 열고, 에이전트를 Windows 네이티브에서 WSL로 전환한 다음 앱을 다시 시작하세요. 다시 시작하기 전까지는 변경 사항이 적용되지 않습니다. 다시 시작한 후에도 프로젝트는 그대로 유지됩니다.

WSL1은 Codex 0.114까지 지원되었습니다. Codex 0.115부터 Linux 샌드박스가 bubblewrap로 이전되었으므로 WSL1은 더 이상 지원되지 않습니다.

통합 터미널은 에이전트와 별도로 구성합니다. 터미널 옵션은 개발 환경에 맞게 사용자 지정을 참조하세요. 워크플로에 따라 에이전트는 WSL에서 실행하면서 터미널에서는 PowerShell을 사용하거나, 양쪽 모두에서 WSL을 사용할 수 있습니다.

유용한 개발자 도구

몇 가지 일반적인 개발자 도구가 이미 설치되어 있으면 Codex를 더욱 효과적으로 사용할 수 있습니다.

  • Git: ChatGPT 데스크톱 앱의 검토 패널을 구동하며 변경 사항을 검사하거나 되돌릴 수 있게 해 줍니다.
  • Node.js: 에이전트가 작업을 더욱 효율적으로 수행하는 데 사용하는 일반적인 도구입니다.
  • Python: 에이전트가 작업을 더욱 효율적으로 수행하는 데 사용하는 일반적인 도구입니다.
  • .NET SDK: 네이티브 Windows 앱을 빌드할 때 유용합니다.
  • GitHub CLI: ChatGPT 데스크톱 앱의 GitHub 관련 기능을 구동합니다.

다음 내용을 통합 터미널에 붙여 넣거나 Codex에 설치를 요청하여 기본 Windows 패키지 관리자 winget로 이러한 도구를 설치하세요.

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

GitHub CLI를 설치한 후 gh auth login을 실행하여 앱에서 GitHub 기능을 활성화하세요.

다른 Python 또는 .NET 버전이 필요하다면 패키지 ID를 원하는 버전으로 변경하세요.

문제 해결 및 FAQ

상승된 권한으로 명령 실행

Codex가 상승된 권한으로 명령을 실행해야 한다면 ChatGPT 데스크톱 앱 자체를 관리자 권한으로 시작하세요. 설치 후 시작 메뉴를 열고, 앱을 찾은 다음 관리자 권한으로 실행을 선택하세요. Codex 에이전트는 해당 권한 수준을 상속합니다.

PowerShell 실행 정책이 명령을 차단하는 경우

이전에 PowerShell에서 Node.js 또는 npm 같은 도구를 사용한 적이 없다면 Codex 에이전트나 통합 터미널에서 실행 정책 오류가 발생할 수 있습니다.

Codex가 사용자를 위해 PowerShell 스크립트를 생성하는 경우에도 이런 문제가 발생할 수 있습니다. 이 경우 PowerShell에서 스크립트를 실행하려면 덜 제한적인 실행 정책이 필요할 수 있습니다.

오류는 다음과 비슷하게 표시될 수 있습니다.

npm.ps1 cannot be loaded because running scripts is disabled on this system.

일반적인 해결 방법은 실행 정책을 RemoteSigned로 설정하는 것입니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

정책을 변경하기 전에 자세한 내용과 다른 옵션을 Microsoft의 실행 정책 가이드에서 확인하세요.

Windows의 로컬 환경 스크립트

로컬 환경에서 npm 스크립트와 같은 크로스 플랫폼 명령을 사용한다면 모든 플랫폼에서 하나의 공통 설정 스크립트 또는 작업 모음을 유지할 수 있습니다.

Windows 전용 동작이 필요하다면 Windows 전용 설정 스크립트 또는 Windows 전용 작업을 만드세요.

작업은 통합 터미널이 사용하는 환경에서 실행됩니다. 개발 환경에 맞게 사용자 지정을 참조하세요.

로컬 설정 스크립트는 에이전트 환경에서 실행됩니다. 에이전트가 WSL을 사용하면 WSL에서, 그렇지 않으면 PowerShell에서 실행됩니다.

구성, 인증 및 세션을 WSL과 공유

Windows 앱은 Windows의 네이티브 Codex와 동일한 Codex 홈 디렉터리를 사용합니다. %USERPROFILE%\.codex

WSL 내에서도 Codex CLI를 실행하는 경우 CLI는 기본적으로 Linux 홈 디렉터리를 사용하므로 Windows 앱과 구성, 캐시된 인증 또는 세션 기록을 자동으로 공유하지 않습니다.

공유하려면 다음 방법 중 하나를 사용하세요.

  • 파일 시스템에서 WSL의 ~/.codex과 %USERPROFILE%\.codex을 동기화합니다.
  • CODEX_HOME을 설정하여 WSL이 Windows Codex 홈 디렉터리를 가리키도록 합니다.
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

모든 셸에서 이 설정을 사용하려면 ~/.bashrc 또는 ~/.zshrc과 같은 WSL 셸 프로필에 추가하세요.

Git 기능을 사용할 수 없는 경우

Windows에 Git이 네이티브로 설치되어 있지 않으면 앱에서 일부 기능을 사용할 수 없습니다. PowerShell에서 winget install Git.Git 또는 cmd.exe을 사용하여 설치하세요.

\\wsl$에서 연 프로젝트의 Git이 감지되지 않는 경우

현재로서는 WSL에서도 접근할 수 있는 프로젝트에 Windows 네이티브 에이전트를 사용하려는 경우 프로젝트를 네이티브 Windows 드라이브에 저장하고 WSL에서 /mnt/<drive>/...을 통해 접근하는 것이 가장 안정적인 해결 방법입니다.

열기 대화 상자에 Cmder이 표시되지 않는 경우

Cmder이 설치되어 있지만 Codex의 열기 대화 상자에 표시되지 않는다면 Windows 시작 메뉴에 추가하세요. Cmder을 마우스 오른쪽 버튼으로 클릭하고 시작 화면에 고정을 선택한 다음 Codex를 다시 시작하거나 시스템을 재부팅하세요.