Claudex

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

Try it live: claudex.pro

Community

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

Why Claudex?

• Local sandbox - Run locally with Docker, fully isolated code execution.
• 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 Docker containers. Fully local, no external dependencies.

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

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

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