CC-Viewer

🌐 Website & Feature-Tour: weiesky.github.io/cc-viewer — in 18 Sprachen verfügbar.

Ein Vibe-Coding-Toolkit, das aus eigener Entwicklungserfahrung destilliert und auf Claude Code aufgebaut wurde:

Fähigkeitsobergrenze erhöhen: Führen Sie /ultraPlan und /ultraReview lokal aus, damit Ihr Projektcode nie vollständig der Cloud von Claude ausgesetzt werden muss;
Multi-Plattform-Unterstützung: Ermöglicht mobiles Programmieren (innerhalb des LAN); die Webversion passt sich an verschiedene Szenarien an, lässt sich problemlos in Browser-Erweiterungen und Splitscreen-Ansichten des Betriebssystems einbetten und bietet einen nativen Installer;
Vollständige Protokollierung: Bietet umfassende Abfang- und Analysefunktionen für Claude Code-Payloads — ideal für Logging, Debugging, Lernen, Inspiration und Reverse-Engineering;
Lern- und Erfahrungsaustausch: Eine Vielzahl von Studienmaterialien und Entwicklungserfahrungen wurden gesammelt (siehe die „?"-Symbole überall im System);
Native Erfahrung bewahrt: Erweitert lediglich die Fähigkeiten von Claude Code, ohne wesentliche Änderungen am Kernel — die native Erfahrung bleibt erhalten;
Drittanbieter-Modelle unterstützt: Kompatibel mit deepseek-v4-*, GLM 5.1, Kimi K2.6, mit eingebauter cc-switch-Fähigkeit für jederzeitiges Hot-Switching zwischen Drittanbieter-Tools;

Verwendung

Voraussetzungen

Stellen Sie sicher, dass Node.js 20.0.0+ installiert ist; Download und Installation
Stellen Sie sicher, dass Claude Code installiert ist; Installationsanleitung

ccv installieren

Installation über npm

npm install -g cc-viewer --registry=https://registry.npmjs.org

Installation über Homebrew (empfohlen für macOS / Linux)

brew tap weiesky/cc-viewer
brew install cc-viewer
brew upgrade cc-viewer   # für Updates — verwende NICHT npm install -g für mit brew installiertes ccv

Start

ccv ist ein Drop-in-Ersatz für claude — alle Argumente werden an claude weitergereicht, während der Web-Viewer gestartet wird.

ccv                    # == claude（interaktiver Modus）

Der vom Autor am häufigsten verwendete Befehl ist:

ccv -c --d             # == claude --continue --dangerously-skip-permissions
                       # ccv reicht alle Startparameter von Claude Code durch — Sie können sie beliebig kombinieren

Nach dem Start im Programmiermodus wird automatisch eine Webseite geöffnet.

CC-Viewer wird auch als native Desktop-App ausgeliefert: Download-Seite

Upgrade auf 1.7.0 (Logformat v2)

Seit 1.7.0 werden Logs im Format eines Verzeichnisses pro Sitzung (wire-format v2) gespeichert statt in einzelnen .jsonl-Dateien — etwa 90 % weniger Speicherplatz. Vorhandene v1-.jsonl-Dateien werden niemals geändert oder gelöscht; der Log-Dialog listet standardmäßig v2-Sitzungen auf, und ein kleiner Eintrag „Legacy-Logs (v1) anzeigen“ (sichtbar, solange alte Dateien vorhanden sind) öffnet eine v1-Ansicht, in der sie angezeigt, migriert oder gelöscht werden können. Beim Start bietet cc-viewer eine Ein-Klick-Migration an, wenn Legacy-Logs gefunden werden (dringend empfohlen, wenn Sie eine alte Unterhaltung mit claude -c fortsetzen, deren erste Hälfte in den alten Dateien liegt). Sie können auch über das Terminal migrieren:

ccv convert <project>   # ein Projekt migrieren
ccv convert --all       # jedes Projekt migrieren
ccv verify <v1-file>    # eine v1-Datei mit ihren konvertierten Sitzungen abgleichen

Besteht eine Sitzung die Golden-Prüfung nicht, wird sie zur Inspektion in sessions-quarantine/ zurückgehalten, statt die gesamte Migration scheitern zu lassen – die übrigen Sitzungen werden weiterhin migriert.

Logger-Modus

Wenn Sie weiterhin das native claude-Tool oder die VS Code-Erweiterung bevorzugen, verwenden Sie diesen Modus.

In diesem Modus startet claude

automatisch einen Protokollierungsprozess, der Anfrageprotokolle in Verzeichnissen pro Sitzung unter ~/.claude/cc-viewer/yourproject/sessions/ (wire-format v2) aufzeichnet.

Logger-Modus starten:

ccv -logger

Wenn die Konsole den spezifischen Port nicht ausgeben kann, ist der erste Standardport 127.0.0.1:7008. Bei mehreren Instanzen werden die Ports fortlaufend vergeben, z. B. 7009, 7010.

Logger-Modus deinstallieren:

ccv --uninstall

Fehlerbehebung (Troubleshooting)

Falls beim Start Probleme auftreten, gibt es einen ultimativen Fehlerbehebungsansatz: Schritt 1: Öffnen Sie Claude Code in einem beliebigen Verzeichnis; Schritt 2: Geben Sie Claude Code die folgende Anweisung:

Ich habe das npm-Paket cc-viewer installiert, aber nach Ausführung von ccv funktioniert es immer noch nicht richtig. Überprüfen Sie cli.js und findcc.js von cc-viewer und passen Sie sie basierend auf der spezifischen Umgebung an die lokale Claude Code-Bereitstellung an. Halten Sie den Änderungsumfang so weit wie möglich auf findcc.js begrenzt.

Claude Code das Problem selbst diagnostizieren zu lassen, ist effektiver, als jemanden zu fragen oder eine Dokumentation zu lesen!

Nachdem die obige Anweisung abgeschlossen ist, wird findcc.js aktualisiert. Wenn Ihr Projekt häufig lokale Bereitstellung erfordert oder geforkter Code häufig Installationsprobleme lösen muss, behalten Sie diese Datei einfach. Beim nächsten Mal kopieren Sie sie direkt. In diesem Stadium werden viele Projekte und Unternehmen, die Claude Code einsetzen, nicht auf Mac bereitgestellt, sondern in serverseitig gehosteten Umgebungen, daher hat der Autor findcc.js separiert, um das Verfolgen von cc-viewer-Quellcode-Updates in Zukunft zu erleichtern.

Hinweis: Diese Anwendung steht in Konflikt mit claude-code-switch und claude-code-router, da es ein Proxy-Wettbewerbsproblem gibt. Stellen Sie daher sicher, dass Sie claude-code-switch und claude-code-router deaktivieren, wenn Sie cc-viewer verwenden — innerhalb von cc-viewer wird eine Proxy-Hot-Update-Funktion als gleichwertiger Ersatz bereitgestellt.

Weitere Hilfsbefehle

Siehe:

ccv -h

Silent-Modus (Silent Mode)

Standardmäßig läuft ccv im Silent-Modus, wenn es claude umhüllt, hält Ihre Terminal-Ausgabe sauber und konsistent mit der nativen Erfahrung. Alle Protokolle werden im Hintergrund erfasst und können unter http://localhost:7008 angezeigt werden.

Nach der Konfiguration verwenden Sie den Befehl claude wie gewohnt. Besuchen Sie http://localhost:7008, um auf die Überwachungsoberfläche zuzugreifen.

Funktionen

Programmiermodus

Nach dem Start mit ccv sehen Sie:

Sie können Code-Diffs direkt nach der Bearbeitung anzeigen:

Sie können Dateien und Code zwar manuell öffnen, aber manuelles Programmieren wird nicht empfohlen — das ist Old-School-Coding!

Mobiles Programmieren

Sie können sogar einen QR-Code scannen, um von Ihrem mobilen Gerät aus zu programmieren:

Erfüllen Sie Ihre Vorstellung vom mobilen Programmieren. Es gibt auch einen Plugin-Mechanismus — wenn Sie Anpassungen an Ihre Programmiergewohnheiten benötigen, bleiben Sie auf dem Laufenden für Plugin-Hook-Updates.

Modellspezifische System-Prompts

Das Modal System-Prompt bearbeiten (Hamburger-Menü → System-Prompt bearbeiten) ist in Tabs gegliedert:

Der Tab Standard behält das klassische Verhalten bei: Er schreibt CC_SYSTEM.md (Überschreiben) oder CC_APPEND_SYSTEM.md (Anhängen) in den aktuellen Arbeitsbereich, injiziert als --system-prompt-file / --append-system-prompt-file beim nächsten ccv-Start.
Modell-Tabs: Klicken Sie auf + Modell hinzufügen, geben Sie einen Namen wie opus oder Gemini3 ein und wählen Sie einen Geltungsbereich — Global (~/.claude/cc-viewer/system_prompt/, gilt für jeden Arbeitsbereich) oder Arbeitsbereich (<project>/system_prompt/). Jeder Tab hat einen eigenen Anhängen/Überschreiben-Schalter und eine Markdown-Vorschau.
Einträge werden als großgeschriebene Dateien gespeichert: OPUS_SYSTEM.md (Überschreiben) oder OPUS_APPEND_SYSTEM.md (Anhängen). Der Abgleich ist unscharf — ein Teilstring der aus der AKTIVEN Konfiguration aufgelösten Modell-ID (Modell-Zuordnung des aktiven Drittanbieter-Proxy-Profils > Umgebungsvariablen ANTHROPIC_MODEL/CLAUDE_MODEL beim Start > model in settings.json; ohne Konfigurationssignal wird kein Eintrag injiziert) ohne Beachtung der Groß-/Kleinschreibung, sodass opus unabhängig von der Version auf claude-opus-4-8[1m] passt. Ein Arbeitsbereich-Treffer schlägt einen globalen; innerhalb eines Geltungsbereichs gewinnt der längste Name; ein passender Eintrag ersetzt für diesen Start die Standard-Dateien vollständig. Bekannte Einschränkungen: Ein Profilwechsel während der Sitzung wird erst nach Neustart der claude-Sitzung neu abgeglichen; ein per Zusatzargument übergebenes --model wird nicht ausgewertet.
Wird ein Tab leer gespeichert, wird der Eintrag gelöscht. Modellwechsel während einer Sitzung greifen beim nächsten Neustart. Setzen Sie CCV_DISABLE_AUTO_SYSTEM_PROMPT=1, um jede automatische Injektion zu deaktivieren. Sie können <project>/system_prompt/ committen, um Prompts mit Ihrem Team zu teilen, oder es zu .gitignore hinzufügen, um sie privat zu halten.

Logger-Modus (Vollständige Claude Code-Sitzungen anzeigen)

Erfasst alle API-Anfragen von Claude Code in Echtzeit und stellt Rohtext sicher — keine redigierten Protokolle (das ist wichtig!!!)
Identifiziert und kennzeichnet automatisch Main Agent- und Sub Agent-Anfragen (Untertypen: Plan, Search, Bash)
MainAgent-Anfragen unterstützen Body Diff JSON und zeigen eingeklappte Unterschiede zur vorherigen MainAgent-Anfrage (nur geänderte/neue Felder)
Jede Anfrage zeigt Inline-Token-Nutzungsstatistiken an (Input/Output-Tokens, Cache-Erstellung/-Lesung, Trefferquote)
Kompatibel mit Claude Code Router (CCR) und anderen Proxy-Szenarien — fällt auf API-Pfadmusterabgleich zurück

Lizenz

MIT

FilesExpand file tree

README.de.md

Latest commit

History