Codex 安装助手 · 系统入口与常用命令

Windows
完整解压后打开 Codex-Setup.exe 或 Start-Codex-Setup.cmd。
默认桌面版，点击“一键安装桌面版”后自动下载、安装并检查结果；系统授权或官方安装器确认仍需完成。
需要终端版时选择 CLI。助手使用 Windows PowerShell 5.1，桌面版需要 64 位 Windows。
桌面版的 Windows 版本要求和组织限制以官方安装提示为准。

macOS
打开 Start-macOS.command，默认推荐桌面版，也可选择 CLI。
桌面版需要 macOS 14 或更新版本，支持 Apple Silicon 和 Intel x64。
安装时自动下载官方镜像、校验 OpenAI 签名，并复制到当前用户 Applications。
需要 curl 和系统自带的 hdiutil、codesign、spctl、lipo、ditto。不会关闭系统安全检查。
如启动文件没有执行权限，在解压目录运行 chmod +x Start-macOS.command。
配置 Key 时在 Terminal 中隐藏输入。

Linux 桌面
在解压目录运行 bash Start-Linux-GUI.sh，选择桌面版或 CLI。
图形菜单需要已有桌面会话、Zenity，以及 gnome-terminal、konsole、xfce4-terminal、xterm 中的一种终端。
官方桌面预览版支持 Ubuntu 24.04/26.04、Debian 13、Fedora 43/44，以及更新完整的 Arch Linux；支持 x64 和 ARM64。
助手自动选择 .deb、.rpm 或 Arch 官方安装脚本，需要 curl、sudo 和系统软件管理器。
Ubuntu/Debian 使用 apt 与 dpkg-deb；Fedora 使用 dnf 与 rpm。管理员密码在操作终端输入。
Arch 安装会配置 OpenAI 软件仓库并进行完整系统升级，请阅读确认提示后继续。
其他发行版可选择 CLI。官方说明：https://learn.chatgpt.com/docs/linux/linux-app

Linux / macOS 命令行
运行 bash Start.sh menu。桌面环境推荐桌面版；无桌面或 SSH 环境默认 CLI。
需要 Bash 3.2 或更新版本、curl 和系统基础工具。

桌面版命令
bash Start.sh desktop-install
bash Start.sh desktop-check
bash Start.sh desktop-login
bash Start.sh configure-key
bash Start.sh desktop-start /项目文件夹的绝对路径

CLI 命令
bash Start.sh install latest
bash Start.sh check
bash Start.sh configure
bash Start.sh configure-key
bash Start.sh start /项目文件夹的绝对路径
bash Start.sh status

保存助手与查看帮助
bash Start.sh persist
bash Start.sh help

桌面版启动后，在官方应用中选择 Codex 并打开项目文件夹。
Key 方式请通过本助手或保存的入口启动；服务需要支持 Responses 接口。
安装需要联网；模型服务账号、Key 和额度由所选服务商提供。
