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、ログに秘密情報や危険な指示がないかは別に確認する。

スマホは操作面、実行は接続先host

接続前の最小チェック

• desktop appとmobile appを最新にし、同じaccount / workspaceでサインインする。hostはスリープせず、作業中にオンラインを保つ。
• desktop appのSettings > Connections > Control this Mac or PCからSet up / Addを開き、表示された承認とQR pairingを確認する。
• 接続先のrepo、subdirectory、Git branch、触ってよいファイルを固定し、スマホからのfollow-upやapprovalを無制限の実行許可と扱わない。
• hostが持つcredentials、MCP、browser session、Computer Use、sandbox、local toolsの権限がremote taskにも影響する前提で、最小権限と秘密情報の非表示を確認する。
• SSHを使う場合は~/.ssh/configのhost alias、trusted key、remote login shell、Codex remote hostの導入を確認し、app-server transportを共有・公開ネットワークへ直接晒さない。

Remoteとローカル・cloudの境界

Remoteは、接続した自分のMac / WindowsまたはSSH先の環境を操作する実行面です。hostのcredentials、permissions、MCP、browser、sandboxを引き継ぐため、スマホから見えている会話だけで安全範囲を判断しません。Cloud environmentのcontainerで動くtaskや、Web taskのuploaded contextとは別に、どのhost・filesystem・Git stateが実際の対象かを毎回確認します。

ローカルのchatをremote hostへhandoffすると、既存chatとGit stateを接続先へ移せます。公式Docsでは、保存済みの同じrepo / subdirectoryが必要で、worktreeを作成または再利用する場合があります。handoff中の応答は中断され、Codex cloud environmentへhandoffする機能ではないため、移動後にbranch、worktree、未コミット差分を確認します。

現行のpairing・host設定・再接続

• hostがsleep、offline、app終了になるとRemoteは停止する。長時間使う専用hostなら、電源・network・awake設定を先に確認する。
• ChatGPTからsign outするとRemote Controlはoffになるが、既存のdevice pairing自体は削除されない。再sign in後にRemote Controlを再度有効化する。
• Remoteが一覧に出ない、approvalが届かない、Add後にerrorになる場合は、同じaccount / workspace、desktop appの稼働、adminのRemote Control設定、QR pairingを確認し、必要ならhostのdesktop appを再起動する。

SSH接続はalias・login shell・remote projectを分けて確認する

SSH hostを使う場合、公式Docsは~/.ssh/configの具体的なhost aliasをCodexがauto-discoverし、pattern-onlyのHostは無視すると説明しています。まずappを動かす端末からSSH接続を確認し、remote userのlogin shellでcodex commandがPATHにあることを確認します。desktop appはSSH経由でremote Codex app serverを起動するため、Settings > ConnectionsでSSH hostを追加・有効化してからremote project folderを選びます。

remote project chatではremote filesystemを読み書きし、remote hostでcommandを実行します。trusted key、least-privilege account、同じsecurity policyを保ち、app-server transportをshared / public networkへ直接公開しません。現在のnetwork外へ接続する必要がある場合は、公式Docsの境界どおりVPNやmesh networkingを使い、公開listenerを作らない前提で設計します。

`.codex`の設定、worktree setup、Actionを分けて確認する

Local environmentを使う前の停止条件

• Local environmentはChatGPT desktop appのCodexで使う機能として扱い、CLIやIDE extensionにも同じSettings UIがあると決めつけない。
• setup scriptはworktree作成時に自動実行される可能性があるため、`npm install`、build、postinstall、外部取得、license、secret参照、生成ファイルを実行前にレビューする。
• `.codex`をGitで共有する場合は、設定が想定するproject root、platform別command、runtime、port、環境変数を確認し、API keyやtokenの実値を置かない。
• Actionはintegrated terminalの便利な入口であり、sandbox、filesystem、network、MCP、browser、hostのpermissionを狭める承認機構ではない。
• desktop appのGit controlsを使っても、現在のcheckout、worktree、branch、未追跡ファイル、生成物、test結果、push先を確認してから公開操作へ進む。

