DEV Community: dudumd

Claude Code Agent Teams：一个人写代码的时代，结束了

dudumd — Sat, 28 Mar 2026 19:44:55 +0000

从单兵作战到 AI 团队协作 —— 手把手教你启用最强编程新功能

阅读时长：8 分钟｜难度：入门级｜建议收藏

🔥 先说一个让我震惊的事

Anthropic 有个工程师，用 16 个 Claude 同时写代码，花了 2 万美金 API 费用，跑了将近 2000 个 Claude Code 会话。

产出是什么？

一个 10 万行的 Rust C 编译器，能编译 Linux 内核。

你没看错。不是一个人写的，是一个 AI 团队写的。

这就是 Agent Teams 的威力。

而现在，这个功能对每个 Claude Code 用户开放了。只需要加一行配置。

🤔 到底什么是 Agent Teams？

先别急着看教程，我们搞清楚一个根本问题：

以前的 Claude Code 就像你雇了一个很厉害的全栈工程师。虽然他什么都会，但一次只能干一件事 —— 写完后端写前端，写完前端跑测试，串行推进。

Agent Teams 的本质是： 你不再是雇了一个人，而是拥有了一整个技术团队。

你跟「技术总监」（Team Lead）下达任务，他会自动派生出多个独立的 Claude 实例，每个实例各司其职、并行工作、互相通信。

▎跟 Subagent 有什么区别？

这是很多人困惑的地方。一张表说清楚：

对比维度	Subagent	Agent Teams
通信方式	只能汇报给主 Agent	队友之间可以直接对话
独立性	共享主会话上下文	每人独立上下文窗口
协调能力	主 Agent 是唯一中转	去中心化，自组织
适用场景	简单的并行子任务	复杂的需要协作的项目
交互方式	不可观察、不可干预	可切换、可观察、可介入

💡 一句话总结：Subagent 像是你的下属向你汇报工作，Agent Teams 像是一群同事围着白板讨论方案。

📋 启用前，你需要准备什么？

别急着复制配置，先确认三件事：

▎1. 确认你的订阅计划

Agent Teams 需要 Claude Pro（$20/月）或 Claude Max（$100-$200/月）计划。

Pro 计划每天大约能跑 2-3 次 Agent Teams 任务。如果你是重度使用者，建议上 Max —— 每 5 小时可以跑 8-10 个复杂任务，做专业项目的话，第二个任务就已经回本了。

▎2. 确认 Claude Code 版本

Agent Teams 需要 Claude Code v2.1.32 以上版本。检查方法：

claude --version

如果版本不够，更新一下：

npm install -g @anthropic-ai/claude-code@latest

▎3.（可选）安装 tmux

tmux 可以让每个 Agent 拥有独立的终端面板，方便你同时观察所有队友的工作状态。不装也行，只是所有输出会挤在一个窗口里。

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

🚀 三步启用 Agent Teams

整个过程不超过 30 秒。

▎第一步：找到配置文件

Claude Code 的设置文件在你的用户目录下：

# macOS / Linux
~/.claude/settings.json

# Windows
%USERPROFILE%\.claude\settings.json

▎第二步：添加环境变量

打开 settings.json，在 env 字段中加一行：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

💡 如果你的 settings.json 里已经有其他 env 配置，只需要在 env 对象里加上这一行就行，别覆盖了原有配置。

▎第三步：重启 Claude Code

关掉当前会话，重新打开 Claude Code。Agent Teams 功能立即生效。

没有第四步了。就是这么简单。

✨ 第一次使用 Agent Teams

启用之后，你不需要学任何新命令。直接用自然语言告诉 Claude 你想组建什么样的团队就行。

▎场景一：代码审查

以前你让 Claude 审查 PR，它会从头到尾看一遍，容易顾此失彼。现在：

Create an agent team to review PR #142.
Spawn three reviewers:
- One focused on security implications
- One checking performance impact
- One validating test coverage
Have them each review and report findings.

三个专家同时审查，安全、性能、测试三个维度一个不落。

▎场景二：全栈开发

一个 feature 涉及前端、后端、测试？拆成三个人同时做：

Create an agent team to build the user dashboard.
One teammate on the API layer,
one on the frontend components,
one on the test suite.

关键在于：当 API 队友定义好了接口类型，它会直接通知前端队友，不需要你手动中转。

