STEP 1 REQUIRED

先登录，未登录不继续

CodexIPhone 采用 Hosted 标准流程。请先在 App 完成邮箱验证码登录，再进行电脑端安装和扫码配对。

未完成登录前，请不要执行后续安装或配对步骤。

打开 App，输入邮箱地址。
点击 Send Email Code 获取验证码。
点击 Verify and Login 完成登录。

Step 2：电脑端安装

登录完成后，优先使用桌面客户端下载包；它能帮你完成 runtime 安装、配对和状态检查。脚本方式仍然保留，适合命令行用户。

macOS 客户端

https://my-agent.com.cn/codexiphone/codex-connector-installer.dmg

下载后双击 .dmg，把应用拖到 Applications 即可安装。首次打开后，先选择 CodexIPhone runtime 目录，再用 App 内按钮管理 connector。

Windows 一键包

下载 Windows 安装器

https://my-agent.com.cn/codexiphone/codex-connector-installer.exe

下载后双击 codex-connector-installer.exe。安装器会把 Codex Connector app 装到本地，并可选择是否创建桌面图标。安装完成后会自动打开 app，由 app 提供 Install / Repair / Uninstall / Exit、进度条和状态日志。

如需兼容旧流程，仍保留 zip 包作为备用下载格式。

备用：macOS zip 备用：Windows zip

如果你更习惯脚本方式，仍可继续使用下面的安装命令：

macOS / Linux 脚本安装

curl -fsSL https://my-agent.com.cn/codexiphone/install.sh | bash

Windows PowerShell 脚本安装

powershell -ExecutionPolicy Bypass -Command "iwr https://my-agent.com.cn/codexiphone/install.ps1 -UseBasicParsing -OutFile $env:TEMP\\codexiphone-install.ps1; & $env:TEMP\\codexiphone-install.ps1"

macOS / Linux 卸载脚本

curl -fsSL https://my-agent.com.cn/codexiphone/uninstall.sh | bash

Windows PowerShell 卸载脚本

powershell -ExecutionPolicy Bypass -Command "iwr https://my-agent.com.cn/codexiphone/uninstall.ps1 -UseBasicParsing -OutFile $env:TEMP\\codexiphone-uninstall.ps1; & $env:TEMP\\codexiphone-uninstall.ps1"

卸载会停止桌面服务、取消当前桌面配对，并清掉本地 CodexIPhone runtime。

Step 3：扫码配对

电脑端完成安装后，保持配对二维码可见。
iPhone 点击 Scan Setup QR 扫描桌面二维码。
在状态页确认设备为 ONLINE。

验收标准：可创建线程并完成消息往返。

产品范围

当前发布形态为 Hosted-only（非自托管）。
安装器仅下载电脑端 runtime 包，不包含 iOS 工程源码。
登录与配对采用邮箱 OTP + Setup QR，不开放手填服务地址。
下载由 runtime-manifest.json 统一下发（版本 + SHA256）。
生产密钥与隐私 token 不会内置在安装包中。

重置、重配与账号删除

Sign Out and Reset (Full) 只清手机本地会话与配置。
重新扫码会新增一条设备关系；旧设备默认保留。
可在 Settings -> Devices -> Active Device 切换控制目标。
如需删除 Hosted 账号，请在 App 内进入 Settings -> Account -> Delete Account。