连接你的第一台设备

各端安装一次后台采集服务，之后通过浏览器管理。

1. 下载通用安装包

需要 Python 3.9 或更高版本，以及本机已登录的 Codex CLI。

安装包包含采集服务、本地网页和插件文件，不包含原生桌面客户端。Windows 原生和 WSL 的 Codex 环境需要分别安装。

macOS / Linux：在解压后的目录运行

python3 scripts/install-service.py install
python3 scripts/install-service.py status
python3 scripts/install-plugin.py

Windows：在解压后的目录打开 PowerShell，运行

python scripts/install-service.py install
python scripts/install-service.py status
python scripts/install-plugin.py

status 会显示带本机访问密钥的网页地址。打开它，进入“账号同步”，生成配对码；再回到云端“我的设备”输入配对码。

可使用 start、stop、status、uninstall 命令管理服务。卸载会保留统计数据。

macOS 使用登录启动项，Linux 使用 systemd 用户服务，Windows 使用当前用户的启动项。没有 systemd 用户服务的环境可直接运行 python3 backend/cli.py serve。

如果 Codex 不在默认位置，安装时追加 --cli 程序路径；如果使用自定义日志目录，追加 --codex-home 目录。包含空格的路径需加引号。