Codex 个人用户安装
在百积木客户端安装 Codex Connector，一次完成 Codex 下载、配置和验证。
整个过程只需要四步。Codex Connector 会在当前电脑上自动完成 ChatGPT desktop app、Codex CLI、隔离的工作区模型凭证和实际调用验证。设备就是运行百积木客户端的本机，工作区就是客户端当前已授权工作区，不需要再选择平台项目。
四步安装
- 打开 百积木客户端下载页，按系统下载并安装客户端。
- 启动百积木客户端并登录，完成当前工作区授权。
- 打开客户端的“应用”，找到 Codex Connector，点击“安装”。
- 等待页面显示“已安装并配置完成”，之后可以直接开始使用。
安装过程中不需要扫码、不需要把链接发送到电脑、不需要复制一大段指令给 AI，也不需要输入设备 ID、工作区 ID、项目 ID、API Key 或访问令牌。
Windows 上，新发布的安装包可能被 Microsoft Defender SmartScreen 标记为“通常不会下载”。只有同时满足以下条件时才继续：下载来自上面的百积木客户端下载页；文件名以 Baijimu_<版本>_x64_en-US.msi 结尾；文件“属性 → 数字签名”的签名者为 原理科技（北京）有限公司，且签名状态有效。条件满足时，在 Edge 下载面板中选择“更多操作 → 保留”，随后选择“仍然保留”。如果 Defender 报告病毒、木马或其他威胁，或者签名缺失、无效、发布者不一致，请立即停止，不要关闭 Defender、添加排除项或强行安装。
Codex Connector 使用公开的 Codex 设备安装执行文档 中的一体化受控脚本。安装包从百积木受控缓存下载并校验 SHA256；连接器只使用客户端当前已授权工作区签发工作区级模型凭证，凭证不会显示在页面或日志中。
如果本机已经登录 ChatGPT/Codex，Connector 不会改写个人 ~/.codex 登录和配置，也不会终止或重启正在使用的桌面客户端；它只创建独立的工作区凭证档案，原登录仍保持为当前选择。全新用户没有可用个人登录时，Connector 会自动启用刚创建的工作区档案，不需要再执行登录或切换步骤。
安装完成标准
客户端显示“已安装并配置完成”前，连接器已经验证：
- ChatGPT desktop app 已安装。
- 当前工作区的隔离 Codex 档案已写入百积木路由和本地认证。
- 已有个人 ChatGPT/Codex 登录和配置保持不变。
- 路由健康检查通过。
- 请求归属到当前用户和当前授权工作区。
遇到问题
在 Codex Connector 页面点击“重试安装配置”。如果仍然失败，把页面上的脱敏错误提示或截图发给支持人员；不要发送完整密钥、访问令牌或敏感业务数据。