Codex 安装助手 1.4.0 · 使用指南

先完整解压整个 ZIP，再打开对应系统入口。安装需要联网，助手会从官方渠道下载桌面应用或 CLI。

1. 安装软件
   普通电脑用户使用默认的“桌面版（推荐）”。需要终端、服务器或自动化时选择“CLI 终端版”。
   Windows：点击“一键安装桌面版”。助手优先通过 winget 自动安装；没有 winget 时下载并校验 Microsoft 签名的官方安装器，再运行安装器。
   请按系统提示允许安装。点击安装即接受 Microsoft 商店与应用许可协议；官方安装器可能需要确认。
   安装完成并检测到应用后，助手自动进入第二步。失败时查看窗口提示，不要同时运行另一项安装。
   macOS：在图形菜单选择桌面版并安装。助手按处理器下载官方镜像、校验 OpenAI 签名，并安装到当前用户的 Applications。
   Linux 桌面：选择桌面版并安装。助手按系统和处理器选择官方安装包，软件管理器会处理依赖；请在操作终端输入管理员密码。
   Arch 官方安装脚本会配置 OpenAI 软件仓库并进行完整系统升级，请确认接受升级再继续。
   已有桌面版时保留现有安装，可直接进入第二步；更新由官方应用或系统软件管理器处理。
   CLI：切换到 CLI 后按第一步提示安装或更新。

2. 登录或填写 Key
   账号方式：在官方桌面应用或 CLI 中按提示登录，已有登录可直接继续。
   Key 方式：填写 API 基础地址、完整模型名称和访问密钥，允许保存后完成保存。
   方核服务地址默认 https://fangcore.baobao.pw/v1；模型名称和 Key 使用服务商提供的信息。
   Windows 在第二步填写表单；macOS / Linux 在 Terminal 或操作终端中隐藏输入 Key。
   服务需要支持 Responses 接口；地址不要填写到 /responses 或 /chat/completions。
   Key 方式使用助手的独立配置。请从本助手或它创建的入口启动，以读取保存的信息。
   保存不调用模型；实际请求按所选服务计费。

3. 开始使用
   桌面版：打开官方应用，在应用中选择 Codex，再打开需要处理的项目文件夹。
   CLI：选择项目文件夹并点击“启动 Codex CLI”，在终端中发送请求。
   按应用提示确认文件访问和运行权限，发送一条简单请求开始使用。

常见问题
- 下载或安装失败：检查网络、系统版本、剩余磁盘空间和系统授权；完成系统安装窗口中的操作后可重新检查安装。
- Windows 商店受到组织限制：请联系设备管理员允许官方应用安装。
- 官方应用显示 ChatGPT：在应用中选择 Codex。
- Key 方式不能响应：核对服务地址、模型名称、Key、余额和接口支持情况。
- 从系统原有入口打开时没有服务配置：使用本助手的启动按钮或它创建的桌面入口。
- 更换服务：在第二步重新填写并保存，再从本助手启动。
- 切回账号：选择账号方式，并在官方应用或 CLI 中完成登录。
- 服务器或 SSH 没有桌面：选择 CLI，无需安装桌面环境。
- EXE 无法打开：使用同目录 Start-Codex-Setup.cmd；不要只复制 EXE。

系统入口、依赖与命令见 MULTIOS.txt。请保护设备，不分享密钥或登录二维码。
