Back to Details

zeude

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

zeude — Enterprise AI Adoption Platform for Claude Code

zeude — 面向Claude Code的企业级AI落地平台

Measure usage. Sync config. Guide teams. Turn AI investment into AI fluency.
zeude
is an enterprise platform that transforms organizations into AI natives by solving the Intention-Action Gap in Claude Code adoption. It provides centralized measurement, automated configuration sync, and context-aware skill guidance — delivering 3× improvement in adoption rates without mandating behavior.
统计使用情况。同步配置。指导团队。将AI投资转化为AI应用能力。
zeude
是一款企业级平台，通过解决Claude Code落地过程中的意向-行动差距，帮助组织转型为AI原生型企业。它提供集中化统计、自动化配置同步和上下文感知的skill指导——无需强制改变行为，就能将落地率提升3倍。

Installation

安装

Plugin (Claude Code)

插件（Claude Code）

bash
claude plugin marketplace add zep-us/zeude
bash
claude plugin marketplace add zep-us/zeude

Self-hosted (recommended for enterprise)

自托管（企业推荐）

bash
git clone https://github.com/zep-us/zeude.git
cd zeude
cp .env.example .env
bash
git clone https://github.com/zep-us/zeude.git
cd zeude
cp .env.example .env

Configure Supabase and ClickHouse credentials in .env

在.env中配置Supabase和ClickHouse凭证

Start dashboard

启动控制面板

cd zeude/dashboard && pnpm install && pnpm dev
undefined
cd zeude/dashboard && pnpm install && pnpm dev
undefined

Skill (any platform)

Skill（任意平台）

bash
npx skills add https://github.com/akillness/oh-my-skills --skill zeude
bash
npx skills add https://github.com/akillness/oh-my-skills --skill zeude

Requirements

依赖要求

  • Claude Code installed and authenticated
  • Supabase account — configuration storage and user management
  • ClickHouse instance — analytics backend
  • macOS or Linux (x86_64 / arm64)
  • Go (for building the CLI shim)
  • Node.js + pnpm (for the dashboard)
  • 已安装并验证Claude Code
  • Supabase账户——用于配置存储和用户管理
  • ClickHouse实例——分析后端
  • macOS或Linux（x86_64 / arm64）
  • Go语言（用于构建CLI Shim）
  • Node.js + pnpm（用于运行控制面板）

When to use

使用场景

  • Measure Claude Code adoption rates across an engineering org without mandating behavior
  • Centrally deploy skills, MCP servers, and hooks to all developers in one push
  • Surface context-aware skill suggestions at the moment a developer types a prompt
  • Identify power users and surface their best practices to the rest of the team
  • Run OpenTelemetry traces on Claude Code sessions for usage analytics in ClickHouse
  • 在不强制改变行为的前提下，统计整个工程组织的Claude Code落地率
  • 集中部署skills、MCP服务器和钩子，一键推送给所有开发者
  • 在开发者输入提示的瞬间，提供上下文感知的skill建议
  • 识别核心用户，并向团队其他成员推广他们的最佳实践
  • 对Claude Code会话运行OpenTelemetry追踪，在ClickHouse中进行使用情况分析

Do not use when

不适用场景

  • You need a single-developer setup → use standard 
    skills add
    directly
  • You don't have Supabase + ClickHouse infrastructure → prerequisites block self-hosting
  • You need a fully managed SaaS → contact enterprise sales at jaegyu.lee@zep.us
  • 单开发者环境 → 直接使用标准
    skills add
    命令
  • 没有Supabase + ClickHouse基础设施 → 前置条件无法满足自托管需求
  • 需要完全托管的SaaS服务 → 联系企业销售：jaegyu.lee@zep.us

Architecture: Three-Layer Ecosystem

架构：三层生态系统

