コンテンツにスキップ

Windows 用 ChatGPT デスクトップアプリ

Windows 用 ChatGPT デスクトップアプリ では、プロジェクト間での作業、並列チャットの実行、結果の確認を 1 つのインターフェースで行えます。 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 に送信する前に、コンポーザーの下にある 承認を求めるを選択します。

Codex をフルアクセスモードで実行すると、Codex はプロジェクトディレクトリに限定されず、データ損失につながる意図しない破壊的な操作を実行する可能性があります。サンドボックスの境界を維持し、対象を絞った例外にはルールを使用するか、承認ポリシーを常に拒否に設定して、承認とセキュリティの設定に基づき、権限の昇格を求めずに Codex が問題の解決を試みるようにしてください。

開発環境に合わせてカスタマイズする

### 優先エディター **開く**などで使用するデフォルトアプリを選択します。Visual Studio、VS Code、その他のエディターを選択できます。プロジェクトごとにこの選択を上書きできます。プロジェクトの**開く**メニューから別のアプリをすでに選択している場合は、そのプロジェクト固有の選択が優先されます。
### 統合ターミナル デフォルトの統合ターミナルを選択することもできます。インストールされているものに応じて、次のオプションがあります。 - PowerShell - Command Prompt - Git Bash - WSL この変更は、新しいターミナルセッションにのみ適用されます。統合ターミナルをすでに開いている場合は、新しいデフォルトターミナルが表示される前に、アプリを再起動するか、新しいチャットを開始してください。

Windows Subsystem for Linux (WSL)

デフォルトでは、ChatGPT デスクトップアプリは Windows ネイティブの Codex エージェントを使用します。つまり、エージェントは PowerShell でコマンドを実行します。アプリは、必要に応じて wsl CLI を使用することで、Windows Subsystem for Linux 2 (WSL2) にあるプロジェクトでも作業できます。

WSL ファイルシステムからプロジェクトを追加する場合は、新しいプロジェクトを追加をクリックするか、Ctrl+O を押して、File Explorer ウィンドウに \\wsl$\ と入力します。そこから、使用する Linux ディストリビューションと開くフォルダーを選択します。

Windows ネイティブのエージェントを使い続ける予定の場合は、プロジェクトを Windows ファイルシステムに保存し、/mnt/<drive>/... を介して WSL からアクセスすることをおすすめします。この設定は、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 固有の機能を動かします。

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 を目的のバージョンに変更してください。

トラブルシューティングと 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 スクリプトなどのクロスプラットフォームコマンドを使用している場合は、すべてのプラットフォームで共有するセットアップスクリプトまたはアクションを 1 つにまとめて使用できます。

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 が検出されない

現時点では、Windows ネイティブのエージェントを、WSL からもアクセスできるプロジェクトで使用する場合、最も信頼性の高い回避策は、プロジェクトをネイティブ Windows ドライブに保存し、/mnt/<drive>/... を介して WSL からアクセスすることです。

Cmder が開くダイアログに表示されない

Cmder がインストールされているにもかかわらず Codex の開くダイアログに表示されない場合は、Windows のスタートメニューに追加します。Cmder を右クリックして スタートに追加を選択し、Codex を再起動するか、再起動します。