MCC - Multi-Client Coder for Claude

A session-aware launcher for Claude Code that enables seamless switching between multiple AI providers with secure credential management, session recovery, and autopilot mode.

npm | GitHub | Documentation

v2.1 Features

• Multi-Provider Support: Claude Max, Z.AI GLM, MiniMax, DeepInfra, local LLMs, and custom endpoints
• Claude Agent SDK Integration: Native support for Anthropic Agent SDK with full tool support
• Interactive Setup Wizard: Guided first-run experience for new users
• Latest Models: Pre-configured with Claude 4.6 (Opus 4.6, Sonnet 4.6)
• Session Recovery: Save and resume sessions with full context transfer
• Autopilot Mode: Fully autonomous execution from idea to working code
• Secure Credential Storage: AES-256-GCM encrypted local storage with environment variable fallback
• Simplified UI: Compact, efficient interactive menu
• Workspace Awareness: Git-aware session detection and organization
• Health Monitoring: Real-time provider status with detailed diagnostics

Installation

From npm (Recommended)

npm install -g @velocity-digital/mcc

From Source

git clone https://github.com/velocity-digital/mcc.git
cd mcc/mcc
npm install
npm run build:bundle
npm link

One-Line Install (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/velocity-digital/mcc/main/release/install.sh | sh

Quick Start

# First run - guided setup wizard
mcc

# Quick launch with specific provider
mcc launch claude-max

# Run setup wizard manually
mcc setup

# List all providers
mcc list

Commands

| Command | Description | |---------|-------------| | mcc | Interactive menu (default) | | mcc setup | Run guided setup wizard | | mcc launch [id] | Launch Claude with provider | | mcc list | List all providers | | mcc health [id] | Check provider health | | mcc switch [id] | Switch active provider without restarting | | mcc status | Show current provider status | | mcc resume [id] | Resume previous session | | mcc sessions ls | List all sessions | | mcc sessions export <id> | Export session to file | | mcc sessions import <file> | Import session from file | | mcc sessions clean [days] | Remove old sessions | | mcc autopilot <prompt> | Fully autonomous execution | | mcc update | Check for and install updates |

Prepopulated Providers

MCC comes with these providers pre-configured (disabled by default):

| Provider | ID | Default Model | Auth | |----------|-----|---------------|------| | Claude Max | claude-max | claude-sonnet-4-6-20250219 | Bearer token | | Z.AI GLM | zai-coding-plan | glm-5 | Bearer token | | MiniMax | minimax-coding-plan | MiniMax-M2.5-highspeed | API key | | DeepInfra | deepinfra | claude-sonnet-4-5-20250929 | API key | | LM Studio | lm-studio | custom-model | None | | GLM-4.7 | glm-local | zai-org/glm-4.7-flash | None |

Setting Up Claude Max

1. Run claude setup-token in a separate terminal
2. Launch MCC: mcc
3. Select provider from menu
4. Enter your bearer token when prompted

Setting Up Z.AI or MiniMax

1. Get API key from z.ai or platform.minimax.io
2. Launch MCC: mcc
3. Select provider from menu
4. Enter your API key when prompted

Credential Management

MCC stores credentials in ~/.config/mcc/.credentials with AES-256-GCM encryption.

Priority Order

1. Encrypted store (primary) - Secure, persistent
2. Environment variables (fallback) - For CI/CD or system-level config

Environment Variables

export ANTHROPIC_AUTH_TOKEN="sk-ant-..."
export ZAI_API_KEY="your-zai-key"
export MINIMAX_API_KEY="your-minimax-key"

Configuration

Config location: ~/.config/mcc/config.yaml

Example Provider

providers:
  - id: claude-max
    name: Claude Max Subscription
    type: anthropic
    enabled: true
    auth:
      method: bearer
      tokenEnv: ANTHROPIC_AUTH_TOKEN
    defaultModel: claude-sonnet-4-5-20250929
    models:
      - claude-opus-4-5-20251101
      - claude-sonnet-4-5-20250929
      - claude-haiku-4-5-20251001
    timeout: 120000

Directory Structure

~/.config/mcc/
├── config.yaml          # Provider configuration
├── .credentials         # Encrypted credential store
├── .active-session.json # Current session pointer
└── sessions/            # Session files
    ├── abc12345.json
    └── def67890.json

Autopilot Mode (Coming Soon)

Autopilot enables fully autonomous execution:

mcc autopilot "add dark mode to the app"
mcc autopilot "fix the login bug" --provider zai
mcc autopilot "refactor auth" --export

Flow:

1. Planning: Break down prompt into tasks
2. Execution: Run tasks with verification
3. Self-Correction: Fix issues automatically
4. Completion: Export session with summary

Multi-Provider Switching

Switch providers without restarting Claude Code:

# Launch Claude with multi-provider proxy
mcc launch claude-max

# In another terminal, switch providers
mcc switch                    # Interactive selection
mcc switch zai-coding-plan     # Direct selection
mcc status                     # Show current status

How it works:

1. MCC runs a local proxy between Claude and providers
2. All enabled providers are loaded at launch
3. The mcc switch command updates the proxy's active provider
4. Next request from Claude routes to the new provider seamlessly

This is useful for:

• Comparing outputs from different providers
• Using cheaper providers for simple tasks
• Switching to specialized providers for specific workloads

Troubleshooting

"No credentials configured"

1. For Claude Max: Run claude setup-token first
2. Use interactive menu to enter credentials
3. Or set environment variable

Provider not responding

1. Run mcc health -v for diagnostics
2. Check endpoint is accessible
3. Increase timeout in config

Development

npm run dev      # Development mode
npm run build    # Build
npm run link     # Link globally
npm run test     # Run tests

License

MIT

Built by Velocity Digital