团队协作工具组合教程

本教程介绍如何搭建 Claude Code + Claude-Flow + New API 的团队协作环境，实现多人协作、多代理编排和统一 API 管理。

🎯 组合优势

工具	作用	解决的问题
Claude Code	AI 编程助手	个人开发效率
Claude-Flow	多代理编排	复杂任务分解、并行开发
New API	API 网关	统一管理、用量控制、成本分摊

组合效果：

👥 团队成员统一 API 入口
🤖 多代理并行处理复杂任务
💰 精确的用量统计和成本分摊
📊 可视化的使用数据看板

📦 第一步：部署 New API

New API 作为团队的统一 API 网关，管理所有成员的 API 调用。

Docker Compose 部署（推荐）

bash

# 创建目录
mkdir -p /opt/new-api && cd /opt/new-api

# 创建 docker-compose.yml
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    ports:
      - "3000:3000"
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=root:password@tcp(mysql:3306)/newapi
      - REDIS_CONN_STRING=redis://redis:6379
      - SESSION_SECRET=your-session-secret-change-me
      - CRYPTO_SECRET=your-crypto-secret-change-me
    volumes:
      - ./data:/data
    depends_on:
      - mysql
      - redis

  mysql:
    image: mysql:8.0
    container_name: new-api-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=newapi
    volumes:
      - ./mysql:/var/lib/mysql

  redis:
    image: redis:7-alpine
    container_name: new-api-redis
    restart: always
    volumes:
      - ./redis:/data
EOF

# 启动服务
docker-compose up -d

🎬 Docker 部署演示

docker-compose up -dCreating new-api ... donedocker psnew-api Up 2 minutes 0.0.0.0:3000->3000

初始配置

访问管理后台：http://your-server:3000
默认账号：root / 123456（首次登录后修改）
添加渠道：
- 进入"渠道管理"
- 添加 Anthropic API 渠道

添加 Anthropic 渠道

渠道名称：Anthropic 官方
渠道类型：Anthropic Claude
Base URL：https://api.anthropic.com
API Key：sk-ant-xxx...
模型：claude-3-5-sonnet-20241022, claude-3-opus-20240229

创建团队令牌

进入"令牌管理"
为每个团队成员创建令牌
设置用量限制和过期时间

令牌名称：张三-开发
额度限制：$100
过期时间：2025-12-31
模型限制：claude-3-5-sonnet（可选）

🤖 第二步：安装 Claude-Flow

Claude-Flow 提供多代理编排能力，适合复杂项目的并行开发。

安装

bash

# 确保已安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 安装 Claude-Flow
npm install -g claude-flow@alpha

# 验证安装
claude-flow --version

初始化项目

bash

# 进入项目目录
cd your-team-project

# 初始化 Claude-Flow
npx claude-flow@alpha init --force

# 查看帮助
npx claude-flow@alpha --help

配置 MCP 服务器

bash

# 添加 Claude-Flow MCP 服务器
claude mcp add claude-flow npx claude-flow@alpha mcp start

🔧 第三步：团队成员配置

配置 API 端点

每个团队成员需要配置使用 New API 作为 API 端点。

macOS / Linux

bash

# 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_BASE_URL="http://your-server:3000"
export ANTHROPIC_API_KEY="sk-your-newapi-token"

# 生效配置
source ~/.bashrc

Windows

powershell

# PowerShell（临时）
$env:ANTHROPIC_BASE_URL = "http://your-server:3000"
$env:ANTHROPIC_API_KEY = "sk-your-newapi-token"

# 永久设置
setx ANTHROPIC_BASE_URL "http://your-server:3000"
setx ANTHROPIC_API_KEY "sk-your-newapi-token"

验证配置

bash

# 启动 Claude Code
claude

# 测试连接
> 你好，请确认你能正常工作

🚀 第四步：团队协作工作流

场景一：功能并行开发

使用 Claude-Flow 的蜂群功能并行开发多个功能：

bash

# 初始化蜂群
npx claude-flow@alpha hive-mind wizard

# 分配任务给不同代理
npx claude-flow@alpha hive-mind spawn "实现用户认证模块" --namespace auth --claude
npx claude-flow@alpha hive-mind spawn "实现订单管理模块" --namespace orders --claude
npx claude-flow@alpha hive-mind spawn "实现支付集成模块" --namespace payment --claude

# 查看状态
npx claude-flow@alpha hive-mind status

场景二：代码审查流程

bash

# 使用 Claude-Flow 进行代码审查
npx claude-flow@alpha swarm "审查 PR #123 的代码变更，关注安全性和性能" --claude

# 或使用技能自动激活
"Review this PR for security issues"

场景三：复杂重构任务

bash

# 创建多代理协作任务
npx claude-flow@alpha swarm init --topology mesh --max-agents 5

# 分配子任务
npx claude-flow@alpha swarm spawn researcher "分析现有代码结构"
npx claude-flow@alpha swarm spawn architect "设计新的架构方案"
npx claude-flow@alpha swarm spawn developer "实现重构代码"
npx claude-flow@alpha swarm spawn tester "编写测试用例"
npx claude-flow@alpha swarm spawn reviewer "审查最终代码"

# 监控进度
npx claude-flow@alpha swarm status

📊 第五步：用量监控与成本管理

New API 数据看板

访问数据看板：http://your-server:3000/dashboard
查看指标：
- 总请求数
- Token 消耗
- 成本统计
- 按用户/渠道分组

