完整参考指南，包含命令、快捷键、配置、插件、技能、MCP 集成和自动化工作流。
快速入门
通过 curl 安装（macOS/Linux）
推荐安装方式
curl -fsSL https://claude.ai/install.sh | bash
通过 PowerShell 安装（Windows）
在 Windows 上使用 PowerShell 安装
irm https://claude.ai/install.ps1 | iex
通过 npm 安装
使用 npm 全局安装（需要 Node.js 18+）
npm install -g @anthropic-ai/claude-code
启动 Claude 代码
在您的项目中启动 Claude 代码
cd your-project && claude
更新到最新版本
保持 Claude 代码最新
claude update
键盘快捷键
| 快捷键 | 功能说明 |
| ! | Bash 模式前缀 |
| @ | 引用文件/文件夹 |
| \ | 换行符（反斜杠 + 回车） |
| Esc | 中断 Claude 响应 |
| Esc+Esc | 打开回滚菜单（撤销更改） |
| Ctrl+R | 显示完整输出/上下文 |
| Ctrl+V | 粘贴图片 |
| Shift+Tab | 自动接受（"yolo 模式"） |
| Shift+Tab+Tab | 计划模式 |
| Cmd+Esc / Ctrl+Esc | 在 IDE 中快速启动 |
| Cmd+Option+K / Alt+Ctrl+K | 插入文件引用 |
配置管理
配置文件位置（优先级顺序）
企业级:/etc/claude-code/managed-settings.json (最高优先级)
项目本地:.claude/settings.local.json (个人设置，Git 忽略)
项目共享:.claude/settings.json (团队设置)
用户全局:~/.claude/settings.json (个人默认设置)
查看所有设置
列出当前配置
claude config list
获取设置值
检查特定设置
claude config get <键名>
设置配置
更改设置值
claude config set <键名> <值>
添加到列表设置
向数组类设置（如权限）添加值
claude config add <键名> <值>
从列表中移除
从数组设置中移除值
claude config remove <键名> <值>
检查点 - 撤销与回滚
自动安全网
Claude 代码自动跟踪所有文件编辑，让您在出现问题时快速恢复到之前的状态。
回滚命令
| 命令 | 说明 |
| Esc+Esc | 打开回滚菜单恢复之前的状态 |
| /rewind | 通过斜杠命令打开回滚菜单 |
回滚选项
| 选项 | 说明 |
| 自动跟踪 | 每次用户提示都会创建新检查点 |
| 对话回滚 | 恢复到之前的用户消息，同时保留代码 |
| 代码回滚 | 恢复文件更改，同时保留对话 |
| 完全回滚 | 同时恢复代码和对话到之前状态 |
限制
Bash 更改无法追踪： 通过 bash 命令（rm, mv, cp）修改的文件无法撤销
外部更改无法追踪： Claude 代码外的手动编辑不会被捕获
非版本控制： 检查点是对 Git 的补充，但不能替代它
使用检查点进行快速恢复，使用 Git 进行永久历史记录
斜杠命令 - 交互式会话控制
交互式会话命令
在 Claude 代码聊天界面中直接输入命令来控制 Claude 的行为。
内置命令
| 命令 | 说明 |
| /add-dir | 添加额外工作目录 |
| /agents | 管理自定义 AI 子代理进行专项任务 |
| /bug | 报告错误（发送对话给 Anthropic） |
| /clear | 清除对话历史 |
| /compact [指令] | 压缩对话并可选聚焦指令 |
| /config | 查看/修改配置 |
| /cost | 显示令牌使用统计 |
| /doctor | 检查 Claude 代码安装状态 |
| /help | 获取使用帮助 |
| /init | 使用 CLAUDE.md 指南初始化项目 |
| /login | 切换 Anthropic 账户 |
| /logout | 登出 Anthropic 账户 |
| /mcp | 管理 MCP 服务器连接和 OAuth 认证 |
| /memory | 编辑 CLAUDE.md 记忆文件 |
| /model | 选择或更改 AI 模型 |
| /permissions | 查看或更新权限 |
| /pr_comments | 查看拉取请求评论 |
| /review | 请求代码审查 |
| /rewind | 回滚对话和/或代码 (Esc+Esc) |
| /sandbox | 启用带文件系统和网络隔离的安全沙箱工具 |
| /status | 查看账户和系统状态 |
| /terminal-setup | 安装 Shift+Enter 键绑定 (iTerm2/VSCode) |
| /usage | 显示计划使用限制和速率限制状态（仅订阅计划） |
| /vim | 进入 vim 模式进行交替插入/命令模式 |
自定义斜杠命令模板
基础项目命令
创建简单的项目特定命令，保存位置: .claude/commands/optimize.md
分析这段代码的性能问题并建议优化方案：
个人命令
创建适用于所有项目的用户级命令，保存位置: ~/.claude/commands/security-review.md
审查这段代码的安全漏洞：
带全部参数的命令
使用 $ARGUMENTS 占位符表示所有参数，保存位置: .claude/commands/fix-issue.md
按照我们的编码标准修复问题 #$ARGUMENTS
带位置参数的命令
使用 1,2, $3 表示单个参数，保存位置: .claude/commands/review-pr.md
--- 参数提示: [pr编号] [优先级] [负责人] 描述: 按优先级和负责人审查拉取请求 --- 审查 PR #$1，优先级 $2，分配给 $3。 重点关注安全性、性能和代码风格。
Git 提交命令
带 bash 执行和文件引用的高级命令，保存位置: .claude/commands/commit.md
--- 允许工具: Bash(git add:*), Bash(git status:*), Bash(git commit:*) 参数提示: [消息] 描述: 创建 git 提交 --- ## 上下文 - 当前 git 状态: !`git status` - 当前 git 差异: !`git diff HEAD` - 当前分支: !`git branch --show-current` - 近期提交: !`git log --oneline -10` ## 任务 基于以上更改，创建单个 git 提交。
带模型覆盖的命令
指定模型并禁用自动调用，保存位置: .claude/commands/deep-analysis.md
--- 描述: 执行深度代码分析 模型: claude-opus-4-1-20250805 禁用模型调用: true --- 对此代码库进行全面分析，重点关注： - 架构模式 - 潜在的可扩展性问题 - 安全漏洞 - 性能瓶颈
使用技巧
项目命令： 存储在 .claude/commands/ 中（与团队共享）
个人命令： 存储在 ~/.claude/commands/ 中（所有项目可用）
参数： 使用 $ARGUMENTS 占位符表示动态值
Bash 执行： 使用 !`命令` 在处理前运行命令
文件引用： 使用 @文件名 包含文件内容
MCP 命令： 格式: /mcp__服务器__提示名称
无头模式 - 程序化使用
非交互式运行 Claude 代码
使用 --print（或 -p）实现自动化、脚本和 CI/CD 管道。非常适合 SRE 机器人、自动代码审查和代理集成。
关键无头命令
| 命令 | 说明 |
| claude -p "查询" | 非交互模式，打印结果并退出 |
| claude -p --output-format json "查询" | 以 JSON 格式输出带元数据 |
| claude -p --output-format stream-json "查询" | 实时流式传输 JSON 消息 |
| claude -c -p "查询" | 非交互式继续最近对话 |
| claude --resume <会话ID> -p "查询" | 非交互式恢复特定会话 |
| `echo "查询" | claude -p` |
| claude --verbose -p "查询" | 启用详细日志用于调试 |
| claude --max-turns 3 -p "查询" | 在非交互模式中限制代理轮次 |
代理技能 - 模块化能力
什么是代理技能？
技能是扩展 Claude 功能的模块化能力。与斜杠命令（用户调用）不同，技能是模型调用的——Claude 会根据上下文自主使用它们。
位置:.claude/skills/ (项目) 或 ~/.claude/skills/ (个人)
结构: 包含 SKILL.md 的目录 + 可选脚本和资源
发现: 基于描述和上下文自动发现
技能设置命令
| 命令 | 说明 |
| mkdir -p .claude/skills/技能名称 | 创建项目技能目录 |
| mkdir -p ~/.claude/skills/技能名称 | 创建个人技能目录 |
| cat > .claude/skills/我的技能/SKILL.md | 创建技能定义文件 |
技能模板
简单技能
基础单文件技能 .claude/skills/commit-helper/SKILL.md
--- 名称: 生成提交消息 描述: 根据 git 差异生成清晰的提交消息。在编写提交消息或审查暂存更改时使用。 --- # 生成提交消息 ## 指令 1. 运行 `git diff --staged` 查看更改 2. 我将提供包含以下内容的提交消息： - 不超过 50 字符的摘要 - 详细描述 - 受影响的组件 ## 最佳实践 - 使用现在时 - 解释内容和原因，而非方式
带工具权限的技能
限制工具访问的技能 .claude/skills/code-reviewer/SKILL.md
--- 名称: 代码审查员 描述: 审查代码的最佳实践和潜在问题。在审查代码、检查 PR 或分析代码质量时使用。 允许工具: Read, Grep, Glob --- # 代码审查员 ## 审查清单 1. 代码组织和结构 2. 错误处理 3. 性能考虑 4. 安全问题 5. 测试覆盖率
技能与斜杠命令的区别
斜杠命令： 用户调用（输入 /命令），简单提示，单文件
代理技能： 模型调用（自动），复杂能力，多文件 + 脚本
使用技能处理综合工作流，使用命令处理快速提示
插件 - 扩展 Claude 代码
什么是插件？
插件通过自定义命令、代理、钩子、技能和 MCP 服务器扩展 Claude 代码。从市场安装或创建自己的插件。
插件管理命令
| 命令 | 说明 |
| /plugin | 打开插件管理界面 |
| /plugin marketplace add <URL或路径> | 添加插件市场 |
| /plugin install <名称>@<市场> | 从市场安装插件 |
| /plugin enable <名称>@<市场> | 启用禁用的插件 |
| /plugin disable <名称>@<市场> | 禁用插件但不卸载 |
| /plugin uninstall <名称>@<市场> | 完全移除插件 |
快速入门示例
添加 GitHub 市场
从 GitHub 添加插件市场
claude mcp add marketplace your-org/claude-plugins
安装插件
从市场安装特定插件
/plugin install formatter@your-org
本地开发市场
为插件开发添加本地市场
/plugin marketplace add ./dev-marketplace
插件功能
自定义命令： 为工作流添加斜杠命令
专业代理： 部署特定任务的专家子代理
代理技能： 打包 Claude 可发现的能力
自动化钩子： 在 Claude 代码事件上运行脚本
MCP 服务器： 连接到外部工具和服务
MCP 服务器与扩展
模型上下文协议 (MCP)
通过外部工具和集成扩展 Claude 代码。MCP 服务器提供浏览器自动化、数据库访问和 API 集成等额外功能。
MCP 管理命令
| 命令 | 说明 |
| claude mcp add <名称> <命令> [参数...] | 添加带命令的 MCP 服务器 |
| claude mcp add --transport sse <名称> <URL> | 添加 SSE 传输的 MCP 服务器 |
| claude mcp add --transport http <名称> <URL> | 添加 HTTP 传输的 MCP 服务器 |
| claude mcp list | 列出已安装的 MCP 服务器 |
| claude mcp remove <名称> | 移除 MCP 服务器 |
热门 MCP 集成
Airtable
读写记录，管理数据库和表格
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=您的密钥 -- npx -y airtable-mcp-server
Asana
与您的 Asana 工作区交互
claude mcp add --transport sse asana https://mcp.asana.com/sse
Atlassian
管理 Jira 工单和 Confluence 文档
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse
Box
访问企业内容并自动化工作流
claude mcp add --transport http box https://mcp.box.com/
Canva
浏览、总结、自动填充和生成 Canva 设计
claude mcp add --transport http canva https://mcp.canva.com/mcp
ClickUp
任务管理，项目跟踪
claude mcp add --transport stdio clickup --env CLICKUP_API_KEY=您的密钥 --env CLICKUP_TEAM_ID=您的团队 -- npx -y @hauptsache.net/clickup-mcp
Cloudflare
构建应用，分析流量，管理安全
claude mcp add --transport http cloudflare https://mcp.cloudflare.com/mcp
Cloudinary
上传、管理、转换媒体资源
claude mcp add --transport http cloudinary https://mcp.cloudinary.com/mcp
Daloopa
高质量基础财务数据
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcp
Figma
在完整 Figma 上下文中生成更好的代码
claude mcp add --transport http figma https://mcp.figma.com/mcp
Fireflies
从会议记录中提取见解
claude mcp add --transport http fireflies https://api.fireflies.ai/mcp
GitHub
管理仓库、PR 和问题
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
HubSpot
访问和管理 HubSpot CRM 数据
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic
Hugging Face
访问 Hugging Face Hub 和 Gradio 应用
claude mcp add --transport http huggingface https://huggingface.co/mcp
Intercom
访问客户对话和工单
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
invideo
构建视频创建能力
claude mcp add --transport sse invideo https://mcp.invideo.io/sse
Jam
通过访问 Jam 记录进行 AI 代理调试
claude mcp add --transport http jam https://mcp.jam.dev/mcp
Linear
问题跟踪和项目管理
claude mcp add --transport http linear https://mcp.linear.app/mcp
Monday
管理 monday.com 看板和项目
claude mcp add --transport http monday https://mcp.monday.com/mcp
Netlify
创建、部署和管理网站
claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp
Notion
阅读文档，更新页面，管理任务
claude mcp add --transport http notion https://mcp.notion.com/mcp
PayPal
支付处理和交易管理
claude mcp add --transport http paypal https://mcp.paypal.com/mcp
Plaid
银行数据和金融账户链接
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sse
Playwright
高级浏览器自动化
claude mcp add --transport stdio playwright -- npx @playwright/mcp@latest
Puppeteer
浏览器自动化
claude mcp add --transport stdio puppeteer -- npx -y @modelcontextprotocol/server-puppeteer
Sentry
监控错误，调试生产问题
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Socket
依赖项的安全分析
claude mcp add --transport http socket https://mcp.socket.dev/
Square
支付、库存、订单等
claude mcp add --transport sse square https://mcp.squareup.com/sse
Stripe
支付处理和订阅管理
claude mcp add --transport http stripe https://mcp.stripe.com
Stytch
配置和管理认证服务
claude mcp add --transport http stytch http://mcp.stytch.dev/mcp
Supabase
数据库操作
claude mcp add --transport stdio supabase --env SUPABASE_ACCESS_TOKEN=您的令牌 -- npx -y @supabase/mcp-server-supabase@latest
Vercel
管理项目、部署和日志
claude mcp add --transport http vercel https://mcp.vercel.com/
Workato
访问应用、工作流和数据
claude mcp add --transport http workato https://mcp.workato.com/mcp
Zapier
连接 8,000+ 应用
claude mcp add --transport http zapier https://mcp.zapier.com/mcp
Git 工作树 - 并行开发
为何在 Claude 代码中使用 Git 工作树？
无上下文丢失： 每个 Claude 会话保持完整的项目理解
并行工作： 在继续功能开发的同时处理热修复
安全实验： 在完全隔离的环境中测试高风险更改
模型比较： 在相同任务上运行不同 AI 模型
零切换成本： 不再需要 git stash、checkout、重启循环
基本工作树命令
| 命令 | 说明 |
| git worktree add <路径> <分支> | 使用现有分支创建工作树 |
| git worktree add <路径> -b <分支> <起点> | 使用新分支创建工作树 |
| git worktree list | 列出所有工作树及其分支 |
| git worktree remove <路径> | 移除工作树目录 |
| git worktree prune | 清理工作树引用 |
| git worktree move <工作树> <新路径> | 移动工作树到新位置 |
强大工作流示例
并行功能开发
同时处理多个功能
git worktree add ../myapp-auth -b feature/auth main git worktree add ../myapp-api -b feature/api main cd ../myapp-auth && claude cd ../myapp-api && claude
开发中处理热修复
在不丢失上下文的情况下处理紧急修复
git worktree add ../myapp-hotfix -b hotfix/critical main cd ../myapp-hotfix claude "修复关键错误" # 原始工作在主目录中继续
安全实验测试
在隔离环境中测试高风险更改
git worktree add ../myapp-experiment -b experiment/refactor main cd ../myapp-experiment claude "重构整个认证系统" # 如果失败，只需删除目录
模型比较
比较不同的 AI 实现
git worktree add ../ml-sonnet -b experiment/sonnet main git worktree add ../ml-opus -b experiment/opus main cd ../ml-sonnet && claude --model sonnet cd ../ml-opus && claude --model opus
代码审查准备
在不影响主要工作的情况下优化代码
git worktree add ../myapp-review -b review/cleanup feature-branch cd ../myapp-review claude "添加文档、测试并清理代码风格" git merge review/cleanup
子代理 - 专业 AI 助手
为何使用子代理？
上下文保留： 每个子代理与主对话有独立的上下文
专业专长： 为特定领域和任务微调的提示
可重用工作流： 跨项目并与团队共享子代理
工具控制： 为安全性按子代理授予特定工具访问权限
自动委派： Claude 主动使用合适的子代理
子代理位置
项目子代理：.claude/agents/ (最高优先级，团队共享)
用户子代理：~/.claude/agents/ (个人，所有项目)
文件格式： 带 YAML 前言的 Markdown
基本子代理命令
| 命令 | 说明 |
| /agents | 打开子代理管理界面 |
| claude "使用 [名称] 子代理来..." | 显式调用特定子代理 |
| mkdir -p .claude/agents | 创建项目子代理目录 |
| mkdir -p ~/.claude/agents | 创建用户子代理目录 |
开箱即用子代理模板
代码审查员
编写/修改代码后的专家代码审查 保存位置: .claude/agents/code-reviewer.md
--- 名称: 代码审查员 描述: 专家代码审查专员。主动审查代码质量、安全性和可维护性。在编写或修改代码后立即使用。 工具: Read, Grep, Glob, Bash 模型: 继承 --- 您是确保代码质量和安全性的高级代码审查员。 调用时： 1. 运行 git diff 查看近期更改 2. 关注修改的文件 3. 立即开始审查 审查清单： - 代码简洁易读 - 函数和变量命名恰当 - 无重复代码 - 正确的错误处理 - 无暴露的密钥或 API 密钥 - 已实现输入验证 - 良好的测试覆盖率 - 已处理性能问题 按优先级提供反馈： - 关键问题（必须修复） - 警告（应该修复） - 建议（考虑改进） 包含具体修复问题的示例。
调试器
针对错误和测试失败的调试专家 保存位置: .claude/agents/debugger.md
--- 名称: 调试器 描述: 错误、测试失败和意外行为的调试专家。在遇到任何问题时主动使用。 工具: Read, Edit, Bash, Grep, Glob 模型: sonnet --- 您是专门从事根本原因分析的专家调试员。 调用时： 1. 捕获错误信息和堆栈跟踪 2. 确定复现步骤 3. 隔离失败位置 4. 实施最小修复 5. 验证解决方案有效 调试流程： - 分析错误信息和日志 - 检查最近的代码更改 - 形成和测试假设 - 添加策略性调试日志 - 检查变量状态 对每个问题提供： - 根本原因解释 - 支持诊断的证据 - 具体代码修复 - 测试方法 - 预防建议 专注于修复根本问题，而非仅解决症状。
数据科学家
SQL 和 BigQuery 的数据分析专家 保存位置: .claude/agents/data-scientist.md
--- 名称: 数据科学家 描述: SQL 查询、BigQuery 操作和数据洞察的数据分析专家。在数据分析任务中主动使用。 工具: Bash, Read, Write 模型: opus --- 您是专门从事 SQL 和 BigQuery 分析的数据科学家。 调用时： 1. 理解数据分析需求 2. 编写高效的 SQL 查询 3. 在适当时使用 BigQuery 命令行工具 (bq) 4. 分析和总结结果 5. 清晰呈现发现 关键实践： - 编写带适当过滤器的优化 SQL 查询 - 使用合适的聚合和连接 - 包含解释复杂逻辑的注释 - 格式化结果以提高可读性 - 提供数据驱动的建议 始终确保查询高效且成本效益高。
使用技巧
自动调用： 在描述中包含"主动"或"必须使用"
显式调用："使用代码审查员子代理检查我的代码"
链式调用："先使用调试器再使用优化器子代理"
工具限制： 仅为安全和专注授予必要工具
团队共享： 将项目子代理纳入版本控制
子代理文件格式
--- 名称: 您的子代理名称 描述: 何时调用此子代理 工具: Read, Edit, Bash # 可选 - 如果省略则继承全部 --- 您的子代理系统提示在此处。 包含具体指令、示例和约束。 定义子代理在其领域内 解决问题的角色、能力和方法。
权限与安全
开箱即用权限模板
为不同安全级别复制完整的 settings.json 配置。保存到项目的 .claude/settings.json。
MCP 工具权限
不支持通配符：mcp__github__* 无效
批准服务器的所有工具："allow": ["mcp__github"]
批准特定工具："allow": ["mcp__github__get_issue"]
企业配置
托管设置：/etc/claude-code/managed-settings.json
托管 MCP：/etc/claude-code/managed-mcp.json
MCP 允许/拒绝列表： 通过 allowedMcpServers 和 deniedMcpServers 控制员工可使用的 MCP 服务器
拒绝列表优先级绝对高于允许列表
基础安全
阻止敏感文件，允许常见开发命令,大多数项目的良好起点
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(git status)",
"Bash(git diff)",
"Bash(git add *)",
"Bash(git commit *)"
],
"ask": [
"Bash(git push:*)",
"Bash(npm install *)"
],
"deny": [
"Read(./.env*)",
"Read(./secrets/**)",
"Read(./**/credentials*)",
"Bash(rm -rf:*)",
"Bash(curl:*)"
]
}
}严格安全
敏感项目的最高安全性,适用于生产系统或敏感代码库
{
"permissions": {
"ask": [
"Bash(*)",
"Write(*)",
"Edit(*)"
],
"deny": [
"Read(./.env*)",
"Read(./secrets/**)",
"Read(./config/**)",
"Read(./**/credentials*)",
"Read(./**/*.key)",
"Read(./**/*.pem)",
"WebFetch",
"Bash(curl:*)",
"Bash(wget:*)",
"Bash(ssh:*)"
]
}
}斜杠命令权限
控制 Claude 可调用的斜杠命令,限制自动命令执行
{
"permissions": {
"allow": [
"SlashCommand:/commit",
"SlashCommand:/review-pr:*"
],
"deny": [
"SlashCommand"
]
}
}企业 MCP 限制
企业 MCP 服务器允许/拒绝列表示例,控制可使用的 MCP 服务器
{
"allowedMcpServers": [
{
"serverName": "github"
},
{
"serverName": "sentry"
},
{
"serverName": "company-internal"
}
],
"deniedMcpServers": [
{
"serverName": "filesystem"
}
]
}钩子 - 自动化与控制
安全警告
钩子使用您的凭证自动执行 shell 命令。添加前务必审查钩子代码。恶意钩子可能损坏您的系统或窃取数据。 使用钩子自动化格式化、日志记录、通知和自定义权限，而非依赖 Claude 记住这些任务。
钩子事件
| 事件 | 说明 |
| PreToolUse | 在工具调用前运行（可阻止调用） |
| PostToolUse | 在工具调用完成后运行 |
| UserPromptSubmit | 在用户提交提示后、Claude 处理前运行 |
| Notification | 在 Claude 代码发送通知时运行 |
| Stop | 在 Claude 代码完成响应时运行 |
| SubagentStop | 在子代理任务完成时运行 |
| PreCompact | 在压缩操作前运行 |
| SessionStart | 在 Claude 代码启动/恢复会话时运行 |
| SessionEnd | 在 Claude 代码会话结束时运行 |
钩子管理命令
| 命令 | 说明 |
| /hooks | 打开钩子配置界面 |
| claude --debug | 运行调试输出查看钩子执行 |
| mkdir -p .claude/hooks | 创建项目钩子目录 |
| chmod +x .claude/hooks/script.sh | 使钩子脚本可执行 |
开箱即用钩子示例
自动格式化代码
在编辑文件上运行 prettier事件: PostToolUse匹配器: Edit|Write
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "npx prettier --write $FILE_PATH"
}
]
}
]
}
}记录活动
记录所有 Claude 会话活动事件: Stop
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "echo \"$(date): $CONVERSATION_SUMMARY\" >> ~/.claude/activity.log"
}
]
}
]
}
}钩子结构与技巧
设置位置：~/.claude/settings.json (用户) 或 .claude/settings.json (项目)
匹配器： 匹配工具名称（如 Bash, Edit|Write, *）
项目脚本： 相对路径使用 $CLAUDE_PROJECT_DIR
退出代码：0=成功, 2=阻止并显示给 Claude, 其他=错误
JSON 输入： 钩子通过 stdin 接收会话数据（使用 jq 解析）
调试： 使用 claude --debug 查看钩子执行详情
