Claudex

Your own Claude Code UI. Open source, self-hosted, runs entirely on your machine.

Community

Join our Discord server to get help, share feedback, and connect with other users.

Why Claudex?

• Multiple sandboxes - Docker (local), E2B (cloud), or Modal (cloud).
• Use your own plans - Claude Max, Z.AI Coding, or OpenRouter.
• Full IDE experience - VS Code in browser, terminal, file explorer.
• Extensible - Skills, agents, slash commands, MCP servers.

Screenshots

Quick Start

git clone https://github.com/Mng-dev-ai/claudex.git
cd claudex
docker compose up -d

Open http://localhost:3000

Features

Sandboxed Code Execution

Run AI agents in isolated environments with multiple sandbox providers:

• Docker - Fully local, no external dependencies
• E2B - Cloud sandboxes with e2b.dev
• Modal - Serverless cloud sandboxes with modal.com

Full Development Environment

• VS Code editor in the browser
• Terminal with full PTY support
• File system management
• Port forwarding for web previews
• Environment checkpoints and snapshots

VNC Browser Control

View and interact with a browser running inside the sandbox via VNC. Use Playwright MCP with Chrome DevTools Protocol (CDP) to let Claude control the browser programmatically.

Multiple AI Providers

Switch between providers in the same chat:

• Anthropic - Use your Max plan
• Z.AI - Use your Coding plan
• OpenRouter - Access to multiple model providers

Extend with Skills & Agents

• Custom Skills - ZIP packages with YAML metadata
• Custom Agents - Define agents with specific tool configurations
• Slash Commands - Built-in (/context, /compact, /review, /init)
• MCP Servers - Model Context Protocol support (NPX, BunX, UVX, HTTP)

Scheduled Tasks

Automate recurring tasks with Celery workers.

Chat Features

• Fork chats from any message point
• Restore to any previous message in history
• File attachments with preview

Preview Capabilities

• Web preview for running applications
• Mobile viewport simulation
• File previews: Markdown, HTML, images, CSV, PDF, PowerPoint

Marketplace

• Browse and install plugins from official catalog
• One-click installation of agents, skills, commands, MCPs

Secrets Management

• Environment variables for sandbox execution

Custom Instructions

• System prompts for global context
• Custom instructions injected with each message

Configuration

Configure in the Settings UI after login:

Setting	Description
Claude OAuth Token	For Max plan
Z.AI API Key	For Coding plan
OpenRouter API Key	For OpenRouter models

You only need one AI provider key.

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    Frontend     │────▶│   FastAPI       │────▶│   PostgreSQL    │
│   React/Vite    │     │   Backend       │     │   Database      │
└─────────────────┘     └────────┬────────┘     └─────────────────┘
                                 │
                    ┌────────────┼────────────┐
                    ▼            ▼            ▼
            ┌───────────┐ ┌───────────┐ ┌─────────────────┐
            │   Redis   │ │  Celery   │ │ Docker Sandbox  │
            │  Pub/Sub  │ │  Workers  │ │                 │
            └───────────┘ └───────────┘ └─────────────────┘

Tech Stack

Frontend: React 19, TypeScript, Vite, TailwindCSS, Zustand, React Query, Monaco Editor, XTerm.js

Backend: FastAPI, Python 3.13, SQLAlchemy 2.0, Celery, Redis, Granian

Services

Service	Port
Frontend	3000
Backend API	8080
PostgreSQL	5432
Redis	6379

Commands

docker compose up -d      # Start
docker compose down       # Stop
docker compose logs -f    # Logs

Deployment

For production deployment on a VPS, see the Coolify Installation Guide.

API & Admin

• API Docs: http://localhost:8080/api/v1/docs
• Admin Panel: http://localhost:8080/admin

Default admin: admin@example.com / admin123

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

License

Apache 2.0 - see LICENSE