Slash命令系统
Slash命令是我用Claude Code时最常用的功能之一。通过简单的 /命令 语法,可以快速执行常见任务、控制Claude行为,甚至创建自己的命令库。
这篇文章详细介绍Slash命令系统,以及如何用它们提升效率。
什么是Slash命令
Slash命令就是以 / 开头的特殊指令,用来在会话中控制Claude Code的行为。有点像终端命令,但更智能、更灵活。
基本语法
/命令名称 [参数1] [参数2] ...
举个例子:
/help # 查看帮助
/clear # 清除对话历史
/export conversation.md # 导出对话
/model opus-4 # 切换模型
Slash命令的优势
- 快速执行:无需编写完整的自然语言描述
- 标准化操作:确保任务执行的一致性
- 可定制化:创建符合你工作流程的自定义命令
- 团队共享:通过项目配置共享团队命令
- 上下文感知:命令可以访问项目上下文和当前状态
内置Slash命令完整列表
Claude Code提供了30多个内置命令,涵盖会话管理、配置、开发工具等各个方面。
会话管理命令
| 命令 | 说明 | 示例 |
|---|---|---|
/clear | 清除对话历史,开始新会话 | /clear |
/exit | 退出Claude Code | /exit |
/resume [session] | 恢复之前的对话会话 | /resume |
/export [filename] | 导出对话到文件或剪贴板 | /export chat.md |
/rewind | 回退对话或代码到之前状态 | /rewind |
/compact [instructions] | 压缩对话历史,可选聚焦指令 | /compact focus on auth |
项目和文件命令
| 命令 | 说明 | 示例 |
|---|---|---|
/add-dir | 添加额外的工作目录 | /add-dir ../shared-lib |
/init | 初始化项目,创建CLAUDE.md | /init |
/memory | 编辑CLAUDE.md记忆文件 | /memory |
/review | 请求代码审查 | /review |
/security-review | 执行完整的安全审查 | /security-review |
/todos | 列出当前TODO项 | /todos |
系统和配置命令
| 命令 | 说明 | 示例 |
|---|---|---|
/help | 显示所有可用命令 | /help |
/config | 打开配置界面(Config标签) | /config |
/status | 打开设置界面(Status标签) | /status |
/doctor | 检查Claude Code安装健康状况 | /doctor |
/permissions | 查看或更新权限设置 | /permissions |
/output-style | 设置输出样式 | /output-style |
/vim | 进入vim模式 | /vim |
模型和使用情况命令
| 命令 | 说明 | 示例 |
|---|---|---|
/model | 选择或更改AI模型 | /model opus-4 |
/context | 可视化当前上下文使用情况 | /context |
/cost | 显示token使用统计 | /cost |
/usage | 显示计划使用限制 | /usage |
/stats | 可视化使用情况和会话历史 | /stats |
集成和扩展命令
| 命令 | 说明 | 示例 |
|---|---|---|
/mcp | 管理MCP服务器连接 | /mcp |
/plugin | 管理插件 | /plugin |
/agents | 管理自定义AI子代理 | /agents |
/hooks | 管理钩子配置 | /hooks |
/ide | 管理IDE集成 | /ide |
/sandbox | 启用沙箱bash工具 | /sandbox |
账号管理命令
| 命令 | 说明 | 示例 |
|---|---|---|
/login | 切换Anthropic账号 | /login |
/logout | 登出当前账号 | /logout |
其他实用命令
| 命令 | 说明 | 示例 |
|---|---|---|
/bug | 向Anthropic报告bug | /bug |
/bashes | 列出和管理后台任务 | /bashes |
常用命令详细讲解
/help - 查看帮助
最基础也是最重要的命令。它会显示所有可用的Slash命令,包括:
- 内置命令
- 项目自定义命令(来自
.claude/commands/) - 个人自定义命令(来自
~/.claude/commands/) - MCP服务器提供的命令
使用场景:
# 查看所有命令
/help
# 输出示例:
# Available slash commands:
#
# Built-in commands:
# /clear - Clear conversation history
# /export - Export conversation to file
# ...
#
# Project commands:
# /commit - Create a git commit (project)
# /test - Run tests (project)
# ...
#
# Personal commands:
# /review - Code review (user)
# ...
/clear - 清除对话历史
清除当前对话的所有历史记录,但不会退出会话。适合:
- 开始全新的任务
- 释放上下文空间
- 避免之前对话的干扰
与/exit的区别:
/clear:清空对话,保持会话活跃/exit:完全退出Claude Code
使用示例:
# 场景1:切换到新任务
你: 帮我创建一个登录表单
Claude: [完成登录表单]
你: /clear
你: 现在帮我设计一个数据库schema
Claude: [开始新任务,不受之前对话影响]
# 场景2:上下文太多时
你: /context
# 显示:Context usage: 85% (170K/200K tokens)
你: /clear
你: /context
# 显示:Context usage: 5% (10K/200K tokens)
/export - 导出对话
将对话历史导出为Markdown文件,便于:
- 文档记录
- 知识分享
- 复现问题
- 学习参考
使用方式:
# 导出到文件
/export conversation.md
# 导出到剪贴板(不指定文件名)
/export
# 导出后查看
cat conversation.md
导出格式示例:
# Claude Code Conversation
Date: 2025-12-25
## User
创建一个React组件
## Claude
I'll create a React component for you...
[代码内容]
## User
添加状态管理
## Claude
I'll add state management...
/context - 查看上下文使用
实时监控上下文窗口的使用情况,帮助你:
- 了解还能容纳多少代码
- 决定是否需要压缩对话
- 优化大型项目的工作方式
使用示例:
/context
# 输出:
# Context Usage Visualization
# ================================
# Total: 200,000 tokens
# Used: 45,234 tokens (22.6%)
#
# Distribution:
# - System prompt: 1,200 tokens (0.6%)
# - CLAUDE.md: 3,500 tokens (1.8%)
# - Files: 28,534 tokens (14.3%)
# - Conversation: 12,000 tokens (6.0%)
#
# [████████░░░░░░░░░░] 22.6%
何时使用:
- 处理大型文件时
- 对话轮次较多时
- 感觉响应变慢时
- 使用
/compact之前
/compact - 压缩对话
智能压缩对话历史,保留重要信息,释放上下文空间。
基本用法:
# 自动压缩
/compact
# 带聚焦指令的压缩
/compact focus on authentication changes
/compact keep database schema discussions
工作原理:
- 分析对话历史
- 识别关键决策和代码更改
- 删除冗余内容
- 生成简洁的摘要
使用场景:
# 场景:长时间开发后上下文快满了
你: /context
# Context usage: 88% (176K/200K tokens)
你: /compact focus on API changes and database schema
# Claude会压缩对话,保留API和数据库相关的讨论
你: /context
# Context usage: 35% (70K/200K tokens)
/model - 切换模型
在不同的Claude模型之间切换,适应不同场景:
- Sonnet:平衡性能和速度,日常开发
- Opus:最强能力,复杂任务
- Haiku:最快速度,简单任务
使用方式:
# 查看可用模型
/model
# 切换到Opus 4.5(最强)
/model opus-4
# 切换到Sonnet(平衡)
/model sonnet
# 切换到Haiku(快速)
/model haiku
使用建议:
# 复杂架构设计 → Opus
/model opus-4
你: 设计一个微服务架构,包含用户服务、订单服务、支付服务
# 日常开发 → Sonnet
/model sonnet
你: 添加一个新的API端点
# 简单修复 → Haiku
/model haiku
你: 修复这个拼写错误
/cost - 查看使用成本
显示当前会话和历史的token使用情况:
/cost
# 输出示例:
# Token Usage Statistics
# =====================
# Current Session:
# Input tokens: 12,450
# Output tokens: 8,320
# Total cost: $0.62
#
# Today:
# Sessions: 5
# Total tokens: 125,600
# Total cost: $3.15
#
# This Month:
# Sessions: 87
# Total tokens: 2,458,900
# Total cost: $58.34
/usage - 查看配额使用
检查你的订阅计划使用情况:
/usage
# 输出示例:
# Plan Usage (Pro Plan)
# =====================
# Messages sent: 1,245 / 10,000
# Rate limit: 25 messages per 5 minutes
#
# Current period: Dec 1 - Dec 31
# Resets in: 6 days
#
# Extended thinking usage:
# Normal thinking: 823 messages
# Deep thinking: 422 messages
/review - 代码审查
请求Claude进行代码审查:
/review
# Claude会:
# 1. 检查最近的代码更改
# 2. 分析代码质量
# 3. 提供改进建议
# 4. 标注潜在问题
输出示例:
Code Review Report
==================
Files Reviewed: 3
- src/auth.js
- src/api/users.js
- tests/auth.test.js
Findings:
🔴 Critical Issues (1):
- auth.js:45 - Password stored in plain text
Recommendation: Use bcrypt for password hashing
🟡 Warnings (3):
- users.js:23 - Missing error handling in async function
- users.js:67 - SQL injection vulnerability
- auth.test.js:12 - Test missing edge case
🟢 Suggestions (5):
- Consider extracting validation logic
- Add JSDoc comments to public methods
- Use const instead of let where possible
/init - 初始化项目
为项目创建CLAUDE.md配置文件:
/init
# Claude会询问:
# - 项目类型(Web App, CLI Tool, Library等)
# - 技术栈(React, Python, etc.)
# - 编码规范(Airbnb, Standard, etc.)
# - 项目约定
生成的CLAUDE.md示例:
# Project: My Web App
## Tech Stack
- Frontend: React 18 + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL
- Testing: Jest
## Coding Standards
- Use TypeScript strict mode
- Follow Airbnb style guide
- Write unit tests for all business logic
- Use functional components with hooks
## Project Structure
/src
/components - React components
/api - API routes
/utils - Utility functions
/types - TypeScript types
/todos - 任务管理
列出当前的TODO项:
/todos
# 输出:
# Current TODO Items
# ==================
#
# In Progress (1):
# ⏳ Implementing user authentication
#
# Pending (3):
# ☐ Add input validation
# ☐ Write unit tests
# ☐ Update documentation
#
# Completed (2):
# ✓ Set up database connection
# ✓ Create user model
/mcp - MCP服务器管理
管理Model Context Protocol服务器连接:
/mcp
# 选项:
# 1. List connected servers
# 2. Add new server
# 3. Remove server
# 4. Test connection
# 5. View server capabilities
创建自定义Slash命令
自定义命令是Slash系统最强大的功能。你可以创建符合自己工作流程的命令。
项目命令 vs 个人命令
项目命令(团队共享):
- 位置:
.claude/commands/ - 特点:随项目版本控制,团队成员共享
- 标识:在
/help中显示(project) - 用途:项目特定的工作流程
个人命令(个人使用):
- 位置:
~/.claude/commands/ - 特点:跨项目使用,个人偏好
- 标识:在
/help中显示(user) - 用途:个人习惯和常用操作
创建第一个自定义命令
示例1:简单的代码优化命令
# 创建命令目录
mkdir -p .claude/commands
# 创建命令文件
cat > .claude/commands/optimize.md << 'EOF'
分析这段代码的性能问题并提供优化建议:
请关注:
1. 时间复杂度
2. 空间复杂度
3. 不必要的循环或计算
4. 可以缓存的结果
5. 可以并行化的操作
提供具体的优化代码实现。
EOF
使用:
你: /optimize
# 然后粘贴或选择要优化的代码
示例2:带参数的命令
创建一个修复issue的命令:
cat > .claude/commands/fix-issue.md << 'EOF'
修复issue #$ARGUMENTS
请按以下步骤进行:
1. 理解issue的描述和复现步骤
2. 定位相关代码
3. 分析根本原因
4. 实现修复
5. 添加测试用例防止回归
6. 更新相关文档
EOF
使用:
/fix-issue 123
# $ARGUMENTS 会被替换为 "123"
示例3:多个参数的命令
创建PR审查命令:
cat > .claude/commands/review-pr.md << 'EOF'
---
argument-hint: [pr-number] [priority] [assignee]
description: Review pull request with priority
---
审查PR #$1,优先级:$2,分配给:$3
审查重点:
1. 代码质量和风格
2. 安全性问题
3. 性能影响
4. 测试覆盖率
5. 文档完整性
请提供详细的审查报告和改进建议。
EOF
使用:
/review-pr 456 high alice
# $1=456, $2=high, $3=alice
高级命令:集成Bash和Git
示例4:智能Git提交
cat > .claude/commands/commit.md << 'EOF'
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a smart git commit
---
## 当前状态
- Git状态: !`git status`
- 暂存变更: !`git diff --cached`
- 未暂存变更: !`git diff`
- 当前分支: !`git branch --show-current`
- 最近提交: !`git log --oneline -5`
## 任务
基于上述变更,创建一个符合规范的git commit:
1. 分析变更内容和影响范围
2. 编写清晰的commit message(使用约定式提交格式)
3. 如果有未暂存的相关变更,先添加到暂存区
4. 执行提交
Commit message格式:
type(scope): subject
body
footer
类型:feat, fix, docs, style, refactor, test, chore
EOF
使用效果:
你: /commit
Claude分析:
- 检测到3个文件变更
- 主要是认证功能的改进
- 修复了一个安全漏洞
Claude执行:
git add src/auth.js src/middleware/verify.js tests/auth.test.js
git commit -m "fix(auth): prevent timing attack in token verification
- Use constant-time comparison for token validation
- Add rate limiting to authentication endpoints
- Update tests to cover security scenarios
Closes #234"
示例5:完整的测试工作流
cat > .claude/commands/test-feature.md << 'EOF'
---
allowed-tools: Bash(npm test:*), Bash(npm run:*), Bash(git:*)
argument-hint: [feature-name]
description: Complete testing workflow for a feature
---
## 测试工作流:$ARGUMENTS
### 第一步:分析功能
1. 找到 $ARGUMENTS 相关的代码文件
2. 理解功能的输入、输出和边界情况
3. 识别需要测试的场景
### 第二步:编写测试
创建测试用例覆盖:
- ✓ 正常流程(happy path)
- ✓ 边界条件
- ✓ 错误处理
- ✓ 边缘情况
### 第三步:运行测试
执行命令:!`npm test -- --coverage`
### 第四步:分析结果
检查:
- 所有测试是否通过
- 代码覆盖率是否达标(>80%)
- 是否有遗漏的场景
### 第五步:生成报告
总结测试结果和改进建议。
EOF
使用Frontmatter配置
Frontmatter允许你精细控制命令的行为:
---
# 允许的工具(安全限制)
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
# 参数提示(帮助文档)
argument-hint: [pr-number] [reviewer]
# 命令描述
description: Submit PR for code review
# 指定使用的模型
model: claude-3-5-haiku-20241022
# 禁止Claude自动调用此命令
disable-model-invocation: false
---
你的命令内容...
Frontmatter字段说明:
| 字段 | 说明 | 示例 |
|---|---|---|
allowed-tools | 限制命令可使用的工具 | Bash(git:*) |
argument-hint | 显示参数提示 | [file] [line] |
description | 命令简短描述 | Fix linting errors |
model | 指定AI模型 | claude-3-opus-4 |
disable-model-invocation | 禁止自动调用 | true |
命令中的特殊语法
1. 参数引用
# 所有参数
$ARGUMENTS
# 单个参数
$1, $2, $3, ...
# 示例
/command arg1 arg2 arg3
# $ARGUMENTS = "arg1 arg2 arg3"
# $1 = "arg1"
# $2 = "arg2"
# $3 = "arg3"
2. Bash命令执行
使用 ! 前缀执行bash命令并插入结果:
当前分支:!`git branch --show-current`
当前时间:!`date`
文件数量:!`find . -name "*.js" | wc -l`
3. 文件引用
使用 @ 引用文件:
分析 @src/utils/helpers.js 中的问题
对比这两个文件:
- @src/old-version.js
- @src/new-version.js
命令组合使用示例
场景1:完整的功能开发流程
# 1. 清空上下文,开始新功能
/clear
# 2. 创建功能分支并开发
你: 创建一个用户认证功能
# 3. 查看上下文使用情况
/context
# 4. 如果上下文较多,压缩一下
/compact focus on authentication implementation
# 5. 运行测试
/test-feature authentication
# 6. 代码审查
/review
# 7. 创建智能提交
/commit
# 8. 导出开发记录
/export auth-feature-development.md
场景2:bug修复工作流
# 1. 修复issue
/fix-issue 789
# 2. 运行相关测试
你: 运行与此bug相关的测试
# 3. 安全审查
/security-review
# 4. 提交修复
/commit
# 5. 查看成本
/cost
场景3:代码重构
# 1. 审查当前代码
/review
# 2. 优化性能
/optimize
# 3. 运行完整测试套件
你: 运行所有测试确保没有破坏功能
# 4. 查看变更
你: 显示所有修改的文件
# 5. 分步提交
/commit
创建自己的命令库
通用命令库结构
建议的目录结构:
.claude/commands/
├── workflow/ # 工作流命令
│ ├── feature.md # 新功能开发
│ ├── bugfix.md # bug修复
│ └── refactor.md # 代码重构
├── git/ # Git相关
│ ├── commit.md # 智能提交
│ ├── pr.md # PR创建
│ └── release.md # 发布管理
├── test/ # 测试相关
│ ├── unit.md # 单元测试
│ ├── e2e.md # 端到端测试
│ └── coverage.md # 覆盖率检查
├── review/ # 代码审查
│ ├── security.md # 安全审查
│ ├── performance.md # 性能审查
│ └── style.md # 代码风格
└── docs/ # 文档相关
├── api.md # API文档
├── readme.md # README生成
└── changelog.md # 变更日志
实用命令模板库
1. 新功能开发模板
---
# .claude/commands/workflow/feature.md
argument-hint: [feature-name]
description: Complete workflow for new feature development
---
## 功能开发:$ARGUMENTS
### 阶段1:规划设计
1. 理解需求和用户场景
2. 设计技术方案
3. 评估技术风险
4. 制定开发计划
### 阶段2:实现开发
1. 创建功能分支:!`git checkout -b feature/$ARGUMENTS`
2. 编写核心代码
3. 添加错误处理
4. 实现日志记录
### 阶段3:测试验证
1. 编写单元测试
2. 执行集成测试
3. 检查代码覆盖率
4. 进行手动测试
### 阶段4:代码审查
1. 自我审查代码质量
2. 检查安全性问题
3. 验证性能影响
4. 更新相关文档
### 阶段5:提交发布
1. 创建commit:!`git add .`
2. 生成变更日志
3. 创建Pull Request
4. 通知团队审查
2. 性能优化模板
---
# .claude/commands/review/performance.md
description: Comprehensive performance analysis and optimization
---
## 性能优化分析
### 当前性能指标
执行性能分析:!`npm run benchmark`
### 分析重点
1. **算法复杂度**
- 识别O(n²)及以上的算法
- 寻找优化机会
2. **内存使用**
- 检查内存泄漏
- 优化大对象处理
3. **数据库查询**
- N+1查询问题
- 索引优化机会
4. **网络请求**
- 批量请求机会
- 缓存策略
5. **渲染性能**(前端)
- 不必要的重渲染
- 组件优化
### 优化建议
提供3-5个具体的优化方案,包括:
- 问题描述
- 预期收益
- 实现难度
- 代码示例
3. 安全审查模板
---
# .claude/commands/review/security.md
description: Security vulnerability scan and remediation
---
## 安全审查清单
### 1. 输入验证
- [ ] 所有用户输入都经过验证
- [ ] 使用白名单而非黑名单
- [ ] 适当的长度和格式限制
### 2. 认证和授权
- [ ] 密码安全存储(bcrypt/argon2)
- [ ] Session管理安全
- [ ] JWT token正确实现
- [ ] 权限检查完整
### 3. 数据保护
- [ ] 敏感数据加密
- [ ] HTTPS强制使用
- [ ] SQL注入防护
- [ ] XSS防护
### 4. 依赖安全
执行安全扫描:!`npm audit`
### 5. 错误处理
- [ ] 不泄露敏感信息
- [ ] 适当的错误日志
- [ ] 用户友好的错误消息
### 扫描结果
分析代码并生成:
1. 🔴 高危问题列表
2. 🟡 中危问题列表
3. 🟢 最佳实践建议
4. 修复优先级排序
4. API文档生成模板
---
# .claude/commands/docs/api.md
argument-hint: [endpoint-path]
description: Generate comprehensive API documentation
---
## API文档:$ARGUMENTS
### 端点信息
**URL**: `$ARGUMENTS`
**方法**: [自动检测]
**认证**: [是/否]
### 请求参数
#### Headers
```json
{
"Content-Type": "application/json",
"Authorization": "Bearer <token>"
}
Path Parameters
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| [自动提取] |
Query Parameters
| 参数 | 类型 | 必需 | 默认值 | 描述 |
|---|---|---|---|---|
| [自动提取] |
Body Parameters
[自动生成示例]
响应格式
成功响应 (200)
[自动生成示例]
错误响应
| 状态码 | 说明 | 响应示例 |
|---|---|---|
| 400 | Bad Request | |
| 401 | Unauthorized | |
| 404 | Not Found | |
| 500 | Server Error |
使用示例
cURL
[自动生成]
JavaScript
[自动生成]
Python
[自动生成]
注意事项
[提取相关的注意事项和最佳实践]
## 团队共享命令的方法
### 方法1:Git版本控制(推荐)
**优点**:
- 自动同步
- 版本历史
- 代码审查
- 易于回滚
**实施步骤**:
1. **创建命令目录**:
```bash
mkdir -p .claude/commands
- 添加到Git:
git add .claude/commands/
git commit -m "feat: add team slash commands"
git push
- 团队成员拉取:
git pull
# 命令自动可用
- 更新命令:
# 编辑命令
vim .claude/commands/review.md
# 提交更新
git add .claude/commands/review.md
git commit -m "feat: improve review command"
git push
方法2:共享文档
- 创建团队命令文档:
# team-commands.md
## 安装命令
bash
# 克隆团队命令库
git clone https://github.com/your-team/claude-commands.git ~/.claude/team-commands
# 链接到项目
ln -s ~/.claude/team-commands/* .claude/commands/
- 维护命令库仓库:
claude-commands/
├── README.md
├── workflow/
├── git/
├── test/
└── review/
方法3:配置文件共享
在CLAUDE.md中记录团队命令:
# CLAUDE.md
## 团队Slash命令
### /feature [name]
开发新功能的完整工作流
位置:`.claude/commands/workflow/feature.md`
### /commit
智能Git提交
位置:`.claude/commands/git/commit.md`
### /review
代码审查
位置:`.claude/commands/review/security.md`
## 安装说明
bash
cp docs/commands/* .claude/commands/
最佳实践
-
命名规范:
- 使用清晰、描述性的名称
- 避免过长的命令名
- 保持一致的命名风格
-
文档完善:
- 每个命令都有描述
- 提供使用示例
- 说明参数含义
-
版本管理:
- 重大更新要通知团队
- 保持向后兼容
- 记录变更日志
-
权限控制:
- 限制危险操作的工具权限
- 使用
allowed-tools字段
-
持续优化:
- 收集团队反馈
- 定期审查和更新
- 删除不再使用的命令
高级技巧
技巧1:命令链式调用
在CLAUDE.md中配置自动调用:
# CLAUDE.md
当我说"完成功能开发"时,请依次执行:
1. /review - 代码审查
2. /test-feature - 运行测试
3. /commit - 创建提交
4. /export - 导出开发日志
技巧2:条件命令
---
# .claude/commands/smart-commit.md
description: Smart commit based on changes
---
## 分析变更
当前状态:!`git status --short`
## 决策
如果变更包含:
- `.test.js` 文件 → 提交类型:test
- `.md` 文件 → 提交类型:docs
- `package.json` → 提交类型:chore
- 其他 → 提交类型:feat/fix(根据内容判断)
创建相应的提交。
技巧3:交互式命令
---
# .claude/commands/interactive-feature.md
description: Interactive feature development
---
## 功能开发向导
我会问你几个问题来更好地开发这个功能:
1. **功能名称**是什么?
2. **主要用途**是什么?
3. **目标用户**是谁?
4. 有哪些**技术限制**或**依赖**?
5. **优先级**如何(高/中/低)?
请逐一回答,我会根据你的回答制定开发计划。
技巧4:动态参数生成
---
# .claude/commands/fix-latest-issue.md
description: Fix the most recent open issue
---
## 获取最新Issue
最新的开放Issue:!`gh issue list --limit 1 --json number,title`
## 修复流程
基于上述Issue,执行修复流程...
技巧5:模板变量
创建可重用的模板:
---
# .claude/commands/api-endpoint.md
argument-hint: [resource-name]
description: Generate complete REST API endpoint
---
## 创建 $ARGUMENTS API端点
### 生成文件:
1. **Controller**: `src/controllers/$ARGUMENTSController.js`
- GET /api/$ARGUMENTS
- GET /api/$ARGUMENTS/:id
- POST /api/$ARGUMENTS
- PUT /api/$ARGUMENTS/:id
- DELETE /api/$ARGUMENTS/:id
2. **Model**: `src/models/$ARGUMENTS.js`
- Schema定义
- Validation规则
3. **Routes**: `src/routes/$ARGUMENTS.js`
- 路由配置
- 中间件绑定
4. **Tests**: `tests/$ARGUMENTS.test.js`
- CRUD操作测试
- 验证测试
完成后运行测试:!`npm test tests/$ARGUMENTS.test.js`
常见问题
Q1: 命令不生效怎么办?
检查步骤:
# 1. 验证命令文件存在
ls .claude/commands/your-command.md
# 2. 检查文件格式
cat .claude/commands/your-command.md
# 3. 重新加载命令
/help
# 4. 检查权限
ls -la .claude/commands/
Q2: 如何调试命令?
# 在命令中添加调试信息
---
description: Debug command
---
## 调试信息
参数1: $1
参数2: $2
所有参数: $ARGUMENTS
工作目录: !`pwd`
Git状态: !`git status`
[命令内容...]
Q3: 命令可以访问环境变量吗?
可以,通过bash命令:
当前用户: !`echo $USER`
Node版本: !`node --version`
自定义变量: !`echo $MY_VAR`
Q4: 如何限制命令权限?
使用allowed-tools:
---
allowed-tools: Bash(git status:*), Bash(git diff:*)
---
只能查看Git状态,不能执行提交或推送。
Q5: 命令可以嵌套调用吗?
不能直接嵌套,但可以在CLAUDE.md中配置工作流:
# CLAUDE.md
执行完整审查流程:
1. 先运行 /review
2. 然后运行 /security-review
3. 最后运行 /performance
总结
Slash命令系统是Claude Code最强大的效率工具:
核心优势:
- ✅ 30+内置命令覆盖常见需求
- ✅ 完全可定制的命令系统
- ✅ 支持团队协作和共享
- ✅ 灵活的参数和bash集成
- ✅ 安全的权限控制
使用建议:
- 从内置命令开始,熟悉基本用法
- 识别重复性任务,创建自定义命令
- 用Git共享团队命令
- 持续优化和改进命令库
- 利用frontmatter实现高级功能
学习路径:
- 掌握常用内置命令(/help, /clear, /context等)
- 创建第一个简单命令
- 学习参数和bash集成
- 构建完整的工作流命令
- 分享给团队使用
通过合理使用Slash命令,可以把重复性工作自动化,提升开发效率,建立标准化的工作流程。开始创建你的命令库吧!