安装 Codex

安装 Codex 只需要两层：先安装百积木客户端，再由客户端安装“Codex 桌面管理器”。 不需要复制安装脚本、配置 API Key，也不需要手工下载 Codex 安装包。

第一步：安装百积木客户端

1. 打开百积木客户端公共下载页。
2. 下载页面为当前操作系统推荐的安装包。
3. 完成安装并启动百积木客户端。
4. 登录百积木账号，按客户端提示授权设备并连接工作区。

下载页会动态显示当前客户端版本、适用平台和安装包，不需要在本页选择或记录具体版本。

第二步：安装 Codex 桌面管理器

1. 在百积木客户端打开“应用”。
2. 点击“安装应用”，保持“应用市场”处于选中状态。
3. 搜索并选择“Codex 桌面管理器”。
4. 阅读应用能力、版本、兼容性和权限说明，然后点击“安装应用”。
5. 等待客户端完成后台下载、校验、安装和启动。

Codex 桌面管理器由百积木本地应用市场分发。客户端会根据当前操作系统选择匹配的制品， 并校验市场记录中的应用身份和完整性；不要改用来源不明的压缩包或仓库地址。

第三步：等待 Codex 自动初始化

安装完成后，在“已安装应用”中打开“Codex 桌面管理器”。应用会自动检查本机 Codex 状态， 并在需要时下载安装和初始化 Codex。页面会显示当前步骤、总体进度和下载进度。

初始化完成后，页面会进入“Codex 默认工作区”。此时可以：

• 使用现有 ChatGPT 登录；
• 创建并切换到已授权的百积木工作区认证通道；
• 在需要时重新验证路由或重启 Codex。

认证通道只有在用户明确确认切换时才会改变。切换认证不会删除 Codex 的会话、历史、技能或其他工作区状态。

遇到问题

应用市场找不到 Codex

先刷新应用市场，并确认客户端已经登录、设备已授权且网络可访问百积木服务。仍然找不到时， 请升级百积木客户端后重新打开应用市场。

提示当前版本不可安装

应用详情会显示所需的客户端版本或主机能力。先从公共下载页安装当前客户端，再返回应用市场重试。

Codex 初始化失败

打开“Codex 桌面管理器”，查看失败步骤和错误说明，然后点击“重新安装并修复”。 该操作复用应用内置的安装流程，不需要手工下载 Codex 或修改系统配置。

安装完成后没有进入默认工作区

点击“刷新状态”。如果页面提示工作区尚未授权，先完成客户端设备与工作区授权，再重新检查。