354 lines
8.5 KiB
Markdown
354 lines
8.5 KiB
Markdown
# Claude Code Customizations - Complete Setup Guide
|
|
|
|
## 📦 All Scripts Created
|
|
|
|
| Script | Size | Description |
|
|
|--------|------|-------------|
|
|
| **interactive-install-claude.sh** | 28KB | ⭐ **NEW** - Interactive step-by-step installer |
|
|
| claude-setup-manager.sh | 11KB | Interactive menu manager |
|
|
| create-complete-package.sh | 16KB | Create full distributable package |
|
|
| install-claude-customizations.sh | 13KB | Automated installer (original) |
|
|
| export-claude-customizations.sh | 6.5KB | Export/backup customizations |
|
|
| verify-claude-setup.sh | 9.2KB | Verify installation |
|
|
|
|
## 🚀 Quick Start - Choose Your Method
|
|
|
|
### Method 1: Interactive Installer (Recommended) ⭐
|
|
|
|
The easiest way to install - guides you through each step:
|
|
|
|
```bash
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
**Features:**
|
|
- ✅ Choose model provider (Anthropic or Z.AI)
|
|
- ✅ Select which agent categories to install
|
|
- ✅ Choose which MCP tools to install
|
|
- ✅ Select plugins and hooks
|
|
- ✅ **Installs Claude Code if not present**
|
|
- ✅ Launches Claude Code when done
|
|
|
|
### Method 2: Menu Manager
|
|
|
|
```bash
|
|
./claude-setup-manager.sh
|
|
```
|
|
|
|
Provides an interactive menu for all operations.
|
|
|
|
### Method 3: Package Distribution
|
|
|
|
For distributing to other machines:
|
|
|
|
```bash
|
|
# On source machine - create package
|
|
./create-complete-package.sh
|
|
|
|
# On target machine - extract and run
|
|
tar -xzf claude-customizations-complete-*.tar.gz
|
|
cd claude-complete-package
|
|
./install.sh
|
|
./verify.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 What Gets Installed
|
|
|
|
### Step-by-Step Selection
|
|
|
|
The interactive installer guides you through:
|
|
|
|
#### **Step 1: Model Provider**
|
|
- Anthropic Claude (official) - Get API key from https://console.anthropic.com/
|
|
- Z.AI / GLM Coding Plan - Get API key from https://open.bigmodel.cn/usercenter/apikeys
|
|
|
|
The script will prompt for your API key with helpful information about where to get it based on your choice.
|
|
|
|
#### **Step 2: Agent Categories** (40+ agents)
|
|
- Engineering (7): AI engineer, frontend/backend dev, DevOps, mobile, rapid prototyper, test writer
|
|
- Marketing (7): TikTok strategist, growth hacker, content creator, Instagram/Reddit/Twitter
|
|
- Product (3): Sprint prioritizer, feedback synthesizer, trend researcher
|
|
- Studio Operations (8): Studio producer, project shipper, analytics, finance, legal, support, coach
|
|
- Project Management (3): Experiment tracker, studio producer, project shipper
|
|
- Testing (5): Test writer/fixer, API tester, performance benchmarker, workflow optimizer
|
|
- Design (5): UI/UX designer, brand guardian, visual storyteller, whimsy injector
|
|
- Bonus (2): Joker, studio coach
|
|
|
|
#### **Step 3: MCP Tools**
|
|
- Vision Analysis (8 tools): images, videos, UI screenshots, errors, data viz, diagrams
|
|
- Web Search: enhanced search with filtering
|
|
- Web Reader: fetch URLs, convert to markdown
|
|
- GitHub Reader: read repos, search docs
|
|
|
|
#### **Step 4: Plugins**
|
|
- glm-plan-bug: Submit bug feedback
|
|
- glm-plan-usage: Query usage stats
|
|
|
|
#### **Step 5: Hooks**
|
|
- Custom automation hooks
|
|
|
|
#### **Step 6: Prerequisites Check**
|
|
- Node.js, npm, python3, npx
|
|
|
|
#### **Step 7: Claude Code Installation** ⭐ NEW
|
|
- Install via npm (recommended)
|
|
- Install via curl (standalone binary)
|
|
- Manual installation link
|
|
- Skip if already installed
|
|
|
|
#### **Step 8: Backup**
|
|
- Backs up existing configuration
|
|
|
|
#### **Step 9: Installation**
|
|
- Creates directory structure
|
|
- Installs selected agents
|
|
- Configures settings
|
|
- Installs MCP tools
|
|
- Configures plugins
|
|
|
|
#### **Step 10: Summary & Launch**
|
|
- Shows what was installed
|
|
- Offers to launch Claude Code
|
|
|
|
---
|
|
|
|
## 🎯 Installation Examples
|
|
|
|
### Example 1: Fresh Machine (No Claude Code)
|
|
|
|
```bash
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
The script will:
|
|
1. Detect Claude Code is not installed
|
|
2. Offer to install it (npm, curl, or manual)
|
|
3. Guide you through selecting components
|
|
4. Install everything
|
|
5. Launch Claude Code
|
|
|
|
### Example 2: Existing Claude Code
|
|
|
|
```bash
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
The script will:
|
|
1. Detect existing installation
|
|
2. Offer to back up current config
|
|
3. Guide you through selecting components
|
|
4. Merge with existing setup
|
|
5. Restart Claude Code
|
|
|
|
### Example 3: Minimal Installation
|
|
|
|
```bash
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
Select:
|
|
- Model: Anthropic
|
|
- Agents: Engineering only
|
|
- MCP Tools: Vision only
|
|
- Plugins: No
|
|
- Hooks: No
|
|
|
|
→ Gets you started with just the essentials
|
|
|
|
### Example 4: Full Installation
|
|
|
|
```bash
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
Select:
|
|
- Model: Z.AI
|
|
- Agents: All categories
|
|
- MCP Tools: All tools
|
|
- Plugins: Yes
|
|
- Hooks: Yes
|
|
|
|
→ Complete setup with all features
|
|
|
|
---
|
|
|
|
## 📁 File Locations
|
|
|
|
All scripts are in: `/home/uroma/`
|
|
|
|
```
|
|
/home/uroma/
|
|
├── interactive-install-claude.sh ⭐ NEW - Main installer
|
|
├── claude-setup-manager.sh - Menu manager
|
|
├── create-complete-package.sh - Package creator
|
|
├── install-claude-customizations.sh - Original installer
|
|
├── export-claude-customizations.sh - Export tool
|
|
├── verify-claude-setup.sh - Verification
|
|
├── CLAUDE-CUSTOMIZATIONS-README.md - Feature docs
|
|
├── SCRIPTS-GUIDE.md - Script usage
|
|
└── FINAL-SETUP-GUIDE.md - This file
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Advanced Usage
|
|
|
|
### Create Custom Package
|
|
|
|
```bash
|
|
# 1. Create package with your selections
|
|
./interactive-install-claude.sh
|
|
|
|
# 2. Package up for distribution
|
|
./create-complete-package.sh
|
|
```
|
|
|
|
### Transfer Between Machines
|
|
|
|
```bash
|
|
# On source machine
|
|
./create-complete-package.sh
|
|
scp claude-customizations-complete-*.tar.gz target:~/
|
|
|
|
# On target machine
|
|
./interactive-install-claude.sh # Will install Claude Code if needed
|
|
```
|
|
|
|
### Verify Installation
|
|
|
|
```bash
|
|
./verify-claude-setup.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 🛠️ Troubleshooting
|
|
|
|
### Claude Code not found?
|
|
→ Run `./interactive-install-claude.sh` - it will offer to install Claude Code
|
|
|
|
### Agents not showing?
|
|
→ Run `./verify-claude-setup.sh` to check installation
|
|
|
|
### MCP tools not working?
|
|
→ Make sure `@z_ai/mcp-server` is installed:
|
|
```bash
|
|
npm list -g @z_ai/mcp-server
|
|
npm install -g @z_ai/mcp-server
|
|
```
|
|
|
|
### Permission errors?
|
|
→ Check `~/.claude/settings.local.json` for allowed commands
|
|
|
|
### Need to start over?
|
|
```bash
|
|
# Backup is saved at ~/.claude-backup-YYYYMMDD_HHMMSS
|
|
rm -rf ~/.claude
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 What Each Script Does
|
|
|
|
### interactive-install-claude.sh ⭐
|
|
**NEW - Main Recommended Script**
|
|
|
|
- Step-by-step interactive installation
|
|
- Choose model provider (Anthropic/Z.AI)
|
|
- Select which components to install
|
|
- Installs Claude Code if missing
|
|
- Launches Claude Code when done
|
|
|
|
**Best for:** New installations, first-time setup
|
|
|
|
### claude-setup-manager.sh
|
|
Interactive menu for:
|
|
- Creating packages
|
|
- Installing customizations
|
|
- Exporting backups
|
|
- Verifying setup
|
|
- Viewing documentation
|
|
- Cleaning backups
|
|
|
|
**Best for:** Ongoing management
|
|
|
|
### create-complete-package.sh
|
|
Creates a complete package with:
|
|
- All agent .md files
|
|
- Plugin configurations
|
|
- Settings templates
|
|
- Self-contained install.sh
|
|
- Verification script
|
|
|
|
**Best for:** Distributing to other machines
|
|
|
|
### install-claude-customizations.sh
|
|
Original automated installer:
|
|
- Creates directory structure
|
|
- Installs agents
|
|
- Configures settings
|
|
- Installs MCP tools
|
|
- Sets up plugins
|
|
|
|
**Best for:** Automated setups, scripting
|
|
|
|
### export-claude-customizations.sh
|
|
Exports existing customizations:
|
|
- Copies agent definitions
|
|
- Exports plugin configs
|
|
- Creates settings template
|
|
- Packages into .tar.gz
|
|
|
|
**Best for:** Backups, transfers
|
|
|
|
### verify-claude-setup.sh
|
|
Verifies installation:
|
|
- Checks directories
|
|
- Counts agents
|
|
- Validates settings
|
|
- Tests MCP tools
|
|
- Checks plugins
|
|
|
|
**Best for:** Troubleshooting
|
|
|
|
---
|
|
|
|
## 🎓 Quick Reference
|
|
|
|
### To install everything:
|
|
```bash
|
|
./interactive-install-claude.sh
|
|
```
|
|
|
|
### To create distribution package:
|
|
```bash
|
|
./create-complete-package.sh
|
|
```
|
|
|
|
### To verify installation:
|
|
```bash
|
|
./verify-claude-setup.sh
|
|
```
|
|
|
|
### To manage existing setup:
|
|
```bash
|
|
./claude-setup-manager.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 📞 Support
|
|
|
|
For detailed documentation:
|
|
- `CLAUDE-CUSTOMIZATIONS-README.md` - Complete feature docs
|
|
- `SCRIPTS-GUIDE.md` - Script usage guide
|
|
|
|
---
|
|
|
|
**Version:** 2.0.0
|
|
**Last Updated:** 2025-01-15
|
|
**What's New:** Interactive installer with Claude Code installation support
|