> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Cindy 安装教程（Windows/Mac/Linux）：开源桌面 AI Agent，接 Claude Code、Codex 订阅或自己的 API Key
- URL: https://tbbbk.com/cindy-ai-agent-install-guide/
- Published: 2026-10-28T23:28:06.000Z
- Updated: 2026-10-28T23:28:06.000Z
- Description: 最近 GitHub 上爆火的开源桌面 AI Agent Cindy：国内版怎么下、Linux 怎么装、第一次启动要注意什么。
- Author: TuBaiBai
- Tags: AI 编程工具, Cindy

这两天 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 分两个地区，账号不通用：

- 中国大陆：[cindy.cn/download](https://cindy.cn/download)
- 海外：[cindy.app/download](https://cindy.app/download)

国内账号就下国内版，海外账号下国际版。官方特别说明不要两个地区混着用，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 中文教程合集](https://tbbbk.com/openclaw-guide/)。

如果你打算让 Cindy 走 DeepSeek 这类便宜的 API，配置思路和 Claude Code 接第三方模型差不多，可以参考 [Claude Code / Codex 接入 DeepSeek](https://tbbbk.com/claude-code-codex-deepseek-flash-setup/)。

参考：[Cindy GitHub](https://github.com/makecindy/cindy)、[中文 README](https://github.com/makecindy/cindy/blob/main/README.zh-CN.md)、[Linux 安装文档](https://github.com/makecindy/cindy/blob/main/docs/linux.md)。