升级codex至gpt-5.5支持版本需保留~/.codex/auth.json和config.toml：windows npm用户执行npm update -g @openai/codex，桌面版下载新exe并勾选“保留现有配置”；mac用户依安装方式分别执行brew upgrade、替换dmg或重装npm包，并修复权限；最后验证项目信任、模型响应头及path路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Windows或Mac上把旧版Codex升级到最新GPT-5.5支持版本，又不想丢失已配置的API密钥、模型偏好和项目信任状态。升级过程必须保留~/.codex/auth.json和~/.codex/config.toml两个核心文件，其他文件可安全覆盖。
Windows平台平滑升级流程
第一步：确认当前安装方式
打开PowerShell，执行where codex。若返回路径含AppData\Roaming\npm\codex.cmd，说明是npm全局安装；若返回C:\Program Files\Codex Desktop\，则是桌面版安装——二者升级路径完全不同。
方法一：npm全局安装用户（推荐）
1. 执行npm update -g @openai/codex，直接拉取最新版CLI工具
2. 运行codex --version验证是否升至0.45.0或更高
【关键】升级后不要删除C:\Users\用户名\.codex\目录，auth.json和config.toml必须原地保留
方法二：桌面版用户
1. 前往OpenAI Codex官网下载最新Windows安装包（exe）
2. 双击运行时勾选「保留现有配置」选项（该选项仅在检测到已有.config目录时出现）
3. 安装完成后手动核对C:\Users\用户名\.codex\config.toml中model字段是否已自动更新为"gpt-5.5"
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
Mac平台增量式升级操作
Mac用户本次升级需特别注意权限变更：新版Codex要求读取屏幕录制权限以启用appshots功能，且首次启动会触发系统级授权弹窗。
① Homebrew安装用户：
执行brew upgrade codex，Homebrew会自动处理依赖链并保留~/.codex目录结构
② 手动下载DMG用户：
将新版本拖入Applications文件夹时，系统提示「替换？」时选择「替换」，macOS会自动迁移旧版偏好设置
③ npm安装用户：
先执行npm uninstall -g @openai/codex，再运行npm install -g @openai/codex@latest
【注意】npm重装后务必检查~/.codex/目录所有权：执行ls -la ~/.codex，若显示root权限需立即修复，否则后续无法写入日志
升级后必检三项
1. 打开终端，进入任意项目目录，运行codex init——若提示「Project already initialized」而非报错，则项目信任状态完好
2. 执行codex chat "test"，观察响应头是否包含X-Model: gpt-5.5字段
3. Windows用户检查PowerShell中$env:PATH是否仍包含Node.js路径，Mac用户验证which codex输出是否指向/usr/local/bin/codex
