A modern web interface for Claude Code CLI - Transform your command-line coding experience into an intuitive web-based chat interface

• ✨ Why Claude Code Web UI?
• 🚀 Quick Start
• ⚙️ CLI Options
• 🔧 Development
• 🔒 Security Considerations
• 📚 Documentation
• ❓ FAQ
• 🤝 Contributing
• 📄 License

Transform the way you interact with Claude Code

Instead of being limited to command-line interactions, Claude Code Web UI brings you:

• 👨‍💻 Developers who prefer visual interfaces
• 📱 Mobile users who want to code on-the-go
• 👥 Teams sharing coding sessions
• 🔄 Multi-project workflows
• 💡 Rapid prototyping with visual feedback

Get up and running in under 2 minutes:

# Download and run (macOS ARM64 example)
curl -LO https://github.com/sugyan/claude-code-webui/releases/latest/download/claude-code-webui-macos-arm64
chmod +x claude-code-webui-macos-arm64
./claude-code-webui-macos-arm64

# Open browser to http://localhost:8080

# Backend
cd backend && deno task dev

# Frontend (new terminal)
cd frontend && npm run dev

# Open browser to http://localhost:3000

• ✅ Claude CLI installed and authenticated (Get it here)
• ✅ Modern browser (Chrome, Firefox, Safari, Edge)

The backend server supports the following command-line options:

• PORT - Same as --port
• DEBUG - Same as --debug

# Default (localhost:8080)
./claude-code-webui

# 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

# Using environment variables
PORT=9000 DEBUG=true ./claude-code-webui

# Clone repository
git clone https://github.com/sugyan/claude-code-webui.git
cd claude-code-webui

# Start backend
cd backend
deno task dev

# Start frontend (new terminal)
cd frontend
npm run dev

Create .env file in project root:

echo "PORT=9000" > .env

Both backend and frontend will automatically use this port.

Important: This tool executes Claude CLI locally and provides web access to it.

• 🏠 Local development: Default localhost access
• 🏢 Trusted networks: LAN access for team collaboration
• 🔐 Project isolation: Claude only accesses selected directories

• No authentication: Currently no built-in auth mechanism
• System access: Claude can read/write files in selected projects
• Network exposure: Configurable but requires careful consideration

# Local only (recommended)
./claude-code-webui --port 8080

# Network access (trusted networks only)
./claude-code-webui --port 8080 --host 0.0.0.0

Never expose to public internet without proper security measures.

For comprehensive technical documentation, see CLAUDE.md which covers:

• Architecture overview and design decisions
• Detailed development setup instructions
• API reference and message types

We welcome contributions! Please see our development setup and feel free to:

• 🐛 Report bugs
• ✨ Suggest features
• 📝 Improve documentation
• 🔧 Submit pull requests

Fun fact: This project is almost entirely written and committed by Claude Code itself! 🤖
We'd love to see pull requests from your Claude Code sessions too :)

MIT License - see LICENSE for details.