admin/claude-code-glm-suite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fb3a233fe3c94ea3a2e5e4efda191d3a382c5d82
claude-code-glm-suite/README.md
uroma fb3a233fe3 Integrate official Z.AI GLM Claude Code documentation 
- Add Claude Code installation prerequisite (npm install)
- Update GLM configuration with official model mappings (glm-4.5-air, glm-4.7)
- Add version verification (recommended 2.0.14+)
- Include troubleshooting steps from Z.AI docs
- Add /status command verification
- Reference official Z.AI documentation: https://docs.z.ai/devpack/tool/claude
- Update README with proper GLM model configuration
2026-01-15 14:48:49 +00:00

15 KiB
Raw Blame History

🚀 Ultimate Claude Code & GLM Suite

40+ specialized AI agents, MCP tools, auto-triggering automation for Claude Code. Works with Anthropic Claude and Z.AI/GLM models.

Agents MCP Tools License

🚀 Quick Start

# Clone the repository
git clone https://github.rommark.dev/admin/claude-code-glm-suite.git
cd claude-code-glm-suite

# Run the interactive installer
chmod +x interactive-install-claude.sh
./interactive-install-claude.sh

# Follow the prompts:
# ✅ Choose model (Anthropic/Z.AI)
# ✅ Select agent categories to install
# ✅ Configure MCP tools
# ✅ Enter your API key
# ✅ Launch Claude Code

🎯 Installation Options

Choose the installation method that works best for you:

Option 1: Master Prompt (Recommended for First-Time Users)

Copy and paste this prompt into Claude Code - it will guide you through the entire installation step-by-step:

📄 MASTER-PROMPT.md

Benefits:

  • ✅ See all steps before executing
  • ✅ Easy to customize and understand
  • ✅ Works entirely within Claude Code
  • ✅ Includes all source repository references

Option 2: Interactive Installation Script

git clone https://github.rommark.dev/admin/claude-code-glm-suite.git
cd claude-code-glm-suite
chmod +x interactive-install-claude.sh
./interactive-install-claude.sh

Benefits:

  • ✅ Automated execution
  • ✅ Menu-driven configuration
  • ✅ Backup and verification built-in
  • ✅ Faster for experienced users

Option 3: Manual Installation

Follow the step-by-step guide below for full control over each component.

✨ What's Included

  • 🤖 40+ Custom Agents across 8 categories
  • 🔧 15+ MCP Tools for vision, search, and GitHub integration
  • ⚡ Auto-Triggering test writer and UI enhancement agents
  • 🎛️ Interactive Installation with model selection (Anthropic/Z.AI)
  • 🛡️ One-Click Setup with comprehensive verification

📋 Complete Integration Guide

Step 1: Choose Your Model Provider

Choose Option A (Anthropic) or Option B (Z.AI/GLM Plan) below.

🔵 Option A: Anthropic Claude (Official API)

Best for: Production, highest quality, official support

1.1 Get Your API Key

# Visit: https://console.anthropic.com/
# Create an account and get your API key

1.2 Configure Claude Code

# Create/update your Claude Code settings
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-your-actual-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}
EOF

1.3 Install Claude Code (if not installed)

# Using npm
npm install -g @anthropic-ai/claude-code

# Or using curl
curl -fsSL https://claude.ai/install.sh | sh

1.4 Verify Installation

# Test Claude Code
claude --version

# Test API connection
echo "Hello, Claude!" | claude

🟢 Option B: Z.AI / GLM Coding Plan (Cost-Effective)

Best for: Development, testing, cost savings (up to 90% cheaper)

Official Documentation: https://docs.z.ai/devpack/tool/claude

1.1 Get Your API Key

# Visit: https://z.ai/
# Create an account and get your GLM Coding Plan API key

1.2 Configure Claude Code for GLM

# Create/update your Claude Code settings
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-zai-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}
EOF

GLM Models Available:

  • glm-4.5-air - Fast, efficient (Haiku equivalent)
  • glm-4.7 - High quality (Sonnet/Opus equivalent)

1.3 Install Claude Code (if not installed)

# Install Claude Code (requires Node.js 18+)
npm install -g @anthropic-ai/claude-code

# Verify version (recommended: 2.0.14+)
claude --version

# Upgrade if needed
claude update

1.4 Verify Installation

# Start Claude Code
claude

# Check model status (enter /status when prompted)
/status

# Troubleshooting:
# - Close all Claude Code windows and reopen
# - Or delete ~/.claude/settings.json and reconfigure
# - Verify JSON format is correct

