For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション
Theme

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

Windows では、ネイティブサンドボックスと PowerShell に対応した ChatGPT デスクトップアプリを利用できます。

Windows 版 ChatGPT デスクトップアプリでは、複数のプロジェクトでの作業、チャットの並行実行、結果のレビューを一つの画面で行えます。 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 を実行すると、操作範囲がプロジェクトディレクトリの外にも及びます。意図せず破壊的な操作を行い、データが失われる可能性があります。サンドボックスの制限を維持し、例外が必要な操作だけをルールで許可してください。または、承認ポリシーを never に設定すると、Codex は承認とセキュリティの設定に従い、権限の昇格を求めずに問題の解決を試みます。

開発環境に合わせた設定

既定のエディター

プロジェクトで「開く」を選択したときに使う既定のアプリを、Visual Studio、VS Code、その他のエディターから選べます。この設定はプロジェクトごとに変更できます。プロジェクトの「開く」メニューですでに別のアプリを選んでいる場合は、そのプロジェクトでの選択が優先されます。

統合ターミナル

既定の統合ターミナルも選べます。インストール済みの環境に応じて、次のような選択肢があります。

  • PowerShell
  • コマンドプロンプト
  • 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 のファイルシステムに保存し、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: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 を目的のバージョンに合わせて変更してください。

トラブルシューティングとよくある質問

管理者権限でのコマンド実行

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 版アプリは、Windows ネイティブの Codex と同じホームディレクトリ %USERPROFILE%\.codex を使用します。

WSL 内でも Codex CLI を実行する場合、CLI は既定で Linux のホームディレクトリを使用します。そのため、設定、キャッシュされた認証情報、セッション履歴は Windows 版アプリと自動的には共有されません。

共有するには、次のいずれかの方法を使います。

  • WSL の ~/.codex と Windows のファイルシステム上の %USERPROFILE%\.codex を同期します。
  • WSL で CODEX_HOME を次のように設定し、Windows 側の Codex ホームディレクトリを指定します。
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

シェルを起動するたびにこの設定を適用するには、WSL のシェルプロファイル(~/.bashrc や ~/.zshrc など)に追加してください。

Git の機能を利用できない場合

Windows 側に Git がインストールされていないと、アプリの一部の機能を利用できません。インストールするには、winget install Git.Git を PowerShell または cmd.exe で実行します。

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

WSL からもアクセスできるプロジェクトで Windows ネイティブのエージェントを使う場合、現時点で最も確実な回避策は、プロジェクトを Windows 側のドライブに保存し、WSL から /mnt/<drive>/... 経由でアクセスすることです。

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

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