# 自定义与扩展

> CLAUDE.md、技能（skills）、插件、MCP、Hooks 与界面自定义

- 作者：David（道雾轩）
- 专栏：Claude Code 中文手册（https://daiw.org/manual/claude-code.md）
- 最后更新：2026-09-28
- 原文：https://daiw.org/manual/claude-code/commands-customization
- 转载与引用：请注明出处并附原文链接（https://daiw.org/about/copyright）

## 项目记忆：CLAUDE.md

| 命令 | 作用 |
| --- | --- |
| `/init` | 探索项目并生成一份 `CLAUDE.md`。设置 `CLAUDE_CODE_NEW_INIT=1` 后会先交互式询问要生成哪些文件（CLAUDE.md、skills、hooks），再动手 |
| `/memory` | 编辑 `CLAUDE.md` 记忆文件，开关自动记忆（auto-memory），查看自动记忆已经记了什么 |

一个新仓库的标准起手式是 `/init` 生成初版 `CLAUDE.md`，再用 `/memory` 逐步精修——把项目约定、常用命令、代码风格写成 Claude 每次都会看到的“常识”，而不是每次对话重复口述。`CLAUDE.md` 的存放位置、加载顺序、`@` 导入语法等文件层面的细节见[配置文件](https://daiw.org/manual/claude-code/configuration-files#claudemd项目记忆)。

## 技能（Skills）

技能是“你反复复制粘贴的一段指令/清单/多步骤流程”的固化产物：写一个 `SKILL.md`，Claude 就能在合适时机自动使用，或者你用 `/skill-name` 直接调用。旧版的 `.claude/commands/*.md` 自定义命令已经并入技能体系，写法兼容，行为等价。完整说明见 **[Skills](https://daiw.org/manual/claude-code/skills)** 与 **[Commands](https://daiw.org/manual/claude-code/custom-commands)**。

## MCP(Model Context Protocol)

| 命令 | 作用 |
| --- | --- |
| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | 管理 MCP 服务器连接与 OAuth 登录状态；不带参数打开交互列表。v2.1.273 起服务器在会话中途断开、自动重连也放弃时，会弹出指向这里的通知；v2.1.283 起工具列表一次显示更多工具，支持翻页键与鼠标，组织封禁的工具带告警图标 |

命令行侧对应 `claude mcp`（增删配置）、`claude mcp login/logout <server>`（单独走 OAuth，v2.1.186+）。MCP 服务器暴露的 prompt 会以 `/mcp__<server>__<prompt>` 的形式出现在命令列表里。

## 插件

| 命令 | 作用 |
| --- | --- |
| `/plugin [subcommand]` | 管理插件；不带参数打开插件菜单，或直接传 `list`/`install`/`enable`/`disable`。🆕 v2.1.275 起 `/plugin install <plugin> --marketplace <source>` 会先提议添加该 marketplace，再安装插件 |
| `/reload-plugins [--force]` | 重新加载全部已启用插件，应用未生效的变更；如果会改变已加载的 MCP 工具集（从而让 prompt 缓存失效），需要加 `--force` 才会真正执行。v2.1.268 起用 `/plugin` 安装、启用、禁用的改动在关闭菜单时即生效，这一步只在手改插件文件后才需要 |
| `/reload-skills` | 重新扫描技能/命令目录，让磁盘上新增或修改的技能无需重启即可生效（v2.1.152+） |

插件可以打包技能、subagent、hooks、MCP 服务器、输出风格，统一分发给团队；完整的组成、目录结构、Marketplace 与作者侧打包见 **[Plugins](https://daiw.org/manual/claude-code/plugins)**。安装示例：

```text
/plugin install skill-creator@claude-plugins-official
```

## Hooks

| 命令 | 作用 |
| --- | --- |
| `/hooks` | 查看当前生效的 hook 配置（按工具事件分类） |

Hooks 用于在特定生命周期事件（如 `SessionStart`、`PreToolUse`、`Stop`）上运行确定性的脚本逻辑，弥补“技能只能靠模型自觉遵守指令”的不足，适合强制校验、审计、自动格式化等场景。v2.1.251 新增 `PreModelSwitch` / `PostModelSwitch` 事件，可以拦截、确认或注释一次模型切换。v2.1.271 起 SessionStart、UserPromptSubmit、PreToolUse、SessionEnd hook 运行时 spinner 会显示出来并计时，等待 SessionStart hook 的提示可以按 Esc 取消。

⚠️ v2.1.280 起 `PermissionRequest` 事件上不再运行 agent 型 hook（它的回答本来就无法批准或拒绝请求），会报错并指向 command 或 http hook。v2.1.281 起阻断型事件（如 PreToolUse）上的 `mcp_tool` hook 在 MCP 服务器还在连接时会等它连上（最长到 MCP 连接超时），不再被跳过；`/hooks` 的详情页也会说明这是哪种 hook、该到哪里修改，而不是一律指向 settings.json。

## 界面与体验

| 命令 | 作用 |
| --- | --- |
| `/theme` | 切换配色主题，含跟随终端明暗的 `auto`、色盲友好主题、ANSI 主题，以及 `~/.claude/themes/` 自定义主题 |
| `/statusline` | 配置状态栏；描述你想要的效果，或不带参数从当前 shell prompt 自动生成 |
| `/keybindings` | 打开快捷键配置文件。⚠️ v2.1.280 起 `y` / `n` 不再默认绑定对话框的确认 / 取消（统一用 Enter / Esc），想找回就在 `keybindings.json` 里把它们绑到 `confirm:yes` / `confirm:no`；v2.1.283 起拼错的修饰键（如 `ctl+k`）会在调试日志里告警，`/rewind` 与 `/diff` 的列表改用通用的 `select:*` 动作（旧的 `messageSelector:*` / `diff:*` 绑定仍然有效） |
| `/color [color\|default]` | 设置当前会话 prompt bar 颜色，连接 Remote Control 时会同步到 claude.ai/code |
| `/focus` | 切换聚焦视图：只显示最后一条 prompt、一行工具调用摘要与最终回复 |
| `/output-style [name]` | 🆕 **v2.1.269+**：列出并切换输出风格（含 v2.1.237 起内置的「Concise」：先给结果、省掉铺垫），Remote Control 与无头会话里也能用 |
| `/tui [default\|fullscreen]` | 设置终端 UI 渲染模式并重新进入（`fullscreen` 为无闪烁 alt-screen 渲染器） |

## 项目专属能力

| 命令 | 作用 |
| --- | --- |
| `/run` | 技能。启动并驱动你的应用，用真实运行效果而非只靠测试来验证改动（v2.1.145+） |
| `/verify` | 技能。构建并运行项目，用观察到的实际行为确认一次代码改动是否达到预期（v2.1.145+） |
| `/run-skill-generator` | 技能。从一次干净环境的启动过程中，记录安装命令、环境变量、启动脚本，固化成项目专属技能 `.claude/skills/run-<project>/`，供 `/run`、`/verify` 及其它 agent 复用（每个项目建议跑一次） |
| `/dataviz [request]` | 技能。图表/仪表盘设计指导：自动挑选图表形式、按角色分配颜色、校验色盲友好度与对比度（v2.1.198+） |
| `/claude-api [migrate\|upgrade\|cost-optimize\|managed-agents-onboard]` | 技能。加载 Claude API 参考资料（按项目语言自动匹配），或帮你把已有 Claude API 代码升级到新模型。v2.1.239 起 `upgrade` 把 Python 项目从 `anthropic` 0.x 迁到 1.x；v2.1.247 起 `cost-optimize` 分析现有项目的 API 花费，逐项做可测量的降本改动 |
| `/design-sync [hint]` | 技能。把仓库里的 React 设计系统同步上传到 Claude Design，让生成的设计使用你的真实组件（仅 Anthropic API 可用） |
| `/design-login` | 为 `/design-sync` 授权 claude.ai 账号访问设计系统 |

## 建议的自定义投入顺序

1. 先写好 `CLAUDE.md`(`/init` + `/memory`），这是成本最低、收益最直接的一步。
2. 把“经常口述的多步骤指令”沉淀成个人/项目技能。
3. 需要跨项目共享或团队统一分发时，再打包成插件。
4. 需要“确定性强制执行”（而不是靠模型自觉）时，才引入 hooks。