▎场景三：竞争性调试

遇到一个诡异的 bug？让三个 Claude 各提一套假设，同时验证：

I have a race condition in the payment service.
Create an agent team with three debuggers:
- One investigating the database connection pool
- One checking the async queue implementation
- One reviewing the transaction locking logic
Have them test their hypotheses and converge.

三条线并行排查，谁先找到谁说话。传统方式可能要串行排查几小时的问题，十几分钟搞定。

⚙️ 两种工作模式，怎么选？

	In-process（默认）	tmux 分屏模式
显示方式	所有队友在同一个终端窗口	每个队友独占一个面板
切换方式	Shift + Down 切换队友	tmux 面板自由切换
适合谁	刚上手，任务简单	重度用户，需要全局视野
额外依赖	无	需要安装 tmux

想切换到 tmux 模式？在 settings.json 里加一行：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "tmux"
}

💰 关于费用，说点大实话

Agent Teams 会消耗更多 Token。 这是必须面对的事实。

每个队友都是一个完整的 Claude 实例，拥有独立的上下文窗口。3 个队友 ≈ 3 倍 Token 消耗。

有人测试过，用 Agent Teams 生成一周的社交媒体内容，5 个 Agent 并行工作 15 分钟，总花费约 $7.80。同样的事手动做，至少要半天。

什么时候值得用？

● 任务可以拆成独立模块并行推进
● 质量控制比速度更重要（多角度审查）
● 跨层协调（前端 + 后端 + 测试同步推进）
● 竞争性调试（多种假设同时验证）

什么时候别用？

● 简单的单文件修改
● 任务之间强依赖、必须串行的
● 日常小问题，一个 Claude 就够的

💡 原则：如果一个人就能干好，不要组团队。这跟管理真人团队是一个道理。

🎯 5 个让你事半功倍的进阶技巧

▎技巧一：在 Prompt 里明确分工

不要说「帮我处理这个项目」。要说清楚每个队友负责什么、边界在哪。模糊的指令会导致队友之间踩脚。

▎技巧二：控制队友数量

最多可以开 10 个队友，但不代表你应该开 10 个。大多数任务，2-4 个队友是最佳平衡点。人多了协调成本反而上去。

▎技巧三：善用 CLAUDE.md

每个队友启动时会自动加载项目根目录的 CLAUDE.md。把项目规范、代码风格、架构约定写在里面，所有队友就有了统一的「团队手册」。

▎技巧四：可以中途介入

发现某个队友方向跑偏了？用 Shift+Down 切过去直接跟它对话纠正，不需要停掉整个团队。

▎技巧五：先用 Plan Mode 审批

在 prompt 里加一句 Require plan approval before any teammate makes changes，队友执行前会先给你看方案，你确认后才动手。适合对代码质量要求高的场景。

⚠️ 当前的局限性（坦诚说）

Agent Teams 仍然是实验功能，有几个已知问题：

会话恢复：如果 Claude Code 意外关闭，队友状态可能无法完美恢复
任务协调：极少数情况下，两个队友可能同时修改同一个文件产生冲突
关闭行为：团队结束时，个别队友可能没有被完全清理
Token 消耗不可预测：复杂任务的实际 Token 用量可能远超预期

这些问题 Anthropic 在持续修复中，每个版本都在变好。但现阶段用的时候，保持对成本的关注。

📝 最后说几句

Agent Teams 不是一个锦上添花的小功能。它代表了一个根本性的范式转变：

从「人指挥一个 AI」到「人管理一个 AI 团队」。这中间的能力鸿沟，会在 2026 年迅速拉开。

现在开始建立「多 Agent 协作」的思维方式和肌肉记忆，是你能做的最有性价比的投资之一。

毕竟，配置只需要 30 秒。而你获得的，是一整个团队。

觉得有用？转发给你那个还在单兵作战的同事吧 👊

点赞 + 收藏 = 下次更新不迷路

我把 Claude Code 接进了 Telegram，手机上终于能随时使唤它了

dudumd — Sat, 28 Mar 2026 08:08:26 +0000

🦞 这两天我折腾了一个很有意思的玩法：把 Claude Code 接进 Telegram。

接通之后，体验确实爽。人在外面，手机给 Bot 发一句话，Claude Code 就能接住，继续干活。

