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/compozyCompozyOS 是一款为 AI Agent 打造的开源操作系统把你已在用的 Agent CLIClaude 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/clibeta方式三从源码构建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 会自动从当前目录推断并注册工作区workspaceAgent 的上下文就绑定在这里。第 3 步创建会话compozy session new --agent general --name first-run第 4 步查看会话 ID 并发送第一条提示compozy session list compozy session prompt 会话ID 总结这个仓库的顶层结构告诉我应该先读什么。 恭喜Agent 已经开始读取你的代码库了。实时追踪会话事件compozy session events --followCompozyOS 把会话中的每一步——提示词、Agent 回复、工具调用、权限决策、用量事件——都持久化为事件流compozy session events 会话ID --follow这是理解持久化会话最快的方式重要步骤都以事件呈现而不会消失在某个终端窗口里。看完按CtrlC退出。浏览器里监督你的 AgentWeb UICompozyOS 默认从同一 HTTP 地址提供 Web 界面直接用浏览器打开http://localhost:2123浏览器和 CLI 读取的是同一份守护进程状态不是第二份副本。你可以在会话目录中视觉化浏览所有会话与记录实时观察正在运行的会话事件流在 Loops / Tasks / 审批面板中管理自动化工作关闭浏览器只是断开这个查看器不会取消已接受的提示——这正是 CompozyOS 把状态放在守护进程侧的意义。会话收尾停止但不丢失历史compozy session stop 会话ID compozy session history 会话ID # 历史依然完整保留session stop结束实时进程并把会话标记为stopped但会话目录、目录记录、历史全部保留之后再发一条普通提示就能带着同样的历史继续跑。快速开始命令速查表步骤命令安装验证compozy version初始化compozy install配置校验compozy config validate启动守护进程compozy daemon start创建会话compozy session new --agent general --name first-run发送提示compozy session prompt ID ...追踪事件compozy session events ID --follow查看历史compozy session history ID停止会话compozy session stop ID下一步把 CompozyOS 玩得更深定义自定义 Agent在~/.compozy/agents/name/下放一个AGENT.md即可创建可复用的 Agent⏰跑起来自动化给工作加上 Cron 定时、Webhook 与触发器构建第一个扩展compozy extension init hello --template tool-provider-go三步生成可扩展的工具工作流记忆Agent 与人类通过同一套公开接口检视、提议、合并项目记忆核心代码与文档入口供进阶阅读快速开始文档quick-start.mdx安装指南installation.mdxWeb UI 指南web-ui.mdx守护进程运行时internal/daemon/Agent 通信协议ACPinternal/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考