Claude Code 使用技巧与 Skills 推荐指南

整理时间:2026-05-12 | 涵盖 Claude Code 4.6/4.7 版本


目录

  1. 核心工作流技巧
  2. CLAUDE.md 最佳实践
  3. Hooks 配置指南
  4. 模型选择与效率设置
  5. 斜杠命令速查表
  6. 键盘快捷键
  7. 推荐 Skills
  8. 推荐插件市场
  9. 推荐 MCP 服务
  10. 新项目快速上手流程
  11. 调试与恢复
  12. 参考资源

1. 核心工作流技巧

1.1 最重要的一条:给 Claude 验证自己工作的能力

这是被普遍引用为影响力最大的实践。如果 Claude 能通过测试、Lint、浏览器工具或 CLI 检查来闭环验证,它会持续迭代直到输出正确。

  • 前端开发:安装 Claude Code Chrome 扩展,Claude 可以查看渲染后的 UI
  • 通用开发:在提示中始终包含测试命令、Lint 检查或预期输出。Boris Cherny(Claude Code 构建者)表示仅此一项就能带来 2-3 倍的质量提升
  • LSP 插件:每次编辑后自动获得诊断信息。安装方式:/plugin install typescript-lsp@claude-plugins-official(或 pyright、rust-analyzer、gopls 等)
  • /simplify:修改后运行,会启动并行 agent 审查代码的复用性、质量和效率

1.2 Plan Mode(计划模式):编码前先设计

Shift+Tab 循环切换:Normal → Auto-Accept Edits → Plan Mode → Auto Mode。

Anthropic 团队推荐的模式:

  1. 进入 Plan Mode → 完善计划 → 切换到 Auto-Accept Edits → Claude 执行
  2. 让一个 Claude 编写计划,启动第二个 Claude 以资深工程师身份审查该计划
  3. 一旦出现问题,立即切回 Plan Mode 重新规划,而非在错误方向上修补
  4. 跳过 Plan Mode 的情况:如果能用一句话描述改动,直接做

1.3 并行工作(最大的生产力提升)

Git Worktrees(工作树)

claude --worktree                     # 在新 worktree 中隔离会话
claude --worktree my-worktree --tmux  # 命名的 worktree + tmux 会话

同时启动 3-5 个 Claude 会话,每个在自己的 worktree 中。许多工程师保留一个专门的"分析"worktree 仅用于阅读日志和查询。

/batch 大规模迁移:Claude 会采访你,然后将工作分发到数十/数百个 worktree agent,每个独立测试并创建自己的 PR。

Agent View:运行 claude agents 或按左箭头查看所有会话概览(哪些在等你、哪些仍在工作、哪些已完成)。

/fork <name>:创建完全隔离的对话分支,功能之间无上下文泄漏。

1.4 上下文管理:保持新鲜

  • /clear:每个新话题从零开始。干净的会话 + 精准的提示胜过混乱的 3 小时会话
  • /compact:在质量下降前主动压缩。在 CLAUDE.md 中添加:“Compacting 时保留完整的修改文件列表和当前测试状态”
  • 手交文档(Handoff):对于长任务,“将剩余计划写入 HANDOFF.md,解释哪些有效、哪些无效,让下一个有新鲜上下文的 agent 能接手”
  • /cost:每小时检查 token 使用量,设定心理预算
  • /btw:在 Claude 工作时快速提问,不污染主对话历史

1.5 提示技巧

提示 使用场景
“严格审查这些改动,在我通过你的测试之前不要创建 PR” 发布前
“向我证明这能正常工作” 通过 diff main vs feature 验证
“基于你现在知道的一切,废弃这个方案,用优雅的方式重新实现” 第一版不够好后
“用 subagents 来…” 投入更多算力解决问题
“展示每个修改文件的 diff,每个改动一句话解释” 发现不想要的编辑

2. CLAUDE.md 最佳实践

2.1 核心原则

CLAUDE.md 是建议性的(约 80% 遵守率),Hooks 是确定性的(100% 强制执行)。 不要用一个做另一个的工作。

2.2 文件位置层级

