Windows용 ChatGPT 데스크톱 앱

Windows용 ChatGPT 데스크톱 앱에서는 한 화면에서 여러 프로젝트를 오가며 작업하고, 여러 채팅을 동시에 진행하고, 결과를 검토할 수 있습니다. Windows 앱은 작업 트리, 예약 작업, Git 기능, 앱 내 브라우저, 파일 미리 보기, 플러그인, 스킬 등 주요 워크플로우를 지원합니다. 기본적으로 Windows에서 PowerShell과 Windows 샌드박스를 사용해 네이티브로 실행되며, Linux용 Windows 하위 시스템 2(WSL2)에서 실행하도록 설정할 수도 있습니다.

ChatGPT

FileEditViewWindowHelp

Add all system fonts to selector

Ran $i=1; Get-Content Views\MainPage.xaml.cs | ForEach-Object { if ($i -ge 1 -and $i -le 260) { "{0,4}: {1}" -f $i, $_ }; $i++ }

Ran $i=1; Get-Content Views\MainPage.xaml.cs | ForEach-Object { if ($i -ge 260 -and $i -le 460) { "{0,4}: {1}" -f $i, $_ }; $i++ }

Ran $i=1; Get-Content Views\MainPage.xaml | ForEach-Object { if ($i -ge 80 -and $i -le 105) { "{0,4}: {1}" -f $i, $_ }; $i++ }

Ran $mainPageXaml = @' <?xml version="1.0" encoding="UTF-8" ?> <Page x:Class="QuickEdit.Views.MainPage" xmlns="..."

The source edits are in place. I’m checking the diff now for correctness, then I’ll run a build to catch any WinUI or interop issues from the new font enumeration path.

Ran $i=1; Get-Content Views\MainPage.xaml.cs for selected lines

Ran git diff -- Views\MainPage.xaml Views\MainPage.xaml.cs for 1s

Ran $i=1; Get-Content Views\MainPage.xaml.cs for selected lines

Ran $i=1; Get-Content Views\MainPage.xaml for selected lines

The code is consistent on inspection. I’m building now to catch any WinUI/XAML or interop compile issues before I hand this back.

Ran dotnet build QuickEdit.csproj for 13s

Worked for 6m 40s

The font selector now loads the full installed Windows font family list at run time instead of the six hard-coded entries. I removed the static ComboBox items in MainPage.xaml and updated the selection handling in MainPage.xaml.cs to work with string-based items.

The installed font families are enumerated from GDI, deduplicated, sorted, and used to populate the selector during page construction in MainPage.xaml.cs and MainPage.xaml.cs. dotnet build QuickEdit.csproj succeeded with 0 warnings and 0 errors. I didn’t launch the UI, so the only remaining check is visual confirmation that the dropdown behaves well with the longer list.

1 file changedUndo

Views\MainPage.xaml +1 -9

Ask for follow-up changes

6 SolMedium

LocalDefault permissionsmain

ChatGPT 데스크톱 앱 다운로드

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

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

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

명령줄에서 설치하려면 다음 명령어를 실행하세요.

winget install --id 9PLM9XGG6VKS -s msstore

네이티브 샌드박스

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

개발 환경에 맞게 설정하기

기본 편집기

Visual Studio, VS Code 또는 다른 편집기를 열기 기능의 기본 앱으로 선택하세요. 프로젝트마다 다른 앱을 지정할 수 있습니다. 특정 프로젝트의 열기 메뉴에서 이미 다른 앱을 선택했다면 해당 프로젝트에서는 그 앱이 우선합니다.

Open

Open in

VS Code

Visual Studio

Sublime Text

GitHub Desktop

File Explorer

Git Bash

Cmder

Rider

Linux용 Windows 하위 시스템(WSL)

ChatGPT 데스크톱 앱은 기본적으로 Windows 네이티브 Codex 에이전트를 사용합니다. 이 에이전트는 PowerShell에서 명령어를 실행합니다. Linux용 Windows 하위 시스템 2(WSL2)에 저장된 프로젝트도 앱에서 열어 작업할 수 있습니다. 이때 앱은 필요에 따라 wsl CLI를 사용합니다.

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

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

에이전트 자체를 WSL2에서 실행하려면 설정 메뉴를 열고 에이전트 실행 환경을 Windows 네이티브에서 WSL로 변경한 다음 앱을 다시 시작하세요. 앱을 다시 시작해야 변경 사항이 적용됩니다. 다시 시작한 후에도 프로젝트는 기존 위치에 그대로 있어야 합니다.

Codex 0.114까지는 WSL1을 지원했습니다. Codex 0.115부터 Linux 샌드박스가 bubblewrap으로 전환되면서 WSL1 지원이 종료되었습니다.

통합 터미널은 에이전트와 별도로 설정합니다. 터미널 옵션은 개발 환경에 맞게 설정하기를 참고하세요. 워크플로우에 따라 에이전트는 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를 설치한 후 gh auth login을 실행하면 앱에서 GitHub 기능을 사용할 수 있습니다.

다른 버전의 Python이나 .NET이 필요하다면 원하는 버전에 해당하는 패키지 ID로 변경하세요.

문제 해결 및 자주 묻는 질문

관리자 권한으로 명령어 실행하기

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 전용 설정 스크립트나 작업을 만드세요.

작업은 통합 터미널이 사용하는 환경에서 실행됩니다. 개발 환경에 맞게 설정하기를 참고하세요.

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

WSL과 설정, 인증 정보, 세션 공유하기

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

WSL에서도 Codex CLI를 실행하는 경우 CLI는 기본적으로 Linux 홈 디렉터리를 사용합니다. 따라서 설정, 캐시된 인증 정보, 세션 기록은 Windows 앱과 자동으로 공유되지 않습니다.

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

• 파일 시스템에서 WSL의 ~/.codex를 %USERPROFILE%\.codex와 동기화하세요.
• WSL에서 Windows의 Codex 홈 디렉터리를 사용하도록 CODEX_HOME을 설정하세요.

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를 다시 시작하거나 컴퓨터를 재부팅하세요.