Multica 自托管部署与使用入门:从上线到让 AI Agent 真正干活
Multica 是一个把 AI Agent 当成团队成员来使用的任务协作平台。你可以把它理解成“带 AI 员工的 Linear”:你创建 issue、分配给某个 agent,agent 会通过你自己的机器执行代码开发、总结、规划等任务。

这篇文章记录一次单机自托管 Multica 的完整使用流程,包括 Docker Compose 部署、邮件验证码、Runtime 连接、Agent 使用方式,以及几个容易踩的坑。
1. Multica 的核心概念
先弄清楚几个角色,后面会容易很多。
Multica 前端浏览器里看到的网页界面
Multica 后端管理登录、工作区、issue、agent、runtime
PostgreSQL保存用户、任务、评论、agent 配置等数据
Runtime / Daemon真正执行任务的机器
AgentMultica 里的 AI 成员,比如 Coding Agent、Planning Agent
Codex / Claude / OpenCode 等 CLIAgent 背后实际调用的 AI 编程工具
最关键的一点:
Agent 只是角色配置,Runtime 才是真正干活的机器。
也就是说,你在 Multica 的前端看到的“Coding Agent”,其实只是一个配置模板——真正跑代码、调 API 的,是你自己的机器(Runtime)。理解了这个关系,后面的部署思路就清晰了。
