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）。理解了这个关系，后面的部署思路就清晰了。