使用说明
克劳德透镜
用于管理Claude Code插件、MCP、代理、技能和命令的TUI。
看到一切。控制一切。除非你愿意，否则不要删除任何内容。
Claude Code的生态系统发展迅速。插件、MCP服务器、自定义代理、技能、命令——你尝试它们，忘记它们，它们就会堆积起来。每个人都只是通过存在来悄悄地消耗上下文。
克劳德透镜 让您完全了解Claude代码配置，并允许您在不删除的情况下打开或关闭任何内容 htop 用于您的Claude Code设置。
特性
- 仪表板概述 在全球和项目范围内安装的所有设备
- 交互式TUI 使用vim风格的键盘导航
- 非破坏性禁用/启用 适用于所有组件类型
- 永久删除 当您准备清理时（通过设置→ 禁用项目）
- 项目级意识 管理每个项目的配置
- JSON输出 用于脚本编写和自动化
- 外部编辑器集成 查看和编辑配置
快速开始
需要Node.js 18+。
npx claude-lens
就是这样。您将看到整个Claude Code配置的交互式仪表板。
对于频繁使用，请全局安装：
npm install -g claude-lens
claude-lens
用法
交互模式（默认）
claude-lens # Launch TUI dashboard
文本摘要
claude-lens scan # Text summary of everything
claude-lens scan --json # Machine-readable JSON output
列出特定组件类型
claude-lens plugins # Installed plugins
claude-lens mcps # MCP server connections
claude-lens agents # Custom agents
claude-lens skills # Skills (linked + plugin-embedded)
claude-lens commands # Custom commands
claude-lens projects # Projects with Claude configuration
所有命令支持 --json 用于脚本编写：
claude-lens mcps --json | jq '.[] | select(.enabled == false)'
打开/关闭组件
# Plugins
claude-lens disable plugin frontend-design
claude-lens enable plugin frontend-design
# Agents
claude-lens disable agent rails-expert
claude-lens enable agent rails-expert
# MCP servers
claude-lens disable mcp rollbar
claude-lens enable mcp rollbar
# Commands and skills work the same way
claude-lens disable command my-command
claude-lens disable skill technical-docs
项目范围内的组件
使用 --project 对于特定项目中的组件：
claude-lens disable mcp sentry --project ~/projects/my-app
claude-lens disable agent custom-helper --project ~/projects/my-app
交互模式
启动 claude-lens 以获得完整的TUI体验（这是默认设置）。
键盘快捷键
导航（所有视图）
| 关键 | 行动 |
|---|---|
j / k |
向下/向上导航 |
h / l |
向左/向右移动 |
Enter |
选择/深入查看 |
Esc |
回去吧 |
? |
显示所有快捷方式 |
q |
退出 |
列表视图
| 关键 | 行动 |
|---|---|
Space |
切换启用/禁用 |
/ |
搜索 |
e / d / a |
筛选器：启用/禁用/全部 |
u |
撤消上次切换 |
详细视图 （代理、命令）
| 关键 | 行动 |
|---|---|
v |
查看完整内容 |
e |
在外部编辑器中打开 |
Space |
切换启用/禁用 |
克劳德镜头管理什么
| 组件 | 它是什么 | 它住在哪里 |
|---|---|---|
| 插件 | 市场扩展（例如Figma、前端设计） | ~/.claude/plugins/ |
| MCPs | 模型上下文协议服务器——与外部工具的连接 | .mcp.json 文件 |
| 代理 | 具有特定行为的自定义AI角色 | ~/.claude/agents/ 或 .claude/agents/ |
| 技能 | 可重复使用的功能，通常与MCP工具相关联 | ~/.claude/skills/ 或 .claude/skills/ |
| 命令 | 可以调用的提示模板 /command-name |
~/.claude/commands/ 或 .claude/commands/ |
禁用如何工作
禁用是 无损的 默认情况下。没有任何内容会被删除。
| 组件 | 禁用机制 |
|---|---|
| 插件 | 切换 enabledPlugins 在 ~/.claude/settings.json |
| 代理 | 重命名文件： my-agent.md → my-agent.md.disabled |
| 命令 | 使用重命名文件 .disabled 后缀 |
| 技能 | 用重命名符号链接 .disabled 后缀 |
| MCP | 跟踪 ~/.claude-lens/disabled-mcps.json |
重新启用会反转此过程。您的配置保持不变。
永久删除
当你准备好清理时，请访问 设置→ 禁用项目 致：
- 恢复 --重新启用已禁用的项目
- 永久删除 --永久删除单个项目
- 删除全部 --永久删除所有禁用项目
配置
编辑
claude lens使用您的系统编辑器查看/编辑文件：
export VISUAL=code # or vim, nano, etc.
export EDITOR=vim # fallback if VISUAL not set
数据位置
claude lens将自己的数据存储在 ~/.claude-lens/:
~/.claude-lens/
└── disabled-mcps.json # Registry of disabled MCP servers
发展
git clone https://github.com/radumardale/claude-lens.git
cd claude-lens
npm install
npm run dev # Run in development mode
npm run build # Compile TypeScript
npm run typecheck # Type checking only
贡献
欢迎投稿！请随意：
- 打开问题以报告错误或建议功能
- 提交带有改进的拉取请求
我是主要维护者，负责审查所有贡献。乐于先讨论问题中的想法。
