文档

从首次安装到高级团队工作流，系统学习 Clavue。

把这些页面作为产品手册：安装、provider 配置、日常工作流、命令、权限、安全与排障。

快速开始

安装 Clavue，在仓库中启动，选择配置模式，然后请求一个可审查的工作单元。

用 npx 运行一次或全局安装
选择官方登录、自定义 API、CCR 代理或稍后手动配置
提出带验证要求的具体任务

npx -y clavue@8.22.5

# first useful prompt
Inspect the failing test, make the smallest source fix, run the targeted test, then verify before reporting back.

安装

可选择一次性 npx、npm 全局安装或固定版本 curl 安装。

Node.js 18 或更高版本
macOS 或 Linux shell
支持固定版本命令

npx -y clavue@8.22.5 --version
npx -y clavue@8.22.5

npm install -g clavue@8.22.5
clavue install --force
clavue

curl -fsSL https://unpkg.com/clavue@8.22.5/install.sh | bash -s -- 8.22.5

Provider 配置

把 providers 当作路由。保存 profiles、校验、修复漂移，并有意识地路由模型槽。

官方登录是可选项
支持自定义 API 与代理路由
只有明确需要时才使用 CLAVUE_API_DIALECT=openai_responses

clavue provider
/provider
/provider list
/provider current
/provider doctor
/provider validate
/provider repair
/provider use gpt54-main

命令

使用 slash commands 作为可复用工作流入口。

/provider 管理路由
/mao 进行审查和救援
/team 检查就绪度
/retro 运行改进循环

/provider doctor
/mao review --background
/mao rescue --write fix the provider override bug and verify it
/team check
/retro onboarding and route validation

最佳实践

保持范围聚焦、要求验证，并一次只请求一个可审查工作单元。

用具体任务替代模糊目标
说明哪些内容不应改变
先运行目标检查，再运行更宽验证

Fix the failing auth retry test, make the smallest source change, and run the targeted test.

Do not refactor unrelated provider code. Keep this to the failing validation path.

安全与信任

Clavue 面向明确的本地执行、权限边界和具体验证。

破坏性或共享状态操作前先确认
用 /provider current 检查当前路由
声明完成前先验证

/approvals
/provider current
/provider validate
CLAVUE_USE_KEYCHAIN=1 clavue # optional old macOS Keychain behavior