Local environmentは、ローカルのChatGPT desktop appとそのproject / worktreeを準備する設定です。Remoteは接続済みhostへ到達する実行面、Cloud environmentはcontainerを使う別の実行面なので、同じsetup scriptやGit stateが自動的に共有されるとは扱いません。どのcheckoutでscriptが動き、どのterminalとpermissionでActionが実行されるかを毎回確認します。

Windowsの導入はinstall・sign in・最初のtaskを分ける

Codex CLIは一つのterminal loopから用途を分ける

公式ページは、CLIをlocal repositoryのinspect・edit・run、repeatable workflowの`codex exec`、変更をcommit前に見るreview、Codex cloudへのhandoffに使う面として整理しています。`codex resume`、画像・web context、subagents、`codex mcp`、`/permissions`、`codex completion`も同じCLIにありますが、local filesystem、cloud environment、MCP server、外部送信の権限が一つに統合されるとは扱いません。

• まずlocal repoで読み取り・小さな変更・diff確認を行い、installや外部通信の副作用を先に把握する。
• `codex exec`をCIやrepeatable workflowへ広げる時は、interactive sessionと出力・approval・sandbox・secretの境界を別に確認する。
• `codex cloud`からlocal repositoryへ結果を戻す時は、cloud taskのdiffを通常の未commit変更としてreviewし、apply成功をcommitやdeploy成功と混同しない。
• `codex mcp`、Plugins、Skills、`/permissions`を追加する時は、接続先、tool、scope、session、sandbox、approvalを一つずつ確認する。

CLIの見た目と入力経路を用途別に設定する

completionとeditorを権限設定と混同しない

• `codex completion`はShellで`codex`の入力を補助するscriptを生成する機能で、filesystem、network、MCP、approvalを許可するcommandではない。
• Shell設定へ追加する前に、生成されたscript、profileの変更箇所、対象Shell、削除方法を保存しておく。公式ページの例はZ shell向けなので、PowerShellでは現在のShellと公式の出力を確認してから反映する。
• `/theme`と`$CODEX_HOME/themes`はCLIの表示設定、`VISUAL` / `EDITOR`はprompt編集の入口であり、projectのAGENTS.mdや`config.toml`のpermission設定を置き換えない。
• 見た目や入力を整えた後も、実行前にはCLI referenceのsandbox、approval、`--cd`、`--config`、Git差分を別に確認する。

Windowsでは環境変数の用途と寿命を先に分ける

秘密情報を環境変数に置いても、漏えい境界は消えない

• `CODEX_API_KEY`、`CODEX_ACCESS_TOKEN`、providerの`env_key`で参照する値は、記事・README・AGENTS.md・config.toml・Git管理下の`.env`へ実値を書かない。環境変数名だけを共有し、値はsecret managerやOSの管理領域で扱う。
• `CODEX_API_KEY`は`codex exec`の1回のnon-interactive実行向けなので、job全体や後続commandへ無制限に継承させない。`CODEX_ACCESS_TOKEN`をtrusted automationで使う場合も、対象repoとprocessを限定する。
• provider側の認証変数名は、設定した`env_key`で決まり、Codexに固定されたprovider API key名とは限らない。設定ファイルのprovider、base URL、wire API、env_keyを値なしでreviewする。
• `CODEX_HOME`と`CODEX_SQLITE_HOME`は単なる一時変数ではなく、認証・履歴・session・SQLite stateの保存先に影響する。別directoryを指定する場合は、意図したprofileと既存stateを確認する。
• インストーラーのnon-interactive設定はpromptを隠すだけで、scriptの安全性を保証しない。install / updateのsource、対象path、PATH変更、post-install処理、外部通信を先に確認する。

環境変数は、config.tomlに置くべきdurable setting、現在のshellだけのoverride、installerの動作制御、認証、TLS、診断を一つの場所にまとめる仕組みではありません。PowerShellで確認する時も、値そのものを表示せず、変数名、設定元、継承先process、保存先、終了後に残るstateだけを監査します。

Windowsのdesktop appはshortcutのsurfaceを確認してから使う

`Ctrl+G`はdesktop appとCodex CLIで意味が違う

