admin/claude-code-glm-suite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
5ec488d7cef5268f6a912f2f706b883ccb92101c
claude-code-glm-suite/MASTER-PROMPT.md
uroma 5ec488d7ce Use @z_ai/coding-helper wizard for easier GLM setup 
MAJOR IMPROVEMENT to GLM setup workflow:

Before: Manual configuration with multiple steps
- Create settings.json manually
- Copy/paste complex JSON
- Edit files manually
- Easy to make mistakes

After: Interactive wizard ( MUCH simpler!)
- npm install -g @z_ai/coding-helper
- npx @z_ai/coding-helper init
- Wizard asks for API key
- Everything configured automatically
- Verified working

Benefits:
- ✅ Fewer steps (3 vs 6+)
- ✅ Less error-prone
- ✅ Interactive and guided
- ✅ Official Z.AI tool
- ✅ Automatic verification

Updates:
- MASTER-PROMPT.md: Promote wizard method as "EASIEST"
- README.md: Add wizard at top as primary method
- Blog post: Update warning with wizard commands
- Keep manual method as alternative

This makes GLM setup as simple as:
  npm install -g @z_ai/coding-helper
  npx @z_ai/coding-helper init
  claude
2026-01-15 15:05:58 +00:00

302 lines
9.3 KiB
Markdown
Raw Blame History

# 🚀 Claude Code & GLM Suite - Master Integration Prompt
> **Quick installation by copy-pasting a prompt into Claude Code**
---
## ⚠️ BEFORE YOU BEGIN - Read This First!
### **If Using Z.AI / GLM Coding Plan (90% cheaper):**
**You MUST configure GLM FIRST before using Claude Code!**
**🎯 EASIEST METHOD - Use Z.AI Coding Helper:**
```bash
# Step 1: Install the coding helper
npm install -g @z_ai/coding-helper
# Step 2: Run the interactive GLM setup wizard
npx @z_ai/coding-helper init
# The wizard will:
# - Ask for your Z.AI API key
# - Configure Claude Code for GLM automatically
# - Set up proper model mappings (glm-4.5-air, glm-4.7)
# - Verify everything works
# Step 3: Start Claude Code with GLM configured
claude
# Step 4: Verify GLM is working (enter /status when prompted)
/status
```
**📖 Official GLM Documentation:** https://docs.z.ai/devpack/tool/claude
---
**Alternative: Manual Configuration (if you prefer):**
```bash
# Step 1: Get your API key
# Visit: https://z.ai/
# Sign up for GLM Coding Plan and copy your API key
# Step 2: Install Claude Code (if not installed)
npm install -g @anthropic-ai/claude-code
# Step 3: Create 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
# Step 4: Start Claude Code
claude
```
---
### **If Using Anthropic Claude (Official API):**
```bash
# Step 1: Get your API key
# Visit: https://console.anthropic.com/
# Step 2: Create Claude Code settings
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-ant-your-api-key-here",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
}
}
EOF
# Step 3: Install Claude Code (if not installed)
npm install -g @anthropic-ai/claude-code
# Step 4: Start Claude Code
claude
```
---
## 📋 HOW TO USE THE MASTER PROMPT
**Once Claude Code is running and configured:**
### **Option 1: Copy From This File**
**✂️ COPY FROM HERE:**
```text
═══════════════════════════════════════════════════════════════════════════════
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:
## 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 Hooks-Based Auto-Triggering (Optional)
Create ~/.claude/hooks.json for additional auto-triggering:
cat > ~/.claude/hooks.json << 'EOF'
{
"userPromptSubmitHook": "test-writer-fixer@agent",
"toolOutputHook": "whimsy-injector@agent"
}
EOF
Note: PROACTIVELY agents (studio-coach, experiment-tracker) work automatically without hooks.
## Step 4: 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.
═══════════════════════════════════════════════════════════════════════════════
```
**✂️ COPY ENDS HERE**
---
## 📖 Detailed Installation Guide
### 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** |
---
## 🎯 Quick Reference
**After Installation, Test With:**
```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 |
---
## 📚 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
- **[Z.AI GLM Documentation](https://docs.z.ai/devpack/tool/claude)** - Official GLM integration guide
---
## ✅ After Installation
Test your setup:
```bash
# 1. Verify agents are installed
ls ~/.claude/agents/
find ~/.claude/agents -name "*.md" | wc -l
# 2. Start Claude Code
claude
# 3. Check status (enter /status when prompted)
/status
# 4. Try an agent
> Use the studio-coach agent to help me plan a complex project
```
---
**Built for developers who ship.** 🚀
Reference in New Issue View Git Blame Copy Permalink