日本語

Windows 向け ChatGPT デスクトップアプリ

プロジェクトサイドバー、進行中のチャット、レビューペインを表示する Windows 向け ChatGPT デスクトップアプリ

ネイティブサンドボックスと PowerShell に対応した 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 にメッセージを送信する前に、コンポーザーの下にある Ask for approval を選択します。

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

優先エディター

Windows のデフォルトの Open In アプリを表示する ChatGPT デスクトップアプリの設定

Visual Studio、VS Code、その他のエディターなど、Open に使用するデフォルトアプリを選択します。この選択はプロジェクトごとに上書きできます。プロジェクトの Open メニューからすでに別のアプリを選択している場合は、そのプロジェクト固有の選択が優先されます。

統合ターミナル

Windows の統合ターミナル選択を表示する ChatGPT デスクトップアプリの設定

デフォルトの統合ターミナルも選択できます。インストールされているものに応じて、次のオプションを利用できます。

  • PowerShell
  • Command Prompt
  • Git Bash
  • WSL

この変更は、新しいターミナルセッションにのみ適用されます。統合ターミナルをすでに開いている場合、新しいデフォルトターミナルを表示するには、アプリを再起動するか、新しいチャットを開始してください。

Windows Subsystem for Linux (WSL)

Windows ネイティブと WSL のオプションを含むエージェントセレクターを表示する ChatGPT デスクトップアプリの設定

デフォルトでは、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 はサポートされなくなりました。

統合ターミナルはエージェントとは別に設定します。ターミナルのオプションについては、 開発環境に合わせてカスタマイズするを参照してください。ワークフローに応じて、エージェントを WSL で実行しながらターミナルでは PowerShell を使用することも、両方で WSL を使用することもできます。

便利な開発者ツール

一般的な開発者ツールをいくつか事前にインストールしておくと、Codex をより効果的に使用できます。

  • Git:ChatGPT デスクトップアプリのレビューパネルを動作させ、変更の確認や取り消しを可能にします。
  • Node.js:エージェントがタスクをより効率的に実行するためによく使用するツールです。
  • Python:エージェントがタスクをより効率的に実行するためによく使用するツールです。
  • .NET SDK:Windows ネイティブアプリを構築する場合に役立ちます。
  • GitHub CLI:ChatGPT デスクトップアプリの GitHub 固有機能を動作させます。

以下を統合ターミナルに貼り付けるか、 Codex にインストールを依頼して、Windows のデフォルトパッケージマネージャー winget でインストールします。

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 デスクトップアプリ自体を管理者として起動します。インストール後、スタートメニューを開いてアプリを探し、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 スクリプトなどのクロスプラットフォームコマンドを使用する場合、すべてのプラットフォームで 1 つの共通セットアップスクリプトまたは一連のアクションを使用できます。

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 または cmd.exe から winget install Git.Git を実行してインストールしてください。

\\wsl$ から開いたプロジェクトで Git が検出されない

現時点では、WSL からもアクセスできるプロジェクトで Windows ネイティブのエージェントを使用する場合、プロジェクトを Windows ネイティブドライブに保存し、WSL から /mnt/<drive>/... 経由でアクセスする方法が最も安定しています。

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

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