Web Claude Code

Run Claude Code directly in your web browser with a powerful terminal interface. Access Claude CLI anywhere, anytime.

Why Web Claude Code?

Traditional Claude CLI requires a terminal application and local setup. Web Claude Code brings Claude to your browser with:

• 🌐 Browser-Based: No local terminal required - access Claude Code from any browser
• 🚀 Quick Setup: One command to start - webcc and you're ready
• 🔄 Real-time Sync: WebSocket-powered bidirectional communication with Claude CLI
• 💾 History Persistence: Terminal history saved across sessions
• 📱 Mobile Friendly: Works on tablets and mobile devices
• 🎨 Beautiful UI: Modern terminal interface with xterm.js
• 🌍 Remote Access: Share your Claude session with online mode

🚀 Quick Start

Install globally:

npm install -g @webccc/cli

Start the server:

webcc

The CLI will prompt you to select a mode:

• Local mode: Start a local server and connect via browser
• Online mode: Connect to remote server (ws.webcc.dev) for session sharing

After starting, open your browser and navigate to the displayed URL (typically http://localhost:4000).

Note: You need to create a .env file with required configuration before running.

⚙️ Configuration

Create a .env file in your project directory:

# Required: Anthropic API Configuration
ANTHROPIC_BASE_URL=http://your-api-url:3000/api
ANTHROPIC_AUTH_TOKEN=sk-ant-xxxxx

# Optional: Customize as needed
PORT=4000
HOST=0.0.0.0
CLAUDE_PATH=claude
WORK_DIR=/path/to/your/project

Then simply run webcc.

📋 Configuration Reference

Required Settings

Variable	Description
ANTHROPIC_BASE_URL	Your Anthropic API base URL
ANTHROPIC_AUTH_TOKEN	Your Anthropic API authentication token

Optional Settings

Variable	Default	Description
PORT	4000	Web server port
HOST	0.0.0.0	Web server host
CLAUDE_PATH	claude	Path to Claude CLI executable
WORK_DIR	Current dir	Working directory for Claude CLI
ANTHROPIC_MODEL	claude-sonnet-4-5-20250929	Primary Claude model
ANTHROPIC_SMALL_FAST_MODEL	claude-sonnet-4-5-20250929	Fast model for quick tasks

💡 Usage Examples

Example 1: Local Mode Setup

# Create .env file
echo "ANTHROPIC_BASE_URL=http://localhost:3000/api" > .env
echo "ANTHROPIC_AUTH_TOKEN=sk-ant-xxxxx" >> .env

# Start CLI
webcc

# Select "local" mode when prompted
# Then open http://localhost:4000 in your browser

Example 2: Online Mode (Session Sharing)

# Create .env file (same as above)
echo "ANTHROPIC_BASE_URL=http://localhost:3000/api" > .env
echo "ANTHROPIC_AUTH_TOKEN=sk-ant-xxxxx" >> .env

# Start CLI
webcc

# Select "online" mode when prompted
# CLI will connect to ws.webcc.dev
# Multiple browsers can connect to the same session using the token

📦 Requirements

• Node.js >= 14.0.0

• Claude CLI installed and accessible in PATH

• expect tool (for PTY support):

  # macOS
  brew install expect
  
  # Ubuntu/Debian
  sudo apt-get install expect
  
  # Windows
  # Use WSL (Windows Subsystem for Linux)

🛠️ Troubleshooting

❌ Claude CLI Not Found

Error: Failed to start CLI: spawn claude ENOENT

Solutions:

1. Verify Claude CLI is installed: which claude
2. Add claude to your PATH
3. Or specify full path in .env:

   CLAUDE_PATH=/usr/local/bin/claude

❌ Port Already in Use

Error: Error: listen EADDRINUSE :::4000

Solutions:

1. Change port in .env:

   PORT=8080

2. Or stop the process using port 4000:

   lsof -ti:4000 | xargs kill

❌ Missing expect Tool

Error: Failed to start CLI: spawn expect ENOENT

Solution: Install expect for your platform:

# macOS
brew install expect

# Ubuntu/Debian
sudo apt-get install expect

# Windows
# Use WSL (Windows Subsystem for Linux)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT