Инструмент Vibe Coding, построенный на основе Claude Code и дистиллированный из собственного опыта разработки:
- Повышение потолка возможностей — можно локально запускать /ultraPlan и /ultraReview, при этом избегая полного раскрытия кода вашего проекта в облаке Claude;
- Адаптация к нескольким устройствам одновременно — позволяет программировать на мобильных устройствах (в локальной сети), веб-версия адаптируется к различным сценариям, легко встраивается в расширения браузера и разделённый экран ОС, также предоставляется нативный установочный пакет;
- Полное сохранение логов — обеспечивает возможность полного перехвата и анализа payload claude code, удобно для логирования, анализа проблем, обучения и реверс-инжиниринга;
- Обмен опытом обучения — накоплено множество учебных материалов и опыта разработки (см. иконки «?» в различных местах системы);
- Сохранение нативного опыта — лишь расширяет возможности claude code без каких-либо существенных изменений ядра, сохраняя нативный опыт;
- Поддержка сторонних моделей — совместим с deepseek-v4-*, GLM 5.1, Kimi K2.6, встроена функциональность cc-switch, позволяющая в любой момент переключать сторонние инструменты на лету;
English | 简体中文 | 繁體中文 | 한국어 | 日本語 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська
- Убедитесь, что установлен nodejs 20.0.0+; Скачать и установить
- Убедитесь, что установлен claude code; Руководство по установке
npm install -g cc-viewer --registry=https://registry.npmjs.orgbrew tap weiesky/cc-viewer
brew install cc-viewer
brew upgrade cc-viewer # используйте это для обновления; ccv, установленный через brew, не обновляйте с помощью npm install -gccv — это прямой заменитель claude: все параметры передаются в claude, и одновременно запускается Web Viewer.
ccv # == claude (интерактивный режим)Самая часто используемая автором команда:
ccv -c --d # == claude --continue --dangerously-skip-permissions
# ccv передаёт все параметры запуска claude code, вы можете произвольно комбинировать их по своему усмотрениюПосле запуска режима программирования веб-страница откроется автоматически.
cc-viewer также предоставляет клиентскую версию: Адрес для загрузки
Если вы по-прежнему привыкли пользоваться нативным инструментом claude или плагином VS code, используйте этот режим.
В этом режиме при запуске claude
автоматически запускается процесс логирования, который записывает логи запросов в ~/.claude/cc-viewer/yourproject/date.jsonl
Запуск режима логирования:
ccv -loggerКогда консоль не может вывести конкретный порт, по умолчанию первый порт запуска — 127.0.0.1:7008. При одновременном существовании нескольких экземпляров порты продолжаются по порядку: 7009, 7010 и т. д.
Удаление режима логирования:
ccv --uninstallЕсли вы столкнулись с проблемой невозможности запуска, существует окончательный способ диагностики: Шаг первый: откройте claude code в любом каталоге; Шаг второй: дайте claude code следующую инструкцию:
我已经安装了cc-viewer这个npm包，但是执行ccv以后仍然无法有效运行。查看cc-viewer的cli.js 和 findcc.js，根据具体的环境，适配本地的claude code的部署方式。适配的时候修改范围尽量约束在findcc.js中。Позволить Claude Code самому проверить ошибки — это эффективнее, чем консультироваться с кем-либо или читать любую документацию!
После выполнения вышеуказанной инструкции файл findcc.js будет обновлён. Если ваш проект часто требует локального развёртывания или если форкнутый код часто должен решать проблемы установки, сохраните этот файл. В следующий раз вы можете просто скопировать его. На данном этапе многие проекты и компании, использующие claude code, развёртывают его не на mac, а на хостинге серверных сред, поэтому автор выделил файл findcc.js, чтобы в дальнейшем было удобно отслеживать обновления исходного кода cc-viewer.
Примечание: данное приложение конфликтует с claude-code-switch и claude-code-router, существует проблема конкуренции за proxy, поэтому при использовании обязательно отключите claude-code-switch и claude-code-router; внутри cc-viewer предоставляется функция горячего обновления прокси как равноценная замена.
См.:
ccv -hПо умолчанию ccv при оборачивании claude работает в тихом режиме, обеспечивая чистый вывод терминала и соответствие нативному опыту. Все логи захватываются в фоновом режиме и могут быть просмотрены по адресу http://localhost:7008.
После настройки используйте команду claude как обычно. Посетите http://localhost:7008 для просмотра интерфейса мониторинга.
После запуска с помощью ccv вы увидите:
Вы можете сразу после завершения редактирования просмотреть diff кода:
Хотя вы можете открывать файлы и программировать вручную, ручное программирование не рекомендуется — это старомодное программирование!
Вы можете даже отсканировать QR-код, чтобы реализовать программирование на мобильных устройствах:
Удовлетворите своё воображение о мобильном программировании. Кроме того, существует механизм плагинов — если вам нужно настроить под собственные привычки программирования, можете в дальнейшем следить за обновлениями hooks плагинов.
- Захват в реальном времени всех API-запросов от Claude Code с гарантией оригинального текста, а не урезанных логов (это очень важно!!!)
- Автоматическое распознавание и маркировка запросов Main Agent и Sub Agent (подтипы: Plan, Search, Bash)
- Запросы MainAgent поддерживают Body Diff JSON, отображают свёрнутые различия с предыдущим запросом MainAgent (показываются только изменённые/новые поля)
- Каждый запрос встроенно отображает статистику использования Token (входные/выходные Token, создание/чтение кэша, частоту попаданий)
- Совместим с Claude Code Router (CCR) и другими прокси-сценариями — резервное сопоставление запросов по шаблонам путей API
Нажмите кнопку «Режим беседы» в правом верхнем углу, чтобы разобрать полную историю беседы Main Agent в виде интерфейса чата:
- Отображение Agent Team пока не поддерживается
- Сообщения пользователя выравниваются по правому краю (синие пузыри), ответы Main Agent — по левому краю (тёмные пузыри)
- Блоки
thinkingпо умолчанию свёрнуты, отображаются в виде Markdown, нажмите для развёртывания и просмотра процесса мышления; поддерживается перевод одним нажатием (функция пока нестабильна) - Сообщения выбора пользователя (AskUserQuestion) отображаются в формате «вопрос-ответ»
- Двусторонняя синхронизация режимов: при переключении в режим беседы автоматическое позиционирование на беседе, соответствующей выбранному запросу; при возврате в режим исходных данных автоматическое позиционирование на выбранном запросе
- Панель настроек: можно переключать состояние свёртывания по умолчанию для результатов инструментов и блоков thinking
- Мобильный просмотр беседы: в мобильном режиме CLI нажмите кнопку «Просмотр беседы» в верхней панели, и появится выдвижной режим беседы только для чтения, в котором можно просматривать полную историю беседы на мобильном устройстве
Через выпадающее меню CC-Viewer в левом верхнем углу:
Сжатие логов Что касается логов, автор должен заявить, что не изменял официальные определения anthropic, чтобы гарантировать целостность логов. Однако, поскольку отдельный лог 1M opus на поздних этапах становится слишком огромным, благодаря применению автором некоторых оптимизаций логов для MainAgent, без gzip можно уменьшить объём как минимум на 66%. Метод парсинга этих сжатых логов можно извлечь из текущего репозитория.
С помощью инструментов боковой панели вы можете быстро находить свои prompt
Интересная функция KV-Cache-Text позволяет вам увидеть именно то, что видит Claude
Вы можете загружать изображения и описывать свои потребности, способности Claude к пониманию изображений чрезвычайно мощные; и, как вы знаете, можно сделать скриншот и просто вставить его через Ctrl + V, и полное содержимое будет отображено в беседе
Вы можете напрямую настраивать плагины, управлять всеми процессами cc-viewer, а cc-viewer обладает возможностью горячего переключения сторонних API (да, вы можете использовать GLM, Kimi, MiniMax, Qwen, DeepSeek, хотя автор считает, что сейчас все они довольно слабы)
Ещё больше функций ждёт вашего открытия... Например: данная система поддерживает Agent Team и имеет встроенный Code Reviewer. Уже скоро будет добавлена интеграция Code Reviewer от Codex (автор настоятельно рекомендует использовать Codex для review кода Claude Code)
MIT