• ChatGPT desktop appでは`Ctrl+G`が過去chatの検索入口で、開いているchat内の検索は`Ctrl+F`。検索結果から開いたchatのworkspace・branch・hostを再確認する。
• Codex CLIのcomposerでは`Ctrl+G`が`VISUAL`または`EDITOR`のprompt editorを開く入口として説明されている。desktop appのchat検索と同じ操作とは扱わない。
• shortcutはnavigation・検索・terminal表示の入口であり、sandbox、approval、MCP、filesystem、networkを広げるpermission設定ではない。
• shortcutを変更した場合は、Settings > Keyboard Shortcutsでcommand名またはkeystrokeを検索し、現在のprofileとapp surfaceに保存された変更を確認する。

`codex://` deep linkはworkspace・設定画面への入口として使う

• `path`はlocal directoryのabsolute pathとして扱い、`originUrl`はGit remote URLからworkspace rootを照合する。両方ある場合は`path`が先に解決される。
• query stringの値はURL encodeし、prompt・path・remote URL・plugin名を未加工で連結しない。deep linkを作る側と開く側で、対象pathと送信先をレビューする。
• `codex://new`はpromptをcomposerへ入れるだけで、ユーザーが送信するまで実行を開始しない。deep linkのクリックは、承認・sandbox・MCP接続・Git操作の完了を意味しない。
• 未対応の`codex://settings/...` pathはmain Settingsを開く場合があるため、画面遷移先を固定前提にせず、表示された設定項目を確認する。

Settingsの待機・follow-up・通知を実行境界と分ける

Follow-upを送る前の停止条件

• 現在のrunをsteerする必要がある場合は、追加指示が既存の変更範囲、実行中command、branch、生成物に与える影響を確認してから送る。
• 現在のrunを変えたくない場合はnext runまでwaitする設定を候補にするが、待機設定はsandbox、approval、MCP、filesystem、networkの権限を狭めるものではない。
• Prevent sleep while runningを有効にしても、PCの電源断、network切断、app終了、Remote hostの再接続、test失敗を自動回復するものとは扱わない。
• completion notificationを受け取っても、完了メッセージだけで公開成功と判断せず、diff、test、未実行範囲、Git stateを確認する。
• Browserのallowed site設定を追加する時は、対象domain、外部送信、ログイン状態、Chrome extension、Computer Useのforeground権限を狭く確認する。

Review paneはCodexが作った差分だけを表示するとは限らない

chatやterminalが停止した時の復旧順序

• chatが進まない時は、まず承認待ちが表示されていないか確認する。承認を無視してpromptを増やすと、停止原因と差分の境界が分かりにくくなる。
• terminalが止まった時は、terminalを閉じてWindows desktop appのTerminalを再度開き、`pwd`と`git status`でcurrent directory・branch・変更状態を確認する。
• Worktree作成がcancelされた場合はup arrowで直前のpromptを復元できる。再実行前に、通常checkoutかWorktreeか、対象pathとsetupの前提を確認する。
• 小さなfocused promptに分け、1回の実行で触る範囲・停止条件・確認するtestを狭くする。active chatが残っている間は、状態を確認せずappをrestartしない。
• restart後も同じ症状なら、AppとCLIのversion、project root、branch、approval、直近のGit stateを記録する。実際のWindows appの再現確認なしに原因を断定しない。

integrated terminalのscopeとoutputを別々に確認する

• terminalを開いたら、最初に`pwd`と`git status`でcurrent directory・branch・未commit差分を確認する。HandoffやWorktreeでは、前のchatで見たpathをそのまま使わない。
• Codexがterminal outputを参照できても、outputに出たpath、環境変数、token、外部URLを無制限に共有してよいとは扱わない。必要な行だけを確認し、secret値を表示・記録しない。
• Actionやterminalからbuild・test・server起動を行う時は、command、対象port、filesystem、network、MCP、生成物、停止方法を先に確認する。shortcutやiconはpermission profileを変更しない。
• `Ctrl+L`で表示をclearしても、running process、background server、未保存のoutput、Git変更を消したとは扱わない。再開前にprocess、cwd、branch、diffを確認する。

desktop appのproject contextをlocal folderと別に確認する

