EnglishРусский Map

cc-mirror

title
cc-mirror
type
toolbox
summary
Клонирует Claude Code в изолированные варианты под разных провайдеров со своей командой, конфигом и темой
tags
typescript, claude-code, llm, tooling
language
TypeScript
license
MIT
created
2026-05-13
updated
2026-07-29
lang
ru
translation_of
cc-mirror
source_updated
2026-07-29
translated
2026-09-01
translator
lllm/antigravity/gemini-3.7-flash-medium

CC-MIRROR - это CLI, который клонирует Claude Code в изолированные варианты, у каждого из которых свой провайдер, сопоставление моделей, тема оформления и каталог конфигурации. Один вызов npx даёт отдельную команду (mclaude, zai, kimi, minimax...), запускающую полностью настроенный вариант Claude Code и не затрагивающую основную установку.

Что делает

Каждый вариант живёт в каталоге ~/.cc-mirror/<name>/ и содержит собственный набор:

  • Нативная установка Claude Code (зафиксированная версия либо отслеживание апстрим-канала stable / latest)
  • API-ключи, сессии, конфигурация MCP-серверов (config/)
  • Тема оформления, встроенная через tweakcc (tweakcc/)
  • Пакет промптов под конкретного провайдера
  • Дополнительные skill'ы (например, dev-browser)
  • Метаданные variant.json

В ~/.local/bin (macOS/Linux) или ~/.cc-mirror/bin (Windows) помещается исполняемый файл-обёртка, благодаря чему вариант доступен как обычная команда.

Матрица провайдеров

Встроенные пресеты, доступные через флаг --provider <name>:

  • Mirror - чистый Claude Code с прямым API Anthropic, только ради изоляции (рекомендуется по умолчанию)
  • Kimi - модель kimi-for-coding через endpoint Kimi Code
  • MiniMax - MiniMax-M2.5
  • Z.ai - GLM-5 / 4.7 / 4.5-Air (Z.ai также выступает спонсором проекта)
  • OpenRouter - более 100 моделей через шлюз OpenRouter
  • Vercel - Vercel AI Gateway
  • Ollama - локально и в облаке (Anthropic-совместимый endpoint)
  • NanoGPT - endpoint в стиле Claude Code
  • CCRouter - указывает на локальный экземпляр claude-code-router
  • GatewayZ - шлюз к нескольким провайдерам
  • custom - произвольные --base-url и ключ

Оформление вариантов через tweakcc: kimi (бирюзовый/циан), minimax (коралловый/красный), zai (карбон + золото), openrouter (серебро/хром + синий), vercel (монохром + зелёный), ollama (песчаник), nanogpt (северное сияние), ccrouter (небесно-голубой), gatewayz (фиолетовый), mirror (цвета по умолчанию).

Команды

npx cc-mirror                                 # interactive wizard
npx cc-mirror quick --provider mirror --name mclaude
npx cc-mirror quick --provider zai --api-key "$Z_AI_API_KEY"
npx cc-mirror list
npx cc-mirror update <name> [--claude-version 2.1.37|stable|latest]
npx cc-mirror apply <name>                    # re-apply tweakcc after upgrade
npx cc-mirror remove <name>
npx cc-mirror doctor
npx cc-mirror tweak <name>
mclaude                                       # run the variant

Флаги --model-sonnet, --model-opus, --model-haiku сопоставляют соответствующий уровень с конкретной строкой модели у провайдера. Каналы stable и latest берутся из апстрима Claude Code - при установке cc-mirror разрешает их в точную версию и сохраняет её в variant.json.

Где применяется

CC-MIRROR занимает ту же нишу "патчинга Claude Code при установке", что и tweakcc (который включён в состав для тем оформления) и openwarp (форк Warp с поддержкой своих провайдеров). Однако здесь единица настройки - это вариант: несколько сосуществующих версий Claude Code, каждая из которых направлена на своего провайдера. В плоскости маршрутизации по провайдерам инструмент решает ту же задачу, что и claude-code-router, но на уровне установки, а не на уровне запросов: cc-mirror даёт отдельный исполняемый файл zai, тогда как ccr добавляет конфиг маршрутизации внутри одного Claude Code. cursor-bridge представляет третий механизм в этом ряду - единый бинарник, который на время одной сессии проксирует запросы к agent CLI в Cursor и не оставляет после себя следов.

Для команд, сравнивающих провайдеров через A/B-тестирование, или для пользователей, проводящих сравнения с подключёнными skill'ами и без них в стиле agent-skills-eval на разных базовых моделях, изолированные варианты исключают расползание конфигураций между сессиями.

Ограничения

  • Каждый вариант жёстко привязан к одному провайдеру - для смены придётся создать новый вариант или вызвать update --provider.
  • Каждый вариант содержит полноценную установку Claude Code (расход диска быстро накапливается).
  • Патчи tweakcc нужно накатывать заново после каждого обновления Claude Code (cc-mirror apply <name>); cc-mirror автоматизирует повторное применение, но общая хрупкость подхода никуда не девается.
  • Пользователям Windows требуется добавить %USERPROFILE%\.cc-mirror\bin в PATH или запускать обёртку .cmd напрямую.

Репозиторий: https://github.com/numman-ali/cc-mirror (MIT, 2.2k звёзд).