备份、安全与恢复
配置工具按“先备份、再修改、可选择恢复”工作。它不会修改 auth.json，不会移除 ChatGPT 登录状态，也不会结束 Codex、VS Code 或其他进程。
工具只管理 ~/.codex/config.toml 中的以下内容：
- 根字段
model。 - 根字段
model_provider。 - 表
[model_providers.nexagw]。
其他 provider、MCP servers、profiles、审批策略、沙箱配置、features、权限和注释会被保留。若检测到重复 NexaGW 表或无法识别的 TOML 表头，工具会停止并保持原文件不变。
Key 保存方式
Section titled “Key 保存方式”Key 写入当前 Windows 用户的 NEXAGW_API_KEY 环境变量，并同步到本次脚本进程。备份中的旧环境值使用 Windows 当前用户加密保护，不以明文 JSON 保存。
Key 写入 ~/.config/nexagw/env，目录权限限制为当前用户，文件权限为 600。Profile 只加载该文件；备份目录权限为 700，其中的旧 env 文件保持 600。
Key 不写入 config.toml，不会作为命令行参数传递，也不会出现在 Status 输出中。
每次 Configure、Switch 或 Restore 前创建时间戳目录：
~/.codex/nexagw-backups/<timestamp>/目录包含修改前的配置或“原文件不存在”标记、环境状态、操作元数据和 SHA256SUMS。POSIX 版本还备份 NexaGW env 文件与实际使用的 shell profile。
使用菜单恢复
Section titled “使用菜单恢复”- 再次运行与你操作系统对应的配置工具。
- 选择
Restore并确认。 - 从新到旧查看备份，选择目标时间戳。
- 工具先保存当前状态，再校验目标备份哈希。
- 恢复完成后重新打开终端和 Codex。
输出中的 Safety backup 是恢复前状态的回滚点。不要手工改动备份目录中的文件，否则校验会拒绝恢复。
只移除 NexaGW 环境状态
Section titled “只移除 NexaGW 环境状态”[Environment]::SetEnvironmentVariable('NEXAGW_API_KEY', $null, 'User')Remove-Item Env:NEXAGW_API_KEY -ErrorAction SilentlyContinuerm -f "$HOME/.config/nexagw/env"随后在 ~/.profile、~/.bash_profile 或 ~/.zshrc 中移除从 # BEGIN NEXAGW MANAGED ENV 到 # END NEXAGW MANAGED ENV 的完整区块。
下一步：查看常见问题与报错。