Skip to content

Commit e658107

Browse files
committed
docs: split README and harden ChatGPT login handoff
1 parent 938d37e commit e658107

6 files changed

Lines changed: 508 additions & 737 deletions

File tree

.codex/SET_UPSTREAM.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,12 +115,30 @@ python -m codex_fast_proxy status
115115

116116
Report 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

120120
Do not use `--restart` unless the user explicitly accepts that restarting the proxy can interrupt
121121
current proxy-backed Codex sessions. If `restart_required=true`, tell the user to restart Codex App,
122122
open 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+
124142
If the user changed API key environment variables, model, reasoning, or other Codex config, tell
125143
them to restart Codex App or open a new CLI process so Codex reloads those settings. The proxy can
126144
read Windows user environment variables directly when possible, but already-running Codex processes

0 commit comments

Comments
 (0)