@sunpix/claude-code-web/README.md

A web-based interface for interacting with Claude Code CLI

# Claude Code Web - Claude Code UI

This product is in alpha state. There is not authentication! So you need to bring your own via a reverse proxy.

This is the production build of Claude Code Web, a web-based interface for interacting with Claude Code CLI.

## Video
https://github.com/user-attachments/assets/418a2aba-829c-40f5-9b04-8e92eae4e8e3

## Prerequisites

- Node.js 18+ 
- Claude Code CLI installed and configured

## Running the Application

1. Git clone
   ```bash
   npm -g install @sunpix/claude-code-web
   ```

2. Run the app:
   ```bash
   claude-code-web
   ```
3. Claude is running on http://localhost:3000/

It will then listen on port 3000. BE AWARE: there is no authentication. So everyone with access to that port control your environment/computer.

## Configuration

### Port Configuration

To run on a different port:
```bash
PORT=8080 claude-code-web
```

### Path
To run on a different subpath (behind a reverse proxy) for example:
```bash
APP_BASE_URL=/claude-code claude-code-web
```

## Image
<img width="887" height="714" alt="472182159-8652996a-5622-4fbb-ac78-7b8c872060a4" src="https://github.com/user-attachments/assets/48cfdd4d-6a85-499f-b745-c88e34a262f4" />

## Support
For issues and documentation, visit the Claude Code UI repository.