设置用量告警

bash

# 在 New API 管理后台设置
# 系统设置 → 通知设置 → 添加告警规则

告警类型：额度告警
阈值：80%
通知方式：邮件/Webhook

成本分摊报表

New API 支持按令牌统计用量，方便团队成本分摊：

用户      | 请求数 | Token 消耗 | 成本
---------|--------|-----------|------
张三      | 1,234  | 2.5M      | $12.50
李四      | 2,345  | 4.8M      | $24.00
王五      | 987    | 1.2M      | $6.00

🔄 第六步：CI/CD 集成

GitHub Actions 集成

yaml

# .github/workflows/ai-review.yml
name: AI Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      
      - name: Run AI Review
        env:
          ANTHROPIC_BASE_URL: ${{ secrets.NEWAPI_URL }}
          ANTHROPIC_API_KEY: ${{ secrets.NEWAPI_TOKEN }}
        run: |
          claude -p "审查这个 PR 的代码变更，提供改进建议" < <(git diff origin/main...HEAD)

自动化任务

bash

# 每日代码质量检查
0 9 * * * cd /path/to/project && claude -p "检查代码质量，生成报告" > /tmp/daily-report.md

# PR 自动审查
# 配置 GitHub Webhook 触发

⚙️ 高级配置

New API 高可用部署

yaml

# docker-compose-ha.yml
version: '3.8'
services:
  new-api-1:
    image: calciumion/new-api:latest
    environment:
      - SESSION_SECRET=shared-secret
      - CRYPTO_SECRET=shared-crypto
      - SQL_DSN=...
      - REDIS_CONN_STRING=...
    
  new-api-2:
    image: calciumion/new-api:latest
    environment:
      - SESSION_SECRET=shared-secret
      - CRYPTO_SECRET=shared-crypto
      - SQL_DSN=...
      - REDIS_CONN_STRING=...

  nginx:
    image: nginx:alpine
    ports:
      - "3000:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf

Claude-Flow 持久化内存

bash

# 启用 AgentDB 向量搜索
npx claude-flow@alpha memory agentdb-info

# 存储项目知识
npx claude-flow@alpha memory store-vector project_arch "项目架构说明..." \
  --namespace team --metadata '{"version":"v2"}'

# 查询知识
npx claude-flow@alpha memory vector-search "用户认证流程" \
  --k 10 --threshold 0.7

🔍 常见问题

Q: 团队成员无法连接 New API？

A: 检查以下几点：

服务器防火墙是否开放 3000 端口
令牌是否正确且未过期
环境变量是否正确设置

Q: Claude-Flow 代理任务失败？

A: 查看日志：

bash

npx claude-flow@alpha logs --tail 100

Q: 如何限制某些用户只能使用特定模型？

A: 在 New API 创建令牌时设置模型限制：

模型限制：claude-3-5-sonnet-20241022

📈 效果对比

指标	传统方式	本组合
API 管理	分散	统一
成本追踪	困难	精确
并行开发	手动协调	自动编排
代码审查	人工	AI 辅助

🎓 下一步

最后更新：2025年12月

团队协作工具组合教程 ​

🎯 组合优势 ​

📦 第一步：部署 New API ​

Docker Compose 部署（推荐） ​

🎬 Docker 部署演示 ​

初始配置 ​

添加 Anthropic 渠道 ​

创建团队令牌 ​

🤖 第二步：安装 Claude-Flow ​

安装 ​

初始化项目 ​

配置 MCP 服务器 ​

🔧 第三步：团队成员配置 ​

配置 API 端点 ​

macOS / Linux ​

Windows ​

验证配置 ​

🚀 第四步：团队协作工作流 ​

场景一：功能并行开发 ​

场景二：代码审查流程 ​

场景三：复杂重构任务 ​

📊 第五步：用量监控与成本管理 ​

New API 数据看板 ​

设置用量告警 ​

成本分摊报表 ​

🔄 第六步：CI/CD 集成 ​

GitHub Actions 集成 ​

自动化任务 ​

⚙️ 高级配置 ​

New API 高可用部署 ​

Claude-Flow 持久化内存 ​

🔍 常见问题 ​

Q: 团队成员无法连接 New API？ ​

Q: Claude-Flow 代理任务失败？ ​

Q: 如何限制某些用户只能使用特定模型？ ​

📈 效果对比 ​

🎓 下一步 ​

团队协作工具组合教程

🎯 组合优势

📦 第一步：部署 New API

Docker Compose 部署（推荐）

🎬 Docker 部署演示

初始配置

添加 Anthropic 渠道

创建团队令牌

🤖 第二步：安装 Claude-Flow

安装

初始化项目

配置 MCP 服务器

🔧 第三步：团队成员配置

配置 API 端点

macOS / Linux

Windows

验证配置

🚀 第四步：团队协作工作流

场景一：功能并行开发

场景二：代码审查流程

场景三：复杂重构任务

📊 第五步：用量监控与成本管理

New API 数据看板

设置用量告警

成本分摊报表

🔄 第六步：CI/CD 集成

GitHub Actions 集成

自动化任务

⚙️ 高级配置

New API 高可用部署

Claude-Flow 持久化内存

🔍 常见问题

Q: 团队成员无法连接 New API？

Q: Claude-Flow 代理任务失败？

Q: 如何限制某些用户只能使用特定模型？

📈 效果对比

🎓 下一步