但这功能不是谁都能无脑冲。

一是它依赖 官方 Claude Code 会员能力，第三方中转一般不支持。
二是真正的风险不在 Telegram，而在 Claude 官方账号环境本身更敏感，更容易遇到风控、限额，甚至封号。

这篇文章我就讲三件事：

它到底是什么

怎么配

值不值得你折腾

我是冲冲，咱们继续用费曼风格讲人话。

一、先说结论：这功能很香，但不是所有人都适合直接冲

先说结论：

Claude Code 接 Telegram 值得试，但前提是你有稳定的官方 Claude Code 环境。

它的门槛主要有两个：

1）必须是官方 Claude Code 能力

这套 --channels + 官方 Telegram 插件，不是第三方中转、镜像站、共享壳都能跑。

2）真正的风险在账号，不在 Telegram

Telegram 接入本身是官方能力。
真正脆弱的是 Claude 官方账号环境：Anthropic 对网络、地区、登录行为更敏感，账号更容易碰到风控、限额，甚至封号。

3）体验上越来越像“随身助手”

一旦接上 Telegram，Claude Code 就不再只是电脑里的编程工具，而开始像一个能随时被叫起来的 AI 搭子。

所以这功能不是不能冲，
而是你得先知道：它能跑，但前提和代价都比表面大。

二、这玩意到底是什么？用人话解释清楚

Claude Code 官方提供了一个 Telegram 插件。

你可以理解为：

给 Claude Code 装上一条“Telegram 通信线”。

接通之后，流程是这样的：

你在 Telegram 里给自己的 Bot 发消息
Bot 把消息交给 Telegram 插件
插件把消息转给 Claude Code 当前会话
Claude Code 生成结果
插件再把结果发回 Telegram

所以它不是“Claude 突然有了 Telegram App”。

而是：

Claude Code + 官方 Telegram 插件 + 你自己的 Telegram Bot

一起组成了一个“手机里可用的 Claude Code 入口”。

这就是它的本质。

三、先别急着装，先确认一件事：你用的是不是官方 Claude Code？

先把边界讲清楚：

这套功能属于官方 Claude Code 生态，不是所有 Claude 服务都支持。

如果你用的是：

第三方中转
镜像站
共享壳
套壳网页

那大概率跑不起来。

所以这篇文章默认适合这三类人：

有官方 Claude Code 环境
能用官方插件
愿意自己折腾一下 Bot 和配置

如果这三条不满足，这篇教程你看完也很难落地。

四、效果到底值不值得配？先看它能干嘛

你只要记住一句话：

它的价值，就是把 Claude Code 从电脑前搬到手机里。

最常见的三个场景：

1）随手丢任务

出门时突然想到：

帮我总结 bug
帮我整理思路
帮我列提纲

以前要回电脑。现在手机发一句就行。

2）把 Claude Code 变成随叫随到的搭子

它不再只是坐在桌面上的编程工具，
而开始变成一个你在路上也能叫起来的助手。

3）从编程工具，往随身助手走

接上 Telegram 后，它能承担的不只是写代码，
还有整理、拆解、讨论、提醒。

这也是为什么我会觉得：

Claude Code 接上 Telegram 后，已经开始有点像 OpenClaw 了。

五、前置条件：不是 Node，是 Bun

要跑这个功能，你至少需要：

Claude Code CLI
Telegram 账号
你自己创建的 Telegram Bot
Bun 运行时

这里有个特别容易踩的坑：

这个 Telegram MCP 服务器跑在 Bun 上，不是 Node.js。

也就是说，你电脑上哪怕装了：

Node
npm
pnpm
yarn

这些都不能替代 Bun。

Mac / Linux 安装方式

curl -fsSL https://bun.sh/install | bash

Windows PowerShell 安装方式

irm bun.sh/install.ps1 | iex

装完后验证：

bun --version

这里最容易踩的坑

如果你是先开 Claude Code，后装 Bun，很容易出现“明明装好了，但 Telegram 不工作”。

原因通常是：

终端还没刷新 PATH，Claude Code 根本没读到 Bun。

解决也简单：

重启终端
重启 Claude Code

六、第一步：去 BotFather 创建你的 Telegram Bot

打开 Telegram
搜索 @botfather
输入：/newbot
按提示填写：
- Name：显示名称，可随便写
- Username：唯一用户名，必须以 bot 结尾

