词元之母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你好,朋友!很高兴见到你!
今天有什么我可以帮助你的吗?