Skip to content

mirror-claude.md

Latest commit

 

History

History
226 lines (172 loc) · 11 KB

mirror-claude.md

File metadata and controls

226 lines (172 loc) · 11 KB

🪞 Mirror Claude

Mirror Claude is a pure Claude Code variant with advanced features enabled. Unlike other providers that proxy through custom APIs, Mirror connects directly to Anthropic's API while providing isolation and enhanced capabilities.

Overview

┌────────────────────────────────────────────────────────────────────────────┐
│                                                                            │
│   ┌─────────────────────────────────────────────────────────────────────┐  │
│   │                    PROXY PROVIDERS                                  │  │
│   │                                                                     │  │
│   │   ┌─────────┐     ┌─────────────┐     ┌─────────────────────────┐  │  │
│   │   │  Z.ai   │────▶│  GLM API    │────▶│  GLM-4.7 Models         │  │  │
│   │   └─────────┘     └─────────────┘     └─────────────────────────┘  │  │
│   │                                                                     │  │
│   │   ┌─────────┐     ┌─────────────┐     ┌─────────────────────────┐  │  │
│   │   │ MiniMax │────▶│ MiniMax API │────▶│  MiniMax-M2.1           │  │  │
│   │   └─────────┘     └─────────────┘     └─────────────────────────┘  │  │
│   │                                                                     │  │
│   └─────────────────────────────────────────────────────────────────────┘  │
│                                                                            │
│   ┌─────────────────────────────────────────────────────────────────────┐  │
│   │                    DIRECT PROVIDER                                  │  │
│   │                                                                     │  │
│   │   ┌─────────┐                         ┌─────────────────────────┐  │  │
│   │   │ Mirror  │─────────────────────────▶│  Anthropic API          │  │  │
│   │   │ Claude  │    (no proxy)           │  api.anthropic.com      │  │  │
│   │   └─────────┘                         └─────────────────────────┘  │  │
│   │                                                                     │  │
│   └─────────────────────────────────────────────────────────────────────┘  │
│                                                                            │
└────────────────────────────────────────────────────────────────────────────┘

Key difference: Mirror Claude doesn't override ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, or any model settings. You authenticate exactly like vanilla Claude Code.

⚡ Quick Start

# Create a Mirror Claude variant
npx cc-mirror create --provider mirror --name mclaude

# Run it - authenticate via normal Claude flow
mclaude

No API key required at setup. When you run mclaude, authenticate via:

  1. OAuth - Sign in through Anthropic Console (subscription)
  2. API Key - Set ANTHROPIC_API_KEY environment variable

🎯 What You Get

Feature Description
🤖 Team Mode Enabled by default - TaskCreate, TaskGet, TaskUpdate, TaskList tools
🎨 Premium Theme Silver/chrome aesthetic with electric blue accents
📁 Full Isolation Separate config, sessions, and task storage
✨ Pure Claude No prompt packs or model overrides - authentic experience

📊 Provider Comparison

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   Feature              │ zai      │ minimax  │ openrouter │ mirror          │
│   ─────────────────────┼──────────┼──────────┼────────────┼─────────────────│
│   Model                │ GLM-4.7  │ M2.1     │ You choose │ Claude (native) │
│   Auth Mode            │ API Key  │ API Key  │ Auth Token │ OAuth or Key    │
│   ANTHROPIC_BASE_URL   │ ✓ Set    │ ✓ Set    │ ✓ Set      │ ✗ Not set       │
│   ANTHROPIC_API_KEY    │ ✓ Set    │ ✓ Set    │ ✗          │ ✗ Not set       │
│   Model Mappings       │ ✓ Auto   │ ✓ Auto   │ ✓ Required │ ✗ Not set       │
│   Prompt Pack          │ ✓ Full   │ ✓ Full   │ ✗          │ ✗ Pure          │
│   Team Mode            │ Optional │ Optional │ Optional   │ ✓ Default       │
│   Config Isolation     │ ✓        │ ✓        │ ✓          │ ✓               │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

🔧 When to Use Mirror Claude

Perfect For

  • Power users who want Claude Code with team features
  • Experimentation - isolated config for testing hooks, skills, MCP servers
  • Multiple accounts - keep work and personal Claude sessions separate
  • Team workflows - shared task management without model changes

Not For

  • Different models - use OpenRouter or CCRouter for alternative LLMs
  • Cost savings - Z.ai and MiniMax offer Coding Plan subscriptions
  • Offline use - Mirror requires Anthropic API access

🎨 Theme Preview

Mirror Claude features a distinctive silver/chrome theme:

┌───────────────────────────────────────────┐
│                                           │
│   Primary:    Silver    #C0C0C0           │
│   Accent:     Electric  #00D4FF           │
│   Secondary:  Purple    #6B5B95           │
│   Background: Near-black metallic         │
│                                           │
│   Thinking verbs:                         │
│   Reflecting, Refracting, Projecting,     │
│   Mirroring, Amplifying, Focusing,        │
│   Polishing, Crystallizing...             │
│                                           │
└───────────────────────────────────────────┘

🔑 Authentication

Mirror Claude uses standard Claude Code authentication:

Option 1: OAuth (Anthropic Subscription)

mclaude
# Follow the OAuth prompt to sign in

Option 2: API Key

export ANTHROPIC_API_KEY="sk-ant-..."
mclaude

Option 3: Console API Key

# Get your key from https://console.anthropic.com/settings/keys
mclaude
# Enter key when prompted

📁 Variant Structure

┌─────────────────────────────────────────────────────────┐
│  ~/.cc-mirror/mclaude/                                  │
│  ├── npm/                    Claude Code installation   │
│  ├── config/                                            │
│  │   ├── settings.json       Minimal env (splash only)  │
│  │   ├── .claude.json        MCP servers, approvals     │
│  │   └── tasks/<team>/       Team mode task storage     │
│  ├── tweakcc/                                           │
│  │   └── config.json         Mirror theme config        │
│  └── variant.json            Variant metadata           │
│                                                         │
│  Wrapper: ~/.local/bin/mclaude                          │
└─────────────────────────────────────────────────────────┘

What Mirror Sets

{
  "env": {
    "CC_MIRROR_SPLASH": "1",
    "CC_MIRROR_PROVIDER_LABEL": "Mirror Claude",
    "CC_MIRROR_SPLASH_STYLE": "mirror",
    "DISABLE_AUTOUPDATER": "1"
  }
}

What Mirror Does NOT Set

  • ANTHROPIC_BASE_URL - Uses Claude Code default
  • ANTHROPIC_API_KEY - User authenticates normally
  • ANTHROPIC_DEFAULT_*_MODEL - Uses Claude Code defaults

💡 Tips

Combine with Other Features

# Mirror with shell env integration (for Zsh/Bash profile)
npx cc-mirror create --provider mirror --name mclaude --shell-env

Run Multiple Mirrors

# Work account
npx cc-mirror create --provider mirror --name work-claude

# Personal account
npx cc-mirror create --provider mirror --name personal-claude

# Run each with different API keys
ANTHROPIC_API_KEY="$WORK_KEY" work-claude
ANTHROPIC_API_KEY="$PERSONAL_KEY" personal-claude

🔙 Related