chadbyte/clay

Clay Studio – 自托管 AI 增强编码工作空间

它是什么

• 一个本地运行的网页应用（守护进程），将你的浏览器变成一个协作 IDE，人类队友和 AI 编码代理（Claude、Codex、GitHub Copilot CLI 等）共享一个持久工作空间。
• 守护进程与每个受支持代理的已安装 CLI 通信，然后 CLI 联系提供商的模型 API。没有代码或聊天数据通过第三方服务器路由。

工作原理

1. 安装任何受支持的编码代理 CLI 并进行身份验证。
2. 运行 npx clay-server – 守护进程在端口 2633（或自定义端口）启动并提供 Web UI。
3. 从任何浏览器或安装了 PWA 的设备打开 URL（或扫描二维码）。
4. 创建会话，将项目、一组代理和参与者绑定在一起。会话状态以 JSONL/Markdown 格式持久化在磁盘上。
5. 协作者可以看到实时光标、提及，并可以交接工作。代理作为“伙伴”拥有自己的身份、指令和记忆。

关键能力

• 共享项目与实时会话 – 侧边栏中的多个仓库、并行会话、存在指示器。
• 持久 AI“伙伴” – 每个代理在会话之间保持自己的角色、指令和记忆。
• 跨提供商连续性（YOKE） – 通用会话界面让你可以在 Claude、Codex、Copilot 等之间切换，而不会丢失上下文。
• 后台/并行工作 – git worktrees、生成的 worker、计划任务和“Ralph Loops”保持可见。
• 设备无关 – 使用桌面浏览器或在移动设备上安装 PWA；推送通知提醒你审批、失败或完成的任务。
• 自托管控制 – 所有数据都保存在你的机器上；唯一的网络流量是代理 CLI 直接向其模型提供商发出的请求。

典型工作流程

浏览器 → Clay 守护进程（本地） → 编码代理 CLI → 模型提供商

你可以通过私有网络（例如 Tailscale）在局域网外暴露 UI，或配置反向代理/隧道设置以用于自定义域名。

受支持的代理（截至 README） Claude Code、Codex、Grok Build、Kimi Code、GitHub Copilot CLI、Qwen Code、Junie CLI、Antigravity CLI、OpenCode、Kiro CLI。

安装与快速开始

# 先决条件：Node.js 20+ 以及至少一个已安装并认证的编码代理 CLI
npx clay-server               # 启动守护进程，打开二维码 / URL
# 可选标志
npx clay-server -p 8080       # 自定义端口
npx clay-server --add .       # 将当前文件夹添加为项目
npx clay-server --list         # 列出已注册的项目
npx clay-server --shutdown    # 停止守护进程

社区与扩展

• 社区构建的 Stream Deck 插件提供物理按钮，用于会话控制、worktree 切换和权限处理。
• 讨论和变更日志托管在 GitHub 上。

许可证

• Clay Studio 的核心以 AGPL-3.0-only 发布。遗留部分在适用情况下保留 MIT 许可。

谁可能受益？

• 希望在不依赖云托管服务的情况下进行 AI 辅助结对编程的小团队。
• 希望在多个编码会话中保留 AI 上下文（提示、记忆）的独立开发者。
• 有严格数据主权要求但仍希望利用基于 LLM 的编码助手的组织。