cc-viewer

CC-Viewer

🌐 Website & feature tour: weiesky.github.io/cc-viewer — available in 18 languages (e.g. 简体中文, 日本語).

Based on Claude Code, a Vibe Coding tool that distills and accumulates real development experience:

English | 简体中文 | 繁體中文 | 한국어 | 日本語 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська

Usage

Prerequisites

* Make sure nodejs 20.0.0+ is installed; Download and install
* Make sure claude code is installed; Installation guide

Install ccv

Install via npm

Install via Homebrew (recommended for macOS / Linux)

Install via pnpm (global)

How to start

ccv is a drop-in replacement for claude — all arguments are passed through to claude while the Web Viewer is launched alongside it.

The command I use most often is:

Once started in programming mode, the web page opens automatically.

cc-viewer also ships as a native desktop app: download page

SDK mode (headless, ccv --sdk)

ccv --sdk runs the session through the Agent SDK instead of an interactive terminal — no main PTY, messages are sent from the web UI, and everything else (session logs, streaming typewriter, usage stats) works the same as in terminal mode. The header still exposes a Terminal button, but it opens the standalone scratch multi-tab shell (unrelated to the SDK session), not a project PTY.

Approvals (Bash/Edit/Write/WebFetch/…) pop up in the browser with allow / deny / allow-for-session, and AskUserQuestion / plan prompts appear as modals. npm publish always requires an explicit approval — even with --d. Requires the @anthropic-ai/claude-agent-sdk package (bundled with cc-viewer); falls back to terminal mode if unavailable.

Choose the Claude executable

On the local CCV page, open Global Settings → Claude…