Skip to content

Claude How ToClaude How To

Claude Code 示例 - 速查卡

🚀 安装速命令

Slash Commands

bash
# 安装全部
cp 01-slash-commands/*.md .claude/commands/

# 安装单个
cp 01-slash-commands/optimize.md .claude/commands/

Memory

bash
# 项目 memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 个人 memory
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

Skills

bash
# 个人 skills
cp -r 03-skills/code-review ~/.claude/skills/

# 项目 skills
cp -r 03-skills/code-review .claude/skills/

Subagents

bash
# 安装全部
cp 04-subagents/*.md .claude/agents/

# 安装单个
cp 04-subagents/code-reviewer.md .claude/agents/

MCP

bash
# 设置凭据
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# 安装配置(项目级)
cp 05-mcp/github-mcp.json .mcp.json

# 或者用户级:添加到 ~/.claude.json

Hooks

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

# 在 settings 中配置(~/.claude/settings.json)

Plugins

bash
# 从示例安装(如果已发布)
/plugin install pr-review
/plugin install devops-automation
/plugin install documentation

Checkpoints

bash
# 每次用户提示后都会自动创建 checkpoint
# 回退:按两次 Esc 或使用:
/rewind

# 然后选择:恢复代码和对话、恢复对话、
# 恢复代码、从这里开始总结,或算了

Advanced Features

bash
# 在 settings 中配置(.claude/settings.json)
# 参见 09-advanced-features/config-examples.json

# planning mode
/plan 任务描述

# 权限模式(使用 --permission-mode 参数)
# default          - 风险操作需要审批
# acceptEdits      - 自动接受文件编辑,其他操作仍需审批
# plan             - 只读分析,不做修改
# dontAsk          - 除危险操作外全部接受
# auto             - 后台分类器自动决定权限
# bypassPermissions - 全部接受(需要 --dangerously-skip-permissions)

# 会话管理
/resume                # 恢复之前的对话
/rename "name"         # 命名当前会话
/fork                  # 分叉当前会话
claude -c              # 继续最近的对话
claude -r "session"    # 按名称/ID 恢复会话

📋 功能速览

功能安装路径用法
Slash Commands(55+).claude/commands/*.md/command-name
Memory./CLAUDE.md自动加载
Skills.claude/skills/*/SKILL.md自动触发
Subagents.claude/agents/*.md自动委派
MCP.mcp.json(项目)或 ~/.claude.json(用户)/mcp__server__action
Hooks(25 个事件)~/.claude/hooks/*.sh事件触发(4 类)
Plugins通过 /plugin install打包所有能力
Checkpoints内置Esc+Esc/rewind
Planning Mode内置/plan <task>
Permission Modes(6 种)内置--allowedTools--permission-mode
Sessions内置/session <command>
Background Tasks内置在后台运行
Remote Control内置WebSocket API
Web Sessions内置claude web
Git Worktrees内置/worktree
Auto Memory内置自动保存到 CLAUDE.md
Task List内置/task list
Bundled Skills(5 个)内置/simplify/loop/claude-api/voice/browse

🎯 常见使用场景

代码审查

bash
# 方法 1:slash command
cp 01-slash-commands/optimize.md .claude/commands/
# 使用:/optimize

# 方法 2:subagent
cp 04-subagents/code-reviewer.md .claude/agents/
# 使用:自动委派

# 方法 3:skill
cp -r 03-skills/code-review ~/.claude/skills/
# 使用:自动触发

# 方法 4:插件(推荐)
/plugin install pr-review
# 使用:/review-pr

文档

bash
# slash command
cp 01-slash-commands/generate-api-docs.md .claude/commands/

# subagent
cp 04-subagents/documentation-writer.md .claude/agents/

# skill
cp -r 03-skills/doc-generator ~/.claude/skills/

# 插件(完整方案)
/plugin install documentation

DevOps

bash
# 完整插件
/plugin install devops-automation

# 命令:/deploy、/rollback、/status、/incident

团队规范

bash
# 项目 memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 按你的团队规范编辑
vim CLAUDE.md

自动化与 Hooks

bash
# 安装 hooks(25 个事件,4 类:command、http、prompt、agent)
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# 示例:
# - 提交前测试:pre-commit.sh
# - 自动格式化代码:format-code.sh
# - 安全扫描:security-scan.sh

# 用 Auto Mode 实现全自动工作流
claude --enable-auto-mode -p "重构并测试 auth 模块"
# 或者用 Shift+Tab 在模式间切换

安全重构

bash
# 每次提示前都会自动创建 checkpoint
# 试着重构
# 如果成功:继续
# 如果失败:按 Esc+Esc 或使用 /rewind 返回

复杂实现

bash
# 使用 planning mode
/plan 实现用户认证系统

# Claude 会创建详细计划
# 你可以审阅并批准
# Claude 会系统化地执行实现

CI/CD 集成

bash
# 以 headless 模式运行(非交互)
claude -p "运行所有测试并生成报告"

# 在 CI 中搭配权限模式
claude -p "运行测试" --permission-mode dontAsk

# 使用 Auto Mode 实现完全自治的 CI 任务
claude --enable-auto-mode -p "运行测试并修复失败项"

# 结合 hooks 做自动化
# 参见 09-advanced-features/README.md

学习与实验

bash
# 用 plan mode 做安全分析
claude --permission-mode plan

# 安全实验 - checkpoint 会自动创建
# 如果需要回退:按 Esc+Esc 或使用 /rewind

Agent 团队

bash
# 启用 agent 团队
export CLAUDE_AGENT_TEAMS=1

# 或者在 settings.json 中
{ "agentTeams": { "enabled": true } }

# 用这句话开始:"使用团队方式实现功能 X"

定时任务

bash
# 每 5 分钟运行一次命令
/loop 5m /check-status

# 一次性提醒
/loop 30m "提醒我检查部署"

📁 文件位置参考

text
Your Project/
├── .claude/
│   ├── commands/              # Slash commands 放这里
│   ├── agents/                # Subagents 放这里
│   ├── skills/                # 项目 skills 放这里
│   └── settings.json          # 项目设置(hooks 等)
├── .mcp.json                  # MCP 配置(项目级)
├── CLAUDE.md                  # 项目 memory
└── src/
    └── api/
        └── CLAUDE.md          # 目录级 memory

User Home/
├── .claude/
│   ├── commands/              # 个人命令
│   ├── agents/                # 个人 agents
│   ├── skills/                # 个人 skills
│   ├── hooks/                 # hook 脚本
│   ├── settings.json          # 用户设置
│   ├── managed-settings.d/    # 托管设置(企业/组织)
│   └── CLAUDE.md              # 个人 memory
└── .claude.json               # 个人 MCP 配置(用户级)

🔍 查找示例

按分类

  • Slash Commands01-slash-commands/
  • Memory02-memory/
  • Skills03-skills/
  • Subagents04-subagents/
  • MCP05-mcp/
  • Hooks06-hooks/
  • Plugins07-plugins/
  • Checkpoints08-checkpoints/
  • Advanced Features09-advanced-features/
  • CLI10-cli/

按使用场景

  • 性能01-slash-commands/optimize.md
  • 安全04-subagents/secure-reviewer.md
  • 测试04-subagents/test-engineer.md
  • 文档03-skills/doc-generator/
  • DevOps07-plugins/devops-automation/

按复杂度

  • 简单:Slash commands
  • 中等:Subagents、Memory
  • 高级:Skills、Hooks
  • 完整:Plugins

🎓 学习路径

第 1 天

bash
# 阅读总览
cat README.md

# 安装一个命令
cp 01-slash-commands/optimize.md .claude/commands/

# 试用
/optimize

第 2-3 天

bash
# 设置 memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
vim CLAUDE.md

# 安装 subagent
cp 04-subagents/code-reviewer.md .claude/agents/

第 4-5 天

bash
# 设置 MCP
export GITHUB_TOKEN="your_token"
cp 05-mcp/github-mcp.json .mcp.json

# 试用 MCP 命令
/mcp__github__list_prs

第 2 周

bash
# 安装 skill
cp -r 03-skills/code-review ~/.claude/skills/

# 让它自动触发
# 直接说:“Review this code for issues”

第 3 周及以后

bash
# 安装完整插件
/plugin install pr-review

# 使用打包功能
/review-pr
/check-security
/check-tests

🆕 新功能(2026 年 3 月)

功能说明用法
Auto Mode通过后台分类器实现完全自治--enable-auto-mode 参数,Shift+Tab 切换模式
ChannelsDiscord 和 Telegram 集成--channels 参数,Discord / Telegram bot
Voice Dictation对 Claude 说出命令和上下文/voice 命令
Hooks(25 个事件)扩展后的 hook 系统,包含 4 类command、http、prompt、agent hook 类型
MCP ElicitationMCP server 可在运行时请求用户输入当 server 需要澄清时自动提示
WebSocket MCPMCP 的 WebSocket 传输.mcp.json 中配置 ws:// URL
Plugin LSP插件支持 Language Server ProtocoluserConfig${CLAUDE_PLUGIN_DATA} 变量
Remote Control通过 WebSocket API 控制 Claude Codeclaude --remote 用于外部集成
Web Sessions基于浏览器的 Claude Code 接口使用 claude web 打开
Desktop App原生桌面应用从 claude.ai/download 下载
Task List管理后台任务/task list/task status <id>
Auto Memory从对话中自动保存记忆Claude 会自动保存关键上下文到 CLAUDE.md
Git Worktrees用于并行开发的隔离工作区使用 /worktree 创建隔离空间
Model Selection在 Sonnet 4.6 和 Opus 4.6 之间切换/model--model 参数
Agent Teams协调多个 agent 执行任务通过环境变量 CLAUDE_AGENT_TEAMS=1 启用
Scheduled Tasks使用 /loop 运行周期任务/loop 5m /command 或 CronCreate 工具
Chrome Integration浏览器自动化--chrome 参数或 /chrome 命令
Keyboard Customization自定义按键绑定/keybindings 命令

💡 小技巧

自定义

  • 先原样使用示例
  • 再按需求修改
  • 分享给团队前先测试
  • 对配置做版本控制

最佳实践

  • 用 memory 保存团队规范
  • 用 plugins 做完整工作流
  • 用 subagents 处理复杂任务
  • 用 slash commands 处理快速任务

故障排查

bash
# 检查文件位置
ls -la .claude/commands/
ls -la .claude/agents/

# 验证 YAML 语法
head -20 .claude/agents/code-reviewer.md

# 测试 MCP 连接
echo $GITHUB_TOKEN

📊 功能矩阵

需求用这个示例
快速快捷操作Slash Command(55+)01-slash-commands/optimize.md
团队规范Memory02-memory/project-CLAUDE.md
自动化工作流Skill03-skills/code-review/
专门任务Subagent04-subagents/code-reviewer.md
外部数据MCP(+ Elicitation、WebSocket)05-mcp/github-mcp.json
事件自动化Hook(25 个事件、4 类)06-hooks/pre-commit.sh
完整方案Plugin(+ LSP 支持)07-plugins/pr-review/
安全实验Checkpoint08-checkpoints/checkpoint-examples.md
完全自治Auto Mode--enable-auto-modeShift+Tab
聊天集成Channels--channels(Discord、Telegram)
CI/CD 流水线CLI10-cli/README.md

🔗 快速链接

  • 主指南README.md
  • 完整索引INDEX.md
  • 速查卡QUICK_REFERENCE.md
  • 原始指南claude_concepts_guide.md

📞 常见问题

问:我应该先用哪个? 答:先从 slash commands 开始,按需逐步添加功能。

问:我可以混用多个功能吗? 答:可以!它们可以一起工作。Memory + Commands + MCP 很强大。

问:怎么分享给团队? 答:把 .claude/ 目录提交到 git。

问:敏感信息怎么办? 答:用环境变量,不要硬编码。

问:我可以改这些示例吗? 答:当然可以!它们本来就是可定制的模板。


✅ 检查清单

入门清单:

  • 阅读 README.md
  • 安装 1 个 slash command
  • 试用该命令
  • 创建项目 CLAUDE.md
  • 安装 1 个 subagent
  • 配置 1 个 MCP 集成
  • 安装 1 个 skill
  • 试用一个完整插件
  • 按你的需求定制
  • 与团队共享

快速开始cat README.md

完整索引cat INDEX.md

这张卡片:建议随手保留,方便快速查阅!