自托管 Claude Code 工作空间，集成浏览器内 VS Code 与终端，支持 Anthropic、OpenAI、Copilot、OpenRouter 多提供商路由与 Docker 沙箱隔离执行。
项目概述#
Claudex 是一个自托管的 Claude Code 工作空间，解决了 Claude Code 官方工具在模型提供商锁定、缺乏统一 Web IDE 界面以及执行环境隔离方面的痛点。它允许开发者在同一个工作空间内，无需切换工具即可使用不同的 LLM 后端执行代码编写和系统操作任务。
核心能力#
多提供商路由#
- Anthropic：直接使用 Claude auth token 原生调用
- OpenAI：支持 gpt-5.2-codex、gpt-5.3-codex 等模型
- GitHub Copilot：通过 GitHub device flow 认证
- OpenRouter：支持 moonshotai/kimi-k2.5、google/gemini-3-pro-preview 等
- Custom：自定义 Anthropic-compatible base_url
执行环境#
- Docker 沙箱隔离与 Host 本地执行模式
- 内置 VNC/WebVNC 可视化操作
- OpenVSCode Server 集成（端口 8765）
会话与扩展#
- Checkpoint 恢复与历史消息分叉
- MCP Servers 支持、自定义 Skills/Agents
- 插件市场与定时任务调度器
架构设计#
React/Vite Frontend → FastAPI Backend → PostgreSQL+Redis (Web) / SQLite (Desktop) → Sandbox Runtime → Claude Code CLI + claude-agent-sdk → Anthropic Bridge (非 Anthropic 提供商)
部署模式#
Web 模式 (Docker)#
git clone https://github.com/Mng-dev-ai/claudex.git
cd claudex
docker compose -p claudex-web -f docker-compose.yml up -d
# 访问 http://localhost:3000
Desktop 模式#
- 目前仅支持 macOS (Apple Silicon)
- 从 Releases 下载 DMG 或从源码构建 Tauri 应用
服务端口#
| 服务 | 端口 |
|---|---|
| Frontend | 3000 |
| Backend API | 8080 |
| VNC | 5900 / WebVNC: 6080 |
| OpenVSCode | 8765 |
API 端点#
- API 文档：
http://localhost:8080/api/v1/docs - Admin 面板：
http://localhost:8080/admin - 健康检查：
GET /health,GET /api/v1/readyz