作者：搬石头的马农

<small>关注公众号：weelinking | 访问官网：weelinking.com；👉 点击访问官网

本文整理自 Anthropic & Forum Ventures 黑客松冠军的《The Shorthand Guide to Everything Claude Code》，作者连续使用 Claude Code 10 个月沉淀的完整配置经验。

一、Skills 和 Commands（技能与命令）

什么是 Skills？

Skills 是限定在特定场景的提示词快捷封装，通过斜杠命令触发。

常用 Skills

/refactor-clean    # 清理废弃代码和 .md 文件
/tdd              # 单元测试
/e2e              # 端到端测试
/test-coverage    # 覆盖率检查

目录结构

~/.claude/skills/
  pmx-guidelines.md      # 项目特定模式
  coding-standards.md    # 语言最佳实践
  tdd-workflow/          # 多文件技能
  security-review/       # 清单式技能

小技巧：多个命令可以在同一条消息中串联使用。

---

二、Hooks（钩子）

Hooks 是基于事件自动触发的配置，在工具调用或对话生命周期中执行。

支持的 Hook 类型

• PreToolUse：工具执行前

• PostToolUse：工具执行后

• UserPromptSubmit：用户提交消息时

• Stop：响应结束时

• PreCompact：上下文压缩前

• Notification：请求权限时

实用示例

长任务提醒：

{
  "PreToolUse": [{
    "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm|pnpm|yarn)\"",
    "hooks": [{
      "type": "command",
      "command": "if [ -z \"$TMUX\" ]; then echo '[Hook] Consider tmux' >&2; fi"
    }]
  }]
}

自动格式化：

{
  "PostToolUse": [{
    "matcher": "Edit && .ts/.tsx",
    "hooks": ["prettier --write", "tsc --noEmit"]
  }]
}

技巧：使用 /hookify 插件，用自然语言描述即可自动生成 Hook。

---

三、Subagents（子代理）

子代理是主 Agent 下的专门子进程，各司其职，严格限定权限范围。

推荐的 Subagents

~/.claude/agents/
  planner.md              # 功能规划
  architect.md            # 系统设计
  tdd-guide.md            # 测试驱动开发
  code-reviewer.md        # 代码审查
  security-reviewer.md    # 安全分析
  build-error-resolver.md # 构建错误修复
  e2e-runner.md           # 端到端测试
  refactor-cleaner.md     # 重构清理

配置原则

• 为每个子代理单独配置可用工具列表

• 限制 MCP 权限范围

• 工具越少，职责越聚焦，效果越好

---

四、Rules（规则）

Rules 是 Claude 必须始终遵守的最佳实践。

推荐结构

~/.claude/rules/
  security.md      # 安全检查（禁止硬编码密钥）
  coding-style.md  # 编码风格（不可变性、文件组织）
  testing.md       # 测试流程（TDD、80% 覆盖率）
  git-workflow.md  # Git 规范（Conventional Commits）
  agents.md        # 子代理委派规则
  performance.md   # 模型选择、上下文管理

个性化规则示例

• 代码库中禁止 emoji

• 前端避免紫色系

• 上线前必须跑测试

• 禁止提交 console.log

---

五、MCP（Model Context Protocol）

MCP 让 Claude 直接连接外部服务，用自然语言操作数据库、部署平台等。

常用 MCP 配置

{
  "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] },
  "supabase": { "command": "npx", "args": ["-y", "@supabase/mcp-server-supabase@latest"] },
  "vercel": { "type": "http", "url": "https://mcp.vercel.com" },
  "memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] }
}

关键原则

• 全局配置 20-30 个，但每个项目只启用 10 个以内

• 总工具数控制在 80 个以内

• 过多 MCP 会占用上下文，导致有效窗口从 200k 降至 70k

管理命令

/plugins   # 查看 MCP 状态
/mcp       # 管理 MCP

---

六、Plugins（插件）

插件是打包好的工具套件，避免逐个配置。

推荐插件

typescript-lsp@claude-plugins-official  # TS 智能提示
pyright-lsp@claude-plugins-official     # Python 类型检查
hookify@claude-plugins-official         # 快速创建 Hooks
mgrep@Mixedbread-Grep                   # 比 grep 更强的搜索
ralph-wiggum@claude-code-plugins        # 循环自动化

