Claude Code TEAM 模式与迁移避坑指南

TEAM 模式

TEAM 模式是 Claude Code 的实验性功能，允许多个 Agent 协作处理任务。

开启方法

在 ~/.claude/settings.json 中添加：

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

重启 Claude Code 后，在新终端启动时使用 prompt 要求开启 agent team 模式。

TEAM 模式 vs 子代理

特性	子代理 (Agent 工具)	TEAM 模式
effortLevel 继承	❌ 默认设置	✅ 继承主 session
模型选择	手动指定	自动继承
思考深度	标准	跟随主 session
任务共享	独立运行	共享任务列表
Agent 间通信	无	可互相发消息

核心优势：当你设置 effortLevel = "high" 时，teammates 会继承同样的深度思考。

使用场景

适合子代理：

简单的并行搜索任务
不需要深度思考的批量操作

适合 TEAM 模式：

复杂多步骤任务
需要深度思考和规划
Agent 间需要协调

迁移后 Plugin 问题

问题现象

恢复备份后，插件显示"已启用"但实际不工作：

settings.json 中 enabledPlugins 正确
但运行时报错或功能不可用

原因

备份时容易遗漏 plugins/cache/ 目录。Claude Code 检测到安装记录，认为插件已安装，不再下载，但文件实际缺失。

解决方案

方案一：重新安装插件

claude plugin install context7@claude-plugins-official
claude plugin install superpowers@claude-plugins-official

方案二：完整备份（推荐）

~/.claude/
├── settings.json          # 设置
├── history.jsonl          # 历史记录
├── projects/              # 会话文件
├── skills/                # 自定义 skills
├── memory/                # 记忆文件
└── plugins/
    ├── installed_plugins.json  # 插件记录
    ├── known_marketplaces.json # 市场信息
    └── cache/                  # ⚠️ 实际插件文件