• Open folderの直後にprimary folder、Git remote、branch、`git status`、AGENTS.md、`.codex`、対象のbuild・test commandを確認する。secondary folderのAGENTS.mdやconfigが自動で適用されるとは扱わない。
• local projectのprimary folderは既定のGit操作とautomatic discoveryの基準であり、secondary folderは関連作業のための追加contextです。projectへの添付だけでGit操作の対象repoや編集対象が広がるとは決めつけません。
• ChatGPT project、pin、Quick chat、desktop appのCodex、CLI、IDE extensionはそれぞれ別surfaceです。表示上の整理・shortcut・同じaccountだけを理由に、cwd、sandbox、approval、MCP、credential、session stateが共有されるとは扱いません。
• projectやfolderを切り替えた後に作業を再開する時は、`pwd`または表示path、`git status`、branch、未commit差分、terminal host、実行中processを再確認し、前のchatの成功状態を引き継いだと推測しません。

Codex chatの実行modeを開始前に固定する

• 新しいCodex chatを始める時は、目的に合わせてLocal・Worktree・Cloudを選び、表示されたmodeだけでなく、対象path、repo、branch、host、sandbox、approval、MCP、networkを確認する。
• LocalとWorktreeはいずれもcomputer上で動くが、同じcheckoutとは限りません。Worktreeでは別directory・branch・tracked / ignored file・setup・cleanupの前提を再確認する。
• Cloudはremoteのconfigured environmentです。localの未commit差分、credential、MCP、plugin、browser、環境変数、生成物が自動で共有されるとは扱わず、入力・出力・secret・networkの境界を先に決める。
• modeの選択は実行場所とファイル隔離の選択であり、commandの安全、approval、sandbox、test、Git commit・push・deployの成功や承認を意味しない。完了後は対象実行面でdiff・test・未実行範囲を確認する。

通知を「状態確認」と「完了証明」に分ける

通知がない・停止した時の確認順

• まずsurface（desktop・Web・CLI・IDE）、対象chat・task、Activity・Scheduledを確認し、unread・running・waiting・Needs input・Blockedのどれかを切り分ける。
• desktopではturn completion、permission、questionの各通知設定と、WindowsのOS notification permissionを別々に確認する。
• Windowsでは`Ctrl+Alt+U`でActivityを開ける。公式DocsにないOS・surfaceのshortcutは推測せず、表示されたActivityで状態を確認する。
• CLI / IDEでは`notify`が実行するexternal program、接続host、commandのscopeを確認し、秘密情報を引数・環境変数・ログへ渡さない。
• 通知が届いた、または届かなかったことだけで成功・失敗を断定せず、diff、test、未実行範囲、approval、Git state、公開操作の境界を確認する。
• 通知がない時は、設定・channel・OS permission・appの状態を確認する。通知の有無だけで作業が停止した、または完了したと判断しない。

petの表示面と作業面を分ける

terminal petを有効にする前の確認順

• 使っているsurfaceがdesktop app、Web、Codex CLI、IDEのどれかを確認し、`/pet`（desktop）と`/pets`（CLI）を混同しない。
• CLIでは`/pets off`で表示を止められる。表示を止めても実行中command、background process、chat、Git変更は停止・取消にならないため、別途確認する。
• terminal petはiTerm2 3.6以降、またはKitty graphics / Sixel対応terminalが必要で、tmuxとZellij内では使えない。Windowsでは現在のterminalが公式要件を満たすか確認してから試す。
• Needs input・Ready・Blockedの状態を見たら、notification・Activity・CLI output・Git diff・test結果を照合し、petだけを唯一の状態ソースにしない。
• custom petはskillのinstall・reloadと新しいchatを伴う。skillの内容、生成物、local保存、prompt、外部送信、再利用範囲を確認し、見た目の変更を権限追加と解釈しない。
• OSのreduced motion設定がpet animationをstill frameへ変える。表示差をtask停止・failure・完了の証拠と扱わない。

Computer Useの画面操作とshell権限を分ける

WindowsでComputer Useを開始・再開する確認順

