✨ Features
| Feature |
Description |
| 🤖 Multi-Model Collaboration |
Configure multiple AI models to work together, each leveraging their strengths |
| 🧠 Smart Task Distribution |
Tech Lead analyzes tasks and automatically assigns them to the best-suited experts |
| 🔗 Workflow Templates |
5 pre-built workflows: code generation, bug fixing, refactoring, review, documentation |
| 🎯 Custom Experts |
Define your own experts (Rust, K8s, Security, etc.) via environment variables |
| 📊 Observability |
Dashboard, cost estimation, and task planning preview |
| 🌐 Proxy API Support |
Custom Base URLs, compatible with various proxy services |
| 📝 Collaboration History |
Complete record of all collaborations with search support |
🚀 Quick Start
Installation
# Global install
npm install -g claude-team
# Or use directly with npx (no install needed)
npx claude-team
Basic Configuration
Add to your IDE’s MCP configuration file:
{
"mcpServers": {
"claude-team": {
"command": "npx",
"args": ["-y", "claude-team"],
"env": {
"CLAUDE_TEAM_MAIN_KEY": "sk-your-api-key",
"CLAUDE_TEAM_MAIN_URL": "https://api.openai.com/v1",
"CLAUDE_TEAM_MAIN_MODEL": "gpt-4o",
"CLAUDE_TEAM_MAIN_PROVIDER": "openai"
}
}
}
}
Start Using
> Help me build a user login feature with the team
> Have the team optimize this code for performance
🎬 How It Works
User: "Optimize this SQL query for performance"
Tech Lead Analysis →
├── Creates: SQL Optimization Expert (powerful)
├── Creates: Index Analysis Expert (balanced)
└── Workflow: sequential
User: "Build a settings page with dark mode"
Tech Lead Analysis →
├── Creates: UI Component Expert (balanced)
├── Creates: Theme System Expert (fast)
├── Creates: State Management Expert (balanced)
└── Workflow: parallel → review
| Tool |
Description |
team_work |
🚀 Team collaboration (auto-creates experts) |
ask_expert |
💬 Consult an expert (supports custom experts) |
code_review |
🔍 Code review |
fix_bug |
🐛 Bug fixing |
| Tool |
Description |
list_workflows |
📋 List all workflow templates |
run_workflow |
▶️ Execute a specific workflow |
suggest_workflow |
💡 Auto-recommend workflow based on task |
Pre-built Workflows:
| Workflow |
Purpose |
Steps |
code-generation |
Generate code from requirements |
Design → Implement → Test → Review |
bug-fix |
Diagnose and fix bugs |
Diagnose → Fix → Verify |
refactoring |
Code refactoring |
Analyze → Plan → Execute → Review |
code-review |
Multi-dimensional review |
Security / Quality / Performance (parallel) |
documentation |
Generate documentation |
Analyze → Document |
| Tool |
Description |
team_dashboard |
🎛️ View team status, experts, models, stats |
cost_estimate |
💰 Estimate task cost (tokens, price, time) |
explain_plan |
🧠 Preview task assignment plan |
usage_stats |
📈 View model usage statistics |
| Tool |
Description |
read_project_files |
📄 Read project files for context |
analyze_project_structure |
🏗️ Analyze project structure and tech stack |
generate_commit_message |
📝 Generate commit message from diff |
History Tools
| Tool |
Description |
history_list |
📋 View collaboration history |
history_get |
📄 Get history details |
history_search |
🔎 Search history records |
history_context |
📚 Get recent context |
⚙️ Configuration
Environment Variables
| Variable |
Required |
Description |
CLAUDE_TEAM_MAIN_KEY |
✅ |
Main model API Key |
CLAUDE_TEAM_MAIN_URL |
❌ |
Main model API URL |
CLAUDE_TEAM_MAIN_MODEL |
❌ |
Main model ID (default: gpt-4o) |
CLAUDE_TEAM_MAIN_PROVIDER |
❌ |
Provider: openai / anthropic / gemini |
CLAUDE_TEAM_MODEL{N}_* |
❌ |
Worker model N config (inherits from MAIN) |
CLAUDE_TEAM_CUSTOM_EXPERTS |
❌ |
Custom experts (JSON format) |
N = 1, 2, 3… supports up to 10 worker models
Custom Experts
Define your own experts beyond the built-in frontend, backend, qa:
{
"env": {
"CLAUDE_TEAM_CUSTOM_EXPERTS": "{\"rust\":{\"name\":\"Rust Expert\",\"prompt\":\"You are a Rust expert...\",\"tier\":\"powerful\"},\"k8s\":{\"name\":\"K8s Expert\",\"prompt\":\"You are a Kubernetes expert...\",\"tier\":\"balanced\"}}"
}
}
| Field |
Required |
Description |
name |
✅ |
Expert display name |
prompt |
✅ |
Expert role description (System Prompt) |
tier |
❌ |
Model tier: fast / balanced / powerful |
skills |
❌ |
Skill tags array |
Model Tiers
| Tier |
Use Case |
Example Scenarios |
fast |
Simple, quick tasks |
Formatting, simple queries, docs |
balanced |
Regular dev tasks |
Components, APIs, unit tests |
powerful |
Complex reasoning |
Architecture, optimization, security |
📦 Changelog
v0.4.0
- 🎯 Custom Experts - Define experts via environment variables
- 🔗 Workflow Templates - 5 pre-built workflows
- 📊 Observability - Dashboard, cost estimation, plan preview
- 🔌 Integration - Project file reading, structure analysis, commit messages
- 💡 Smart Recommendations - Auto-suggest workflows
- 🧪 Test Coverage - 155 test cases
v0.3.0
- 🔄 Task interrupt/resume support
- 💬 Multi-turn expert conversations
- 📊 Token counting and cost estimation
- 📋 Expert templates (6 built-in + custom)
- 🔔 Webhook notifications
- ⚡ Exponential backoff retry
- 🔧 Hot config reload
🤝 Contributing
Contributions are welcome! Please read our:
📄 License
MIT
