核心功能
Plugin
Plugin 是 Z Code 的扩展机制——通过插件市场，你可以为 Agent 添加新的能力，比如连接 GitHub 管理仓库、安装 LSP 获得代码智能、或者引入团队共享的工作流。
浏览与安装
在 Agents 设置 > 插件 > 发现 标签中，你可以浏览所有可用插件。Z Code 内置了 Claude Code 官方市场（claude-plugins-official），开箱即用。
每个插件卡片会显示名称、类型标签（Agent / Command / MCP / LSP / Skill / Hook 等）和简短描述。点击右侧的 安装 按钮即可一键安装。
插件类型
| 类型标签 | 说明 | 典型插件 |
|---|---|---|
| Agent | 专业 Agent，提供特定领域的完整工作流 | feature-dev |
| Command | 自定义命令，扩展 / 快捷指令 | ralph-loop |
| MCP | MCP 服务集成，连接外部工具和数据源 | context7, github |
| LSP | 语言服务器，提供代码跳转、类型检查等智能 | typescript-lsp, pyright-lsp |
| Skill | 技能定义，指导 Agent 的工作方式 | frontend-design |
| Hook | 钩子，在特定事件触发时自动执行 | ralph-loop |
管理已安装插件
切换到 已安装 标签，可以查看当前已安装的所有插件。
- 使用 开关按钮 启用或禁用插件（禁用后不会加载，但保留配置）
- 点击 删除图标 卸载插件
- 插件按来源市场分组显示
管理插件市场
切换到 市场 标签，可以管理你的插件源。除了内置的官方市场，你还可以添加第三方或团队私有的市场。
添加自定义市场
点击 + 添加市场，在弹出的对话框中输入市场源地址。支持四种格式：
| 格式 | 示例 | 说明 |
|---|---|---|
| GitHub 仓库 | owner/repo | 最简单的方式，直接使用 GitHub 用户名/仓库名 |
| SSH 地址 | git@github.com:owner/repo.git | 支持 GitLab、Bitbucket 等任意 Git 托管平台 |
| 远程 URL | https://example.com/marketplace.json | 托管的 marketplace.json 文件地址 |
| 本地路径 | /path/to/marketplace | 本地目录或 marketplace.json 文件 |
安装范围
安装插件时可以选择不同的范围，决定插件的可见性：
| 范围 | 存储位置 | 可见性 |
|---|---|---|
| User | ~/.claude/ | 所有项目可用，仅自己 |
| Project | .claude/settings.json | 团队共享（需提交到仓库） |
| Local | .claude/local.settings.json | 仅自己在当前项目可用 |
常见问题
Plugin 和 Skill 有什么区别？
- Plugin：扩展能力——添加新命令、集成外部服务、提供新工具
- Skill：指导行为——告诉 Agent 如何完成任务、遵循什么规范
简单说，Plugin 解决「能做什么」，Skill 解决「怎么做」。
添加市场后插件没有显示？
检查以下几点：
- 市场地址格式是否正确
- 仓库是否包含
.claude-plugin/marketplace.json文件 - 私有仓库是否需要认证
- 尝试刷新市场列表
可以为团队创建共享的插件市场吗？
可以。创建一个包含 .claude-plugin/marketplace.json 的 Git 仓库，团队成员添加这个市场地址即可共享插件。