Claude Code
完全手册

什么是 Slash Commands？

Slash Commands 是用户在 Claude Code 中主动输入的快捷操作，例如 /help、/model、/rewind。

常见内建命令

命令	用途
/help	查看帮助
/clear	清空当前对话
/config	查看或编辑配置
/agents	查看可用 agents
/skills	查看可用 skills
/hooks	查看 hooks
/mcp	查看或管理 MCP servers
/plugin	管理 plugins
/plan	进入 planning mode
/rewind	回退到 checkpoint

更多命令（含 /branch、/export、/insights、/memory、/usage、/stats 等）的用法说明与示例见 官方教程 · 命令参考；请以本机 /help 为准。

自定义 Slash Command

# 创建命令文件
mkdir -p .claude/commands
cat > .claude/commands/my-command.md << 'EOF'
---
name: my-command
description: 我的自定义命令
---

请帮我完成以下任务：
1. 分析当前代码
2. 提供优化建议
EOF

# 使用
# /my-command

什么是 Memory？

Memory 是 Claude Code 用来长期加载规则和上下文的机制。通过 CLAUDE.md 文件定义。

三种 Memory 层级

示例 CLAUDE.md

# 项目规则

## 代码规范
- 使用 TypeScript strict mode
- 遵循 ESLint 规则
- 测试覆盖率 > 80%

## 架构说明
- 前端: React + Vite
- 后端: Node.js + Express
- 数据库: PostgreSQL

## 工作流
- 提交前运行: npm run lint && npm test
- PR 需要 1 个以上 review

什么是 Skills？

Skills 是 Claude Code 会根据描述自动触发的复用能力。它们比单个 slash command 更适合长期维护的工作流。

Skill 目录结构

.claude/skills/skill-name/
├── SKILL.md        # 技能定义文件
├── scripts/        # 脚本目录
└── templates/      # 模板目录

SKILL.md 示例

---
name: code-review
description: 代码审查技能
effort: medium
---

## 触发条件
当用户请求代码审查时自动触发

## 审查步骤
1. 检查代码风格
2. 分析潜在问题
3. 提供优化建议
4. 生成审查报告

什么是 Hooks？

Hooks 是事件驱动的自动化动作，适合在关键节点做检查、拦截和通知。

常见应用场景

• 提交前自动运行测试
• 修改代码后自动格式化
• 敏感操作前的安全检查
• 操作后的日志记录

Hook 配置示例

# ~/.claude/settings.json
{
  "hooks": {
    "PreCommit": [
      {
        "type": "command",
        "command": "npm run lint && npm test"
      }
    ],
    "PostFileEdit": [
      {
        "type": "command",
        "command": "prettier --write ${file}"
      }
    ]
  }
}

Hook 类型

类型	说明
command	执行 shell 命令
http	发送 HTTP 请求
prompt	插入提示文本
agent	触发子代理

什么是 MCP？

MCP (Model Context Protocol) 是一种协议，让 Claude Code 连接外部工具、服务和实时数据。

MCP 配置示例

# .mcp.json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "$GITHUB_TOKEN"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    }
  }
}

常用 MCP Servers

Server	用途
github	GitHub API 集成
filesystem	文件系统访问
postgres	PostgreSQL 数据库
sqlite	SQLite 数据库

什么是 Subagents？

Subagents 是专门负责某类任务的子代理，适合复杂任务拆分。

内建 Subagents

名称	用途
general-purpose	通用复杂任务
Plan	方案设计
Explore	快速搜索与理解代码

自定义 Subagent

# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: 代码质量审查专家
model: sonnet
tools:
  - Read
  - Grep
  - Glob
---

你是一个专业的代码审查员。
请检查代码质量、潜在问题和最佳实践。

什么是 Plugins？

Plugins 把 slash commands、skills、hooks、MCP、subagents 组合成一套方案，方便团队分发。

Plugin 目录结构

plugin-name/
├── .claude-plugin/
│   └── plugin.json    # 插件清单
├── commands/          # slash commands
├── agents/            # subagents
├── hooks/             # hooks
├── mcp/               # MCP 配置
└── scripts/           # 脚本

plugin.json 示例

{
  "name": "pr-review",
  "version": "1.0.0",
  "description": "PR 审查工作流插件",
  "license": "MIT"
}

安装插件

# 安装
/plugin install pr-review

# 或从 URL 安装
/plugin install https://github.com/user/plugin