内容
# 克拉克多
[](https://www.npmjs.com/package/@claxedo/workspace-runtime)
[](./LICENSE)
**[claxedo.com](https://claxedo.com) · [docs.claxedo.com](https://docs.claxedo.com) · [npm: @claxedo/\*](https://www.npmjs.com/search?q=%40claxedo)**
克拉克多是一款开源的编码代理工作空间：一个桌面应用程序，用于在您自己的项目上运行终端编码代理（OpenCode、Claude、Codex、Cursor、Pi），以及一个可组合的TypeScript框架 — 规范化的代理事件、多个通道的运行时外观、每个工作空间的主机、中继/隧道管道、沙盒管理、MCP工具以及可重用的代理扩展 — 用于在相同的基元上构建您自己的编码代理产品。
## 快速开始
克隆仓库并直接运行桌面应用程序或引擎：
```sh
git clone https://github.com/kyashrathore/Claxedo.git
cd Claxedo
bun install
bun run dev # OpenCode 引擎（CLI/服务器）
bun run dev:desktop # 桌面应用程序（Electron 外壳）
bun typecheck # 跨工作空间的 turbo 类型检查
```
或者跳过 monorepo，直接获取框架 — 在任何 Node/Bun 项目中安装所需的包：
```sh
npm install @claxedo/workspace-runtime @claxedo/agent-sdk-runtime @claxedo/agent-event-runtime
```
每个包都可独立使用；大多数完整产品都从 `@claxedo/workspace-runtime` 开始。参见[安装指南](https://docs.claxedo.com/guides/install)和[快速开始](https://docs.claxedo.com/guides/see-it-in-action)，了解整个设置。
## 软件包
所有 12 个软件包都发布在 npm 上，位于[`@claxedo/*`](https://www.npmjs.com/search?q=%40claxedo)下：
| 软件包 | 描述 |
| --- | --- |
| [`@claxedo/workspace-runtime`](https://www.npmjs.com/package/@claxedo/workspace-runtime) | 代理会话、终端、进程、文件、差异和中继附件的每个工作空间主机运行时 |
| [`@claxedo/agent-sdk-runtime`](https://www.npmjs.com/package/@claxedo/agent-sdk-runtime) | 编码代理通道的运行时外观（Claude、Codex、Cursor、OpenCode、Pi）：会话、回合、SSE 路由、可插拔存储 |
| [`@claxedo/agent-event-runtime`](https://www.npmjs.com/package/@claxedo/agent-event-runtime) | 规范代理事件合约和通道适配器，将 Claude SDK、Codex、Cursor 和 ACP 事件流规范为一个事件模型 |
| [`@claxedo/agent-extensions`](https://www.npmjs.com/package/@claxedo/agent-extensions) | 将可重用的代理功能（技能、MCP 配置、插件）安装并物化到 Codex、Claude、OpenCode 和 Cursor |
| [`@claxedo/workspace-relay`](https://www.npmjs.com/package/@claxedo/workspace-relay) | 中继/隧道服务器，将身份验证流量路由到工作空间运行时，具有 Bun 和 Cloudflare 适配器 |
| [`@claxedo/workspace-relay-protocol`](https://www.npmjs.com/package/@claxedo/workspace-relay-protocol) | 工作空间中继隧道协议的线路类型、消息验证和令牌验证接口 |
| [`@claxedo/sandbox-manager`](https://www.npmjs.com/package/@claxedo/sandbox-manager) | 沙盒生命周期管理器，具有基于纪元的租期和 Daytona、Modal、Vercel Sandbox、Cloudflare、Box 和 Docker 的可插拔驱动器 |
| [`@claxedo/channels`](https://www.npmjs.com/package/@claxedo/channels) | 将 GitHub、Slack、Telegram、Discord 和 WhatsApp 消息路由到克拉克多运行时 |
| [`@claxedo/connections`](https://www.npmjs.com/package/@claxedo/connections) | 集成注册表、凭证存储端口、OAuth 尝试机和令牌服务，用于链接外部帐户 |
| [`@claxedo/mcp`](https://www.npmjs.com/package/@claxedo/mcp) | 克拉克多文档、工作图、进程、日志、会话和浏览器工具的 MCP 服务器和 CLI |
| [`@claxedo/workgraph`](https://www.npmjs.com/package/@claxedo/workgraph) | 用于组织、执行和记住 AI 辅助工作的个人操作系统 |
| [`@claxedo/wakes`](https://www.npmjs.com/package/@claxedo/wakes) | 从带外触发器恢复空闲代理会话 — 由时间、外部事件或授权批准触发的持久唤醒 |
## 布局
- `packages/claxedo-server` — 控制平面（嵌入 OpenCode 引擎，运行本地/云/混合会话）
- `packages/claxedo-app` — 网页应用程序（Solid）；`packages/claxedo-desktop` — Electron 外壳
- `packages/workspace-runtime`、`workspace-relay*`、`sandbox-manager` — 会话执行 + 路由
- `packages/{channels,connections,workgraph,wakes,mcp,agent-*}` — 第一方 `@claxedo/*` 功能
- `packages/{opencode,core,server,protocol,schema,plugin,llm,codemode,tui,ui,session-ui,sdk,http-recorder}` — 供应商 OpenCode 引擎 + 共享 UI（负载承载依赖项）
- `packages/cli` — `claxedo deploy` CLI (`lildax`)
## OpenCode 遗产
克拉克多是 [OpenCode](https://github.com/anomalyco/opencode) 的一个硬分叉 — 引擎和共享 UI 包作为第一方源代码被供应商在仓库中；其他所有内容（控制平面、工作空间运行时、中继、通道、连接、工作图、网页/桌面应用程序）都是克拉克多的。
## 贡献
参见 [CONTRIBUTING.md](./CONTRIBUTING.md)。安全问题通过 [SECURITY.md](./SECURITY.md) 进行，而不是公共问题。
## 许可证
MIT — 参见 [LICENSE](./LICENSE)。
MCP 市场