Cindy 安装教程（Windows/Mac/Linux）：开源桌面 AI Agent，接 Claude Code、Codex 订阅或自己的 API Key
这两天 GitHub 上涨得最猛的 AI 项目之一是 Cindy（makecindy/cindy），一天涨一千多颗星，现在已经 8 千多。它是一个开源的桌面 AI Agent，能直接接你已有的 Claude Code、Codex 订阅，或者自己的 API Key、本地模型，在你电脑上干活，手机上还能远程接管。
用过 OpenClaw 的应该会觉得很眼熟，思路差不多，但它是开箱即用的桌面客户端，不用敲命令装。而且它专门做了国内版，下载、账号都是分开的。
中文教程目前基本没有，这篇按官方文档把下载安装和第一次启动要注意的地方整理一下。
Cindy 能干什么
- 多个 Agent 引擎：Claude Code、Codex 和 Pi，每个任务可以选不同的引擎和模型
- 模型来源随便选：授权你已有的订阅（比如 Claude Code、Codex 套餐）、填自己的 API Key、用本地模型，或者用 Cindy 官方的模型服务
- 真的动手：能操作你电脑上的文件、浏览器和软件，回复里还能带图表、HTML
- 多设备：同一个任务可以换台设备接着做，手机内置远程桌面，能直接操作电脑
- 自动化：定时任务，从飞书、Slack 这类聊天工具派任务，支持 Skill、插件和 MCP
客户端开源免费（Apache-2.0），但模型调用不是免费的，用订阅就按订阅的额度走，用 API 就按量付费。
下载：国内版和国际版别下错
Cindy 分两个地区，账号不通用：
国内账号就下国内版，海外账号下国际版。官方特别说明不要两个地区混着用，Linux 上也不支持同时装两个地区的版本。
各平台的要求：
- Windows：Windows 10 及以上，x64
- macOS：macOS 13 及以上，分 Apple 芯片和 Intel 芯片两个包，按自己的机器选
- Linux：x64，官方支持 Ubuntu 22.04 / 24.04 和 Arch / Omarchy，arm64 没有 Beta 通道
- 手机：Android 是 APK，iPhone / iPad 有客户端，主要用来远程看和接管电脑上的任务
Windows 和 Mac 直接下安装包装就行，没什么特别的。
Linux 安装
Ubuntu
Ubuntu 22.04 / 24.04 从下载页拿 .deb 包，用 apt 装。之后在软件里更新，更新时会弹授权框。Debian 和 Mint 官方的安装脚本不支持。
Arch / Omarchy
先装依赖（这一步用 sudo）：
sudo pacman -Syu --needed curl jq libarchive coreutils util-linux findutils procps-ng \
gtk3 nss alsa-lib libxss libxtst libnotify libdrm mesa \
gnome-keyring libsecret desktop-file-utils xdg-utils然后用普通用户、不要加 sudo跑安装脚本。国内版：
curl -fsSL https://hotfix.cindy.com.cn/cindy/install-omarchy.sh | bash -s -- --region cn国际版：
curl -fsSL https://hotfix.cindy.app/cindy/install-omarchy.sh | bash默认装在 ~/.local/opt/cindy。以后想更新，可以在软件里点更新，也可以把这条命令再跑一遍，顺便还能修复启动器。
Linux 最常见的坑：密钥环
Cindy 要用系统的密钥环（Secret Service）存登录凭据，密钥环是锁着的就登录不了，而且它不会退回到明文保存。所以：
- 要在正常登录的桌面环境里运行，不要用 root 桌面
- 装了
gnome-keyring和libsecret还不够，要确保登录后密钥环是解锁的（一般靠桌面登录时自动解锁） - 不要再手动起一个密钥环进程，也别为了绕过去关沙箱、乱改权限
卸载的话，退出 Cindy 后删掉安装目录（默认 ~/.local/opt/cindy）和对应的 com.xd.cindy.user.*.desktop 启动项就行，用户数据和密钥环里的东西不会跟着删。
第一次启动
打开后是登录页，有两个选择：
- 登录 Cindy 账号：多设备同步、手机远程这些功能都要账号
- 跳过登录：不登录也能用本地 Agent，界面会显示"未登录"，依赖服务器的功能用不了。只想在一台电脑上试试的话，跳过就行
接着选模型来源：已有的 Claude Code / Codex 订阅、自己的 API Key、本地模型，或者 Cindy 自己的模型服务。官方文档目前没有写每一种的详细配置界面，按软件里的提示走。
想用手机远程操作电脑，要满足三个条件：电脑开着在线、两台设备登录同一个账号、在设置里开了远程相关的权限。
建议顺手关掉使用统计
官方版本里带了 TapDB 使用统计，登录后会跟你的账号关联。官方说不收集聊天内容、文件内容和工作目录，介意的话可以关掉：
- 电脑端：设置 → 关于 → 使用统计
- 手机端：设置里的 使用统计
和 OpenClaw 比怎么选
简单说：OpenClaw 更适合装在 VPS 上 7×24 跑、接各种聊天软件、自己深度折腾；Cindy 是桌面客户端，装上就能用，主打在自己电脑和手机之间操作，还能直接复用 Claude Code、Codex 的订阅。两个不冲突，看你主要在哪用。OpenClaw 的教程我之前写了一整套，见 OpenClaw 中文教程合集。
如果你打算让 Cindy 走 DeepSeek 这类便宜的 API，配置思路和 Claude Code 接第三方模型差不多，可以参考 Claude Code / Codex 接入 DeepSeek。