Claude 使用指南

项目定位

Claude How To 是一套面向 Claude Code 的结构化、图解化、示例驱动教程。它不重复官方文档的功能罗列，而是通过 Mermaid 架构图、生产级模板和渐进式学习路径，帮助开发者理解各项能力如何组合使用。

项目针对三类常见问题：官方文档缺少端到端组合示例、各功能之间缺乏明确学习顺序、基础演示无法支撑代码审查与部署等真实工作流。完整路径包含 10 个模块，预计耗时 11 至 13 小时；初学者也可在约 15 分钟内完成首个可运行配置。

核心能力

教程覆盖斜杠命令、记忆、技能、子代理、MCP、钩子、插件、检查点、规划与后台任务、CLI。各类能力的职责如下：

• 斜杠命令：以 Markdown 文件保存可手动调用的快捷操作，如 /optimize、/pr。
• 记忆：通过项目、目录或个人 CLAUDE.md 自动加载持久上下文。
• 技能：由指令、脚本和模板组成的可复用能力，可在相关任务中自动触发。
• 子代理：在隔离上下文中处理代码审查、测试、文档和安全审查等专业任务。
• MCP：通过标准协议访问 GitHub、数据库和文件系统等外部数据或工具。
• 钩子：在工具调用、会话启动、任务完成等事件发生时自动执行命令、HTTP 请求、提示词或代理。
• 插件：将命令、代理、MCP 与钩子打包为完整解决方案。
• 检查点：保存会话状态，并通过 /rewind 恢复代码、对话或从指定节点创建探索分支。

快速安装与配置

推荐使用原生安装程序；npm 方式已不作为官方首选。企业代理需允许下载主机 downloads.claude.ai。

# macOS 或 Linux 原生安装
curl -fsSL https://claude.ai/install.sh | bash

# macOS 也可使用 Homebrew
brew install --cask claude-code

# Windows 可使用 WinGet
winget install Anthropic.ClaudeCode

克隆教程并安装首批配置：

git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 项目级斜杠命令
mkdir -p /path/to/project/.claude/commands
cp 01-slash-commands/*.md /path/to/project/.claude/commands/

# 项目记忆
cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md

# 个人技能
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# 子代理
cp 04-subagents/*.md /path/to/project/.claude/agents/

在 Claude Code 中调用 /optimize，或运行项目记忆后继续执行任务。

钩子配置示例

钩子通常配置在 ~/.claude/settings.json。例如，文件写入后自动格式化并执行安全扫描：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/format-code.sh"
          },
          {
            "type": "command",
            "command": "~/.claude/hooks/security-scan.sh"
          }
        ]
      }
    ]
  }
}

支持 command、http、prompt、mcp_tool 和 agent 五种执行类型；事件覆盖工具调用、会话生命周期、任务状态及配置变更等类别。

MCP、插件与 CLI

MCP 可通过 CLI 注册外部服务：

claude mcp add --transport http github \
  https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

本地插件通过仓库目录加载：

claude --plugin-dir ./07-plugins/pr-review
claude --plugin-dir ./07-plugins/devops-automation

CLI 支持交互、脚本化、文件输入与 JSON 输出：

claude "解释此项目"
claude -p "审查此代码"
cat error.log | claude -p "解释此错误"
claude -p --output-format json "列出所有函数"
claude -r "feature-auth" "继续实现"

高级模式还包括规划模式、扩展思考、后台任务、无头运行和细粒度权限控制，可用于 CI/CD、批量处理与复杂重构。

典型工作流

自动化代码审查通常先加载项目规范，再通过 GitHub MCP 获取变更，随后委派代码审查与测试子代理，最后汇总质量、测试和安全意见。部署流程则由部署前钩子校验环境，部署子代理结合 Kubernetes MCP 执行操作，后台监控进度，最后由部署后钩子完成健康检查。

最佳实践是从斜杠命令和记忆开始，逐步引入技能、钩子与 MCP；敏感凭据不得硬编码或提交，团队规范应纳入版本控制。项目采用 MIT 许可证，并提供离线 EPUB 生成：

uv run scripts/build_epub.py