企业官网建设流程全解析

CompozyOS 快速开始：5分钟从安装到第一个 Agent 会话的完整教程

【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy

CompozyOS 是一款为 AI Agent 打造的开源"操作系统"：把你已在用的 Agent CLI（Claude Code、Codex、Gemini CLI、Cursor 等）接入同一个守护进程，让它们组成一个团队——分工协作、互相交接任务、按计划自动运行，并共享同一份项目记忆。本教程带你完成 CompozyOS 安装，并在 5 分钟内跑通第一个 Agent 会话。

先认识一下：为什么需要 CompozyOS

给单个 Agent 发提示词谁都会，但让多个 Agent持续、可靠、可监管地干活，才是真正的工程问题：循环、触发器、定时任务、记忆、权限、审批……这些"胶水"往往要自己写。

CompozyOS 把这些全部产品化了：

• 🧩创建即资产：会话、Agent、Loops 都是可复用的对象，而不是每次重写的脚本
• ⏰自动化：Cron 定时、Webhook、触发器让工作在没有终端打开的情况下继续跑
• 👀可监管：审批、权限、运行状态、产物全程可查
• 💾工作不怕断线：会话和运行归属于守护进程，关闭客户端不会丢失进度

一键安装 CompozyOS：三种方式任选

CompozyOS 是一个本地优先（local-first）的工具：单个 Go 二进制 + SQLite 存储，运行时状态默认全部留在你自己的机器上。当前 v0.3 处于 beta 阶段，推荐以下任一方式安装：

方式一：官方验证安装脚本（macOS / Linux，推荐 ⭐）

curl -fsSL https://compozy.com/install.sh | sh

脚本会固定最新的 beta 版本，先验证 Sigstore 来源签名，再安装二进制。

方式二：npm 全局安装

npm install -g @compozy/cli@beta

方式三：从源码构建

git clone https://gitcode.com/gh_mirrors/co/compozy cd compozy go build -o ./bin/compozy .

⚠️ 注意：Go 的@latest目前解析到的是旧版 v0.2 稳定线，用go install时请显式指定 v0.3 的发布 tag。

安装完成后，验证命令可用：

compozy version

初始化配置：compozy install 一条命令

在终端运行引导命令（交互式安装脚本通常会自动执行这一步）：

compozy install

它会在~/.compozy/下创建两样东西：

• 全局配置文件~/.compozy/config.toml
• 内置generalAgent 的定义~/.compozy/agents/general/AGENT.md

引导流程会引导你为generalAgent 选择默认模型供应商和模型。在此之前，请确保你的 Agent 已经登录——比如 Claude Code 这类原生 CLI 供应商，先用它自己的登录命令完成鉴权。

用下面两条命令确认环境健康：

compozy config path # 查看实际读取的配置文件路径 compozy config validate # 校验配置是否有效

启动守护进程并创建第一个 Agent 会话

这是本教程的核心：从启动到收到 Agent 回复，只需要 4 条命令。

第 1 步：启动守护进程

compozy daemon start compozy status

守护进程是 CompozyOS 的"内核"，会话、任务、记忆都由它统一管理。想在前台看日志可以加--foreground。

第 2 步：进入你的项目目录

cd 你的项目目录

CompozyOS 会自动从当前目录推断并注册工作区（workspace），Agent 的上下文就绑定在这里。

第 3 步：创建会话

compozy session new --agent general --name first-run

第 4 步：查看会话 ID 并发送第一条提示

compozy session list compozy session prompt <会话ID> "总结这个仓库的顶层结构，告诉我应该先读什么。"

🎉 恭喜！Agent 已经开始读取你的代码库了。

实时追踪会话事件：compozy session events --follow

CompozyOS 把会话中的每一步——提示词、Agent 回复、工具调用、权限决策、用量事件——都持久化为事件流：

compozy session events <会话ID> --follow

这是理解"持久化会话"最快的方式：重要步骤都以事件呈现，而不会消失在某个终端窗口里。看完按Ctrl+C退出。

浏览器里监督你的 Agent：Web UI

CompozyOS 默认从同一 HTTP 地址提供 Web 界面，直接用浏览器打开：

http://localhost:2123

浏览器和 CLI 读取的是同一份守护进程状态，不是第二份副本。你可以：

• 在会话目录中视觉化浏览所有会话与记录
• 实时观察正在运行的会话事件流
• 在 Loops / Tasks / 审批面板中管理自动化工作

关闭浏览器只是断开这个"查看器"，不会取消已接受的提示——这正是 CompozyOS 把状态放在守护进程侧的意义。

会话收尾：停止但不丢失历史

compozy session stop <会话ID> compozy session history <会话ID> # 历史依然完整保留

session stop结束实时进程并把会话标记为stopped，但会话目录、目录记录、历史全部保留；之后再发一条普通提示就能带着同样的历史继续跑。

快速开始命令速查表

下一步：把 CompozyOS 玩得更深

• 🤖定义自定义 Agent：在~/.compozy/agents/<name>/下放一个AGENT.md即可创建可复用的 Agent
• ⏰跑起来自动化：给工作加上 Cron 定时、Webhook 与触发器
• 🧩构建第一个扩展：compozy extension init hello --template tool-provider-go，三步生成可扩展的工具
• 🧠工作流记忆：Agent 与人类通过同一套公开接口检视、提议、合并项目记忆

核心代码与文档入口，供进阶阅读：

• 快速开始文档：quick-start.mdx
• 安装指南：installation.mdx
• Web UI 指南：web-ui.mdx
• 守护进程运行时：internal/daemon/
• Agent 通信协议（ACP）：internal/acp/
• 会话管理：internal/session/
• 项目总览：README.md

从compozy install到收到 Agent 的第一条回复，5 分钟就够了。现在，去让它开始干活吧 🚀

【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy