Files

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

9.0 KiB

Raw Blame History

🚀 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 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

Get your API key: https://console.anthropic.com/
Create ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-your-actual-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

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

Get your GLM Coding Plan API key:
- Visit: https://z.ai/
- Sign up for GLM Coding Plan
- Copy your API key
Configure Claude Code for GLM: Create ~/.claude/settings.json with:

{
  "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"
  }
}

Verify and test:

# Check Claude Code version (recommended: 2.0.14+)
claude --version

# Start Claude Code
claude

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

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:

List agents: ls -la ~/.claude/agents/
Count agents: find ~/.claude/agents -name "*.md" | wc -l
Test Claude Code: claude --version
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:

studio-coach - Coordinates complex multi-agent tasks
test-writer-fixer - Writes tests after code changes
whimsy-injector - Adds delight to UI designs
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:

PROACTIVELY Keyword (contains-studio) - Context-aware, zero config
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 - Technical details
Contains Studio Integration - PROACTIVELY mechanism
README - Complete documentation

Built for developers who ship. 🚀

9.0 KiB Raw Blame History