Skip to content

Claude How ToClaude How To

Claude Code 功能目录

一份关于 Claude Code 所有功能的快速参考:命令、agents、skills、plugins 和 hooks。

导航: 命令 | 权限模式 | Subagents | Skills | Plugins | MCP Servers | Hooks | Memory | 2026 年 3 月新功能


概览

功能内置示例总数参考
Slash Commands55+863+01-slash-commands/README.md
Subagents6101604-subagents/README.md
Skills5 个内置4903-skills/README.md
Plugins-3307-plugins/README.md
MCP Servers18905-mcp/README.md
Hooks25 个事件7706-hooks/README.md
Memory7 种类型3302-memory/README.md
总计9943117

斜杠命令

命令是用户手动触发的快捷操作,用来执行特定任务。

内置命令

命令说明适用场景
/help显示帮助信息开始上手、学习命令
/btw提出不写入上下文的插话问题临时补充问题
/chrome配置 Chrome 集成浏览器自动化
/clear清空对话历史重新开始、减少上下文
/diff交互式 diff 查看器审查变更
/config查看/编辑配置自定义行为
/status显示会话状态检查当前状态
/agents列出可用 agents查看委派选项
/skills列出可用 skills查看可自动触发的能力
/hooks列出已配置的 hooks调试自动化
/insights分析会话模式优化会话使用
/install-slack-app安装 Claude Slack 应用Slack 集成
/keybindings自定义键盘快捷键按键定制
/mcp列出 MCP servers检查外部集成
/memory查看已加载的 memory 文件调试上下文加载
/mobile生成移动端二维码手机访问
/passes查看使用通行证订阅信息
/plugin管理 plugins安装/移除扩展
/plan进入规划模式复杂实现
/rewind回退到 checkpoint撤销变更、探索替代方案
/checkpoint管理 checkpoints保存/恢复状态
/cost显示 token 消耗监控开销
/context显示上下文窗口使用情况管理对话长度
/export导出对话保存以供参考
/extra-usage配置额外用量限制限流管理
/feedback提交反馈或 bug 报告报告问题
/login通过 Anthropic 认证访问功能
/logout登出切换账号
/sandbox切换 sandbox 模式安全执行命令
/doctor运行诊断排查问题
/reload-plugins重新加载已安装的 plugins插件管理
/release-notes显示更新说明查看新功能
/remote-control启用远程控制远程访问
/permissions管理权限控制访问
/session管理会话多会话工作流
/rename重命名当前会话组织会话
/resume恢复之前的会话继续工作
/todo查看/管理待办列表跟踪任务
/tasks查看后台任务监控异步操作
/copy复制最后一次回复到剪贴板快速分享输出
/teleport将会话转移到另一台机器远程继续工作
/desktop打开 Claude Desktop 应用切换桌面界面
/theme更改颜色主题自定义外观
/usage显示 API 使用统计监控配额和消耗
/fork分叉当前对话探索替代方案
/stats显示会话统计查看会话指标
/statusline配置状态栏自定义状态显示
/stickers查看会话贴纸趣味奖励
/fast切换快速输出模式加快响应
/terminal-setup配置终端集成设置终端特性
/upgrade检查更新版本管理

自定义命令(示例)

命令说明适用场景作用域安装
/optimize分析代码以做优化性能改进项目cp 01-slash-commands/optimize.md .claude/commands/
/pr准备 Pull Request提交 PR 前项目cp 01-slash-commands/pr.md .claude/commands/
/generate-api-docs生成 API 文档编写 API 文档项目cp 01-slash-commands/generate-api-docs.md .claude/commands/
/commit结合上下文创建 git commit提交变更用户cp 01-slash-commands/commit.md .claude/commands/
/push-all先暂存、提交再 push快速发布用户cp 01-slash-commands/push-all.md .claude/commands/
/doc-refactor重构文档结构改进文档项目cp 01-slash-commands/doc-refactor.md .claude/commands/
/setup-ci-cd搭建 CI/CD 流水线新项目项目cp 01-slash-commands/setup-ci-cd.md .claude/commands/
/unit-test-expand扩展测试覆盖率改进测试项目cp 01-slash-commands/unit-test-expand.md .claude/commands/