• 対象を1つのapp・window・flowに絞り、promptでexact appまたは`@AppName`・`@Computer`と目的を明示する。専用pluginやstructured integrationがある場合は先に比較する。
• Windowsではactive desktopとforeground inputを前提にし、作業中に同じPCのmouse・keyboardを操作しない。Computer Useをbackground実行の代わりに扱わない。
• app permission、Always allow、Computer Use pluginのserver・skill toggle、sandbox・approvalをそれぞれ確認する。どれか1つを許可しても他の層は自動で広がらない。
• signed-in browser、clipboard、screenshot、画面に見えるsecretを対象にしない。必要な場合は人が在席し、送信・クリック・保存の各stepをreviewする。
• taskが別windowを触る、誤ったappを開く、意図しないformを送る、sensitive actionへ進む場合はすぐcancelし、再開前にtarget window・app approval・configを確認する。
• Computer Useの表示上の完了は、ファイル変更、test、Git state、外部appの保存、公開・送信の成功証明ではない。対象appとrepoの両方で結果を確認する。

Browserのsurface・profile・website permissionを分ける

Browserを開始・再開する確認順

• surfaceとprofileを確認する。desktopの`@Browser`、通常のChromeの`@Chrome`、CLI・IDEの作業面を混同せず、exact URL・hostname・public/localの別を明示する。
• ページ内の命令はuntrustedとして扱う。別domainへのredirect、credential、upload、payment、delete、外部送信を要求されたら、ユーザーの明示したscopeと一致するか確認して止める。
• local previewではroute・viewport・stateを名前で固定し、rendered pageの確認とcode diff、test、accessibility、Git stateを別々にreviewする。Browserの完了表示だけで成功と判断しない。
• download、history、cookie、sessionの範囲を確認する。通常のChromeやlocal projectの秘密情報が組み込みBrowser・cloud Browserへ自動共有されるとは扱わない。
• full CDPは必要な時だけ選び、explicit approval、adminの`requirements.toml`、対象Browser、console・networkに出るsensitive dataの範囲を確認する。
• cloud Browserではsigned-in状態やopen tabを前提にせず、site permissionを最小にして、取得した情報のsource・cookie・screenshot・replayをreviewする。

Chrome extensionのsigned-in profileと権限を最小化する

Chrome extensionを開始・再開する確認順

• local previewなら`@Browser`、ログイン済みChromeの既存tabなら`@Chrome`を選ぶ。対象URL、hostname、Chrome profile、active tab、local fileの別をpromptに明示する。
• desktop appのPlugins DirectoryでChrome pluginを有効にし、Chrome toolbarのextensionが同じprofileへinstall・enableされていることを確認する。他のChromium-based browserで動くと推測しない。
• extensionのpermission promptを確認し、page debugger、全site data、history、bookmarks、downloads、tab groups、native application通信がtaskに必要かを分けて判断する。
• 新しいwebsiteのpromptではhostnameを確認し、Allow onceまたはAllow for this siteを優先する。Allow for all sitesはdomain allowlist・blocklistと別に高リスク設定として再確認する。
• browser historyはinternal URL、search term、signed-in deviceのactivityを含み得る。historyアクセスはrequest単位で必要な範囲だけ許可し、page content・selected text・video transcriptもuntrustedとしてreviewする。
• file uploadでは`Allow access to file URLs`を対象Chrome profileだけで有効にし、file path、upload先、送信内容、task終了後の権限を確認する。完了表示だけでupload成功・安全とは扱わない。
• connection不良時は、blocklist、desktop app・Chrome・plugin・extensionのversionとprofile、active Work / Codex chatを確認してから再起動・再installを検討する。

生成ファイルのpreviewと検証結果を別の証拠として扱う

生成ファイルを作成・再開する確認順

• source data、expected file type、structure、review criteriaを先に決め、生成物の保存場所と対象surface（desktop app、Web、CLI、IDE）を明示する。
• desktop appやWebでpreviewが見える場合も、rendered preview、source、実ファイル、download先、account・workspaceを別に確認する。
• HTMLはrendered viewとsource viewを照合し、script、external resource、form、download、error・empty state、responsive表示を必要な範囲で確認する。
• CLI・IDEではvisual previewやannotationがない前提で、absolute output path、作成・変更file、command終了結果、test・lint・format、未確認のviewer範囲を報告する。
• annotationやtargeted feedbackはpage・slide・sheet・table・passageなど対象を狭く指定し、保持する構造・データ・レイアウトを明記する。
• preview、sidebarのplan・sources・summary、完了メッセージを、内容の正確性、secret非混入、Git diff、upload、提出・公開成功の代わりにしない。

