tutti-os/tutti · 上手攻略

  • 仓库：tutti-os/tutti
  • 链接：https://github.com/tutti-os/tutti
  • 分类：AI 多智能体协作平台
  • 作者：Tom
  • 更新：2026-07-26

这是什么

Tutti（音乐术语，意为"全体一起"）是一个多 AI 智能体实时协作工作空间。

它解决的问题很直接：当你同时使用 Claude Code、Codex、Canvas 等多个 AI 智能体时，它们各自独立运作——你需要反复在不同窗口之间复制粘贴上下文、解释需求、协调交接。AI 理论上该替你干活，实际上你成了"智能体之间的传话筒"。

Tutti 的核心思路是：让多个 AI 智能体共享同一个工作空间，文件、任务、上下文、App 输出全部实时互通，不再需要人来手动搬运信息。

官方对自己的定位说得很清楚：Tutti is not a replacement for your coding agent. It's a real-time shared workspace for your agents.

解决什么问题

核心痛点：多智能体协作时的上下文丢失与手动交接

典型场景：

  • Claude Code 写好了一个 API，Codex 要接前端 → 你得手动复制粘贴 API 文档、项目现状说明、设计意图
  • 想加 UI，还需要设计师智能体 → 又要再总结一遍，传给下一个
  • 每个智能体的新会话都是从零开始，没有记忆

Tutti 的解决方式：

  1. 实时共享工作空间：Codex 可以直接 @ 引用 Claude Code 的历史会话、文件、任务和 App 调用结果，无需复制粘贴
  2. 智能体间直接指挥：Codex 可以 @ 指挥 Claude Code 去执行任务，而不是让你在两个窗口之间来回跳转
  3. 原生 App 生态：内置图像生成、UI 原型设计、文档、PPT 等 App，智能体可以直接调用，结果留存在同一空间供下一步使用
  4. 任务分解与编排：用户描述目标（"我要做一个网站"），Tutti 自动拆解为子任务，用户审核后分配给合适的智能体执行

快速安装

目前 Tutti 以Electron 桌面应用形式提供，尚未完全开源服务端。

macOS（当前唯一官方支持的桌面端）

下载地址（需访问 Tutti 官网）：

https://tutti.sh/desktop/download?platform=macos&arch=universal&format=dmg

下载 DMG 文件后拖入 Application 即可。

开发环境本地运行（仅限阅读源码，不可完整复现）

⚠️ 以下内容基于 CONTRIBUTING.md，实际运行需要完整的服务端 tuttid，普通用户无法本地完整复现。

前置依赖： - Node.js 24 或更高 - pnpm 10.11.0 - Go 1.24 - golangci-lint v2.12.0

# clone 仓库
git clone https://github.com/tutti-os/tutti.git
cd tutti

# 安装依赖
pnpm install

# 安装 golangci-lint
pnpm install:golangci-lint

# 前置检查
pnpm setup:dev

# 启动桌面应用开发模式
make dev-gui

常见命令：

pnpm build         # 构建
pnpm typecheck     # 类型检查
pnpm lint          # 全量 lint
pnpm test:ts       # TypeScript 测试
pnpm test:go       # Go 测试
pnpm check:full    # 完整验证

仓库结构（源码阅读参考）：

apps/desktop/          # Electron 桌面外壳、渲染进程、预加载桥
services/tuttid/      # 核心长期运行守护进程（Go）
packages/clients/*/   # 共享领域客户端
packages/configs/*/   # 共享工程配置
packages/ui/*/         # 共享视觉系统边界

核心用法

1. @ 引用历史会话与文件

在 Codex 聊天框中，使用 @ 符号可以直接引用： - Claude Code 的历史会话 - 任意本地文件 - App 调用结果 - 任务列表

这解决了过去"跨智能体上下文传递靠复制粘贴"的难题。

2. + 引用 App 产出

在智能体聊天框中点 "+" 按钮，引用本地文件或 App 生成的内容（如 UI 原型图），直接进入下一步工作流。

3. App 生态（核心差异点）

Tutti 内置 App Center，支持用户和智能体共同使用：

App 用途
原型设计 生成 UI 界面草图，Codex @ 调用相当于获得 Claude Design 能力
AI Canvas（图像生成） 生成配图，可直接拖入 Codex 或 Claude Code 的前端开发流
AI 文档 起草、结构化整理文章，导出 HTML
AI PPT 生成演示文稿，支持手动拖拽模块调整

App 调用依赖用户已有的智能体订阅（如 Codex、Claude Code），不额外收取模型费用。

4. 目标→任务自动分解

描述一个目标（例如"我要做一个网站"），Tutti 自动拆解为可执行的子任务，审核后分配给对应的智能体，减少手动规划。

5. Tutti · VM（即将推出）

官网显示 Tutti · VM 正在开发中，提供多人协作版本。@ 引用将支持跨协作者——@ 队友即可拉取其任意智能体的会话、文件或任务，实现真正团队级别的 AI 协作。

典型适用场景

适合使用 Tutti 的人：

  • 同时订阅了多个 AI 智能体（Claude Code、Codex、Canvas 等）并希望它们协同工作
  • 有复杂的多步骤项目，需要设计→开发→配图的完整流程
  • 希望减少在不同 AI 产品之间复制粘贴上下文的工作量
  • 多人团队希望共享 AI 智能体的工作成果

不太适合：

  • 只需要单一智能体完成独立任务
  • 对数据隐私要求极高（需要评估桌面应用的数据流向）
  • Windows 用户（当前仅 macOS 可用桌面端）

坑与注意

  1. 桌面端仅 macOS
    Windows 支持在开发路线图上，但目前没有可用的 Windows 版本。Linux 尚无官方支持计划。

  2. VM 版需等待
    多人协作（Tutti · VM）尚未发布，跨人协作能力受限。

  3. 完整功能需要订阅多个 AI 产品
    Tutti 本身不提供 AI 模型能力，App 调用依赖用户的 Codex/Claude Code 等订阅账号。

  4. 开源的是桌面壳，服务端未完全开源
    GitHub 仓库开源了 Electron 前端和部分代码，但核心的 tuttid 守护进程的功能完整度和开源程度需要进一步确认（CONTRIBUTING.md 中提到了它的存在）。

  5. API 尚未稳定
    官方文档注明"Tutti is in early preview — APIs may change before 1.0"。

与同类对比

工具 定位 核心差异
Tutti 多智能体实时共享工作空间 实时共享上下文 + 原生 App 生态，智能体间无需人肉传递
Claude Squad 终端多智能体管理 纯命令行，在独立工作区运行多实例，无共享空间
AgentsHive 多智能体角色协作 强调角色分配，但为独立项目（非共享空间设计）
OpenClaw AI Agent 运行时与平台 偏向服务端编排与任务流，支持多种 Agent 运行时
Cursor / Windsurf 单智能体 IDE 单一智能体增强，非多智能体协作场景

Tutti 的核心差异化：实时共享 + App 生态，让智能体之间可以像团队成员一样互相引用产出，而不只是接收人类的文字转述。

一句话推荐结论

如果你已经同时使用多个 AI 智能体、厌倦了在不同窗口之间手动搬运上下文，Tutti 是目前最接近"智能体即团队成员"这一愿景的桌面级协作平台，值得在 macOS 上试水（Windows 用户请关注 VM 版路线图）。