词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
课程信息 预计学时:4-6小时 难度等级:⭐⭐ 入门级 更新日期:2026年4月 适用版本:Claude Code v2.1.133(验证于 2026-05-08) 信息来源:内置命令参考 | Skills 官方文档 | Claude Command Suite | 最佳实践 前置要求:已完成Claude Code安装和基础使用
.claude/commands/,什么时候应该迁移到 Skills/plan、/plugin、/release-notes、/rewind、/insights、/schedule、/statusline前置知识:本教程假设你已掌握02教程中的30+内置命令用法,重点讲解自定义命令开发。
根据你的情况选择学习路径:这是一篇长教程,不用全看!根据你的目标选择路径。
✅ 术语表(3分钟)
✅ 第二部分:5分钟快速开始(5分钟)注意:内置命令的详细用法已在「02-基础使用完整指南」中讲解,本教程重点是自定义命令开发!
第六部分:FAQ - 20个常见问题解答
第五部分5.5节:故障排查Ctrl + F 搜索你的问题关键词| 想学什么 | 看哪几节 | 预计时间 |
|---|---|---|
| frontmatter配置 | 第4.3节 | 30分钟 |
| 参数处理 | 第4.4节 | 30分钟 |
| 工具调用 | 第4.5节 | 45分钟 |
| 命令组合 | 第5.2节 | 30分钟 |
| 社区命令库 | 第5.4节 | 20分钟 |
| 术语 | 英文全称 | 通俗解释 | 生活类比 |
|---|---|---|---|
| Slash命令 | Slash Commands | 以"/"开头的快捷指令 | 手机快捷方式(一点就打开App) |
| 自定义命令 | Custom Commands | 你自己创建的命令 | 自己设置的手机快捷方式 |
| 内置命令 | Built-in Commands | Claude Code自带的命令 | 手机出厂预装的App |
| frontmatter | - | 命令文件开头的配置区(YAML格式,见下方说明) | 书的封面信息(书名、作者等) |
| $ARGUMENTS | - | 接收用户输入参数的变量 | 快递单上的"收件人"空格 |
| allowed-tools | - | 允许命令使用的工具列表 | 工具箱(限定可用的工具) |
| 命令作用域 | Command Scope | 命令生效的范围(项目级/用户级) | 门禁卡(有的只能开一个门,有的能开所有门) |
| 命令命名空间 | Namespace | 命令的分组前缀 | 文件夹分类(/dev:xxx、/test:xxx) |
~ 符号是什么?~(波浪号)是你的"用户主目录"的简写:~ = C:\Users\你的用户名(比如 C:\Users\admin)~ = /Users/你的用户名~ = /home/你的用户名~/.claude/commands/ 的意思是:C:\Users\admin\.claude\commands\/Users/laojin/.claude/commands/⚠️ 重要提醒:heredoc是在PowerShell/Bash终端里用的,不是在Claude Code对话框里用的! 如果你已经在Claude Code里,根本不需要学heredoc,直接说人话让Claude帮你创建文件就行: 帮我创建文件 .claude/commands/hello.md,内容是: # 问候命令 你好!请问候用户:$ARGUMENTSClaude Code会自动帮你创建文件夹和文件!
@'
这里是第一行
这里是第二行
这里是第三行
'@ | Out-File -FilePath "文件路径"Shift + Enter,按 Enter 会直接发送消息。一句话理解:Slash命令就是Claude Code的"快捷方式",输入 /命令名就能触发预设的操作。
自定义命令 = .claude/commands/目录下的Markdown文件
命令名 = 文件名(不含.md后缀)
命令内容 = Markdown文件的内容(作为提示词注入)
参数 = $ARGUMENTS变量接收用户输入
当你输入 /write AI教程
Claude Code做的事:
1. 找到 .claude/commands/write.md 文件
2. 读取文件内容作为提示词
3. 把"AI教程"赋值给 $ARGUMENTS
4. 执行这个提示词| 类型 | 来源 | 存放位置 | 特点 |
|---|---|---|---|
| 内置命令 | Claude Code官方 | 程序内部 | 不可修改,核心功能 |
| 兼容自定义命令 | 你自己创建 | .claude/commands/ | 适合旧项目和轻量 prompt 包装 |
| 用户级兼容命令 | 你自己创建(全局) | ~/.claude/commands/ | 所有项目共享,偏个人习惯 |
| Skills 工作流 | 你自己创建 | .claude/skills/ / ~/.claude/skills/ | 当前官方推荐的自定义能力形态 |
你需要什么功能?
│
├── 会话管理、系统诊断?
│ └── 用内置命令(/clear、/doctor等)
│
├── 项目特定且要长期维护的工作流?
│ └── 优先创建项目级 Skills
│
├── 只是给当前项目包一层轻量 slash 入口?
│ └── 用 `.claude/commands/` 兼容方式也可以
│
└── 所有项目通用的工具?
└── 创建用户级 Skills 或用户级兼容命令你:帮我写一篇公众号文章,主题是AI工具
要求:
1. 风格要接地气
2. 字数1500-2000
3. 包含实战案例
4. 开头要有金句
5. 结尾要有行动号召
...(每次都要重复说一遍)
10分钟后...
你:帮我写另一篇,主题是Claude Code
要求:(又要重复一遍...)你:/write AI工具
Claude自动知道:
- 风格要接地气
- 字数1500-2000
- 包含实战案例
- 开头要有金句
- 结尾要有行动号召
直接开始写作!| 对比维度 | 手动输入 | 使用Commands |
|---|---|---|
| 效率 | 每次重复输入 | 一次配置,永久使用 |
| 一致性 | 每次可能遗漏要求 | 标准化执行 |
| 可复用 | 无法分享 | 团队共享、社区贡献 |
| 可维护 | 分散在聊天记录 | 集中管理、版本控制 |
本节目的:用最快速度创建第一个自定义命令,让你立即看到效果! 预计时间:5分钟
# 进入你的项目目录
cd C:\你的项目路径
# 创建commands目录
New-Item -ItemType Directory -Path ".claude\commands" -Force.claude/commands/hello.md:💡 你有两种选择: 选择A:在Claude Code对话框里说人话(推荐新手) 帮我创建文件 .claude/commands/hello.md,内容是: # 问候命令 你好!我是你的AI助手。 用户想要问候的对象是:$ARGUMENTS 如果没有提供名字,请使用"朋友"作为默认称呼。 请用热情友好的方式问候,并询问今天可以帮助什么。(换行用 Shift + Enter,最后按Enter发送)选择B:在终端里用命令行(熟悉命令行的用户)
见下方PowerShell/Bash代码
@'
# 问候命令
你好!我是你的AI助手。
用户想要问候的对象是:$ARGUMENTS
如果没有提供名字,请使用"朋友"作为默认称呼。
请用热情友好的方式问候,并询问今天可以帮助什么。
'@ | Out-File -FilePath ".claude\commands\hello.md" -Encoding utf8You: /hello 张三你好,张三!很高兴见到你!
今天有什么我可以帮助你的吗?无论是写代码、解答问题,
还是其他任何事情,我都随时准备为你效劳!You: /hello你好,朋友!很高兴见到你!
今天有什么我可以帮助你的吗?.claude/commands/hello.md$ARGUMENTS 接收参数命令文件 = Markdown文件
命令名 = 文件名(不含.md)
参数 = $ARGUMENTS 变量
/hello 张三
│ │
│ └── $ARGUMENTS = "张三"
└── 读取 hello.md本节说明:这一节是参考表,不建议第一次学习时逐行阅读。你已经在第二部分创建过一个能运行的命令;如果目标是继续实操,可以直接跳到「第四部分:自定义命令开发」。需要查命令时再回来看这张表。 详细教程:请回顾「02-基础使用完整指南.md」→ 第四部分:Slash命令大全 版本校准(2026-04):当前官方 Commands Reference 没有 /todos。Claude 的待办追踪是内部TodoWrite工具 / SDK 事件;后台任务管理使用/tasks。
| 分类 | 命令 | 功能 | 常用场景 | 重要 |
|---|---|---|---|---|
| 会话管理 | /clear | 清空对话历史 | 开始新任务 | ⭐ |
/compact | 智能压缩对话 | Token超60%时 | ⭐ | |
/resume | 恢复历史会话 | 继续之前的工作 | ⭐ | |
/export | 导出对话记录 | 保存重要对话 | ||
/rename | 重命名会话 | 整理会话列表 | ||
/branch | 创建会话分支 | 探索不同方案 | ||
/btw | 提旁路问题 | 不污染主上下文 | ||
/side | 临时旁路会话 | 快速追问 | ||
/teleport | 拉取 Web 会话到终端 | Web/CLI 接力 | ||
| 上下文控制 | /context | 查看Token使用 | 监控上下文 | ⭐ |
/cost | 查看费用与用量(v2.1.92+ 订阅用户含 per-model / cache-hit,见 release) | 成本控制 | ||
/model | 切换AI模型 | 按需选模型 | ⭐ | |
/effort | 推理深度控制 | 调节AI思考深度 | ⭐ | |
/usage | 账户使用量 | 查看配额 | ||
/focus | 聚焦视图 | 减少界面噪声 | ||
/recap | 生成会话一句话摘要 | 快速恢复上下文 | ||
| 项目配置 | /init | 初始化CLAUDE.md | 新项目配置 | ⭐ |
/memory | 编辑记忆文件 | 添加项目规则 | ||
/permissions | 管理权限设置 | 安全控制 | ||
/add-dir | 添加工作目录 | 跨目录操作 | ⭐ | |
/config | 打开设置界面 | 调主题、模型、输出风格 | ||
/keybindings | 编辑按键绑定 | 自定义快捷键 | ||
/theme | 切换主题 | 终端显示调整 | ||
/terminal-setup | 配置终端快捷键 | Shift+Enter 等 | ||
/ide | 管理 IDE 集成 | IDE 联动 | ||
/chrome | 配置 Chrome 集成 | 浏览器联动 | ||
| 开发辅助 | /security-review | 安全审查 | 检查当前 diff 的安全问题 | |
/review | 本地 PR / 改动审查 | 通用代码审查 | ||
/simplify | 复用、质量、效率修正 | 改完后打磨 | ||
/batch | 大规模并行改造 | 多 worktree/多 agent | ||
/autofix-pr | 远程盯 PR 并修 CI/评论 | PR 修复循环 | ||
/ultrareview | 云端多 Agent 深度审查 | 高风险 PR | ||
/ultraplan | 云端深度计划 | 复杂方案设计 | ||
/tasks | 后台任务管理 | 查看后台 Bash / agent 任务 | ||
/rewind | 回退检查点 | 撤销修改 | ⭐ | |
| 诊断工具 | /doctor | 系统健康检查 | 排查问题 | |
/status | 完整状态信息 | 环境确认 | ||
/stats | 使用统计 | 习惯分析 | ||
/debug | 开启并分析调试日志 | 排查异常 | ||
/feedback | 提交反馈/问题报告 | 反馈 bug | ||
/heapdump | 写出堆快照 | 内存问题诊断 | ||
/powerup | 交互式功能教程(v2.1.90+) | 新手熟悉 CLI | ||
| MCP相关 | /mcp | 管理MCP连接 | 外部工具 | ⭐ |
/hooks | 管理Hooks | 自动化触发 | ⭐ | |
/plugin | 管理插件 | 安装/卸载插件 | ||
/reload-plugins | 重载插件 | 调试插件改动 | ||
/skills | 查看 Skills | 管理可用工作流 | ||
| 其他 | /help | 显示帮助 | 快速查命令 | ⭐ |
/release-notes | 更新日志(v2.1.92+ 为交互式版本选择器) | 查看新功能 | ||
/loop | Bundled skill:定时循环执行 | 监控部署状态 | ⭐ | |
/schedule | 云端例行任务 | 定时 routine | ||
/remote-control | 远程控制当前会话 | 手机/网页接力 | ||
/desktop | 在桌面 App 继续 | 桌面接力 | ||
/mobile | 显示移动端二维码 | 手机端安装 | ||
/login / /logout | 登录/退出账号 | 账号切换 | ||
/privacy-settings | 隐私设置 | Pro/Max 用户 | ||
/extra-usage | 配置额外用量 | 限额后继续工作 | ||
/passes | 分享体验资格 | 符合资格时 | ||
/upgrade | 打开升级页面 | 升级套餐 | ||
/web-setup | 连接 GitHub 到 Web | Web 工作流 | ||
/sandbox | 沙箱隔离模式 | 安全执行 | ||
/color | 会话颜色设置 | 个性化 | ||
/copy | 复制AI回复 | 分享内容 |
💡 提示:输入 /然后按Tab键可以查看所有可用命令。
/powerup:交互式课程(v2.1.90,官方 release 原文:interactive lessons teaching Claude Code features with animated demos)/loop:bundled skill 形式的定时循环任务/effort:推理深度控制(五级:low/medium/high/xhigh/max)/sandbox:沙箱隔离/color:会话颜色/copy:复制回复/branch:会话分支/plan:先规划后执行/plugin:插件市场与安装入口/release-notes:更新日志(v2.1.92 起为 interactive version picker,见官方 release)/cost:费用与用量(v2.1.92 起对 subscription users 增加 per-model and cache-hit breakdown,见官方 release)/rewind:回退到更早会话状态/insights:查看会话和使用洞察/schedule:计划性任务入口/statusline:状态行定制/skills:查看和搜索已安装的 Skills(支持关键词过滤)/proactive:/loop 的别名(v2.1.105+)Added /powerup — interactive lessons teaching Claude Code features with animated demos。/powerup,按界面提示学习即可;具体步骤与课时结构以当前版本 CLI 为准,此处不臆造菜单文案。/loop [时间间隔] [提示词]s秒 / m分钟 / h小时)。如果省略时间间隔,Claude 会根据任务动态选择合适的检查频率。Esc 取消当前循环/proactive 是 /loop 的别名💡 实用场景:监控CI/CD部署进度、定期检查构建状态、轮询外部服务健康状况。
| 级别 | 符号 | Token消耗 | 适用场景 |
|---|---|---|---|
| low | ○ | 最少 | 简单问答、格式转换 |
| medium | ◐ | 中等 | 日常开发、代码修改 |
| high | ● | 较多 | 架构设计、复杂调试 |
| xhigh | ◉ | 多 | 深度推理,Opus 4.7 推荐默认 |
| max | ⬤ | 最多 | 极限推理,关键决策 |
💡 省钱技巧:批量处理简单任务时切换到 low,关键决策时切换到xhigh。
💡 交互式滑块:直接输入 /effort(不带参数)会弹出交互式滑块,拖动选择级别。
💡 其他设置方式: claude --effort xhigh(CLI 参数)或CLAUDE_CODE_EFFORT_LEVEL=xhigh(环境变量)。
settings.json 中可以精细配置:{
"sandbox": {
"filesystem": {
"allowWrite": ["/tmp", "./src"],
"allowRead": ["./", "/usr/lib"],
"denyRead": [".env", "credentials.json"]
}
}
}⚠️ 安全提示:处理不信任的代码或敏感项目时,强烈建议启用沙箱模式。
💡 多窗口区分:同时开多个Claude Code会话时,用不同颜色区分(比如:蓝色=前端、绿色=后端)。
💡 提示:这是原 /fork命令的重命名版本。适合在关键决策点创建分支,分别尝试方案A和方案B。
本节目的:掌握自定义命令开发的完整技能 预计时间:90分钟
| 作用域 | 存放位置 | 生效范围 | 适用场景 |
|---|---|---|---|
| 项目级 | .claude/commands/ | 仅当前项目 | 团队共享、项目特定 |
| 用户级 | ~/.claude/commands/ | 所有项目 | 个人工具、通用模板 |
1. 项目级(最高): .claude/commands/
2. 用户级: ~/.claude/commands/
3. 内置命令(最低)⚠️ 重要澄清:核心系统命令(如 /clear、/help、/compact、/doctor等)是受保护的,不能被自定义命令覆盖。上述优先级规则仅适用于非核心内置命令。
.claude/commands/deploy.md(项目级)~/.claude/commands/deploy.md(用户级)/deploy/deploy 时,优先使用项目级的 deploy.md。.claude/commands/clear.md 不会覆盖内置 的 /clear 命令。.claude/commands/
├── 01-write.md # 核心写作命令
├── 02-write-auto.md # 自动写作
├── 11-hotspot.md # 热点扫描
├── 21-title-gen.md # 标题生成
├── 22-title-score.md # 标题评分
├── dev/ # 开发类命令(子目录)
│ ├── code-review.md
│ └── debug.md
└── test/ # 测试类命令
└── generate-tests.md命名空间:使用子目录时,命令名变成 /dev:code-review格式。
--- 包围。⚠️ 注意: version和author不是Claude Code官方支持的frontmatter字段,但你可以添加它们用于自己的管理目的(Claude Code会忽略未知字段)。
/help 和Tab补全时显示,帮助用户了解命令功能。/命令名 后显示的占位符提示。| 工具名 | 功能 | 适用场景 | 通俗解释 |
|---|---|---|---|
Read | 读取文件 | 分析代码、读取配置 | 打开文件看内容 |
Write | 写入文件 | 创建文件、保存结果 | 新建文件并写入 |
Edit | 编辑文件 | 修改现有代码 | 修改已有文件的内容 |
Bash | 执行命令 | 运行脚本、Git操作 | 在终端运行命令 |
WebSearch | 网络搜索 | 获取最新信息 | 像Google一样搜网页 |
WebFetch | 抓取网页 | 获取网页内容 | 下载网页内容来分析 |
Glob | 按名称查找文件 | 批量查找特定类型的文件 | 比如找所有.md文件:*.md |
Grep | 按内容搜索文件 | 在代码中搜索关键词 | 比如找包含"TODO"的代码 |
Task | 启动子代理 | 并行执行复杂任务 | 派出分身帮你干活 |
NotebookEdit | 编辑Jupyter笔记本 | 数据分析、机器学习 | 编辑.ipynb文件 |
TodoWrite | 任务管理 | 跟踪待办事项 | 创建和更新待办清单 |
💡 提示:最常用的工具是 Read、Write、Edit、Bash、WebSearch。其他工具按需使用。
true时,命令只进行简单的文本替换,不会触发AI模型 推理。$ARGUMENTS 直接替换)/copyright 老金 会直接输出 © 2025 老金. All rights reserved.,不经过AI处理。$ARGUMENTS 是Claude Code的内置变量,接收用户在命令后输入的所有内容。/hello 张三
→ $ARGUMENTS = "张三"
/hello
→ $ARGUMENTS = ""💡 什么是MCP? MCP(Model Context Protocol)是Claude Code的"外部工具扩展系统"。 通俗解释:MCP就像手机的"应用商店"——你可以安装各种第三方工具(如搜索引擎、数据库查询、GitHub操作等),让Claude Code拥有更多能力。 命名规则: mcp__服务器名__工具名比如mcp__mcp-router__search就是调用mcp-router服务器的search工具。详细教程:MCP的安装和配置请见「04-MCP集成完整指南」。
.claude/commands/write.md