zeude

zeude — Claude Code 企业 AI 采用平台

衡量使用情况。同步配置。指导团队。将 AI 投资转化为 AI 熟练度。

zeude 是一个企业平台，通过解决 Claude Code 采用中的意图与行动差距，帮助组织成为 AI 原生组织。它提供集中式衡量、自动配置同步和上下文感知的技能指导——无需强制规定行为，即可将采用率提升 3×。

安装

插件（Claude Code）

claude plugin marketplace add zep-us/zeude

可自托管（推荐用于企业）

git clone https://github.com/zep-us/zeude.git
cd zeude
cp .env.example .env
# Configure Supabase and ClickHouse credentials in .env

# Start dashboard
cd zeude/dashboard && pnpm install && pnpm dev

技能（适用于任何平台）

npx skills add https://github.com/akillness/jeo-skills --skill zeude

要求

• 已安装并完成身份验证的 Claude Code
• Supabase 账户——用于配置存储和用户管理
• ClickHouse 实例——用于分析后端
• macOS 或 Linux（x86_64 / arm64）
• Go（用于构建 CLI shim）
• Node.js + pnpm（用于仪表板）

适用场景

• 在不强制规定行为的情况下，衡量工程组织中的 Claude Code 采用率
• 一键向所有开发者集中部署技能、MCP 服务和钩子
• 在开发者输入提示词时，提供上下文感知的技能建议
• 识别高级用户，并向团队其他成员展示他们的最佳实践
• 对 Claude Code 会话运行 OpenTelemetry 跟踪，在 ClickHouse 中进行使用情况分析

不适用场景

• 你需要单开发者配置 → 直接使用标准的 skills add
• 你没有 Supabase + ClickHouse 基础设施 → 先决条件会阻止自托管
• 你需要完全托管的 SaaS → 联系企业销售团队：[email protected]

架构：三层生态系统

Sensing   → OpenTelemetry traces → ClickHouse → Dashboard analytics
Delivery  → Dashboard API → Zeude Shim → Local ~/.claude/ configuration
Guidance  → User prompts → Hook analysis → Context-aware skill suggestions

1. 感知 — 衡量采用情况

Zeude 通过 OpenTelemetry 捕获每个 Claude Code 会话，且不会改变开发者的行为。

# Configure OTEL endpoint in .env
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
CLICKHOUSE_DSN=clickhouse://...

仪表板显示：

• 按团队和个人划分的采用率
• Token 使用模式
• 最常用的技能和提示词
• 高级用户识别

2. 交付 — 同步配置

Zeude Shim 会拦截 claude 命令，并在将控制权交给真正的 Claude CLI 前同步集中式配置。

# Per-developer install (using agent key from dashboard)
curl -fsSL https://raw.githubusercontent.com/zep-us/zeude/main/install.sh | bash -s -- --key <AGENT_KEY>

每次调用时同步的配置：

• ~/.claude/skills/ — 已部署的技能
• MCP 服务配置
• 钩子（UserPromptSubmit 等）

3. 指导 — 技能建议

Zeude 通过 UserPromptSubmit 钩子，使用两层关键词匹配，在提示词输入时提供相关技能建议。

# Hook fires on every Claude prompt
# Zeude analyzes intent → suggests relevant skills inline

仪表板 API

# Start dashboard (after .env configuration)
cd dashboard && pnpm dev

# Available endpoints (via dashboard)
GET  /api/skills          # list deployed skills
POST /api/skills          # deploy a skill to all team members
GET  /api/analytics       # adoption metrics
POST /api/teams           # create/manage teams

操作规则

1. 在任何开发者安装 Shim 之前，先设置 Supabase 和 ClickHouse
2. 部署仪表板并确认 API 健康状态正常，然后再分发 Agent 密钥
3. 使用 Zeude Shim 安装程序（而非手动创建符号链接），以确保自动更新正常工作
4. 每周监控 ClickHouse 仪表板，识别采用差距
5. 从仪表板集中推送新技能，而不是要求开发者手动安装
6. 按团队使用 Agent 密钥，以实现更精细的访问控制

参考资料

• zep-us/zeude
• 文档
• 企业联系邮箱：[email protected]

来源：zep-us/zeude — Apache-2.0 许可证