安装示例

claude plugin marketplace add https://github.com/mixedbread-ai/mgrep
# 然后在 Claude 中运行 /plugins 安装

---

七、实用技巧

键盘快捷键

快捷键	功能
Ctrl + U	删除整行
!	执行 bash 命令
@	文件搜索
/	触发斜杠命令
Shift + Enter	多行输入
Tab	显示/隐藏 Thinking
Esc Esc	中断输出/恢复代码

并行工作流

/fork   # Fork 对话分支处理多任务

Git Worktrees

git worktree add ../feature-branch feature-branch
# 在不同 worktree 中运行独立的 Claude 会话

tmux 长任务

tmux new -s dev
# Claude 在 tmux session 中执行长任务
tmux attach -t dev

mgrep 搜索

mgrep "function handleSubmit"              # 本地搜索
mgrep --web "Next.js 15 app router changes" # Web 搜索

其他命令

/rewind      # 回到之前的会话状态
/statusline  # 自定义状态栏
/checkpoints # 创建撤销节点
/compact     # 手动压缩上下文

---

八、编辑器选择

Zed（推荐）

• 轻量快速：Rust 实现，秒开

• Agent 面板集成：实时展示 Claude 修改的文件

• 一键跳转：直接跳转到 Claude 提到的文件

• 低资源占用：不抢 CPU/内存

• Vim 模式：完整 Vim 键位支持

推荐配置：

• 分屏：左边终端跑 Claude，右边 Zed 编辑

• Ctrl+G 快速打开文件

• 开启自动保存和文件自动刷新

VSCode / Cursor

两种用法：

1. 终端模式：终端跑 Claude Code + \ide 同步

2. 扩展模式：安装 Claude 官方扩展，面板嵌入编辑器

---

九、核心配置示例

常用 Hooks

{
  "PreToolUse": [
    { "matcher": "npm|yarn|cargo", "hooks": ["tmux reminder"] },
    { "matcher": "Write && .md file", "hooks": ["block unless README"] },
    { "matcher": "git push", "hooks": ["open editor for review"] }
  ],
  "PostToolUse": [
    { "matcher": "Edit && .ts/.tsx", "hooks": ["prettier --write", "tsc --noEmit"] },
    { "matcher": "Edit", "hooks": ["grep console.log warning"] }
  ],
  "Stop": [
    { "matcher": "*", "hooks": ["check console.log in modified files"] }
  ]
}

自定义状态栏

显示内容：

• 当前用户和目录

• Git 分支状态

• 剩余上下文百分比

• 当前模型（Haiku/Sonnet/Opus）

• 当前 todo 数量

---

十、关键要点总结

1. 配置是微调，不是重建

不要把配置搞成"大工程"，只是对默认行为做优化。

2. 上下文窗口非常稀缺

• MCP/插件装多了会吃满上下文

• 保留"已配置但默认禁用"的策略

• 按项目只开需要的 MCP

3. 尽可能并行执行

• 用 /fork 分叉会话

• 用 Git worktree 多分支并行开发

4. 重复的事情自动化

• 格式化、Lint、类型检查自动化

• 长任务提醒、git push 前检查

5. 子代理边界要清晰

• 每个 Subagent 只给少量明确工具

• 工具越少，作用越聚焦

---

资源链接

• Plugins Reference

• Hooks Documentation

• MCP Overview

• Claude Code 官方文档

---

作者经验：连续使用 Claude Code 10 个月，在 Anthropic x Forum Ventures 纽约黑客松上使用 Claude Code 完成项目并获得冠军。

本配置仅供参考，建议根据自己的工作流调整优化。

---

写在最后

看到这里，相信你已经掌握了 Claude Code 的核心配置方法。但工欲善其事，必先利其器 —— 如果你还没有稳定使用 Claude 的方式，再多的配置技巧也无从施展。

🚀 国内稳定使用 Claude 的推荐方案

作为过来人，经过一年多的摸索和使用，我发现这是国内最稳定、最省心的 Claude 使用方案，特别适合老程序员：

🎯 有两种方式体验

1. 关注公众号：weelinking（获取最新教程和福利）

2. 访问官网： weelinking.com

</br>

👉 点击访问官网

</br>