Step 2: Install This Customization Suite

# Clone this repository
git clone https://github.rommark.dev/admin/claude-code-glm-suite.git
cd claude-code-glm-suite

# Run the interactive installer
chmod +x interactive-install-claude.sh
./interactive-install-claude.sh

The installer will:

  • ✅ Detect your Claude Code installation
  • ✅ Backup existing customizations
  • ✅ Let you choose agent categories to install
  • ✅ Configure MCP tools
  • ✅ Set up auto-triggering agents
  • ✅ Verify everything works

Installation options:

Step 1: Model Selection
  [ ] Already configured - skip model setup
  [ ] Anthropic Claude (official API)
  [ ] Z.AI / GLM Coding Plan

Step 2: Agent Categories
  [ ] Engineering (7 agents) - RECOMMENDED
  [ ] Marketing (7 agents)
  [ ] Product (3 agents)
  [ ] Project Management (3 agents)
  [ ] Studio Operations (5 agents)
  [ ] Testing (5 agents) - RECOMMENDED
  [ ] Design (5 agents)
  [ ] Bonus (2 agents)

Step 3: MCP Tools
  [ ] Vision Tools (8 tools) - RECOMMENDED
  [ ] Web Tools (search, reader)
  [ ] GitHub Tools (zread)

Step 4: Plugins & Hooks
  [ ] Auto-triggering agents
  [ ] Custom hooks

Step 3: Install MCP Tools (Optional but Recommended)

3.1 Vision Tools (8 tools)

# Install Z.AI MCP server for vision tools
npm install -g @z_ai/mcp-server

# Verify installation
npx @z_ai/mcp-server --help

3.2 Web & GitHub Tools

# Install Z.AI coding helper
npm install -g @z_ai/coding-helper

# Verify installation
npx @z_ai/coding-helper --help

Step 4: Verify Your Installation

# Run the verification script
chmod +x verify-claude-setup.sh
./verify-claude-setup.sh

Expected output:

✅ Claude Code installed
✅ Settings configured
✅ Agents directory exists
✅ 37 agent files found
✅ MCP tools available
✅ Configuration valid

Step 5: Test Your Setup

5.1 Test Basic Functionality

# Start Claude Code
claude

# Try a simple command
> List all available agents

5.2 Test an Agent

# In Claude Code, try:
> Use the frontend-developer agent to create a React component

5.3 Test MCP Tools (if installed)

# In Claude Code, try:
> Analyze this image: [path to image]
> Search the web for "latest AI trends"
> Read the documentation from https://example.com

📦 Installation Scripts

Script Description Size
interactive-install-claude.sh Full interactive installer (recommended) 33KB
claude-setup-manager.sh Menu-driven setup manager 11KB
create-complete-package.sh Create distributable packages 16KB
verify-claude-setup.sh Verify your installation 9KB
export-claude-customizations.sh Export existing customizations 6.5KB

🤖 Agent Categories

Engineering (7 agents)

  • AI Engineer - ML & LLM integration, prompt engineering
  • Backend Architect - API design, database architecture, microservices
  • DevOps Automator - CI/CD pipelines, infrastructure as code
  • Frontend Developer - React/Vue/Angular, responsive design
  • Mobile Builder - iOS/Android React Native apps
  • Rapid Prototyper - Quick MVPs in 6-day cycles
  • Test Writer/Fixer - Auto-write and fix tests

Marketing (7 agents)

  • TikTok Strategist - Viral TikTok marketing strategies
  • Growth Hacker - Growth strategies and user acquisition
  • Content Creator - Multi-platform content creation
  • Instagram Curator - Instagram strategy and engagement
  • Reddit Builder - Reddit community building
  • Twitter Engager - Twitter strategy and tactics
  • App Store Optimizer - ASO optimization

Product (3 agents)

  • Feedback Synthesizer - User feedback analysis
  • Sprint Prioritizer - 6-day sprint planning
  • Trend Researcher - Market trend analysis

Project Management (3 agents)

  • Experiment Tracker - A/B test tracking
  • Project Shipper - Launch coordination
  • Studio Producer - Team workflow optimization

Studio Operations (5 agents)

  • Analytics Reporter - Data analysis and reporting
  • Finance Tracker - Financial tracking
  • Infrastructure Maintainer - Infrastructure management
  • Legal Compliance Checker - Compliance checks
  • Support Responder - Customer support automation

