斜杠 / 命令是 Claude Code 交互式会话的 快捷控制入口 ，通过输入 / 开头的指令，就能快速调用功能、管理会话、自定义工作流。
查看所有可用命令：
/help
/help 会列出所有内置命令、当前项目的自定义命令（Skills / Commands），以及已连接 MCP 服务器暴露的命令。
命令类型：
命令优先级（同名时） ：企业级 > 个人级 > 项目级 > 内置
/
.claude/skills/
.claude/commands/
一、常用内置斜杠命令
内置命令是 Claude Code 自带的核心功能，直接输入就能用。新手优先掌握这几类高频命令：
基础操作命令
例如我们使用 /help 命令查看帮助信息， Tab 键可以切换菜单， Esc 退出：
会话管理命令
上下文与记忆
项目与配置
模型与输出
可用模型对照表（2026）：
代码与工具
集成与扩展
/plugin 子命令详情：
统计与账户
二、内置 Skills NEW
内置 Skills 是随 Claude Code 附带的预置 AI 工作流，与内置命令不同——它们加载详细提示词后由 Claude 推理执行，可产出更丰富的分析和操作结果，同样用 / 触发。
/clear
/compact
/debug
/simplify
三、命令前缀语法
! 前缀使用示例：
> ! ls > !git log --oneline -10 > !npm test -- --coverage > !cat logs/error.log | tail -50
@ 前缀使用示例：
> 对比 @src/auth/v1.ts 和 @src/auth/v2.ts 的实现差异 > 审查 @src/api/users.ts 中的错误处理逻辑是否完善
四、自定义 Skills（新推荐格式）
Skills 是自定义命令的新一代格式，取代旧版 .claude/commands/ 。两种格式均可正常使用，但新项目建议直接使用 Skills。
Skills vs Commands 对比
创建 Skill 步骤
步骤 1：创建目录结构
自定义 Skills 分两种，存储位置不同：
# 创建项目级 Skill（团队共享，纳入 git） mkdir -p .claude/skills/optimize # 创建个人级 Skill（跨项目通用，本地私有） mkdir -p ~/.claude/skills/fix-bug
步骤 2：编写 SKILL.md
新建 SKILL.md 文件，YAML frontmatter 写配置，下方 Markdown 正文写提示词。 name 字段定义触发命令名。
示例：创建代码性能优化 Skill
--- name: optimize description: 分析代码性能瓶颈，给出优化建议。当用户提到性能问题时自动触发。 allowed-tools: Read, Grep, Glob argument-hint: [目标文件或目录] model: claude-sonnet-4-6 --- 分析以下代码的性能瓶颈，给出具体的优化建议，优先考虑时间复杂度和内存占用： $ARGUMENTS
使用时输入：
/optimize src/utils/data-processor.ts
子目录命名空间组织
可在 .claude/skills/ 下用子目录按职能分类管理，目录名即命令名：
.claude/skills/ ├── optimize/ → /optimize │ ├── SKILL.md │ └── examples/ # 可选：示例文件辅助 Claude 理解 ├── debug/ → /debug │ ├── SKILL.md │ └── scripts/ # 可选：辅助脚本 └── commit/ → /commit └── SKILL.md
五、自定义斜杠命令（旧格式，兼容）
如果有 重复使用的提示词 （比如固定的代码审查要求、重复的指令模板），可以把它做成自定义命令，一键调用。
命令文件存储位置：
参数语法：
核心原理
自定义命令本质是 Markdown 文本文件 ——文件名就是命令名，文件内容就是要执行的提示词，支持传参数、调用 Bash 命令。
步骤创建自定义命令
步骤 1：创建命令存储目录
自定义命令分两种，存储位置不同：
以创建项目命令为例，先建目录：
# 在项目根目录执行 mkdir -p .claude/commands
步骤 2：写 Markdown 命令文件
新建一个 .md 文件，文件名就是命令名（比如 optimize.md → 命令 /optimize ），文件内容写提示词。
示例：创建代码性能优化命令
# 写入提示词到文件 echo "分析这段代码的性能瓶颈，给出具体的优化建议，优先考虑时间复杂度和内存占用：" > .claude/commands/optimize.md
现在，在会话里输入 /optimize ，再粘贴代码，Claude 就会按你的要求做性能分析！
高级技巧：给命令加参数
命令可以带参数，用 $ARGUMENTS （捕获所有参数）或 $1 $2 （按位置取参数）。
示例：带参数的 Bug 修复命令
创建命令文件 .claude/commands/fix-issue.md ：
修复 Issue #$ARGUMENTS，要求： 1. 符合项目编码规范 2. 附上测试用例 3. 说明修复思路
使用命令：
/fix-issue 123 # $ARGUMENTS 会被替换成 "123"
六、Frontmatter 字段参考
自定义命令文件（ commands/*.md ）和 Skills（ skills/*/SKILL.md ）顶部均可添加 YAML Frontmatter 进行精细配置：
--- name: commit # Skills 中必填；命令文件中可选（默认取文件名） allowed-tools: Bash(git add:*), Bash(git commit:*), Read, Edit argument-hint: [commit-message] description: 检查代码质量后提交 model: claude-haiku-4-5-20251001 context: fork agent: general-purpose disable-model-invocation: false user-invocable: true hooks: PreToolUse: - matcher: "Bash" hooks: - type: command command: "./scripts/validate.sh" once: true ---
字段说明
allowed-tools 写法示例
Hook 触发时机
七、插件与 MCP 命令
除了自己写，还能通过 插件 和 MCP 服务器 获取更多扩展命令。
命名格式：
/mcp__<服务器名>__<命令名> [参数]
常用 MCP 命令示例
查看所有可用 MCP 命令： /help （MCP 命令在帮助列表底部单独分组展示）
1. 插件命令
安装 Claude Code 插件后，会自动新增插件专属命令，格式通常是：
/plugin-name:command-name # 避免命令名冲突
比如安装 Git 插件后，可能会有 /git:commit 命令，一键生成规范的 commit 信息。
2. MCP 命令
MCP（模型上下文协议）服务器可以把外部工具（比如 GitHub、Jira）的功能变成斜杠命令，格式：
/mcp__<服务器名>__<功能名> [参数]
示例：
/mcp__github__list_prs # 列出 GitHub 仓库的 PR /mcp__jira__create_issue "登录按钮失效" high # 在 Jira 创建高优先级问题
八、实用命令模板库
模板概览
智能 Git 提交：
<!-- .claude/commands/commit.md --> --- allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git diff:*), Bash(git commit:*) argument-hint: [commit-message] description: 检查代码质量后提交 model: claude-haiku-4-5-20251001 --- ## 暂存区内容 !`git diff --cached` 提交前检查以下问题，发现问题则报告并询问是否继续： 1. 遗留的 `console.log` / `print` 调试语句 2. 未处理的 `TODO` / `FIXME` 注释 3. 大段被注释掉的代码 4. 测试文件中的 `.only` / `.skip` 标记 若无问题，使用以下信息提交：$ARGUMENTS
PR 代码审查：
<!-- .claude/commands/pr-review.md --> --- allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*) description: 全面的 PR 代码审查 --- ## 变更文件 !`git diff --name-only HEAD~1` ## 详细差异 !`git diff HEAD~1` ## 近期提交 !`git log --oneline -5` 按 Critical / Major / Minor 三级优先级输出审查结果，涵盖： 代码逻辑与可读性、安全漏洞、性能隐患（N+1 查询）、测试覆盖率、文档完整性
智能测试运行：
<!-- .claude/commands/test.md --> --- allowed-tools: Bash, Read, Edit argument-hint: [test-pattern] description: 运行测试并自动修复失败用例 --- 运行匹配 "$ARGUMENTS" 的测试： 1. 自动检测测试框架（Jest / pytest / Go test） 2. 运行指定模式的测试 3. 若有失败，分析根因并修复代码 4. 重新运行验证修复 不提供参数则运行全量测试并输出覆盖率报告。
安全漏洞扫描：
<!-- .claude/commands/security-scan.md --> --- allowed-tools: Read, Grep, Glob description: OWASP Top 10 安全漏洞扫描 model: claude-opus-4-6 --- 以安全工程师视角审查代码库： 高危：SQL 注入、XSS、命令注入、硬编码密钥 中危：不安全的反序列化、过时依赖、敏感信息写入日志、CORS 配置过宽 低危：缺失安全响应头、错误信息暴露内部细节 输出格式：漏洞位置 + 危险级别 + 修复建议代码示例
API 文档生成：
<!-- .claude/commands/api-docs.md --> --- allowed-tools: Read, Glob, Edit argument-hint: [输出文件路径] description: 自动生成 REST API 文档 --- 扫描 @src/routes/ 和 @src/controllers/，为所有端点生成 Markdown 文档： - 端点路径与 HTTP 方法 - 请求参数（Query / Body / Path）及类型 - 响应结构（成功与错误） - 认证要求 - curl 调用示例 保存到：$ARGUMENTS（默认：docs/api.md）
代码重构：
<!-- .claude/commands/refactor.md --> --- allowed-tools: Read, Edit, Glob argument-hint: [目标文件或目录] description: 代码质量重构 --- 对 $ARGUMENTS 进行重构，遵循原则： - 可读性：变量/函数命名语义化，消除魔法数字 - DRY 原则：提取重复逻辑为复用函数 - 单一职责：拆分超过 50 行的函数 - 错误处理：完善异常捕获和错误边界 - TypeScript：消除 `any` 类型，补全类型注解 重构前先输出变更计划，确认后再执行。
文档链接检查：
<!-- .claude/commands/check-links.md --> --- allowed-tools: Read, Bash, WebFetch argument-hint: [文档文件路径] description: 检查文档中的链接是否全部有效 model: claude-haiku-4-5-20251001 --- 读取 $ARGUMENTS 文件，提取所有超链接（http/https），逐一请求并检查响应状态码。 输出格式： - 有效链接（200） - 重定向链接（3xx）及目标地址 - 失效链接（4xx/5xx）及建议替代链接 最后输出汇总：共 N 个链接，M 个失效。
附：配置文件说明
建议： 将 CLAUDE.local.md 和 .claude/settings.local.json 加入 .gitignore ，避免个人偏好影响团队成员。
