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 звёзд).