Testing (5 agents)

  • API Tester - API testing
  • Performance Benchmarker - Performance testing
  • Test Results Analyzer - Test analysis
  • Tool Evaluator - Tool evaluation
  • Workflow Optimizer - Workflow optimization

Design (5 agents)

  • Brand Guardian - Brand consistency
  • UI Designer - UI design and implementation
  • UX Researcher - User experience research
  • Visual Storyteller - Visual communication
  • Whimsy Injector - Delightful UI enhancements

Bonus (2 agents)

  • Joker - Humor and team morale
  • Studio Coach - Team coaching and motivation

🔧 MCP Tools

Vision Tools (8 tools)

Tool Function Input
analyze_image General image analysis PNG, JPG, JPEG
analyze_video Video content analysis MP4, MOV, M4V
ui_to_artifact UI screenshot to code Screenshots
extract_text OCR text extraction Any image
diagnose_error Error screenshot diagnosis Error screenshots
ui_diff_check Compare UI screenshots Before/after
analyze_data_viz Data visualization insights Dashboards, charts
understand_diagram Technical diagram analysis UML, flowcharts

Web & GitHub Tools

Tool Function Source
web-search-prime AI-optimized web search claude-codex-settings
web-reader Web page to markdown conversion claude-codex-settings
zread GitHub repository reader claude-codex-settings
@z_ai/mcp-server Vision and analysis tools @z_ai/mcp-server
@z_ai/coding-helper Web and GitHub integration @z_ai/mcp-server

📚 Advanced Configuration

Auto-Triggering Agents

This suite supports two auto-triggering mechanisms:

Method 1: Hooks-Based (Our Implementation)

Configure hooks.json for automatic agent invocation:

cat > ~/.claude/hooks.json << 'EOF'
{
  "userPromptSubmitHook": "test-writer-fixer@agent",
  "toolOutputHook": "whimsy-injector@agent"
}
EOF

Method 2: PROACTIVELY Keyword (Contains Studio Pattern)

Agents with PROACTIVELY in their description automatically trigger based on context:

---
name: studio-coach
description: PROACTIVELY use this agent when complex multi-agent tasks begin...
---

The 4 Proactive Agents:

  1. studio-coach - Triggers on complex multi-agent tasks
  2. test-writer-fixer - Triggers after code modifications
  3. whimsy-injector - Triggers after UI/UX changes
  4. experiment-tracker - Triggers when feature flags are added

This method requires no hooks.json - Claude Code's built-in agent selection system detects the PROACTIVELY keyword and automatically invokes agents when matching conditions occur.

Key Differences:

Feature Hooks-Based PROACTIVELY Keyword
Configuration hooks.json file Built into agent description
Trigger Scope Global events Context-aware conditions
Flexibility Manual setup Self-documenting
Detection File/tool operations Semantic context

Custom Model Selection

Use specific models for different tasks:

# Add to settings.json
{
  "env": {
    "MODEL_DEFAULT": "claude-sonnet-4-20250514",
    "MODEL_FAST": "claude-haiku-4-20250514",
    "MODEL_EXPENSIVE": "claude-opus-4-20250514"
  }
}

📚 Documentation

🙏 Acknowledgments & Sources

This customization suite is built upon excellent open-source projects and community contributions.

Core Inspiration

  • contains-studio/agents by contains-studio

    • 37 specialized agents with PROACTIVELY auto-triggering system
    • Inspired rich example format with tags and 500+ word system prompts
    • Source of studio-coach coordination patterns and department-based organization

  • claude-codex-settings by fcakyon

    • Comprehensive Claude Code settings and MCP configurations
    • Foundation for MCP tool integration patterns

  • ui-ux-pro-max-skill by nextlevelbuilder

    • Professional UI/UX design patterns and agent behaviors
    • Inspired design-focused agents and whimsy-injector

  • Ralph by iannuttall

    • AI assistant framework and agent patterns
    • Inspired multi-agent coordination and studio operations workflows

MCP Tool Sources

Agent Architecture

  • 6-Day Development Cycle - Inspired by rapid iteration methodologies and startup best practices
  • Studio Operations - Professional studio management patterns applied to software development
  • Auto-Triggering Agents - Proactive agent invocation patterns for test writing and UI enhancement

🤝 Community & Contributing

This suite is 100% open source and available on GitHub.

  • ⭐ Star the repo
  • 🐛 Report issues
  • 🔄 Submit pull requests
  • 💡 Contribute your own agents!

📝 License

MIT License - Feel free to use and modify for your needs.

Built for developers who ship. 🚀

Reference in New Issue View Git Blame Copy Permalink