- 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
279 lines
9.0 KiB
Markdown
279 lines
9.0 KiB
Markdown
# 🚀 Claude Code & GLM Suite - Master Integration Prompt
|
|
|
|
> **Copy and paste this entire prompt into Claude Code to automatically install the complete customization suite.**
|
|
|
|
---
|
|
|
|
## 📋 Master Integration Prompt
|
|
|
|
**Copy everything below this line and paste into Claude Code:**
|
|
|
|
```
|
|
I want to install the Ultimate Claude Code & GLM Customization Suite with 40+ agents, MCP tools, and auto-triggering automation. Please perform the following integration:
|
|
|
|
## Prerequisites: Install Claude Code
|
|
|
|
**Before installing agents and tools, ensure Claude Code is installed:**
|
|
|
|
```bash
|
|
# Install Claude Code (requires Node.js 18+)
|
|
npm install -g @anthropic-ai/claude-code
|
|
|
|
# Verify installation (recommended: 2.0.14+)
|
|
claude --version
|
|
|
|
# If needed, upgrade to latest
|
|
claude update
|
|
```
|
|
|
|
**Reference:** https://docs.anthropic.com/en/docs/claude-code/overview
|
|
|
|
---
|
|
|
|
## Step 1: Install Contains Studio Agents (37 agents with PROACTIVELY auto-triggering)
|
|
|
|
Clone the contains-studio/agents repository:
|
|
git clone https://github.com/contains-studio/agents.git /tmp/contains-studio-agents
|
|
|
|
Copy all agents to Claude Code agents directory:
|
|
cp -r /tmp/contains-studio-agents/agents/* ~/.claude/agents/
|
|
|
|
This provides:
|
|
- 37 specialized agents across 8 departments
|
|
- PROACTIVELY auto-triggering system (studio-coach, test-writer-fixer, whimsy-injector, experiment-tracker)
|
|
- Rich example format with <commentary> tags
|
|
- 500+ word system prompts
|
|
|
|
## Step 2: Configure MCP Tools (Vision + Web + GitHub)
|
|
|
|
Install Z.AI MCP server for vision tools:
|
|
npm install -g @z_ai/mcp-server
|
|
|
|
Install Z.AI coding helper for web/GitHub integration:
|
|
npm install -g @z_ai/coding-helper
|
|
|
|
Verify installations:
|
|
npx @z_ai/mcp-server --help
|
|
npx @z_ai/coding-helper --help
|
|
|
|
This provides 15+ MCP tools including:
|
|
- Image/video analysis
|
|
- UI to code conversion
|
|
- OCR text extraction
|
|
- Error diagnosis
|
|
- UI comparison
|
|
- Data visualization insights
|
|
- Diagram understanding
|
|
- Web search and page reading
|
|
- GitHub repository reading
|
|
|
|
## Step 3: Configure Model (Choose ONE)
|
|
|
|
### Option A: Anthropic Claude (Official API)
|
|
|
|
**Best for:** Production, highest quality, official support
|
|
|
|
1. Get your API key: https://console.anthropic.com/
|
|
2. Create ~/.claude/settings.json:
|
|
```json
|
|
{
|
|
"env": {
|
|
"ANTHROPIC_AUTH_TOKEN": "sk-ant-your-actual-api-key-here",
|
|
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
|
|
}
|
|
}
|
|
```
|
|
3. Verify installation: `claude --version`
|
|
|
|
### Option B: Z.AI / GLM Coding Plan (90% cheaper, Official Integration)
|
|
|
|
**Best for:** Development, testing, cost-sensitive projects
|
|
|
|
**Follow official Z.AI documentation:** https://docs.z.ai/devpack/tool/claude
|
|
|
|
1. **Get your GLM Coding Plan API key:**
|
|
- Visit: https://z.ai/
|
|
- Sign up for GLM Coding Plan
|
|
- Copy your API key
|
|
|
|
2. **Configure Claude Code for GLM:**
|
|
Create ~/.claude/settings.json with:
|
|
```json
|
|
{
|
|
"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"
|
|
}
|
|
}
|
|
```
|
|
|
|
3. **Verify and test:**
|
|
```bash
|
|
# Check Claude Code version (recommended: 2.0.14+)
|
|
claude --version
|
|
|
|
# Start Claude Code
|
|
claude
|
|
|
|
# Check model status (enter /status when prompted)
|
|
/status
|
|
```
|
|
|
|
4. **Troubleshooting (if configuration doesn't take effect):**
|
|
- Close all Claude Code windows
|
|
- Open new terminal and run `claude` again
|
|
- Or delete ~/.claude/settings.json and reconfigure
|
|
- Verify JSON format is correct (no missing/extra commas)
|
|
|
|
**GLM Models Available:**
|
|
- `glm-4.5-air` - Fast, efficient (Haiku equivalent)
|
|
- `glm-4.7` - High quality (Sonnet/Opus equivalent)
|
|
|
|
## Step 4: Configure Hooks-Based Auto-Triggering (Optional)
|
|
|
|
Create ~/.claude/hooks.json for additional auto-triggering:
|
|
{
|
|
"userPromptSubmitHook": "test-writer-fixer@agent",
|
|
"toolOutputHook": "whimsy-injector@agent"
|
|
}
|
|
|
|
Note: PROACTIVELY agents (studio-coach, experiment-tracker) work automatically without hooks.
|
|
|
|
## Step 5: Verify Installation
|
|
|
|
Run these checks:
|
|
1. List agents: ls -la ~/.claude/agents/
|
|
2. Count agents: find ~/.claude/agents -name "*.md" | wc -l
|
|
3. Test Claude Code: claude --version
|
|
4. Check MCP tools: npx @z_ai/mcp-server --help
|
|
|
|
Expected results:
|
|
- 38+ agent files (37 agents + README)
|
|
- All department folders present (engineering, marketing, design, product, project-management, studio-operations, testing, bonus)
|
|
- MCP tools installed and accessible
|
|
- Settings configured
|
|
|
|
## What This Integration Provides:
|
|
|
|
### 40+ AI Agents Including:
|
|
- Engineering: AI Engineer, Backend Architect, DevOps Automator, Frontend Developer, Mobile Builder, Rapid Prototyper, Test Writer/Fixer
|
|
- Marketing: TikTok Strategist, Growth Hacker, Content Creator, Instagram Curator, Reddit Builder, Twitter Engager, App Store Optimizer
|
|
- Product: Feedback Synthesizer, Sprint Prioritizer, Trend Researcher
|
|
- Project Management: Experiment Tracker, Project Shipper, Studio Producer
|
|
- Studio Operations: Analytics Reporter, Finance Tracker, Infrastructure Maintainer, Legal Compliance Checker, Support Responder
|
|
- Testing: API Tester, Performance Benchmarker, Test Results Analyzer, Tool Evaluator, Workflow Optimizer
|
|
- Design: Brand Guardian, UI Designer, UX Researcher, Visual Storyteller, Whimsy Injector
|
|
- Bonus: Studio Coach, Joker
|
|
|
|
### Auto-Triggering Agents:
|
|
1. studio-coach - Coordinates complex multi-agent tasks
|
|
2. test-writer-fixer - Writes tests after code changes
|
|
3. whimsy-injector - Adds delight to UI designs
|
|
4. experiment-tracker - Tracks A/B tests and experiments
|
|
|
|
### 15+ MCP Tools:
|
|
- Vision: analyze_image, analyze_video, ui_to_artifact, extract_text, diagnose_error, ui_diff_check, analyze_data_viz, understand_diagram
|
|
- Web: web-search-prime, web-reader
|
|
- GitHub: zread (repository reader)
|
|
|
|
### Two Auto-Triggering Mechanisms:
|
|
1. PROACTIVELY Keyword (contains-studio) - Context-aware, zero config
|
|
2. Hooks-Based (our implementation) - Event-driven, explicit control
|
|
|
|
Please execute this integration step by step and confirm when complete.
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 How to Use
|
|
|
|
1. **Copy** the entire prompt above (including the code block)
|
|
2. **Paste** into Claude Code
|
|
3. **Follow** the step-by-step installation
|
|
4. **Verify** your installation
|
|
|
|
---
|
|
|
|
## 📚 Source Repositories
|
|
|
|
This integration pulls from multiple open-source projects:
|
|
|
|
### Core Agents
|
|
- **[contains-studio/agents](https://github.com/contains-studio/agents)** - 37 agents with PROACTIVELY auto-triggering
|
|
- **[claude-codex-settings](https://github.com/fcakyon/claude-codex-settings)** - MCP configuration patterns
|
|
|
|
### Design Inspiration
|
|
- **[ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)** - UI/UX design patterns
|
|
|
|
### Coordination Framework
|
|
- **[Ralph](https://github.com/iannuttall/ralph)** - Multi-agent coordination patterns
|
|
|
|
### MCP Tools
|
|
- **[@z_ai/mcp-server](https://github.com/zai-ai/mcp-server)** - Vision and analysis tools
|
|
- **[Model Context Protocol](https://github.com/modelcontextprotocol)** - Open standard for AI tools
|
|
|
|
### Official Tools
|
|
- **[Claude Code](https://github.com/anthropics/claude-code)** - Official Claude Code CLI
|
|
|
|
---
|
|
|
|
## 🔧 What Gets Installed
|
|
|
|
| Component | Source | Count |
|
|
|-----------|--------|-------|
|
|
| AI Agents | contains-studio/agents | 37 |
|
|
| MCP Vision Tools | @z_ai/mcp-server | 8 |
|
|
| MCP Web Tools | claude-codex-settings | 2 |
|
|
| MCP GitHub Tools | @z_ai/coding-helper | 1 |
|
|
| Auto-Triggering | contains-studio + custom | 4 agents |
|
|
| **Total** | | **40+ agents, 15+ tools** |
|
|
|
|
---
|
|
|
|
## ✅ After Installation
|
|
|
|
Test your setup:
|
|
|
|
```bash
|
|
# Start Claude Code
|
|
claude
|
|
|
|
# Try these commands:
|
|
> List all available agents
|
|
> Use the frontend-developer agent to create a React component
|
|
> Use the whimsy-injector agent to enhance this UI
|
|
|
|
# Test MCP tools:
|
|
> Analyze this image: [path to image]
|
|
> Search the web for "latest AI trends"
|
|
> Read the documentation from https://example.com
|
|
```
|
|
|
|
---
|
|
|
|
## 🆚 Master Prompt vs Installation Scripts
|
|
|
|
| Feature | Master Prompt | Installation Scripts |
|
|
|---------|--------------|---------------------|
|
|
| **Setup** | Copy-paste into Claude Code | Run bash scripts |
|
|
| **Control** | Step-by-step confirmation | Automated execution |
|
|
| **Customization** | Easy to modify steps | Edit script files |
|
|
| **Transparency** | See all steps upfront | Scripts run automatically |
|
|
| **Best For** | Understanding what happens | Quick installation |
|
|
|
|
---
|
|
|
|
## 📖 Documentation
|
|
|
|
- **[Integration Guide](https://github.rommark.dev/admin/claude-code-glm-suite/src/main/INTEGRATION-GUIDE.md)** - Technical details
|
|
- **[Contains Studio Integration](https://github.rommark.dev/admin/claude-code-glm-suite/src/main/CONTAINS-STUDIO-INTEGRATION.md)** - PROACTIVELY mechanism
|
|
- **[README](https://github.rommark.dev/admin/claude-code-glm-suite)** - Complete documentation
|
|
|
|
---
|
|
|
|
**Built for developers who ship.** 🚀
|