project context・primary folder・Git targetを分ける

Projectsとchatを切り替える確認順

• workがself-containedならprojectなし、複数output・同じsource・長期作業ならprojectを選ぶ。ChatGPT projectかlocal projectか、Chat・ChatGPT Work・Codexのどれかを最初に明示する。
• local projectではprimary folderを確認し、`Make primary`で変更されていないか、Git remote・branch・cwd・AGENTS.md・`.codex`・configが意図したrepoにあるかを確認する。
• secondary folderは追加contextとして必要なfileを明示し、automatic discovery・Git操作・PR・worktreeのtargetを広げる理由にしない。remote projectは別host・別folderの実行面として扱う。
• Review paneで複数repositoryの変更が見える時はrepo・branch・Last turn・staged / unstagedを分ける。PR・worktree actionはprimary repositoryをtargetにするため、対象を再確認する。
• CLIでは起動directoryまたは`--cd` / `-C`、IDEではfolder・multi-root workspaceを確認する。desktopのProjects view、project instruction、ChatGPT sourceが自動でCLI・IDEへ移るとは扱わない。
• `/new`でdistinct outcomeを分け、`/resume`・`codex resume`で再開する時はtranscript・recorded working directoryと現在のGit state・diff・processを照合する。耐久的な指示はAGENTS.mdやchecked-in docsへ置く。
• projectのfolder・chat整理はsandboxが読める、書ける、network accessできる範囲を広げない。実行前後にsandbox、approval、MCP、secret、test、Git stateを別に確認する。

IDE extensionのeditor contextと変更レビューを分ける

WindowsでIDEからCodexを再開する確認順

• IDEを開く前に対象repoのabsolute path、Git root、workspaceまたはmulti-rootのroot、remote、branch、`git status`、未commit diff、AGENTS.md、`.codex`、configを確認する。
• composerへ追加するopen file・selection・recent chatをtaskのcontextとして明示し、見えていないsourceや別folderが自動で適用されるとは扱わない。耐久的な指示はAGENTS.mdやchecked-in docsに残す。
• VS Code / Cursor / WindsurfのCodex iconまたはCommand Paletteを使い、Xcode / JetBrainsでは公式integrationの入口を使う。extension未導入、未sign-in、workspace未open、command非表示を混同しない。
• 作業がlocalかCodex webへのdelegateかを選び、host、cwd、sandbox、approval、network、MCP、secret、Git targetを別々に確認する。長い作業のhandoffは権限や完了を広げない。
• IDEのsummaryとfocused diffを読んだ後、実ファイル、Git diff、test・lint・build、生成物、upload parityを確認し、前後のcheckpointと未実行範囲を記録する。

WSL2・native Windows・IDE・CLIの実行面を分ける

WSLを使うWindows作業の再開確認順

• native WindowsかWSL2かを最初に選び、Codex version、WSL version、distro、実際のhost、sandbox mode、network、approval、MCPを記録する。WSL1は現行Codexの選択肢にしない。
• WSLで作業するならrepoのabsolute pathを`/home/...`などLinux側で確認し、`/mnt/c/...`のI/O、symlink、permission、line endingの影響を別に評価する。Windows側の同名repoを現在対象と推測しない。
• VS CodeではWSL extensionと`WSL: <distro>` status、Linux pathのterminal、workspace rootを確認する。Codex iconやIDE extensionが見えても、Windows native windowとWSL windowの実行面を混ぜない。
• WSL shellの`PATH`、`which codex`、node・gitの実体、config、credential、MCP、secretの参照先を確認する。Windows側のPATH・credential・configを自動共有されるとは扱わない。
• WindowsとWSLを切り替えた後は、Git root、branch、未commit diff、生成物、dist/upload、test・build、source path、外部アクセスの未実行範囲を再確認する。WSL導入・update・shutdownはOS状態の変更として別に扱う。

/reviewのscopeとGit stateを分ける

Windowsでreviewを再開する確認順

