必须按插件类型分路径升级：computer use需在codex设置中检查更新并安装；vs code插件通过扩展面板更新后重启；codexbar cli用codexbar update或手动替换；mac升级后须重授辅助功能与屏幕录制权限；全程保留.config/.codex目录及会话记录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Windows或Mac上把已安装的Codex插件（如Computer Use、VS Code Extension、CodexBar等）升级到最新版，同时确保插件配置、权限状态、绑定账号和本地会话记录全部保留——不是重装，而是原地平滑更新。
Windows平台插件升级路径
先确认你当前使用的是哪类插件主体：桌面应用版（Microsoft Store或exe安装）、CLI工具版（npm全局安装）、还是IDE集成版（VS Code插件）。三者升级逻辑完全不同，混用会导致权限丢失或配置错乱。
方法一：Computer Use插件升级（必须前置完成）
打开Codex → 左下角头像 → Settings → Computer Use → 点击「Check for Updates」→ 若显示「Update Available」，点击Install并等待15秒；【升级过程禁止关闭Codex主窗口，否则权限注册中断】。
方法二：VS Code插件升级
启动VS Code → 打开Extensions面板（Ctrl+Shift+X）→ 搜索“Codex” → 在“OpenAI Codex Assistant”条目右侧点击“Update” → 完成后重启VS Code；这一步不会清除你已配置的workspace settings.json中的codex.*字段。
方法三：CodexBar CLI插件升级（仅限已安装CodexBar用户）
打开PowerShell → 执行codexbar update → 若提示“Permission denied”，说明/usr/local/bin/codex软链接指向只读目录，此时需手动运行：sudo cp /Applications/CodexBar.app/Contents/MacOS/codex /usr/local/bin/（注意：此命令为Mac语法，Windows用户请跳过）。
Mac平台插件升级操作
Mac系统对辅助功能和屏幕录制权限极为敏感，插件升级后若未重新授权，将直接导致Computer Use类插件失效。所有升级必须在「系统设置 → 隐私与安全性」中二次确认权限状态。
① Homebrew安装的CodexBar插件：
执行brew upgrade codexbar → 升级完成后立即前往「系统设置 → 隐私与安全性 → 辅助功能」→ 找到CodexBar.app并勾选（若未出现，点击左下角「+」手动添加）。
② VS Code插件升级：
打开VS Code → Extensions → 搜索Codex → 点击「Update」→ 重启VS Code → 首次启动后Codex插件会自动检测并请求「屏幕录制」权限 → 必须点「打开系统设置」跳转并手动开启，【系统不会再次弹窗提醒，错过即永久失效】。
③ 手动替换DMG安装包升级：
下载新版本DMG → 拖入Applications文件夹 → 系统提示“替换”时选「替换」→ macOS自动迁移旧版偏好设置 → 启动Codex → 输入@Computer Use验证是否唤起记事本。
跨平台通用配置保护动作
第一步：锁定核心配置目录
Windows路径：C:\Users\你的用户名\.codex\；Mac路径：/Users/你的用户名/.codex/。
该目录下auth.json和config.toml两个文件决定API密钥、模型选择、中转地址等全部行为，【任何插件升级前，务必确认该目录未被杀毒软件隔离或同步工具误删】。
第二步：备份sessions日志（可选但推荐）
进入~/.codex/sessions/目录 → 将最近7天的JSON日志文件复制到桌面 → 这些文件记录了配额消耗、失败请求ID、模型响应头，可用于故障回溯。
第三步：验证插件链完整性
终端执行codex --version → 确认CLI版本≥v26.5.0；
打开Codex主界面 → 左下角状态栏应显示“Online · GPT-5.5”；
输入@Computer Use → 记事本启动且右下角显示「Computer Use active」。
