第一次安装 ReCodex：从下载到跑通

桌面端第一次启动会依次经过四个状态：

missing_official_app  →  installed  →  ready_to_login  →  logged_in

排查任何安装问题，第一步都是先确认自己停在哪一个上——后面每一节对应一个状态。

missing_official_app：还没有官方 Codex

ReCodex 的桌面端是官方 Codex 应用的启动器，不是它的替代品，也不会偷偷替你下载官方程序。 所以这个状态下它只做两件事：给你一个下载链接，或者让你手动选一个你自己拿到的安装包。

两种安装包的区别也在这里：

• Full 包自带一个经过兼容性验证的 Codex 客户端，装完直接进下一步；
• Only 包只检查你机器上已有的 Codex 是不是兼容版本。

如果你不确定自己缺什么，可以先跑一次只读检查，它不会改动任何东西：

recodex install check

installed → ready_to_login：装好了，还没登录

这一步不需要你做什么。启动器会拉起官方 Codex 窗口，并把我们的账号面板嵌进去。

logged_in：在账号页登录

登录入口在 Codex++ 窗口内部的 ReCodex 账号页，不在浏览器里。

登录之后，同一个页面还负责这些事：

• 刷新额度
• 轮换会话令牌
• 选择接入网关
• 检查客户端更新
• 发送已脱敏的诊断信息

遇到问题时，先发一次诊断再来找我们——那份数据能直接定位到是网关、是令牌还是本机环境。

重复运行是安全的

启动器是幂等的。再跑一次它会复用已有安装，既不会装后台服务，也不会删掉 Codex 的会话、主题、插件、脚本或工作流数据。

所以「要不要重装一次试试」这个问题，答案通常是：可以，代价很低。