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

Windows용 ChatGPT 데스크톱 앱

Windows용 ChatGPT 데스크톱 앱

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

프로젝트 사이드바, 활성 채팅 및 검토 창을 보여 주는 Windows용 ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱 다운로드

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

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

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

명령줄 설치 방식을 선호한다면 다음을 실행하세요.

winget install --id 9PLM9XGG6VKS -s msstore

네이티브 샌드박스

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

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

선호 편집기

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

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

통합 터미널

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

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

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

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

Windows Subsystem for Linux (WSL)

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

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

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

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

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

Windows native 및 WSL 옵션이 있는 에이전트 선택기를 보여 주는 ChatGPT 데스크톱 앱 설정
통합 터미널은 에이전트와 별도로 구성합니다. 터미널 옵션은 [개발 환경에 맞게 사용자 지정](#customize-for-your-dev-setup)을 참조하세요. 워크플로에 따라 에이전트는 WSL에서 실행하면서 터미널에서는 PowerShell을 사용하거나, 둘 다 WSL을 사용할 수 있습니다.

유용한 개발자 도구

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

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

기본 Windows 패키지 관리자 winget을 사용하여 설치하려면 다음을 통합 터미널에 붙여 넣거나 Codex에 설치를 요청하세요.

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를 설치한 후 앱에서 GitHub 기능을 활성화하려면 gh auth login을 실행하세요.

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

문제 해결 및 FAQ

상향된 권한으로 명령 실행

Codex가 상향된 권한으로 명령을 실행해야 한다면 ChatGPT 데스크톱 앱 자체를 관리자로 시작하세요. 설치 후 시작 메뉴를 열고 앱을 찾은 다음 Run as administrator를 선택하세요. 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를 마우스 오른쪽 버튼으로 클릭하고 Add to Start를 선택한 다음 Codex를 다시 시작하거나 컴퓨터를 재부팅하세요.