~/.claude/CLAUDE.md         # 用户级全局默认值(个人偏好)
./CLAUDE.md                 # 项目级(团队共享,签入 Git)
./CLAUDE.local.md           # 本地覆盖(自动 Git-ignored)
./.claude/rules/*.md        # 路径作用域模块化规则

2.3 包含与排除

包含每一行通过此测试的内容:“删除这一行会导致 Claude 犯错吗?”

包含 排除
Claude 猜不到的构建/测试命令 Claude 已知的标准约定(PEP 8、Prettier 默认值)
非默认代码风格规则 格式化规则(交给 Linter + Hooks)
架构约束和坑点 完整 API 文档(链接替代)
仓库礼仪(分支命名、PR 规则) 频繁变化的信息
测试指南和首选运行器 不言自明的指令如"写干净的代码"

2.4 结构建议

  • 控制在 200 行以内 — 冗长的文件会稀释关键指令
  • 谨慎使用强调标记IMPORTANTYOU MUST 在关键规则上可量化提升合规率,但如果所有内容都强调,就什么都不强调了
  • 使用 @imports 保持主文件精简:@docs/api-standards.md
  • CLAUDE.md 在 /compact 后仍然存在 — 在聊天中输入的指令不会。将持久规则放在文件中
  • 每发现 Claude 犯一次错,就更新一条规则:“将这条加入 CLAUDE.md 确保不再发生”

2.5 模板示例

# Commands
- 开发:`bun run dev`(端口 3000)
- 测试:`bun test`(单个:`bun test path/to/file`)
- Lint:`bun run lint`

# Architecture
- Next.js 15 App Router, PostgreSQL + Drizzle ORM
- Auth:Clerk 中间件应用于 /dashboard/*
- REST 约定见 @docs/api-patterns.md

# Workflow
- IMPORTANT:代码变更后始终进行类型检查
- 优先单测而非全量测试
- 永远不要直接推送到 main

# Gotchas
- YOU MUST NOT 编辑 /generated/ 中的文件
- /api/webhooks 路由必须保持不受保护

3. Hooks 配置指南

3.1 关键区分

方面 CLAUDE.md Hooks
性质 建议性(约 80% 遵守率) 确定性(100% 强制执行)
机制 注入系统提示;Claude 读取并尝试遵循 由运行时无条件执行的 Shell 命令
最适合 项目上下文、编码约定、架构指导 安全护栏、自动化、阻止危险模式

黄金法则: 如果某规则必须每次都执行(运行 Linter、阻止 rm -rf、保护敏感文件),放在 Hook 中,而非 CLAUDE.md。

3.2 配置范围

// .claude/settings.local.json  — 个人覆盖(Git-ignored)
// .claude/settings.json        — 团队共享(签入 Git)← 最有价值
// ~/.claude/settings.json      — 用户级全局默认值

3.3 核心 Hook 事件

事件 触发时机 可阻止? 常见用途
PreToolUse 工具执行前 阻止危险命令、保护文件
PostToolUse 工具成功后 自动格式化、运行 Linter、审计日志
Stop Claude 完成时 (强制继续) 防止搪塞式收尾
Notification Claude 发送通知时 长运行任务的桌面提醒
SessionStart 会话开始时 注入上下文(分支、项目、环境)

3.4 退出码

  • 0 → 允许(stdout 解析为 JSON 控制)
  • 2 → 阻止(stderr 作为错误信息反馈给 Claude)

3.5 实用 Hook 示例

阻止危险命令和保护文件

{
  "PreToolUse": [
    {
      "matcher": "Bash",
      "if": "tool_input.command matches 'rm -rf'",
      "hooks": [{
        "type": "command",
        "command": "echo 'BLOCKED: use trash instead' && exit 2"
      }]
    },
    {
      "matcher": "Write|Edit",
      "if": "tool_input.file_path matches '(\\.env|package-lock\\.json)'",
      "hooks": [{
        "type": "command",
        "command": "echo 'BLOCKED: protected file' && exit 2"
      }]
    }
  ]
}

保存时自动格式化(多语言)

{
  "PostToolUse": [{
    "matcher": "Write|Edit",
    "hooks": [{
      "type": "command",
      "command": "FILE=$(jq -r '.tool_input.file_path' /dev/stdin); case \"$FILE\" in *.ts|*.tsx) npx prettier --write \"$FILE\";; *.py) black \"$FILE\";; esac; exit 0"
    }]
  }]
}

4. 模型选择与效率设置

4.1 模型选择策略

场景 推荐模型
架构设计、调试、复杂决策 Opus + Extended Thinking
日常实现 Sonnet(快速、成本低)
简单任务 Haiku(最经济)

设置:/model opus/model sonnet/model haiku

4.2 思考努力级别

/effort 可选择:lowmediumhighmaxauto

  • high — 推荐默认值(Team/Enterprise 计划)
  • max — 用于困难调试/架构决策
  • 关键词 ultrathink — 触发约 32K token 推理预算的扩展思考。节约使用,适用于跨领域重构和架构决策

4.3 百万 Token 上下文窗口

Opus/Sonnet 4.6 支持 1M token 上下文(Max、Team、Enterprise 计划):

  • /model opus[1m]/model sonnet[1m]

5. 斜杠命令速查表

命令 功能
/init 扫描代码库,生成 CLAUDE.md
/compact 摘要对话,释放上下文
/clear 清除对话,重新开始
/cost 当前会话 token 使用量
/usage 速率限制仪表板
/stats GitHub 风格活动图 + 终身统计
/effort 设置智能水平(low/medium/high/max/auto)
/plan 进入计划模式(只读分析)
/permissions 预批准受信任的命令
/sandbox 切换操作系统级沙箱隔离
/memory 配置自动记忆系统
/simplify 审查已修改代码的质量/复用性
/loop 安排循环本地任务
/schedule 安排云端任务
/btw 快速提问,不污染上下文
/voice 按住说话语音输入
/copy 复制最后一条回复为 Markdown
/agents 浏览/创建自定义子代理
/mcp 管理 MCP 服务器连接
/plugin 浏览/安装插件
/chrome 切换浏览器集成
/config 配置输出样式和设置
/rewind 恢复检查点(代码、对话或两者)
/bg 将当前会话后台化到 Agent View

6. 键盘快捷键

快捷键 操作
Shift+Tab 循环:Normal → Auto-Accept → Plan → Auto
Esc 立即停止 Claude 操作(不丢失上下文)
Esc+Esc 打开 Rewind/检查点选择器
Ctrl+S 暂存当前草稿,快速提问,恢复草稿
Ctrl+B 将长时间运行的 bash 命令发送到后台
Ctrl+G 在文本编辑器中打开 Claude 的计划
! 前缀 立即运行终端命令(!git status!npm test

7. 推荐 Skills

7.1 技能市场平台

平台 规模 特点
SkillsMP.com 100,000+ Skills 最大聚合平台,智能分类 + AI 搜索 + 一键安装
tonssofskills.com 423 插件 / 2,849 Skills 开源市场,带 ccpi CLI 包管理器
GitHub Topic claude-code-skill 2,393+ 社区驱动,每日同步 GitHub

7.2 高星社区 Skills 仓库

仓库 Stars 说明
alirezarezvani/claude-skills ⭐2,300+ 86 个生产级 Skills,覆盖工程/产品/市场/合规/财务
jezweb/claude-skills ⭐763 97 个生产级 Skills,节省约 60% Token
VoltAgent/awesome-agent-skills 精选 收录最全,含 Anthropic/Vercel/Stripe/Cloudflare 官方 Skills

7.3 前端设计类 Top Skills

排名 Skill 名称 说明
🥇 Anthropic Frontend Design 277K+ 安装,打破 AI "Inter 字体+紫蓝渐变"同质化
🥈 UI/UX Pro Max 55.8K+ Stars,设计智能数据库,自动匹配风格
🥉 Impeccable 精细化设计工坊,针对已有页面打磨
4 Vercel Agent Skills 19.5K+ Stars,工程化质量守门员
5 Taste Skill 6.6K+ Stars,参数化风格调校器

7.4 安装方式

技能放到以下目录,Claude 会自动发现并加载:

  • ~/.claude/skills/ — 个人使用(跨所有项目)
  • .claude/skills/ — 项目使用(团队共享,签入 Git)

8. 推荐插件市场

8.1 Wookstar Claude Code Plugins(24 个插件)

安装:

/plugin marketplace add henkisdabro/wookstar-claude-plugins
插件 用途
developer 全栈套件:3 个 agent、6 个 MCP(Playwright、Chrome DevTools、Firecrawl、Context7)
documents Word、Excel、PDF 处理技能
shopify-developer 6 个 Shopify 开发技能
claudecode /ultra-think 深度推理、/reflection 改进 CLAUDE.md
git-worktrees 并行开发工作流

8.2 Claude Plugin Suite(rohittcodes)

CI/CD 和自动化专用市场:

/plugin marketplace add rohittcodes/claude-plugin-suite

包含 16 个专用子代理、10+ 个斜杠命令(/deploy/test/code-review)和 8+ 个 MCP 集成。


9. 推荐 MCP 服务

MCP 服务器 使用场景 优先级
Playwright / Chrome DevTools 浏览器自动化、UI 测试、网页截图 🔴 最高
Context7 / Claude Context 语义代码搜索,大型仓库理解 🔴 最高
Firecrawl 网页抓取与搜索 🟡 高
Notion MCP 知识库集成 🟡 高
GitHub CLI(gh PR、Issues、评论(比 MCP 更省上下文) 🟡 高
Slack MCP 粘贴 Bug 线程、零上下文切换 🟢 中
Vercel MCP 部署自动化 🟢 中
Google Workspace Gmail、Drive、Calendar 自动化 🟢 中
PostgreSQL / MySQL MCP 数据库直连查询 🟢 中
Figma MCP 设计稿转代码 🔵 可选
Perplexity MCP Claude Code 内网络搜索 🔵 可选

原则:精选 1-3 个高质量 MCP,更多的并不更好 —— token 消耗是真实的。建议将 MCP 转换为 Skills 以减少开销。


10. 新项目快速上手流程

# 1. 初始化 CLAUDE.md
/init                           # 自动扫描代码库生成 CLAUDE.md

# 2. 精简 CLAUDE.md —— 移除 Claude 能自行推断的所有内容

# 3. 添加必要的 Hooks
#    - PostToolUse:保存时格式化
#    - PreToolUse:阻止危险命令

# 4. 预批准安全命令
/permissions                    # 白名单 npm test、npm run lint 等

# 5. 设置默认模型和效率
/model sonnet                   # 或 /model opus 用于复杂项目
/effort high                    # Team/Enterprise 推荐默认值

# 6. 安装语言特定的 LSP 插件
/plugin install typescript-lsp@claude-plugins-official

# 7. 设置状态行
/statusline                     # 显示模型、分支、上下文使用率等

# 8. 安装推荐的插件市场
/plugin marketplace add henkisdabro/wookstar-claude-plugins

11. 调试与恢复

11.1 黄金规则

  • 粘贴原始错误日志,而非你的解读:你的抽象会丢失 Claude 需要的细节。直接说"fix"然后粘贴原始内容
  • 大型重构前先 checkpointgit add . && git commit -m "checkpoint: before changes"
  • Claude 陷入循环时:不要解释更多 —— /compact/clear 然后以更精准的提示重启
  • 恢复模式“停下来。从 Git 读取原始工作版本。这是我们试图达成的目标。用不同的方法重新开始。”
  • 调试日志tail -f ~/.claude/debug/latest —— 实时观察每个触发器、Hook 和状态管理决策

11.2 安全设置

方式 说明
/permissions 预批准受信任的命令,签入 .claude/settings.json
claude --enable-auto-mode 安全操作自动批准
/sandbox 操作系统级沙箱隔离(macOS Seatbelt / Linux bubblewrap)
Docker 容器 风险工作的完全隔离 + 轻松回滚

权限原则:永远不要 --dangerously-skip-permissions,除非你深刻理解 Claude 的能力。通过 /permissions 预批准特定命令。


12. 参考资源

官方资源

社区精华

Skills 市场

插件资源

配置深入学习


记住这一句就够了: 投资验证闭环(测试/Lint/浏览器),保持 CLAUDE.md 精准精简,复杂工作用 Plan Mode,在 Worktree 中并行运行多个会话,积极 compact/clear 保持上下文新鲜。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