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

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

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

Используйте приложение ChatGPT для Windows со встроенной поддержкой песочницы и PowerShell

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

Скачивание приложения ChatGPT

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

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

Варианты установки и обновления в корпоративной среде описаны в разделе «Развертывание приложения для Windows».

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

winget install --id 9PLM9XGG6VKS -s msstore

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

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

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

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

Настройки приложения ChatGPT с приложением по умолчанию для команды Open In в Windows

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

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

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

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

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

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

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

Настройки приложения ChatGPT с выбором агента между нативным режимом Windows и 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 больше не поддерживается.

Встроенный терминал настраивается независимо от агента. Варианты терминала описаны в разделе «Настройка под вашу среду разработки». Можно оставить агент в 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 или перезагрузите компьютер.