Multica 托管服务使用教程

用 multica.ai 托管服务（无需自己部署 Docker），把 Claude Code、Codex 等 AI 编程工具接进来，像管理团队一样创建项目、分配需求、让 agent 自动开发。本文聚焦"怎么用"，不涉及部署。

一、5 分钟跑通（Cloud 版）

注册 multica.ai → 连接一台电脑 → 创建智能体 → 分配第一个任务 → 看结果

第 1 步 注册登录：打开 multica.ai，邮箱收验证码登录（也支持 Google）。

第 2 步 连接电脑（二选一）： - Desktop 应用（macOS/Win/Linux）：下载安装后自动把这台电脑注册为运行时，并检测已装工具。最省事。 - Web + CLI：网页里「设置 → 运行时 → 添加电脑」，在目标电脑终端跑弹窗给的两条命令： bash curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash multica setup # 打开浏览器登录，后台启动守护进程 成功标志：运行时列表出现一台在线的电脑。

第 3 步 创建智能体：工作区 → 智能体 → 新建智能体，最少填名称 + 运行时即可。

第 4 步 分配第一个任务：新建任务（快捷键 C）→ 选智能体为创建者 → 一句话描述（如"介绍一下这个工作区可以怎么用"）→ 提交。打开任务即可看到执行日志 + 时间线。

⚠️ 前置：运行 agent 的电脑上至少装好并登录一款 AI 编程工具（Claude Code / Codex 等）。Multica 只驱动这些工具，不自带它们。

二、创建团队（工作区）

工作区是 Multica 的最上层隔离边界：成员、任务、项目、智能体、skill 全部属于某个工作区，彼此隔离。

创建工作区（填三项）

字段 说明
名称 展示给成员，之后可改
工作区 URL 地址 slug（multica.ai/my-team 里的 my-team），小写字母/数字/连字符，创建后不可改
任务前缀 任务编号前缀，如 MUL → 任务显示 MUL-1、MUL-2，工作区内递增

创建者自动成为 owner。

三种角色

操作 owner admin member
查看工作区、日常协作（建任务/评论） ✓ ✓ ✓
修改工作区设置 ✓ ✓ —
邀请 admin/member、调整/移除 admin/member ✓ ✓ —
授予/收回/移除 owner ✓ — —
删除工作区 ✓ — —

角色只管工作区设置和团队管理，不决定谁能运行智能体——每个智能体有独立的 Access（见下文）。

邀请成员

设置 → 成员 → 输入邮箱 + 选角色 → 发邀请。受邀者用该邮箱登录即接受，无需提前注册，邀请 7 天有效。owner 需先加入再被提升。

三、创建项目（组织需求）

项目用来组织需要多条任务一起完成的工作（一次发布、一次迁移、一个分阶段功能）。一条任务能说清的工作不需要项目。

项目组成

内容 用途
名称、图标、描述 目标、范围、长期要求；描述会进入项目内智能体的执行上下文
状态 planned / in_progress / paused / completed / cancelled
优先级 urgent / high / medium / low / none
负责人（lead） 成员或智能体，只表示"谁协调"，不自动分配任务
日期 开始/截止
资源 关联 GitHub 仓库或本地目录

进度自动计算：进度 = (done + cancelled 的任务数) ÷ 项目总任务数。

关联资源（让 agent 知道在哪改代码）

资源 场景 执行位置
GitHub 仓库（推荐） 团队共享代码库 运行时管理的工作目录，默认 worktree 并行
本地目录 超大仓库 / 需直接看本地改动 指定电脑的原目录（仅 Desktop 可选）

worktree 模式（强烈推荐）：每次运行拿到仓库的独立 git worktree，同一仓库可无限并发、互不干扰，结果以分支 agent/<agent>/<issue> 交回，你用 git log/git diff 审阅后自己决定 merge 还是 cherry-pick。Multica 不会替你合并。而 in_place 模式是直接改你当前分支和未提交文件，同一时间只跑一次。

CLI 关联仓库：

multica project create --title "Agent UX" --repo https://github.com/your/repo
multica project resource add <project-id> --type github_repo --url https://github.com/your/repo --ref main

四、接入 Agent 工具（Codex / Claude Code 等）

1. 安装 + 登录工具

先在执行电脑的终端装好工具并登录（Multica 只检测、不代装、不代登录）：

工具 命令 版本要求 官方安装
Claude Code claude ≥ 2.0.0 anthropic 官方
Codex codex ≥ 0.100.0 openai 官方
Copilot CLI copilot ≥ 1.0.0 GitHub
DeepSeek Harness dsh Node 20+ npm i -g @deepseek-ai/dsh
Kimi kimi — 月之暗面
Qwen Code qwen ≥ 0.20.0 阿里通义
MiniMax Code mcode ≥ 0.1.2 npm i -g @minimax-ai/code

完整 26 种工具见附录。登录凭据留在本机，Multica 不收 Claude/Codex 的 token。

2. 确认守护进程能识别

command -v claude   # 返回路径说明在 PATH 里
command -v codex
multica daemon restart   # 装了新工具后重启守护进程重新检测

守护进程至少检测到一款内置支持的工具才启动。装了但识别不到：multica daemon logs -f 看版本/路径/认证错误。

3. 工具能力对照（选型关键）