• 対象projectがGit repo内にあることを確認し、absolute path、Git root、remote、current branch、status、diff、untracked、staged、保護対象ファイルを記録する。別repoの同名pathや前回のreview結果を現在状態と推測しない。
• レビューの目的を、base branch、uncommitted、commit、branch、Last turn、custom criteriaのどれかに限定し、PR番号・branch・commit・対象file・確認観点をpromptで明示する。複数repoでは選択repoを先に固定する。
• Unstagedだけを見て完了にせず、必要ならStaged、Commit、Branchの範囲を個別に確認する。review paneのfindingはGit全体の選択範囲に対する指摘であり、Codexの今回の編集だけに限定されない。
• findingやinline commentは、再現条件・対象行・影響・根拠を確認してから修正を依頼する。follow-upでは修正範囲を明示し、作業ツリー、diff、test・build結果、生成物を再確認する。
• 修正後は通常のsandbox・approvalでstage、revert、commit、pushを判断する。FTP、DNS、CDN、production、Search Consoleはreviewの完了とは別の手動gateとして残す。

Fast mode・credit・Codex-Sparkを分ける

Windows local devで速度設定を再開する確認順

• 最初に実行面をdesktop app、CLI、IDE extension、WSL/native Windowsのどれかへ固定し、ChatGPT sign-inかAPI keyか、対象account、workspace、repo、branchを記録する。
• 現在の /fast status、選択model、config.tomlのservice_tierとfeatures.fast_mode、環境変数、usage・credit dashboardを確認する。前回のchat表示や別profileの設定を現在値と推測しない。
• Fast modeの速度向上とcredit倍率をtask単位で評価し、長時間run、反復debug、生成物build、外部network、MCP、secretを速さだけで自動承認しない。停止条件とbudgetを先に決める。
• Codex-Sparkを選ぶ場合はFast modeとは別modelとしてlimit、preview資格、出力品質、必要なtest・reviewを確認する。Sparkで速く返ったことをrelease・security・productionの証明にしない。
• 設定を変えた後は小さなread-onlyまたは低リスクtaskで実測し、credit・token usage、ログ、diff、test・build、生成物parityを確認する。請求設定やAPI経路の変更は別の承認境界として扱う。

Record & ReplayをWindowsの機能と取り違えない

Windowsでskills・replayを再開する確認順

• 最初にOS、region、account、desktop appのsurface、Computer Useのavailability・enabled状態、organization policyを確認する。WindowsでmacOS限定機能の入口を再現しようとしない。
• recordingするworkflowは既知で安定し、success criteriaが明確な短いものに限定する。録画前に変動するinput、命名規則、decision point、停止条件、検証手順を決める。
• realistic inputを使ってもsecret、API key、Cookie、個人情報、機密file、signed-in画面をrecordingへ含めない。画面content、window、plugin、Browser、外部送信の範囲をreviewする。
• 生成skillは新しいchatでreplayする前に、入力、許可、対象path、外部service、成功条件、検証方法を読み、現在hostのtool・permission・MCP・sandboxと一致するか確認する。
• team配布やMCP・connector・install metadataが必要になったら、skillのreplayとplugin化を分けて設計する。実行後は結果だけでなくdiff、test・build、外部変更、ログ、secret露出、停止方法を確認する。

Sample Configを完成済み設定と扱わない

WindowsでSample Configから再開する確認順

• 現在のhostがWindows nativeかWSL2か、対象repoのabsolute path、Git root、user config、project-scoped .codex/config.toml、CODEX_HOME、使用profileを先に記録する。
• sampleから必要なkey・sectionだけを選び、root keyとtableの位置、重複、commented exampleの解除、config precedence、既存AGENTS.md・policyとの関係を確認する。
• approval_policy、sandbox_mode、writable_roots、network_access、MCP、model、service tier、secret・credentialを一度に広げない。変更前後にcodexの設定表示、status、Git diff、対象pathを確認する。
• Windows native・WSL2・IDE・CLIで実際に読むconfigとprofileが同じとは扱わない。windows.sandbox、windows_wsl_setup_acknowledged、PATH、repo path、生成先をsurfaceごとに確認する。
• OTLPや外部networkを使う場合はendpoint、TLS、header、token、個人情報・source・promptの送信範囲を承認し、設定後に低リスクtaskとログ確認を行う。sample適用をtest・release・production gateの代わりにしない。

