Multica 完整部署教程：AI 智能体协作平台

Multica 是一个开源的工作区平台，让你能够将 AI 编程智能体（如 Claude Code、Codex、Cursor 等）像团队成员一样分配任务。它提供了一个统一的界面来管理智能体、任务和代码审查，支持自托管部署，确保你的代码和上下文完全可控。

本教程将指导你完成 Multica 的部署，涵盖快速体验（云服务）、一键自托管脚本和高级开发环境搭建。

这是最快捷的体验方式，无需自己管理服务器，适合个人或小团队快速上手。

访问官网：在浏览器中打开 multica.ai 并注册/登录账号。
下载桌面应用（可选）：从 multica.ai/download 下载适用于 macOS、Windows 或 Linux 的桌面客户端。桌面应用会自动将你当前使用的计算机注册为一个“运行时”（Runtime），并检测已安装的智能体 CLI。
添加更多运行时（可选）：如果你需要让智能体在云端或另一台机器上工作，可以在 Web 界面左侧边栏打开 Runtimes，点击 Add a computer，然后在目标机器的终端中粘贴并运行给出的两条命令。
创建智能体：在侧边栏 Agents 中点击 New agent，选择一个已连接的运行时、一个智能体提供商（如 Claude Code），并为其命名。你可以使用 Build with AI 功能通过自然语言描述来生成配置。
分配任务：创建一个 Issue 并将其分配给该智能体。智能体会自动领取任务，在你的机器上执行，并在过程中留下评论，最后将 Issue 移至审查状态。

Multica 允许你将整个平台（包括后端、数据库和 Web 界面）部署在自己的基础设施上。官方提供了一键安装脚本和 Docker Compose 两种主要方式。

此脚本会安装 Multica 服务器及其依赖（需要 Docker）。

1 2	curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh \| sh -s -- --with-server multica setup self-host

Windows：以管理员身份打开 PowerShell，设置环境变量并运行：

1 2	$env:MULTICA_MODE="with-server" irm https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.ps1 \| iex

说明：脚本会从 GitHub Container Registry (GHCR) 拉取官方镜像。如果所选标签尚未发布，可以从代码仓库检出并执行 make selfhost-build 来本地构建镜像。

这种方式提供了更高的可控性，适合已有 Docker 环境的用户。

克隆仓库：

1 2	git clone https://github.com/multica-ai/multica.git cd multica

配置环境：复制示例环境变量文件并根据需要修改（如数据库密码、密钥等）：
1
cp .env.example .env
启动服务：使用提供的 docker-compose.selfhost.yml 文件启动所有服务（包括 Web 前端、Go 后端、PostgreSQL 数据库和 Nginx 代理）：
1
docker-compose -f docker-compose.selfhost.yml up -d
服务启动后，Multica Web 界面会默认在 http://localhost:80 可用。

如果你希望进行二次开发或贡献代码，可以搭建完整的开发环境。

前提条件：

部署步骤：

克隆仓库：

1 2	git clone https://github.com/multica-ai/multica.git cd multica

一键启动开发环境：
1
make dev
这个命令会自动完成以下所有步骤：
- 检测环境并生成 .env 文件。
- 安装所有依赖（前端使用 pnpm，后端使用 Go mod）。
- 使用 Docker 启动 PostgreSQL 数据库并完成迁移。
- 启动所有服务（Web 前端、Go 后端、WebSocket 服务等）。
访问应用：开发服务器启动后，通常可以在 http://localhost:3000 (前端) 和 http://localhost:8080 (后端 API) 访问。

成功部署后，了解以下核心概念有助于你更好地使用 Multica：

运行时 (Runtime)：运行智能体 CLI 的实际机器（你的笔记本电脑或云服务器）。你需要在每台用于执行任务的机器上安装并配置好至少一个支持的智能体 CLI（如 claude, codex）。
智能体 (Agent)：对特定 AI 编程助手的配置封装。你可以为同一个提供商（如 Claude Code）创建多个不同名称的智能体，用于不同的项目或权限。
项目 (Project)：将相关的代码仓库、文档和任务组织在一起，为智能体提供必要的上下文。
技能 (Skills)：将常见问题或解决流程封装成可复用的知识库，所有智能体都可以调用。
小队 (Squads)：将多个智能体或人类成员组合成一个团队，由队长负责分配工作。

智能体无法启动或执行任务：
1. 检查目标 运行时 是否在线且连接正常。
2. 确保该机器上已安装并登录了对应的智能体 CLI（如 claude, codex）。
3. 查看任务的 执行日志 (Execution log)，其中会详细记录每一步的工具调用、命令和错误信息。
自托管时端口冲突：
修改 docker-compose.selfhost.yml 文件中的端口映射（如 "80:80"），或者修改 .env 文件中的相关配置。
数据库迁移失败：
确保 PostgreSQL 服务已完全启动且 .env 中的数据库连接字符串正确。在开发环境下，可以手动运行 make migrate。
更新部署：
- 自托管脚本：重新运行安装脚本即可。
- Docker Compose：git pull 拉取最新代码，然后重新执行 docker-compose -f docker-compose.selfhost.yml pull && docker-compose -f docker-compose.selfhost.yml up -d。
- 开发环境：git pull 后，运行 make dev 会自动更新依赖和数据库。

许可证：Multica 采用 Multica 许可证，其核心是 Apache License 2.0，但附加了关于托管服务、商业嵌入和品牌使用的额外条件。请仔细阅读项目根目录下的 LICENSE 和 NOTICE 文件。
智能体 CLI：Multica 不提供或分发任何智能体 CLI（如 Claude Code）。你需要自行安装、登录并管理这些工具的许可证和使用。
安全：Multica 的设计强调安全。你可以通过 角色 (Roles) 和 访问范围 (Access Scopes) 精确控制每个成员可以运行哪些智能体，以及智能体可以访问哪些资源。