WindowsでCodexローカル開発を始める手順

2026年7月追記：Codex appは新ChatGPT desktop appへ統合

Windows / MacのCodex appは通常updateで新ChatGPT desktop appへ移行します。Codexをdefault viewにでき、ChatGPT Classicとは別です。更新前後にproject、repo、permissions、sandbox、network、pluginsを確認し、設定や未保存データが必ず保持されるとは断定しません。

Windowsではelevatedを基本に、unelevatedはfallbackとして扱う

Native Windows sandboxにはelevatedとunelevatedの2つのmodeがあります。elevatedはpreferredで、専用の低権限sandbox user、filesystem permission boundary、firewall rule、local policyを使います。unelevatedは現在のuserから派生したrestricted tokenとACLベースのfilesystem boundary、environment-levelのoffline controlを使うfallbackです。unelevatedは作業を続けるために有用ですが、elevatedと同等とは扱いません。

Windows sandboxを使う前の停止条件

• 最初はread-onlyまたは対象workspaceに限定した作業から始め、実際のsandbox mode、作業フォルダ、network状態を確認する。
• elevatedのsetupが管理者承認やenterprise policyで止まった場合、permissionsを広げて回避せず、原因を記録してunelevated利用または管理者確認へ分ける。
• unelevatedに切り替わっても、filesystem・network・secret・外部送信の確認を省略しない。
• Windows nativeとWSLは別の実行環境として扱い、切り替えたらPATH、config、MCP、生成先、Git rootを再確認する。
• sandboxが作業フォルダ外のwriteや明示承認なしのnetworkを制限していても、README、外部ページ、MCP、ログに秘密情報や危険な指示がないかは別に確認する。

WindowsでCodexを始める順番

このページの主題は、WindowsでCodexを使ってローカル開発を始めるために、何を準備し、どの実行面を選び、最初に何を確認するかです。Browser、Computer Use、workspace管理、設定keyの全解説はここで完結させず、用途別のガイドへ分けます。

最初のプロジェクト確認

• 作業対象をrepoのフォルダに限定し、Documents全体やDownloadsをcwdにしない
• git rev-parse --show-toplevelでGit rootを確認し、branchと未コミット差分を先に見る
• node --version、git --version、package.jsonのscriptsを確認し、Nodeの導入方法を勝手に増やさない
• 最初はREADME、設定、主要sourceを読み取り、1ファイルの小さな変更から始める
• build、git diff --check、生成物の確認を公開やpushより前に置く

native WindowsとWSLは同じ環境として扱わない

native WindowsはWindows側のpath、PowerShell、sandboxを使い、WSL2はLinux側のfilesystem、shell、PATH、credential、configを使います。IDEやCLIの表示が同じでも、実際に読んでいるrepo、実行されるNode、MCP、secretの場所が同じとは限りません。切り替えたらcwd、Git root、branch、runtimeを再確認します。

Codex CLI・desktop app・IDEは入口を一つずつ試す

CLIはterminalとproject directory、desktop appは選択したfolderとproject context、IDE extensionはeditorのfile・selection・workspaceを入口にします。入口が違えば、表示されるcontext、実行場所、利用できる機能が変わるため、同じchatや同じ権限が自動的に共有されるとは考えません。

設定と権限は最小範囲から広げる

最初の作業ではread-onlyや狭いworkspace-writeを優先し、MCP、network、Browser、外部サービス、push、deployを同時に有効化しません。設定ファイルのkey、workspaceのrole、モデルの表示、runtime permissionは別々の確認項目です。