@@ -115,12 +115,30 @@ python -m codex_fast_proxy status
115115
116116Report the set-upstream JSON and the final status JSON. The key fields are ` provider ` , ` base_url ` ,
117117` previous_upstream_base ` , ` upstream_base ` , ` service_tier_policy ` , ` upstream_auth ` , ` config_matches ` ,
118- ` verification ` , ` restart_required ` , and ` start_result ` .
118+ ` verification ` , ` restart_required ` , ` start_result ` , and ` next_user_action ` .
119119
120120Do not use ` --restart ` unless the user explicitly accepts that restarting the proxy can interrupt
121121current proxy-backed Codex sessions. If ` restart_required=true ` , tell the user to restart Codex App,
122122open a new CLI process, or run ` python -m codex_fast_proxy start ` later to apply the new upstream.
123123
124+ For ChatGPT-login preparation, ` restart_required=true ` or final ` status.needs_restart=true ` is a
125+ hard stop before login. The provider auth split has been verified and saved, but the running proxy
126+ has not loaded the new auth override yet. Tell the user to restart Codex App, or explicitly allow
127+ ` python -m codex_fast_proxy start ` , before signing in with ChatGPT. Do not tell the user they can
128+ switch to ChatGPT login while ` needs_restart=true ` ; model requests may still fail with 401.
129+
130+ After provider auth split is active and final ` status.needs_restart=false ` , the user can sign in
131+ with ChatGPT if they want the full Codex App UI. Also mention this Windows login troubleshooting
132+ path: if ChatGPT login fails with ` OSError: [WinError 10013] ... socket ... ` , ask the user to retry
133+ after running these commands in an Administrator PowerShell:
134+
135+ ``` powershell
136+ net stop winnat
137+ netsh interface ipv4 show excludedportrange protocol=tcp
138+ net start winnat
139+ netsh interface ipv4 show excludedportrange protocol=tcp
140+ ```
141+
124142If the user changed API key environment variables, model, reasoning, or other Codex config, tell
125143them to restart Codex App or open a new CLI process so Codex reloads those settings. The proxy can
126144read Windows user environment variables directly when possible, but already-running Codex processes
0 commit comments