๐ Claude Code WebUI
A comprehensive web interface for Claude Code with advanced session management and integrated development tools
ไธไธชๅ่ฝๅฎๆด็Claude Code Web็้ข๏ผๆไพไผ่ฏ็ฎก็ใๅๅฒ่ฎฐๅฝใMCPๆๅกๅจ้ ็ฝฎๅ้ๆๅผๅๅทฅๅ ท็็ฐไปฃๅWebๅบ็จ
๐ฌ Demo
Experience the power of Claude Code WebUI in action
ไฝ้ชClaude Code WebUI็ๅผบๅคงๅ่ฝ
๐ธ Screenshots | ๆชๅพๅฑ็คบ
โจ Core Features | ๆ ธๅฟ็นๆง
๐ฏ Session Management System | ไผ่ฏ็ฎก็็ณป็ป
- Intelligent session organization by project
ๆ้กน็ฎๆบ่ฝ็ป็ปไผ่ฏ - Advanced search and filtering capabilities
้ซ็บงๆ็ดข่ฟๆปคๅ่ฝ - Custom tag system for better organization
่ชๅฎไนๆ ็ญพๅ็ฑป็ณป็ป - Easy import and export functionality
่ฝปๆพๅฏผๅ ฅๅฏผๅบๅ่ฝ
๐ History Records & Analytics | ๅๅฒ่ฎฐๅฝไธๅๆ
- Complete conversation history preservation
ๅฎๆดๅฏน่ฏๅๅฒไฟๅญ - Visual statistics and cost analysis
ๅฏ่งๅ็ป่ฎกๅๆๆฌๅๆ - Smart timeline view of project development
ๆบ่ฝๆถ้ด็บฟๅฑ็คบ้กน็ฎๅผๅๅ็จ - One-click session recovery
ไธ้ฎๆขๅคๅๅฒไผ่ฏ
๐ง MCP Server Management | MCPๆๅกๅจ็ฎก็
- Visual MCP server configuration interface
ๅฏ่งๅMCPๆๅกๅจ้ ็ฝฎ็้ข - Real-time server status monitoring
ๅฎๆถๆๅกๅจ็ถๆ็ๆง - Categorized server management
ๅ็ฑป็ฎก็ๆๅกๅจ - One-click server operations
ไธ้ฎๆๅกๅจๆไฝ
๐ Integrated Development Tools | ้ๆๅผๅๅทฅๅ ท
- Built-in terminal for command execution
ๅ ็ฝฎ็ป็ซฏๆง่กๅฝไปค่กๆไฝ - Visual file browser and management
ๅฏ่งๅๆไปถๆต่งๅ็ฎก็ - Integrated web browser functionality
้ๆ็็ฝ้กตๆต่งๅ่ฝ - Seamless tool switching interface
ๅจๅคๅทฅๅ ท้ดๆ ็ผๅๆข
๐จ User Experience | ็จๆทไฝ้ช
- Responsive design for all devices
ๅๅบๅผ่ฎพ่ฎก้้ ๆๆ่ฎพๅค - Dark/Light theme support
ๆทฑ่ฒ/ๆต ่ฒไธป้ขๆฏๆ - Real-time streaming interactions
ๅฎๆถๆตๅผไบคไบไฝ้ช - Keyboard shortcuts for efficiency
้ฎ็ๅฟซๆท้ฎๆ้ซๆ็
๐ Quick Start | ๅฟซ้ๅผๅง
Prerequisites | ๅ็ฝฎ่ฆๆฑ
- โ
Claude CLI installed and authenticated
Claude CLIๅทฒๅฎ่ฃ ๅนถ่ฎค่ฏ (Get it here | ่ทๅๅฐๅ) - โ
Node.js 18+ for frontend development
Node.js 18+ ็จไบๅ็ซฏๅผๅ - โ
Deno 2.x for backend development
Deno 2.x ็จไบๅ็ซฏๅผๅ - โ
Modern browser support
็ฐไปฃๆต่งๅจๆฏๆ (Chrome, Firefox, Safari, Edge)
Method 1: Binary Release (Recommended) | ๆนๅผไธ๏ผไฝฟ็จๅๅธ็ๆฌ๏ผๆจ่๏ผ
# Download the latest release (macOS ARM64 example)
# ไธ่ฝฝๆๆฐๅๅธ็ๆฌ๏ผไปฅ macOS ARM64 ไธบไพ๏ผ
curl -LO https://github.com/B143KC47/claudeCO-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
# ๅจๆต่งๅจไธญๆๅผ http://localhost:8080
Method 2: Development Mode | ๆนๅผไบ:ๅผๅๆจกๅผ่ฟ่ก
Option A: One-Line Launch (Recommended) | ้้กนA๏ผไธ้ฎๅฏๅจ๏ผๆจ่๏ผ
# Clone the repository
# ๅ
้้กน็ฎ
git clone https://github.com/B143KC47/claudeCO-webui.git
cd claudeCO-webui
# Install dependencies
# ๅฎ่ฃ
ไพ่ต
make install
# Start both frontend and backend concurrently
# ๅๆถๅฏๅจๅ็ซฏๅๅ็ซฏ
make dev
# OR / ๆ่
npm run dev
# Open browser to http://localhost:3000
# ๅจๆต่งๅจไธญๆๅผ http://localhost:3000
Option B: Manual Start | ้้กนB๏ผๆๅจๅฏๅจ
# Clone the repository
# ๅ
้้กน็ฎ
git clone https://github.com/B143KC47/claudeCO-webui.git
cd claudeCO-webui
# Start backend service
# ๅฏๅจๅ็ซฏๆๅก
cd backend
deno task dev
# Start frontend (new terminal window)
# ๅฏๅจๅ็ซฏ๏ผๆฐ็ป็ซฏ็ชๅฃ๏ผ
cd frontend
npm install
npm run dev
# Open browser to http://localhost:3000
# ๅจๆต่งๅจไธญๆๅผ http://localhost:3000
๐ Quick Start | ๅฟซ้ๅผๅง
Command Line Arguments | ๅฝไปค่กๅๆฐ
| Parameter | Description | Default |
Environment Variables | ็ฏๅขๅ้
PORT- Same as--port/ ็ญๅไบ--portDEBUG- Same as--debug/ ็ญๅไบ--debug
Usage Examples | ไฝฟ็จ็คบไพ
# Default configuration (localhost:8080)
# ้ป่ฎค้
็ฝฎ (localhost:8080)
./claude-code-webui
# Custom port
# ่ชๅฎไน็ซฏๅฃ
./claude-code-webui --port 3000
# Allow network access (use with caution)
# ๅ
่ฎธ็ฝ็ป่ฎฟ้ฎ๏ผ่ฐจๆ
ไฝฟ็จ๏ผ
./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
๐ Technical Architecture | ๆๆฏๆถๆ
Frontend Technology Stack | ๅ็ซฏๆๆฏๆ
- React 19 - Modern UI framework / ็ฐไปฃUIๆกๆถ
- TypeScript - Type-safe JavaScript / ็ฑปๅๅฎๅ จ็JavaScript
- Vite - Fast build tool / ๅฟซ้ๆๅปบๅทฅๅ ท
- Tailwind CSS - Utility-first CSS framework / ๅฎ็จไผๅ ็CSSๆกๆถ
- Heroicons - Beautiful SVG icons / ็ฒพ็พ็SVGๅพๆ
- React Router - Client-side routing / ๅฎขๆท็ซฏ่ทฏ็ฑ
Backend Technology Stack | ๅ็ซฏๆๆฏๆ
- Deno - Modern JavaScript/TypeScript runtime / ็ฐไปฃJavaScript/TypeScript่ฟ่กๆถ
- Hono - Lightweight web framework / ่ฝป้็บงWebๆกๆถ
- Claude Code SDK - Official Anthropic SDK / AnthropicๅฎๆนSDK
- WebSocket - Real-time communication / ๅฎๆถ้ไฟก
- File System API - File operations / ๆไปถๆไฝ
Core Architecture | ๆ ธๅฟๅ่ฝๆถๆ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ Web Frontend โ โ Deno Backend โ โ Claude CLI โ
โ Webๅ็ซฏ็้ข โโโโโบโ Denoๅ็ซฏๆๅก โโโโโบโ Claudeๅฝไปค่ก โ
โ Session Manager โ โ HTTP/WebSocket โ โ Native Process โ
โ History Viewer โ โ File Operations โ โ MCP Integration โ
โ MCP Config UI โ โ Stream Handling โ โ AI Processing โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
๐ Security Considerations | ๅฎๅ จ่่
โ ๏ธ Important Notice | ้่ฆๆ้
This tool executes Claude CLI locally and provides web access
ๆญคๅทฅๅ
ทๅจๆฌๅฐๆง่กClaude CLIๅนถๆไพWeb่ฎฟ้ฎ๏ผ่ฏทๆณจๆไปฅไธๅฎๅ
จไบ้กน
โ Safe Usage Patterns | ๅฎๅ จไฝฟ็จๆจกๅผ
- ๐ Local development: Default localhost access only
๐ ๆฌๅฐๅผๅ๏ผ้ป่ฎคไป localhost่ฎฟ้ฎ - ๐ข Trusted networks: LAN access for team collaboration
๐ข ๅฏไฟก็ฝ็ป๏ผๅฑๅ็ฝๅ ๅข้ๅไฝ - ๐ Project isolation: Claude accesses selected directories only
๐ ้กน็ฎ้็ฆป๏ผClaudeไป ่ฎฟ้ฎ้ๅฎ็ฎๅฝ
๐ก๏ธ Security Recommendations | ๅฎๅ จๅปบ่ฎฎ
- No built-in authentication: Use in trusted environments only
ๆ ๅ ็ฝฎ่ฎค่ฏ๏ผไป ๅจๅฏไฟก็ฏๅขไฝฟ็จ - System access: Claude can read/write project files
็ณป็ป่ฎฟ้ฎ๏ผClaudeๅฏ่ฏปๅ้กน็ฎๆไปถ - Network exposure: Ensure network security if needed
็ฝ็ปๆด้ฒ๏ผๅฆ้็ฝ็ป่ฎฟ้ฎ่ฏท็กฎไฟ็ฝ็ปๅฎๅ จ
# Local access only (recommended)
# ไป
ๆฌๅฐ่ฎฟ้ฎ๏ผๆจ่๏ผ
./claude-code-webui --port 8080
# Network access (trusted networks only)
# ็ฝ็ป่ฎฟ้ฎ๏ผไป
ๅฏไฟก็ฝ็ป๏ผ
./claude-code-webui --host 0.0.0.0 --port 8080
โ ๏ธ Never expose to public internet without proper security measures
โ ๏ธ ๅๅฟๅจๆฒกๆ้ๅฝๅฎๅ
จๆชๆฝ็ๆ
ๅตไธๆด้ฒๅฐๅ
ฌ็ฝ
๐ Development Documentation | ๅผๅๆๆกฃ
Project Structure | ้กน็ฎ็ปๆ
claudeCO-webui/
โโโ frontend/ # React frontend application / Reactๅ็ซฏๅบ็จ
โ โโโ src/
โ โ โโโ components/ # UI components / UI็ปไปถ
โ โ โโโ hooks/ # Custom hooks / ่ชๅฎไนHook
โ โ โโโ services/ # Service layer / ๆๅกๅฑ
โ โ โโโ utils/ # Utility functions / ๅทฅๅ
ทๅฝๆฐ
โโโ backend/ # Deno backend service / Denoๅ็ซฏๆๅก
โ โโโ handlers/ # Request handlers / ่ฏทๆฑๅค็ๅจ
โ โโโ history/ # History processing / ๅๅฒ่ฎฐๅฝๅค็
โ โโโ middleware/ # Middleware / ไธญ้ดไปถ
โโโ shared/ # Shared type definitions / ๅ
ฑไบซ็ฑปๅๅฎไน
โโโ docs/ # Documentation / ๆๆกฃ
Development Guide | ๅผๅๆๅ
For detailed technical documentation, see CLAUDE.md, including:
่ฏฆ็ป็ๆๆฏๆๆกฃ่ฏทๅ่ CLAUDE.md๏ผๅ
ๅซ๏ผ
- System architecture design / ็ณป็ปๆถๆ่ฎพ่ฎก
- API interface documentation / APIๆฅๅฃๆๆกฃ
- Development environment configuration / ๅผๅ็ฏๅข้ ็ฝฎ
- Message type definitions / ๆถๆฏ็ฑปๅๅฎไน
๐ค Contributing Guide | ่ดก็ฎๆๅ
We welcome all forms of contributions!
ๆไปฌๆฌข่ฟๅ็งๅฝขๅผ็่ดก็ฎ๏ผ
How to Contribute | ๅฆไฝ่ดก็ฎ
- ๐ด Fork this project / Fork ๆญค้กน็ฎ
- ๐ Create feature branch / ๅๅปบๅ่ฝๅๆฏ (
git checkout -b feature/AmazingFeature) - ๐พ Commit your changes / ๆไบคๆดๆน (
git commit -m 'Add some AmazingFeature') - ๐ค Push to the branch / ๆจ้ๅฐๅๆฏ (
git push origin feature/AmazingFeature) - ๐ Create Pull Request / ๅๅปบ Pull Request
Development Setup | ๅผๅ่ฎพ็ฝฎ
# Install frontend dependencies
# ๅฎ่ฃ
ๅ็ซฏไพ่ต
cd frontend && npm install
# Run tests
# ่ฟ่กๆต่ฏ
npm test
# Code formatting
# ไปฃ็ ๆ ผๅผๅ
npm run format
# Type checking
# ็ฑปๅๆฃๆฅ
npm run typecheck
๐ License | ่ฎธๅฏ่ฏ
This project is licensed under the MIT License
ๆฌ้กน็ฎ้็จ MIT License ่ฎธๅฏ่ฏ
๐ Acknowledgments | ่ด่ฐข
Inspiration Sources | ็ตๆๆฅๆบ
- sugyan/claude-code-webui - Provided initial inspiration and README structure reference
ไธบๆฌ้กน็ฎๆไพไบๅๅง็ตๆๅREADME็ปๆๅ่ - Anthropic Claude - Powerful AI programming assistant
ๆไพๅผบๅคง็AI็ผ็จๅฉๆ - Claude Code CLI - Official command-line tool
ๅฎๆนๅฝไปค่กๅทฅๅ ท
Technical Acknowledgments | ๆๆฏ่ด่ฐข
- React Team - Excellent framework for modern web development
Reactๅข้ - ไธบ็ฐไปฃWebๅผๅๆไพไผ็งๆกๆถ - Deno Team - Modern JavaScript runtime
Denoๅข้ - ็ฐไปฃ็JavaScript่ฟ่กๆถ - Open Source Community - All the open source libraries used in this project
ๅผๆบ็คพๅบ - ไธบ้กน็ฎไฝฟ็จ็ๆๆๅผๆบไพ่ตๅบ
Special Thanks | ็นๅซๆ่ฐข
Thanks to all developers who contributed code, reported issues, and provided suggestions!
ๆ่ฐขๆๆไธบๆญค้กน็ฎ่ดก็ฎไปฃ็ ใๆฅๅ้ฎ้ขใๆๅบๅปบ่ฎฎ็ๅผๅ่
ไปฌ๏ผ
โญ If this project helps you, please give it a Star!
โญ ๅฆๆ่ฟไธช้กน็ฎๅฏนไฝ ๆๅธฎๅฉ๏ผ่ฏท็ปไธไธชStar๏ผ
๐ Found an issue? Create Issue | ้ๅฐ้ฎ้ข๏ผ ๅๅปบIssue
๐ฌ Want to discuss? Join Discussions | ๆณ่ฆ่ฎจ่ฎบ๏ผ ๅไธDiscussions