创建成功后，BotFather 会给你一串 Token，比如：

123456789:AAHfiqksKZ8xxxxxxxxxxxx

这里记住一句话

这个 Token 就是你 Bot 的密码。

不要公开，不要乱发，不要贴仓库。

谁拿到它，谁就能控制你的机器人。

七、第二步：安装官方 Telegram 插件

先启动 Claude Code：

claude

然后执行：

/plugin install telegram@claude-plugins-official

插件装完后，最稳的做法就是：

直接重启 Claude Code。

原因很简单：有时插件其实装好了，但命令还没加载出来。
这时候别折腾，重开最快。

八、第三步：配置 Bot Token

在 Claude Code 里执行：

/telegram:configure 你的BotToken

比如：

/telegram:configure 123456789:AAHfiqksKZ8xxxxxxxxxxxx

执行后，它会把 Token 写到：

~/.claude/channels/telegram/.env

里面本质上就是：

TELEGRAM_BOT_TOKEN=你的Token

这一步没什么花活，照着配就行。

九、第四步：真正关键的是 `--channels`

很多人最容易在这里翻车。

插件装了、Token 配了，不代表 Telegram 已经通了。

你必须退出 Claude Code，然后这样启动：

claude --channels plugin:telegram@claude-plugins-official

这一步为什么这么重要？

你可以把 --channels 理解成：

启动 Claude Code 时，顺手把 Telegram 这条消息通道也一起拉起来。

如果不加这个参数，会怎么样？

Bot 可能根本不回你
或者只表现得像死了一样
你以为 Token 错了、网络炸了、插件坏了

结果其实只是：

通道根本没启动。

所以这一步不是“可选项”，而是核心项。

十、第五步：配对，让 Bot 认出你

现在 Claude Code 已经带着 Telegram channel 跑起来了。

接着你去 Telegram 私聊你的 Bot，随便发一句话。

正常情况下，Bot 会回你一个 6 位配对码。

然后回到 Claude Code，执行：

/telegram:access pair <6位配对码>

配对完成后，你再发消息，Claude Code 就能真正接住。

这个配对机制本质上在干嘛？

一句话：

把 Telegram 里的这个人，绑定到 Claude Code 当前允许访问的用户列表里。

它的好处是你不用手动折腾 Telegram 数字 ID。

对单人场景来说，这个体验还是挺舒服的。

十一、第六步：配对成功后，立刻锁权限

这一步很重要。

默认情况下，插件通常会处于一种适合“首次配对”的模式。

但你一旦已经配好了自己的账号，就别继续放着不管了。

直接执行：

/telegram:access policy allowlist

为什么要这么做？

因为配对模式本质上是在等待新用户来尝试接入。

这在第一次配置时很方便，但如果你的 Bot 链接被人看到了、用户名被别人搜到了，就有可能引来不必要的尝试。

所以最稳的操作是：

自己配完，立刻切 allowlist，只允许白名单用户访问。

这一步是安全底线。

十二、风险提醒：官方会员也不是绝对安全

这一段我觉得必须单独写，而且要写在明显位置。

因为如果我只告诉你“怎么配”，不告诉你“可能会出什么事”，那就不厚道了。

风险提醒：风险不在 Telegram，而在 Claude 官方账号环境

这句话一定要讲准确：

Telegram 接入是官方能力，真正有风险的是 Claude 官方账号环境。

你想用这套功能，通常要依赖官方 Claude Code 会员体系。
而 Anthropic 对账号环境更敏感，比较容易碰到：

风控
限额
封号

所以这功能不是不能用，
而是你得先接受一个前提：

真正脆弱的不是接入链路，而是账号本身。

如果你本来就有稳定的官方环境，这功能会很好用。
如果你的账号环境本来就不稳，那它再香也很难长期放心用。

十三、日常怎么用？

以后每次你要让 Claude Code 连 Telegram，都要这样启动：

claude --channels plugin:telegram@claude-plugins-official

如果已经配过，一般不需要重复配对。

建议你顺手配个别名

比如在 Mac / Linux 下：

alias claudetg='claude --channels plugin:telegram@claude-plugins-official'

以后只要敲：

claudetg

就能直接启动。

这个小优化，看起来不起眼，实际会大幅减少你后面使用的摩擦。

