コンテンツにスキップ

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 にメッセージを送信する前に、composer の下にある 承認を求める を選択します。

Codex をフルアクセスモードで実行すると、Codex はプロジェクト ディレクトリに限定されず、データ損失につながる意図しない破壊的な操作を 実行する可能性があります。サンドボックスの境界を維持し、 対象を限定した例外には ルールを使用するか、 承認ポリシーを never に設定して、承認およびセキュリティの設定に基づき、 権限の昇格を求めずに 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 を押して、ファイル エクスプローラーのウィンドウに \\wsl$\ と入力します。そこから Linux ディストリビューションと、開きたいフォルダーを選択します。

Windows ネイティブのエージェントを使い続ける予定の場合は、プロジェクトを Windows ファイルシステムに保存し、/mnt/<drive>/... を介して WSL からアクセスすることをおすすめします。この構成は、WSL ファイルシステムからプロジェクトを直接開くよりも信頼性が高くなります。

エージェント自体を WSL2 で実行する場合は、Settings を開き、エージェントを 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 を再起動するか、コンピューターを再起動します。