终极指南：解锁gh_mirrors/cl/claude-code-by-agents的@mentions功能，高效协调本地与远程智能体

秦俐冶Kirby

427人浏览 · 2026-07-13 08:58:00

秦俐冶Kirby · 2026-07-13 08:58:00 发布

终极指南：解锁gh_mirrors/cl/claude-code-by-agents的@mentions功能，高效协调本地与远程智能体

【免费下载链接】claude-code-by-agents Desktop app and API created in public for multi-agent Claude Code orchestration - coordinate local and remote agents through @mentions. 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-by-agents

你是否曾想过拥有一个能够同时指挥多个AI编程助手的智能指挥中心？gh_mirrors/cl/claude-code-by-agents项目正是这样一个革命性的多智能体协调工具。这个开源项目通过创新的@mentions功能，让你能够像指挥团队成员一样轻松协调本地和远程的Claude Code智能体，实现高效的并行编程协作。无论你是个人开发者还是团队负责人，掌握这一功能都将极大提升你的开发效率和工作流程。

什么是Claude Code Agentrooms？

Claude Code Agentrooms是一个专门为多智能体协调设计的桌面应用程序，它基于OpenAgents工作空间协议构建，支持macOS和iOS平台。项目的核心功能是通过@mentions（@提及）机制，让你能够在一个统一的聊天界面中与多个智能体进行交互，每个智能体都可以专注于特定的任务或技术栈。

想象一下这样的场景：你可以同时拥有一个负责前端开发的@frontend智能体、一个负责后端逻辑的@backend智能体、一个处理机器学习的@ml智能体，还有一个负责基础设施的@infra智能体。所有这些智能体都可以运行在不同的机器上，但你只需要在一个聊天窗口中就能指挥它们协同工作！

为什么你需要@mentions功能？

在传统的AI编程助手使用模式中，你通常只能与一个智能体进行交互。当你需要处理复杂的多模块项目时，这种单一线程的工作方式会带来诸多限制：

上下文切换成本高：在不同任务间切换需要重新解释需求
专业知识分散：单个智能体难以精通所有技术栈
资源利用率低：无法充分利用多台机器的计算能力
协作效率低下：缺乏智能体间的直接沟通机制

@mentions功能完美解决了这些问题。通过简单的@智能体名称语法，你可以：

精确路由任务：将特定任务分配给最合适的智能体
并行处理：让多个智能体同时处理不同的子任务
上下文共享：所有智能体都能访问相同的工作空间历史
责任明确：每个智能体都有清晰的职责范围

快速上手：5步搭建你的智能体团队

第1步：安装应用程序

首先从项目的Releases页面下载最新的.dmg文件（适用于Apple Silicon芯片的Mac）。iOS版本将通过TestFlight分发。

第2步：配置远程智能体

在你的远程机器（可以是Mac mini、云服务器或任何其他设备）上安装智能体连接器：

npm install -g @openagents-org/agent-connector

安装Claude运行时并创建智能体：

# 安装Claude运行时
agent-connector install claude

# 创建名为"backend"的智能体
agent-connector create backend --type claude

# 授权配置
agent-connector up

第3步：连接工作空间

你需要一个工作空间URL和令牌。可以选择使用公共的OpenAgents工作空间，也可以自托管工作空间后端：

agent-connector connect backend <workspace-token>

第4步：启动应用程序

打开Claude Code Agentrooms应用，粘贴你的工作空间URL（包含?token=参数）。应用程序会自动通过/v1/discover接口发现所有已连接的智能体。

第5步：开始使用@mentions

现在你就可以在聊天界面中使用@mentions功能了！例如：

@backend 请添加一个健康检查端点 /healthz
@frontend 更新登录页面，然后@backend配置新的认证路由

@mentions功能的强大应用场景

场景一：全栈开发协调

假设你正在开发一个Web应用，可以这样分配任务：

@frontend 创建用户注册页面，包含邮箱验证功能
@backend 实现用户注册API，支持邮箱验证码发送
@database 设计用户表结构，包含邮箱验证状态字段

三个智能体会同时开始工作，各自专注于自己擅长的领域。

场景二：跨团队代码审查

当需要代码审查时，你可以指定专门的审查智能体：

@codex-review 请审查这个PR #4221中的安全漏洞
@frontend-review 检查前端组件的响应式设计

场景三：多环境部署

部署到不同环境时，可以指定不同的基础设施智能体：

@staging-infra 部署v1.2.3到预发布环境
@production-infra 准备生产环境部署清单

核心技术架构解析

Claude Code Agentrooms采用三层架构设计，确保系统的灵活性和可扩展性：

交互层（Interaction Layer）

这是应用程序的核心，负责路由消息到正确的智能体，并在聊天界面中渲染智能体的响应。所有@mentions功能都在这一层实现，代码位于OpenAgents/Views/ChatView.swift。

知识层（Knowledge Layer）

所有智能体共享的工作空间历史存储在这里，确保每个智能体都能访问相同的上下文信息。消息模型定义在OpenAgents/Models/Message.swift，支持丰富的消息类型和附件功能。

智能体层（Specialist Agents）

每个智能体都是独立的运行时实例，可以运行在不同的机器上。它们通过@openagents-org/agent-connector与工作空间连接，专注于特定的工作流程。

高级使用技巧

1. 智能体命名策略

为智能体选择有意义的名称非常重要。建议使用：

技术栈前缀：@frontend-react、@backend-go
环境标识：@dev-db、@prod-api
功能描述：@auth-specialist、@payment-processor

2. 消息路由优化

当需要多个智能体协作时，使用清晰的指令链：

@frontend 创建用户个人资料组件
完成后请@backend 提供用户数据API
然后@designer 优化UI视觉效果

3. 工作空间管理

每个工作空间都可以包含多个智能体。你可以为不同项目创建独立的工作空间，或者为团队的不同职能创建专门的工作空间。

常见问题解答

Q: 最多可以连接多少个智能体？ A: 理论上没有限制，但建议根据实际需求配置，通常3-5个智能体就能满足大多数开发场景。

Q: 智能体之间能直接通信吗？ A: 智能体通过共享的工作空间历史进行间接通信，你可以通过@mentions显式地让它们协作。

Q: 支持哪些编程语言和框架？ A: Claude Code智能体支持所有主流编程语言和框架，每个智能体都可以配置专门的工具集和工作目录。

Q: 如何确保安全性？ A: 每个智能体都有自己的权限范围和工作目录，不会越权访问其他智能体的资源。

从源码构建

如果你想从源码构建应用程序，需要Xcode 16+和xcodegen：

brew install xcodegen
git clone https://gitcode.com/gh_mirrors/cl/claude-code-by-agents.git
cd claude-code-by-agents
xcodegen generate
open Agentrooms.xcodeproj

构建完成后，你可以创建自定义的智能体配置或修改界面功能。