Sensing   → OpenTelemetry traces → ClickHouse → Dashboard analytics
Delivery  → Dashboard API → Zeude Shim → Local ~/.claude/ configuration
Guidance  → User prompts → Hook analysis → Context-aware skill suggestions
感知层   → OpenTelemetry追踪 → ClickHouse → 控制面板分析
交付层  → 控制面板API → Zeude Shim → 本地~/.claude/配置
指导层  → 用户提示 → 钩子分析 → 上下文感知的skill建议

1. Sensing — Measure adoption

1. 感知层 — 统计落地情况

Zeude captures every Claude Code session via OpenTelemetry without modifying developer behavior.
bash
undefined
Zeude通过OpenTelemetry捕获每一次Claude Code会话，无需修改开发者行为。
bash
undefined

Configure OTEL endpoint in .env

在.env中配置OTEL端点

OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 CLICKHOUSE_DSN=clickhouse://...

Dashboard shows:
- Adoption rates by team and individual
- Token usage patterns
- Most-used skills and prompts
- Power user identification
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 CLICKHOUSE_DSN=clickhouse://...

控制面板展示：
- 按团队和个人划分的落地率
- Token使用模式
- 最常用的skills和提示语
- 核心用户识别

2. Delivery — Sync configuration

2. 交付层 — 同步配置

The Zeude Shim intercepts 
claude
commands and syncs centralized config before passing control to the real Claude CLI.
bash
undefined
Zeude Shim拦截
claude
命令，在将控制权传递给真实Claude CLI之前，同步集中化配置。
bash
undefined

Per-developer install (using agent key from dashboard)

开发者端安装（使用控制面板提供的agent密钥）

curl -fsSL https://raw.githubusercontent.com/zep-us/zeude/main/install.sh | bash -s -- --key <AGENT_KEY>

Config synced on every invocation:
- `~/.claude/skills/` — deployed skills
- MCP server configurations
- Hooks (UserPromptSubmit, etc.)
curl -fsSL https://raw.githubusercontent.com/zep-us/zeude/main/install.sh | bash -s -- --key <AGENT_KEY>

每次调用时同步的配置：
- `~/.claude/skills/` — 已部署的skills
- MCP服务器配置
- 钩子（UserPromptSubmit等）

3. Guidance — Skill suggestions

3. 指导层 — Skill建议

Zeude uses 2-tier keyword matching to deliver relevant skill suggestions at prompt time via 
UserPromptSubmit
hooks.
bash
undefined
Zeude使用双层关键词匹配，通过
UserPromptSubmit
钩子在输入提示时提供相关的skill建议。
bash
undefined

Hook fires on every Claude prompt

钩子在每次Claude提示时触发

Zeude analyzes intent → suggests relevant skills inline

Zeude分析意图 → 内联推荐相关skills

undefined
undefined

Dashboard API

控制面板API

bash
undefined
bash
undefined

Start dashboard (after .env configuration)

配置.env后启动控制面板

cd dashboard && pnpm dev
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
undefined
GET /api/skills # 列出已部署的skills POST /api/skills # 向所有团队成员部署skill GET /api/analytics # 落地指标 POST /api/teams # 创建/管理团队
undefined

Operating rules

操作规则

  1. Set up Supabase and ClickHouse before any developer installs the Shim
  2. Deploy the dashboard and verify API health before distributing agent keys
  3. Use the Zeude Shim installer (not manual symlinks) so auto-update works
  4. Monitor the ClickHouse dashboard weekly to identify adoption gaps
  5. Push new skills centrally from the dashboard rather than asking developers to install manually
  6. Keep agent keys per-team for access control granularity
  1. 在开发者安装Shim之前，先搭建好Supabase和ClickHouse
  2. 部署控制面板并验证API健康状态后，再分发agent密钥
  3. 使用Zeude Shim安装程序（而非手动创建符号链接），以支持自动更新
  4. 每周监控ClickHouse控制面板，识别落地差距
  5. 从控制面板集中推送新skills，而非要求开发者手动安装
  6. 为每个团队分配独立的agent密钥，实现细粒度访问控制

References

参考资料

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