A self-hosted Claude Code workspace featuring in-browser VS Code and terminal, multi-provider routing (Anthropic, OpenAI, Copilot, OpenRouter), and Docker sandboxed execution environment.
Overview#
Claudex is a self-hosted Claude Code workspace that addresses limitations of the official Claude Code tool: provider lock-in, lack of unified Web IDE interface, and execution environment isolation. It enables developers to use different LLM backends within the same workspace without switching tools.
Core Capabilities#
Multi-Provider Routing#
- Anthropic: Native Claude auth token support
- OpenAI: gpt-5.2-codex, gpt-5.3-codex models
- GitHub Copilot: GitHub device flow authentication
- OpenRouter: moonshotai/kimi-k2.5, google/gemini-3-pro-preview, etc.
- Custom: Anthropic-compatible base_url configuration
Execution Environment#
- Docker sandbox isolation and Host local execution modes
- Built-in VNC/WebVNC for visual operations
- OpenVSCode Server integration (port 8765)
Session & Extensions#
- Checkpoint recovery and message forking
- MCP Servers support, custom Skills/Agents
- Plugin marketplace and scheduled tasks
Architecture#
React/Vite Frontend → FastAPI Backend → PostgreSQL+Redis (Web) / SQLite (Desktop) → Sandbox Runtime → Claude Code CLI + claude-agent-sdk → Anthropic Bridge (non-Anthropic providers)
Deployment Modes#
Web Mode (Docker)#
git clone https://github.com/Mng-dev-ai/claudex.git
cd claudex
docker compose -p claudex-web -f docker-compose.yml up -d
# Access at http://localhost:3000
Desktop Mode#
- Currently macOS only (Apple Silicon)
- Download DMG from Releases or build Tauri app from source
Service Ports#
| Service | Port |
|---|---|
| Frontend | 3000 |
| Backend API | 8080 |
| VNC | 5900 / WebVNC: 6080 |
| OpenVSCode | 8765 |
API Endpoints#
- API Docs:
http://localhost:8080/api/v1/docs - Admin Panel:
http://localhost:8080/admin - Health:
GET /health,GET /api/v1/readyz