十四、这个插件到底给了 Claude 哪些能力？

官方 Telegram 插件主要给 Claude 暴露了三个能力：

1）reply

发消息回 Telegram 聊天。

支持：

回复指定消息
发图片
发文件
长文本自动分段

2）react

给消息加 emoji 反应。

3）edit_message

编辑 Bot 自己发过的消息。

这个功能特别适合做“处理中 → 最终结果”的进度体验。

比如先发：

正在整理，稍等一下……

等处理完了，再把原消息改成正式答案。

体验会比一次性生硬吐一大段好很多。

十五、你一定要知道的限制：它没你想得那么万能

1）没有历史消息搜索

这一点非常关键。

官方文档写得很明确：

Telegram Bot API 不提供消息历史和搜索能力。

也就是说：

Bot 只能看到“新到达的消息”
看不到过去的聊天记录
不能回头翻历史

所以如果你希望 Claude Code 理解上文，只能：

你自己粘贴给它
或者你自己总结后发给它

2）图片会压缩

如果你发普通图片给 Bot，Telegram 很可能会压缩。

如果你希望 Claude 读取更完整的原图，建议：

作为文件发送，不要直接当普通图片发送。

3）离线时消息可能就错过了

这套方案不是“永远在线云端助手”，而更像“你当前打开着的消息通道”。

如果 Claude Code 没开，或者没带 --channels，那你发过去的消息不一定会被补拉。

这一点非常像“实时转发”，而不是“历史回放”。

十六、它和 OpenClaw，是不是越来越像了？

写到这里，我有个感受越来越强烈：

Claude Code 一旦接上 Telegram，它真的开始有点像 OpenClaw 了。

为什么会有这种感觉？

因为它已经开始具备这些特征：

可以在聊天里被唤起
可以远程接收任务
可以通过 Bot 跟你持续互动
可以从“工具”变成“助手”

从体验层看，这确实已经很接近 OpenClaw 了。

但如果要说得更准确一点，我会这么讲：

Claude Code + Telegram 更像什么？

更像：

把一个强大的 AI 编程助手，搬进聊天框。

它的核心强项依然是：

写代码
改项目
处理工程任务
当你的编程搭子

OpenClaw 更像什么？

更像：

原生为聊天、渠道、自动化、工具编排而生的 AI 助手平台。

它更偏：

多渠道接入
工具系统
skill 体系
自动化编排
长期运行

所以我的判断是：

Claude Code 接上 Telegram 后，在“体验层面”开始接近 OpenClaw；

但在“架构层面”，两者仍然不是一回事。

一句话总结：

Claude Code 接上 Telegram 后，开始从“编程工具”往“随身助手”进化；

而 OpenClaw，本来就是按“随身助手”这个方向长出来的。

这个差别，我觉得很值得玩味。

十七、值不值得折腾？我的真实答案

值，但不是无脑值。

更准确地说：

如果你有稳定的官方 Claude Code 环境，并且愿意自己折腾，这功能很值得试。

因为它真正带来的变化是：

Claude Code 不再被锁在电脑前。

但如果你账号本来就不稳，或者特别在意账号安全，
那就别把它当成必须立刻上的功能。先观望，也完全合理。

十八、最短记忆版：整套流程就 6 步

如果你只想记住最核心的流程，记这 6 步就行：

装 Bun
用 BotFather 创建 Telegram Bot
在 Claude Code 里安装官方 Telegram 插件
用 /telegram:configure 写入 Bot Token
用 claude --channels plugin:telegram@claude-plugins-official 启动
私聊 Bot 拿配对码，配完立刻切 allowlist

就这么多。

真正麻烦的从来不是步骤，而是：

你知不知道这个功能的边界在哪
你能不能接受它背后的风险

冲冲的最后总结

我写完这篇最大的感受是：

AI 编程工具，正在慢慢长成 AI 助手。

Claude Code 本来是桌面上的编程工具。
接上 Telegram 之后，它开始变成一个你随时都能叫起来的搭子。

这也是我会联想到 OpenClaw 的原因。
体验上，它们越来越像；
但定位上，一个更偏编程助手，一个更偏原生 AI 助手平台。

这也是这个玩法最有意思的地方。

参考资料

Anthropic 官方 Telegram 插件说明：
https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/README.md