Документация ChatGPT
Русский
Связаться goolvyouyou@gmail.com

Приложение ChatGPT для Windows

Приложение ChatGPT для Windows

Настольное приложение ChatGPT для Windows предоставляет единый интерфейс для работы с разными проектами, параллельного ведения чатов и проверки результатов. Приложение для Windows поддерживает основные рабочие процессы, включая рабочие деревья, запланированные задачи, функции Git, встроенный браузер, предварительный просмотр файлов, плагины и навыки. Оно работает непосредственно в Windows с использованием PowerShell и песочницы Windows. Кроме того, его можно настроить для работы в Подсистеме Windows для Linux 2 (WSL2).

Настольное приложение ChatGPT для Windows с боковой панелью проекта, активным чатом и панелью проверки

Скачивание настольного приложения ChatGPT

Скачайте приложение ChatGPT для Windows.

Затем следуйте краткому руководству, чтобы начать работу.

Сведения о вариантах установки и обновления в корпоративной среде см. в разделе Развёртывание приложения для Windows.

Если вы предпочитаете установку из командной строки, выполните:

winget install --id 9PLM9XGG6VKS -s msstore

Встроенная песочница

Приложение ChatGPT для Windows поддерживает встроенную песочницу Windows, когда агент работает в PowerShell, и использует песочницу Linux, когда агент работает в Подсистеме Windows для Linux 2 (WSL2). Чтобы применить защиту песочницы в любом из этих режимов, перед отправкой сообщений Codex выберите Запрашивать подтверждение под полем ввода.

Настройка под вашу среду разработки

Предпочитаемый редактор

Выберите приложение по умолчанию для действия Открыть, например Visual Studio, VS Code или другой редактор. Этот выбор можно переопределить для отдельного проекта. Если ранее вы выбрали для проекта другое приложение в меню Открыть, настройка для этого проекта имеет приоритет.

Настройки настольного приложения ChatGPT с приложением по умолчанию для действия «Открыть в» в Windows

Встроенный терминал

Вы также можете выбрать встроенный терминал по умолчанию. В зависимости от установленных программ доступны следующие варианты:

  • PowerShell
  • Командная строка
  • Git Bash
  • WSL

Это изменение применяется только к новым сеансам терминала. Если встроенный терминал уже открыт, перезапустите приложение или начните новый чат, прежде чем ожидать появления нового терминала по умолчанию.

Настройки настольного приложения ChatGPT с выбором встроенного терминала в Windows

Подсистема Windows для Linux (WSL)

По умолчанию приложение ChatGPT использует нативный агент Codex для Windows. Это означает, что агент выполняет команды в PowerShell. При необходимости приложение по-прежнему может работать с проектами, расположенными в Подсистеме Windows для Linux 2 (WSL2), с помощью CLI wsl.

Чтобы добавить проект из файловой системы WSL, нажмите Добавить новый проект или Ctrl+O, а затем введите \\wsl$\ в окне Проводника. После этого выберите нужный дистрибутив Linux и папку, которую хотите открыть.

Если вы планируете продолжать использовать нативный агент для Windows, рекомендуется хранить проекты в файловой системе Windows и обращаться к ним из WSL через /mnt/<drive>/.... Такая конфигурация надежнее, чем открытие проектов непосредственно из файловой системы WSL.

Если вы хотите, чтобы сам агент работал в WSL2, откройте Настройки, переключите агент с нативного режима Windows на WSL и перезапустите приложение. Изменение вступит в силу только после перезапуска. После перезапуска ваши проекты должны остаться на месте.

WSL1 поддерживалась до версии Codex 0.114 включительно. Начиная с Codex 0.115, песочница Linux перешла на bubblewrap, поэтому WSL1 больше не поддерживается.

Настройки настольного приложения ChatGPT с выбором агента между нативным режимом Windows и WSL
Встроенный терминал настраивается независимо от агента. Доступные параметры терминала описаны в разделе [Настройка для вашей среды разработки](#customize-for-your-dev-setup). Можно оставить агента в WSL, а в терминале использовать PowerShell, либо использовать WSL в обоих случаях — в зависимости от рабочего процесса.

Полезные инструменты разработчика

Codex работает эффективнее, если уже установлены несколько распространенных инструментов разработчика:

  • Git: обеспечивает работу панели проверки в приложении ChatGPT и позволяет просматривать или отменять изменения.
  • Node.js: распространенный инструмент, который агент использует для более эффективного выполнения задач.
  • Python: распространенный инструмент, который агент использует для более эффективного выполнения задач.
  • .NET SDK: пригодится для разработки нативных приложений для Windows.
  • GitHub CLI: обеспечивает работу функций GitHub в приложении ChatGPT.

Установите их с помощью стандартного диспетчера пакетов 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, замените идентификаторы пакетов на идентификаторы нужных версий.

Устранение неполадок и часто задаваемые вопросы

Выполнение команд с повышенными правами

Если 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 использует тот же домашний каталог Codex, что и нативный Codex в Windows: %USERPROFILE%\.codex.

Если вы также запускаете Codex CLI внутри WSL, по умолчанию CLI использует домашний каталог Linux, поэтому конфигурация, кэшированные данные аутентификации и история сеансов не предоставляются приложению для Windows автоматически.

Чтобы сделать их общими, используйте один из следующих подходов:

  • Синхронизируйте WSL ~/.codex с %USERPROFILE%\.codex в своей файловой системе.
  • Укажите WSL домашний каталог Codex в Windows, задав CODEX_HOME:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Чтобы эта настройка применялась в каждой командной оболочке, добавьте ее в профиль оболочки WSL, например ~/.bashrc или ~/.zshrc.

Функции Git недоступны

Если Git не установлен непосредственно в Windows, приложение не сможет использовать некоторые функции. Установите его с помощью winget install Git.Git из PowerShell или cmd.exe.

Git не обнаруживается в проектах, открытых из \\wsl$

На данный момент, если вы хотите использовать нативный агент для Windows с проектом, который также доступен из WSL, наиболее надежный обходной путь — хранить проект на нативном диске Windows и обращаться к нему из WSL через /mnt/<drive>/....

Cmder отсутствует в диалоговом окне открытия

Если Cmder установлен, но не отображается в диалоговом окне открытия Codex, добавьте его в меню «Пуск» Windows: нажмите правой кнопкой мыши Cmder и выберите Добавить в меню «Пуск», затем перезапустите Codex или перезагрузите компьютер.