快速上手
连接一台电脑，创建你的第一个智能体，并让它完成第一个任务。
智能体执行前，运行它的电脑上需要有至少一款已安装并登录的支持的 AI 编程工具，例如 Claude Code、Codex 或 Cursor。Multica 不自带这些工具。
登录，进入工作区
用 Web（multica.ai）或 Multica Desktop 登录，支持邮箱验证码和 Google。用 Desktop 登录的话，下一步可以自动连接这台电脑；用 Web 则要在下一步通过命令行连接。
连接一台电脑
智能体在你连接的电脑上执行工作。打开侧边栏 AI 团队 下的 运行时：
- 用 Desktop：Desktop 会自动把这台电脑注册为运行时，并检测已安装的 AI 编程工具。刚安装的工具，点"刷新"重新检测。
- 用 Web，或需要添加另一台电脑：点右上角的 添加，选择 其他机器或服务器，在目标电脑的终端里运行弹窗给出的两条命令：
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash
multica setupmultica setup 会打开浏览器完成登录，然后让守护进程在后台运行。守护进程上线后，弹窗通常在一分钟内检测到这台电脑。
成功标志：运行时列表里出现一台在线的电脑。
自托管实例的连接命令略有不同，见自托管快速上手。
创建一个智能体
打开侧边栏 AI 团队 下的 智能体，点 新建智能体。先选择刚连接的电脑上的一款 AI 编程工具，再填名称，点 创建智能体。必填的只有运行时和名称。
不想从头写配置，可以在配置页点 让 AI 帮我写，由 Agent Builder 提问并补全；这需要所选运行时在线。其余配置可以之后完善，详见创建和配置智能体。
成功标志：智能体列表中出现你的智能体，并显示为在线。
把第一个任务交给它
点侧边栏顶部的 新建任务（或按快捷键 C）。在默认的智能体模式下：
- 在 创建者 中选择刚创建的智能体；
- 用一两句话描述要做的事，例如"介绍一下这个工作区可以怎么用"；
- 提交。Multica 会创建任务、把智能体设为负责人并立即开始执行。
常见问题
| 现象 | 先检查什么 |
|---|---|
| 没有找到运行时 | 确认 AI 编程工具已经安装并能在终端中运行。Desktop 点"刷新"；CLI 方式重新运行 multica setup。 |
| 运行时显示离线 | Desktop 保持打开；CLI 方式运行 multica daemon status，未启动时运行 multica daemon start。 |
| 任务一直排队 | 确认智能体使用的运行时在线。运行时达到并发上限时，新运行会继续排队。 |
更多情况见故障排查。
接下来
- 核心概念 — 三分钟认识 Multica 的全部核心对象。
- Multica 的工作方式 — 理解任务、智能体、运行时和每次执行之间的关系。
- 让智能体开始工作 — 除了分配，还可以用 @提及、对话和自动化让智能体开始工作。