Requirements・Managed defaults・workspace権限を分ける

WindowsでManaged configurationから再開する確認順

• ChatGPT desktop app、Codex CLI、IDE extensionのversionとhostを記録し、native WindowsかWSLか、local・cloud・MDM・system requirementsのどの層を使うかを先に切り分ける。
• requirements.tomlのadmin-enforced constraintとmanaged_config.tomlのdefaultを別々に確認し、effective config・status・実際のsandbox・approvalを照合する。
• Requirementsの変更はuserがoverrideできない一方、managed defaultの変更はrun中だけ有効で次回launchに戻る可能性を確認し、再開前後の値とGit diffを記録する。
• MCPを許可する場合はnameだけでなくstdio commandまたはHTTP URLのidentity、structured commandのmatch、空allowlistの意味、plugin marketplaceの対応clientを確認する。
• network、OTel、prompt logging、filesystem restriction、secret送信を最小範囲でテストし、Windowsのdirect file toolとshell subprocessの違いを確認する。Managed configurationの確認をworkspace RBAC、production、deployの完了条件にしない。

project-scoped configはtrustとkey scopeで制限される

WindowsでConfiguration Referenceから再開する確認順

• repoがtrustedか、対象Git root、native WindowsかWSLか、実行中のCodex client・version、CODEX_HOME、user-level config、project-scoped configを記録する。
• project-scoped configへ追加するkeyを一つずつ選び、provider・auth・profile・notification・telemetryなどprojectで無視されるkeyを混ぜない。
• profileを使う場合はprofile fileのpathと--profile名、approval_policy、sandbox_mode、writable roots、network、MCP、modelをstatus・実行結果と照合する。
• approval、sandbox、permission profile、requirementsを別レイヤーで確認し、project trustやconfig読み込みをadmin policy、workspace access、external service accessと混同しない。
• 変更後は低リスクtask、Git diff、ログ・secret・外部送信、dist/upload parityを確認する。Config Referenceのkey存在だけでWindows/WSL、release、productionの成功を断定しない。

Codex Local・workspace・runtime・外部サービスを分ける

Windowsでworkspace/local境界から再開する確認順

• workspace settingsのCodex Localが独立client名ではないことを確認し、実際に使うChatGPT desktop app、Codex CLI、IDE extension、version、Windows native・WSLを記録する。
• seat・workspace role・RBAC・feature accessと、localのapproval、permission profile、sandbox、filesystem・network、managed requirementsを別の欄で確認する。
• pluginがavailableでもconnected systemのauthorizationやauthenticated accountのrepo・file・message accessが自動で広がるとは扱わない。実際のsource systemのpermissionを確認する。
• Codex cloud、local worktree、Platform APIを同じ実行面と扱わず、host、repo path、branch、credential、model、billing、外部送信の境界を照合する。
• 要求がworkspace、local client、cloud、API、plugin、connected systemの複数boundaryを通る場合は全てを確認し、local permission profileやCodex Localの表示だけでworkspace・model・production accessの完了としない。

モデル可否・認証・実行権限を分ける

Windowsでmodel availabilityから再開する確認順

• 最初にproduct surface（ChatGPT workspace、desktop、CLI、IDE、cloud、API）とauthentication（ChatGPT sign-inかAPI keyか）、native Windows・WSL、client versionを記録する。
• workspace plan・member・role、API organization・project、signed-in identity、Codex client supportのどれがmodel accessを決めるかをsurfaceごとに確認し、ChatGPT model pickerを横展開しない。
• profile、managed defaults、model設定、custom agent、scheduled taskのmodel IDを照合し、2026-08-31のgpt-5.4・gpt-5.4-mini移行対象か、API key利用で対象外かを確認する。
• modelが利用可能になった後も、approval、sandbox、filesystem、network、MCP、connected system、secret boundaryを別にテストする。model accessをフル権限の代わりにしない。
• 選択できない場合はsurface・auth・workspaceまたはAPI organization/project・current access control・client/cloud supportの順で確認し、production・billing・deployを自動操作しない。