Claude Code 配置与使用技巧完全指南(精简版)

Claude Code 配置与使用技巧指南

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

关注公众号：weelinking | 访问官网：weelinking.com

一、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 下的专门子进程，各司其职，严格限定权限范围。

配置原则

为每个子代理单独配置可用工具列表
限制 MCP 权限范围
工具越少，职责越聚焦，效果越好

四、Rules（规则）

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

个性化规则示例

代码库中禁止 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（插件）

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

安装示例

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

两种用法：

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

扩展模式：安装 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 只给少量明确工具
工具越少，作用越聚焦

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

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

写在最后

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

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

访问官网： weelinking.com