@microwiseai/claude-web-server/README.md

Local server for Web Claude Code - Unofficial web interface for Claude Code

# Claude Web Server

Local server component for the [Unofficial Claude Code Web Interface](https://claude.microwiseai.com).

## What is this?

This is the local server that enables the web interface to access your terminal and file system for Claude Code. It runs on your machine and provides a secure bridge between the web interface and your local development environment.

**Note**: This is an unofficial community project and is not affiliated with Anthropic.

## Installation

```bash
npm install -g @microwiseai/claude-web-server
```

## Usage

After installation, simply run:

```bash
claude-web-server
```

Then visit https://claude.microwiseai.com to use the web interface.

### Commands

```bash
# Start server (default port 3001)
web-claude-code

# Run in background
web-claude-code start --daemon

# Stop background server
web-claude-code stop

# Check status
web-claude-code status

# Auto-start configuration
web-claude-code autostart         # Interactive
web-claude-code autostart --enable
web-claude-code autostart --disable
```

## Auto-start

The server can start automatically when your computer boots. This is optional and can be configured during installation or later using the `autostart` command.

## Security

- Runs only on localhost (127.0.0.1)
- No external network access
- All data stays on your machine
- File access limited to user permissions

## Requirements

- Node.js 16+
- tmux (for terminal sessions)
- Claude Code CLI

## Troubleshooting

### Port already in use

If port 3001 is busy, you can use a different port:

```bash
web-claude-code start --port 3002
```

### Connection issues

1. Make sure the server is running: `web-claude-code status`
2. Check your firewall settings
3. Try restarting the server: `web-claude-code stop && web-claude-code start`

## Support

Visit https://web-claude-code.com/support for help.

## License

MIT