claude-code-webui: A Web Interface for Claude CLI with Streaming Responses

claude-code-webui: A Web Interface for Claude CLI with Streaming Responses

Summary

claude-code-webui transforms the command-line Claude CLI experience into an intuitive web-based chat interface. It offers real-time streaming responses, visual project selection, and mobile-responsive design. This tool enhances productivity by providing a rich, visual environment for interacting with Claude Code locally.

Repository Info

Updated on April 30, 2026
View on GitHub

Tags

claudeclaude-cliweb-uitypescriptaideveloper-toolsfrontendcli-interface

Click on any tag to explore related repositories

Introduction

claude-code-webui, developed by sugyan, is an open-source project that provides a modern, web-based interface for the Claude Code CLI. It aims to transform the command-line coding experience into an intuitive chat interface accessible from any device with a browser. With 1059 stars and 242 forks, this TypeScript project under the MIT License offers a powerful way to interact with Claude Code.

Key features include real-time streaming responses, visual project selection, conversation history, and granular tool permission management, all wrapped in a mobile-responsive design with dark/light theme support.

Installation

Get claude-code-webui up and running quickly with the recommended npm package installation.

Prerequisites:

  • Claude CLI installed and authenticated.
  • Node.js >=20.0.0.
  • Modern browser.

Option 1: npm Package (Recommended)

# Install globally via npm
npm install -g claude-code-webui

# Start the server
claude-code-webui

# Open browser to http://localhost:8080

Examples

The backend server supports various command-line options to customize its behavior.

Custom Port:

claude-code-webui --port 3000

Bind to All Interfaces (accessible from network):

claude-code-webui --host 0.0.0.0 --port 9000

Enable Debug Mode:

claude-code-webui --debug

Custom Claude CLI Path (for non-standard installations):

claude-code-webui --claude-path /path/to/claude

Why Use claude-code-webui?

claude-code-webui transforms the way you interact with Claude Code, moving beyond the limitations of a terminal-only experience.

Benefits over CLI:

  • Accessibility: Use on any device with a browser, not just desktop.
  • Mobile-Friendly: Enjoy a touch-optimized interface on mobile devices.
  • Rich Responses: Get beautifully formatted responses instead of plain text output.
  • Visual Project Selection: Easily choose projects for context-aware sessions.

Key Features:

  • Permission Mode Switching: Toggle between normal and plan mode execution.
  • Real-time Streaming Responses: See live Claude Code output in the chat interface.
  • Project Directory Selection: Visual project picker for context-aware sessions.
  • Conversation History: Browse and restore previous chat sessions.
  • Tool Permission Management: Granular control over Claude's tool access.
  • Dark/Light Theme Support: Automatic system preference detection.
  • Mobile-Responsive Design: Optimized interface for any device.

Links