作用域: User = 个人工作流(~/.claude/commands/),Project = 团队共享(.claude/commands/

参考: 01-slash-commands/README.md | 官方文档

快速安装(所有自定义命令)

bash
cp 01-slash-commands/*.md .claude/commands/

权限模式

Claude Code 提供 6 种权限模式,用来控制工具调用如何被授权。

模式说明适用场景
default每次工具调用都询问标准交互式使用
acceptEdits自动接受文件编辑,其他情况仍询问可信编辑工作流
plan只允许只读工具,不允许写入规划与探索
auto不再提示,自动接受所有工具完全自主运行(Research Preview)
bypassPermissions跳过所有权限检查CI/CD、无头环境
dontAsk跳过需要权限的工具非交互脚本

注意auto 模式是 Research Preview 功能(2026 年 3 月)。只有在可信且已隔离的环境中才使用 bypassPermissions

参考: 官方文档


Subagents

为特定任务准备的专门化 AI 助手,拥有隔离上下文。

内置 Subagents

Agent说明工具模型适用场景
general-purpose多步任务、研究所有工具继承当前模型复杂研究、多文件任务
Plan实现规划Read、Glob、Grep、Bash继承当前模型架构设计、规划
Explore代码库探索Read、Glob、GrepHaiku 4.5快速搜索、理解代码
Bash命令执行Bash继承当前模型git 操作、终端任务
statusline-setup状态栏配置Bash、Read、WriteSonnet 4.6配置状态栏显示
Claude Code Guide帮助与文档Read、Glob、GrepHaiku 4.5获取帮助、学习功能

Subagent 配置字段

字段类型说明
namestringagent 标识
descriptionstring这个 agent 的用途
modelstring模型覆盖值(例如 haiku-4.5
toolsarray允许使用的工具列表
effortstring推理强度等级(lowmediumhigh
initialPromptstringagent 启动时注入的 system prompt
disallowedToolsarray明确禁止该 agent 使用的工具

自定义 Subagents(示例)

Agent说明适用场景作用域安装
code-reviewer全面的代码质量检查代码审查会话项目cp 04-subagents/code-reviewer.md .claude/agents/
code-architect功能架构设计新功能规划项目cp 04-subagents/code-architect.md .claude/agents/
code-explorer深入分析代码库理解已有功能项目cp 04-subagents/code-explorer.md .claude/agents/
clean-code-reviewer按 Clean Code 原则审查可维护性审查项目cp 04-subagents/clean-code-reviewer.md .claude/agents/
test-engineer测试策略与覆盖率测试规划项目cp 04-subagents/test-engineer.md .claude/agents/
documentation-writer技术文档编写API 文档、指南项目cp 04-subagents/documentation-writer.md .claude/agents/
secure-reviewer面向安全的审查安全审计项目cp 04-subagents/secure-reviewer.md .claude/agents/
implementation-agent完整功能实现功能开发项目cp 04-subagents/implementation-agent.md .claude/agents/
debugger根因分析Bug 调查用户cp 04-subagents/debugger.md .claude/agents/
data-scientistSQL 查询、数据分析数据任务用户cp 04-subagents/data-scientist.md .claude/agents/

作用域: User = 个人(~/.claude/agents/),Project = 团队共享(.claude/agents/

参考: 04-subagents/README.md | 官方文档

快速安装(所有自定义 agents)

bash
cp 04-subagents/*.md .claude/agents/

Skills

可自动触发的能力包,包含说明、脚本和模板。

示例 Skills

Skill说明何时自动触发作用域安装
code-review全面的代码审查“Review this code”, “Check quality”项目cp -r 03-skills/code-review .claude/skills/
brand-voice品牌一致性检查器编写营销文案时项目cp -r 03-skills/brand-voice .claude/skills/
doc-generatorAPI 文档生成器“Generate docs”, “Document API”项目cp -r 03-skills/doc-generator .claude/skills/
refactor系统化代码重构(Martin Fowler)“Refactor this”, “Clean up code”用户cp -r 03-skills/refactor ~/.claude/skills/

作用域: User = 个人(~/.claude/skills/),Project = 团队共享(.claude/skills/

Skill 结构

~/.claude/skills/skill-name/
├── SKILL.md          # skill 定义与说明
├── scripts/          # 辅助脚本
└── templates/        # 输出模板

Skill Frontmatter 字段

Skills 支持在 SKILL.md 中使用 YAML frontmatter 进行配置:

字段类型说明
namestringskill 显示名称
descriptionstring这个 skill 的作用
autoInvokearray自动触发的关键词
effortstring推理强度等级(lowmediumhigh
shellstring脚本使用的 shell(bashzshsh

参考: 03-skills/README.md | 官方文档

快速安装(所有 skills)

bash
cp -r 03-skills/* ~/.claude/skills/

内置 Skills

Skill说明何时自动触发
/simplify审查代码质量写完代码后
/batch对多个文件运行提示词批量操作
/debug调试失败的测试/错误调试会话
/loop按间隔运行提示词周期性任务
/claude-api使用 Claude API 构建应用API 开发

Plugins

把 commands、agents、MCP servers 和 hooks 打包在一起的集合。

示例 Plugins

Plugin说明组件适用场景作用域安装
pr-reviewPR 审查工作流3 个 commands、3 个 agents、GitHub MCP代码审查项目/plugin install pr-review
devops-automation部署与监控4 个 commands、3 个 agents、K8s MCPDevOps 任务项目/plugin install devops-automation
documentation文档生成套件4 个 commands、3 个 agents、模板文档编写项目/plugin install documentation

作用域: Project = 团队共享,User = 个人工作流

Plugin 结构

.claude-plugin/
├── plugin.json       # manifest 文件
├── commands/         # Slash commands
├── agents/           # Subagents
├── skills/           # Skills
├── mcp/              # MCP 配置
├── hooks/            # Hook 脚本
└── scripts/          # 工具脚本

参考: 07-plugins/README.md | 官方文档

Plugin 管理命令

bash
/plugin list              # 列出已安装的 plugins
/plugin install <name>    # 安装 plugin
/plugin remove <name>     # 移除 plugin
/plugin update <name>     # 更新 plugin

MCP Servers

用于访问外部工具和 API 的 Model Context Protocol servers。

常见 MCP Servers

Server说明适用场景作用域安装
GitHubPR 管理、issues、代码GitHub 工作流项目claude mcp add github -- npx -y @modelcontextprotocol/server-github
DatabaseSQL 查询、数据访问数据库操作项目claude mcp add db -- npx -y @modelcontextprotocol/server-postgres
Filesystem高级文件操作复杂文件任务用户claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem
Slack团队沟通通知、更新项目在设置中配置
Google Docs文档访问文档编辑、审阅项目在设置中配置
Asana项目管理任务跟踪项目在设置中配置
Stripe支付数据财务分析项目在设置中配置
Memory持久记忆跨会话回忆用户在设置中配置
Context7库文档查找最新文档内置内置

作用域: Project = 团队(.mcp.json),User = 个人(~/.claude.json),Built-in = 预装

MCP 配置示例

json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

参考: 05-mcp/README.md | MCP 协议文档

快速安装(GitHub MCP)

bash
export GITHUB_TOKEN="your_token" && claude mcp add github -- npx -y @modelcontextprotocol/server-github

Hooks

在 Claude Code 事件发生时执行的事件驱动自动化。

Hook 事件

事件说明触发时机使用场景
SessionStart会话开始/恢复会话初始化初始化任务
InstructionsLoaded指令已加载CLAUDE.md 或规则文件加载自定义指令处理
UserPromptSubmit提示词提交前用户发送消息输入校验
PreToolUse工具执行前任意工具运行之前校验、日志
PermissionRequest显示权限对话框敏感操作前自定义审批流程
PostToolUse工具成功后任意工具完成后格式化、通知
PostToolUseFailure工具执行失败工具报错后错误处理、日志
Notification发送通知时Claude 发送通知外部提醒
SubagentStart启动 subagentsubagent 任务开始初始化上下文
SubagentStopsubagent 完成subagent 任务结束链式动作
StopClaude 完成响应响应完成清理、汇报
StopFailureAPI 错误导致结束API 错误发生错误恢复、日志
TeammateIdle队友 agent 空闲agent team 协调分配工作
TaskCompleted任务标记完成任务完成任务后处理
TaskCreated通过 TaskCreate 创建任务新任务创建任务追踪、日志
ConfigChange配置更新设置被修改响应配置变化
CwdChanged当前工作目录变化目录切换目录级初始化
FileChanged监控文件发生变化文件被修改文件监控、重建
PreCompact压缩前上下文压缩前状态保留
PostCompact压缩完成后压缩完成压缩后动作
WorktreeCreateworktree 创建中git worktree 创建设置 worktree 环境
WorktreeRemoveworktree 被移除git worktree 删除清理 worktree 资源
ElicitationMCP server 请求输入MCP elicitation输入校验
ElicitationResult用户响应 elicitation用户回答响应处理
SessionEnd会话结束会话终止清理、保存状态

示例 Hooks

Hook说明事件作用域安装
validate-bash.py命令校验PreToolUse:Bash项目cp 06-hooks/validate-bash.py .claude/hooks/
security-scan.py安全扫描PostToolUse:Write项目cp 06-hooks/security-scan.py .claude/hooks/
format-code.sh自动格式化PostToolUse:Write用户cp 06-hooks/format-code.sh ~/.claude/hooks/
validate-prompt.py提示词校验UserPromptSubmit项目cp 06-hooks/validate-prompt.py .claude/hooks/
context-tracker.pytoken 使用跟踪Stop用户cp 06-hooks/context-tracker.py ~/.claude/hooks/
pre-commit.sh提交前校验PreToolUse:Bash项目cp 06-hooks/pre-commit.sh .claude/hooks/
log-bash.sh命令日志记录PostToolUse:Bash用户cp 06-hooks/log-bash.sh ~/.claude/hooks/

作用域: Project = 团队(.claude/settings.json),User = 个人(~/.claude/settings.json

Hook 配置

json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "~/.claude/hooks/validate-bash.py"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "command": "~/.claude/hooks/format-code.sh"
      }
    ]
  }
}

参考: 06-hooks/README.md | 官方文档

快速安装(所有 hooks)

bash
mkdir -p ~/.claude/hooks && cp 06-hooks/*.sh ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.sh

Memory Files

会在多个会话之间自动加载的持久上下文。

Memory 类型

类型位置作用域适用场景
Managed Policy组织管理的策略Organization统一组织标准
Project./CLAUDE.mdProject(团队)团队规范、项目上下文
Project Rules.claude/rules/Project(团队)模块化项目规则
User~/.claude/CLAUDE.mdUser(个人)个人偏好
User Rules~/.claude/rules/User(个人)模块化个人规则
Local./CLAUDE.local.mdLocal(git 忽略)机器特定覆盖(截至 2026 年 3 月不在官方文档中,可能是历史遗留)
Auto Memory自动Session自动捕捉的洞察和修正

作用域: Organization = 管理员管理,Project = 通过 git 与团队共享,User = 个人偏好,Local = 不提交,Session = 自动管理

参考: 02-memory/README.md | 官方文档

快速安装

bash
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

2026 年 3 月新功能

功能说明使用方式
Remote Control通过 API 远程控制 Claude Code 会话使用远程控制 API 以编程方式发送提示并接收响应
Web Sessions在浏览器环境中运行 Claude Code通过 claude web 或 Anthropic Console 访问
Desktop AppClaude Code 的原生桌面应用使用 /desktop 或从 Anthropic 网站下载
Agent Teams协调多个 agent 共同处理相关任务配置协作并共享上下文的 teammate agents
Task List后台任务管理与监控使用 /tasks 查看和管理后台操作
Prompt Suggestions上下文感知的命令建议根据当前上下文自动出现建议
Git Worktrees用于并行开发的隔离 git worktree使用 worktree 命令进行安全的并行分支工作
Sandboxing安全隔离的执行环境使用 /sandbox 切换,在受限环境中运行命令
MCP OAuth为 MCP servers 提供 OAuth 认证在 MCP server 设置中配置 OAuth 凭据以安全访问
MCP Tool Search动态搜索和发现 MCP 工具使用工具搜索查找已连接 server 上可用的 MCP 工具
Scheduled Tasks使用 /loop 和 cron 工具设置周期任务使用 /loop 5m /command 或 CronCreate 工具
Chrome Integration使用无头 Chromium 做浏览器自动化使用 --chrome 标志或 /chrome 命令
Keyboard Customization自定义按键映射并支持 chord使用 /keybindings 或编辑 ~/.claude/keybindings.json
自动模式(Auto Mode)无需权限提示的完全自主运行(Research Preview)使用 --mode auto/permissions auto;2026 年 3 月
通道(Channels)多通道通信(Telegram、Slack 等)(Research Preview)配置 channel plugins;2026 年 3 月
语音输入(Voice Dictation)用语音输入提示词使用麦克风图标或语音快捷键
Agent Hook Type触发 subagent 而不是执行 shell 命令的 hook在 hook 配置中设置 "type": "agent"
Prompt Hook Type将 prompt 文本注入对话的 hook在 hook 配置中设置 "type": "prompt"
MCP ElicitationMCP servers 可在工具执行期间请求用户输入通过 ElicitationElicitationResult hook 事件处理
WebSocket MCP Transport用 WebSocket 连接 MCP server在 MCP server 配置中使用 "transport": "websocket"
Plugin LSP Support通过 plugins 集成 Language Server Protocolplugin.json 中配置 LSP servers,以获得编辑器能力
Managed Drop-ins组织管理的 drop-in 配置(v2.1.83)通过 managed policies 由管理员配置,自动应用到所有用户

快速参考矩阵

功能选择指南

需求推荐功能原因
快捷命令Slash Command手动、立即执行
持久上下文Memory自动加载
复杂自动化Skill自动触发
专门任务Subagent隔离上下文
外部数据MCP Server实时访问
事件自动化Hook事件触发
完整解决方案Plugin一体化打包

安装优先级

优先级功能命令
1. 必装Memorycp 02-memory/project-CLAUDE.md ./CLAUDE.md
2. 日常使用Slash Commandscp 01-slash-commands/*.md .claude/commands/
3. 质量提升Subagentscp 04-subagents/*.md .claude/agents/
4. 自动化Hookscp 06-hooks/*.sh ~/.claude/hooks/
5. 集成MCP Serversclaude mcp add github -- npx -y @modelcontextprotocol/server-github
6. 全量打包Plugins/plugin install <name>

一条命令完成安装

bash
# 创建目录
mkdir -p .claude/commands .claude/agents ~/.claude/hooks ~/.claude/skills

# 安装所有功能
cp 01-slash-commands/*.md .claude/commands/
cp 04-subagents/*.md .claude/agents/
cp -r 03-skills/* ~/.claude/skills/
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# 配置 MCP
export GITHUB_TOKEN="your_token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 使用 Plugins
/plugin install pr-review
/plugin install devops-automation

其他资源


最后更新: 2026 年 4 月 9 日 Claude Code 版本: 2.1.97