工具 会话恢复 Multica 管 MCP skill 注入位置
Claude Code ✓ ✓ .claude/skills/
Codex ✓ ✓ $CODEX_HOME/skills/（单次执行隔离）
DeepSeek Harness ✓ ✓ .dsh/skills/
Hermes ✓ ✓ 单次执行 HERMES_HOME/skills/
Kimi ✓ ✓ .kimi/skills/
Qwen Code ✓ ✓ .qwen/skills/

模型来源：创建智能体时模型列表来自对应运行时。DeepSeek Harness 用 dsh --profile multica --list-models 列出，模型 id 是 provider/model 形式（如 deepseek-official/deepseek-chat）。

4. 国内网络/账号的现实提醒

五、管理开发需求（核心工作流）

1. 创建任务（issue）

任务 = 一项工作的完整上下文（标题、描述、负责人、状态、讨论、执行记录）。填标题即可，其余随时补。

7 个内置状态（可按需在设置里加自定义状态）：

状态 含义
backlog 暂不启动（分配智能体不会启动执行，移出才启动）
todo 已明确，等待开始（分配即启动）
in_progress 处理中
in_review 已有结果，等检查
done 完成（通常留人工确认或 PR 合并）
blocked 卡外部依赖
cancelled 不再继续，保留记录

2. 四种触发 agent 的方式

方式 何时用 效果
分配任务 需要 agent 持续负责一项工作 设负责人 = 创建运行；可"暂不开始"只设归属
评论中 @智能体 只需处理一条具体请求 不改变负责人，只处理这条评论
对话 提问/探索/私人草稿 一对一私人，不依附任务
自动化 定时/事件触发的重复工作 cron 或 webhook

分配任务的标准动作：打开任务 → 点「负责人」→ 选智能体/小队 → 确认窗点「开始」。确认窗里的「暂不开始」只保存负责人、不创建运行（适合先明确归属，等依赖就绪）。

分配后：智能体读取任务说明/评论 + 自己的指令/skill/项目上下文 → 在本地工作目录跑 → 边跑边评论、自动把状态推到 in_progress → 交付推到 in_review。

3. 评论、@提及与对话

4. 智能体配置要点

配置 作用
指令 每次执行都读：职责、边界、先查什么、允许改什么、如何交付、何时问人
Skills 挂可复用方法包
模型 + 运行时 哪台机器、哪款工具、哪个模型
Access 谁能运行：仅自己 / 整个工作区 / 指定成员
并发上限 默认 6，daemon 全局 20
环境变量 注入工具启动环境（放有限权限凭据，服务端明文存储，别放高价值 key）

5. 沉淀 Skill（复用方法）

Skill = SKILL.md 主文件 + 可选 references/、templates/、scripts/。四种导入：手动创建 / 本地导入（文件夹或 .skill/.zip）/ URL 导入（GitHub、ClawHub、Skills.sh）/ 从运行时复制。挂给智能体后，方法多处复用、一处维护。

6. 小队（多 agent 协作）

小队 = 1 个 leader 智能体 + 若干成员（智能体或人）。分配小队时只唤醒 leader，由它读上下文、@成员 派活、记 evaluation、派完就停。适合"工作需多能力、创建任务时定不了负责人"的场景。

7. 自动化（cron + webhook）

输出模式 行为
创建任务 先建任务再分配，记录留任务里
仅运行 直接建运行，不产生任务

cron 用标准 5 字段（不含秒）：0 9 * * 1-5（工作日 9:00）。webhook 生成唯一 URL，POST JSON 触发（≤256 KiB，Idempotency-Key 去重）。

8. 接飞书（你已用飞书）

Cloud 无需配置密钥。智能体 → 集成 → 绑定到飞书 → 扫码授权。之后：私聊直接发消息、群里 @Bot、/issue 标题 创建任务。每个 Bot 对应一个智能体。

六、典型工作流：需求 → PR

1. 建项目「用户中心重构」，关联 GitHub 仓库（worktree 模式）
2. 建任务「重构登录模块」，负责人 = 智能体「Backend Engineer」
3. 智能体领取 → 在独立 worktree 里开发 → 边做边评论
4. 智能体交付 → 推到 in_review → 结果交回分支 agent/backend-engineer/MUL-3
5. 你 git log/git diff 审阅 → 决定 merge 还是 cherry-pick
6. 需要改：在评论里 @智能体 提要求，它续接同一分支继续
7. 满意 → merge 后关联 PR → 状态 done

七、落地清单

附录：26 种支持的工具

Claude Code(claude)、Codex(codex)、Copilot(copilot)、Cursor Agent(cursor-agent)、DeepSeek Harness(dsh)、Hermes(hermes)、Kimi(kimi)、Qwen Code(qwen)、QwenPaw(qwenpaw)、MiniMax Code(mcode)、Qoder(qodercli)、Qoder CN(qoderclicn)、Trae(traecli)、Antigravity(agy)、CodeBuddy(codebuddy)、CodeArts(codearts)、DevEco(deveco)、Grok(grok)、Kiro(kiro-cli)、OpenClaw(openclaw)、OpenCode(opencode)、Pi(pi)、Oh-My-Pi(omp)、Reasonix(reasonix)、Dim(dim)、ZeroClaw。

数据来源：multica.ai/docs/zh（工作区、成员与权限、项目、项目资源、任务、分配任务、评论、对话、智能体、Skills、小队、运行时、自动化、AI 工具对照、安装 AI 编程工具等页），2026-08 抓取。