Everything Claude Code 简明指南¶

自 2 月实验性推出以来,一直作为热心的 Claude Code 用户活跃,并与 @DRodriguezFX 一起在 zenith.chat 的 Anthropic x Forum Ventures 黑客松中获胜 — 全部使用 Claude Code 完成。
10 个月日常使用后的完整设置介绍:技能、钩子、子代理、MCP、插件,以及真正有效的内容。
技能与命令¶
技能是主要的工作流界面。它们作为范围明确的工作流捆绑包发挥作用:可复用的提示、结构、支持文件,以及在需要特定执行模式时的代码地图。
在 Opus 4.5 的长时间编码会话后,想要清理死代码和杂乱的 .md 文件?运行 /refactor-clean。需要测试?/tdd、/e2e、/test-coverage。这些斜杠入口很方便,但真正持久的单元是基础技能。技能中也可以包含代码地图 — 一种让 Claude 快速导航代码库而不消耗上下文进行探索的方式。
命令的链式执行
ECC 仍然提供 commands/ 层,但最好将其视为迁移过程中的遗留斜杠入口兼容层。持久逻辑应放在技能中。
- 技能:
~/.claude/skills/- 正式的工作流定义 - 命令:
~/.claude/commands/- 仍需要时的遗留斜杠入口模拟
# スキル構造の例
~/.claude/skills/
pmx-guidelines.md # プロジェクト固有パターン
coding-standards.md # 言語のベストプラクティス
tdd-workflow/ # SKILL.md付きマルチファイルスキル
security-review/ # チェックリストベースのスキル
钩子¶
钩子是触发器式自动化,会在特定事件上触发。与技能不同,它们受限于工具调用和生命周期事件。
钩子类型:
- PreToolUse - 工具执行前(验证、提醒)
- PostToolUse - 工具完成后(格式化、反馈循环)
- UserPromptSubmit - 消息提交时
- Stop - Claude 响应完成时
- PreCompact - 上下文压缩前
- Notification - 权限请求
示例:长时间运行命令前的 tmux 提醒
{
"PreToolUse": [
{
"matcher": "tool == \"Bash\" && tool_input.command matches \"(npm|pnpm|yarn|cargo|pytest)\"",
"hooks": [
{
"type": "command",
"command": "if [ -z \"$TMUX\" ]; then echo '[Hook] Consider tmux for session persistence' >&2; fi"
}
]
}
]
}
PostToolUse 钩子执行期间在 Claude Code 中的反馈示例
专业提示: 与其手动编写 JSON,可以使用 hookify 插件以对话方式创建钩子。运行 /hookify 并描述你想要的功能。
子代理¶
子代理是编排器(主 Claude)可以在限定范围内委派任务的过程。它们可以在后台或前台运行,并释放主代理的上下文。
子代理与技能配合良好 — 你可以将任务委派给能够执行技能子集的子代理,并让它们自主使用这些技能。此外,还可以使用特定的工具权限对其进行沙箱化。
# サブエージェント構造の例
~/.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 文件夹中存储包含 Claude 应始终遵循的最佳实践的 .md 文件。有两种方法:
- 单一 CLAUDE.md - 将所有内容放在一个文件中(用户或项目级别)
- 规则文件夹 - 按关注点分组的模块化 .md 文件
~/.claude/rules/
security.md # ハードコードされたシークレット禁止、入力バリデーション
coding-style.md # イミュータビリティ、ファイル構成
testing.md # TDDワークフロー、80%カバレッジ
git-workflow.md # コミット形式、PRプロセス
agents.md # サブエージェントへの委任タイミング
performance.md # モデル選択、コンテキスト管理
规则示例:
- 不在代码库中使用表情符号
- 在前端中避免使用紫色系颜色
- 部署前务必测试代码
- 优先使用模块化代码而非巨型文件
- 不提交 console.log
MCP(Model Context Protocol)¶
MCP 将 Claude 直接连接到外部服务。它不是 API 的替代品,而是提示驱动的包装器,为信息导航提供灵活性。
示例: 通过 Supabase MCP,Claude 可以无需复制粘贴即可获取特定数据,并直接在上游执行 SQL。数据库、部署平台等也是如此。
Supabase MCP 列出 public 架构中表的示例
Claude 内的 Chrome: 一个内置插件 MCP,让 Claude 自主控制浏览器 — 点击即可确认其运行。
重要:上下文窗口管理
请精选 MCP。虽然我将所有 MCP 放入用户设置中,但禁用了所有未使用的 MCP。前往 /plugins 滚动查看,或运行 /mcp。
使用 /plugins 查看 MCP 的安装情况和状态
即使压缩前的 200k 上下文窗口,如果启用的工具过多,也可能只剩下 70k。性能会大幅下降。
参考: 在设置中保留 20 到 30 个 MCP,同时启用少于 10 个 / 活动工具少于 80 个。
插件¶
插件将工具打包,以便轻松安装,替代繁琐的手动设置。插件可以是技能 + MCP 的组合,也可以是钩子/工具的捆绑包。
插件安装:
# マーケットプレイスを追加
# @mixedbread-ai による mgrep プラグイン
claude plugin marketplace add https://github.com/mixedbread-ai/mgrep
# Claudeを開き、/plugins を実行、新しいマーケットプレイスを見つけてインストール
新安装的 Mixedbread-Grep 市场显示
LSP 插件 在经常在编辑器外使用 Claude Code 时特别有用。通过 Language Server Protocol,无需打开 IDE 即可为 Claude 提供实时类型检查、跳转定义和智能补全。
# 有効なプラグインの例
typescript-lsp@claude-plugins-official # TypeScriptインテリジェンス
pyright-lsp@claude-plugins-official # Python型チェック
hookify@claude-plugins-official # フックを会話的に作成
mgrep@Mixedbread-Grep # ripgrepより優れた検索
与 MCP 相同的警告 — 注意上下文窗口。
提示与技巧¶
键盘快捷键¶
Ctrl+U- 删除整行(比连续按退格键更快)!- 快速 bash 命令前缀@- 文件搜索/- 开始斜杠命令Shift+Enter- 多行输入Tab- 切换思考显示Esc Esc- 中断 Claude / 恢复代码
并行工作流¶
- 分叉(
/fork)— 分叉会话以并行执行不重复的任务(而不是连续发送排队消息) - Git 工作树 — 无冲突地运行重复的并行 Claude。每个工作树是独立的检出
用于长时间运行命令的 tmux¶
流式传输和监控 Claude 执行的日志/bash 进程:
mgrep > grep¶
mgrep 是 ripgrep/grep 的重大改进。从插件市场安装,并使用 /mgrep 技能。支持本地搜索和 Web 搜索。
其他实用命令¶
/rewind- 返回先前状态/statusline- 使用分支、上下文 %、待办事项自定义/checkpoints- 文件级别的撤销点/compact- 手动触发上下文压缩
GitHub Actions CI/CD¶
在 GitHub Actions 中为 PR 设置代码审查。设置后,Claude 可以自动审查 PR。
Claude 批准 Bug 修复 PR
沙箱¶
对于有风险的操作,使用沙箱模式 — Claude 会在一个受限环境中运行,不会影响实际系统。
关于编辑器¶
编辑器的选择会显著影响 Claude Code 的工作流。Claude Code 可以在任意终端中运行,但搭配功能强大的编辑器后,可以实现实时文件跟踪、快速导航和集成的命令执行。
Zed(我的推荐)¶
我使用 Zed — 由于用 Rust 编写,它真的很快。它能立即打开,轻松处理大型代码库,并且几乎不消耗系统资源。
Zed + Claude Code 是优秀组合的原因:
- 速度 — 基于 Rust 的性能,即使 Claude 快速编辑文件也不会延迟。编辑器能够跟上
- Agent 面板集成 — 通过 Zed 的 Claude 集成,实时跟踪 Claude 编辑带来的文件变更。无需离开编辑器即可在 Claude 引用的文件之间跳转
- CMD+Shift+R 命令面板 — 通过可搜索 UI 快速访问自定义斜杠命令、调试器和构建脚本
- 最小资源占用 — 在繁重操作期间不与 Claude 争夺 RAM/CPU。运行 Opus 时很重要
- Vim 模式 — 如需要,支持完整 Vim 键位
使用 CMD+Shift+R 显示自定义命令下拉菜单的 Zed 编辑器。右下角以靶心形式显示跟随模式。
不依赖编辑器的提示:
- 分屏 — 一侧是 Claude Code 终端,另一侧是编辑器
- Ctrl + G — 在 Zed 中快速打开 Claude 当前正在处理的文件
- 自动保存 — 启用自动保存,确保 Claude 读取的文件始终最新
- Git 集成 — 使用编辑器的 Git 功能,在提交前审查 Claude 的变更
- 文件监视器 — 大多数编辑器会自动重新加载已修改的文件,请确认其已启用
VSCode / Cursor¶
这也是一个实用选择,能与 Claude Code 良好配合。你可以选择通过 \ide 启用 LSP 功能的终端形式(插件方式略显冗长),或者选择由编辑器深度集成、UI 匹配的扩展。
VS Code 扩展直接在 IDE 内提供 Claude Code 的原生图形界面。
我的设置¶
插件¶
已安装:(通常同时启用 4 到 5 个)
ralph-wiggum@claude-code-plugins # ループ自動化
frontend-patterns@claude-code-plugins # UI/UXパターン
commit-commands@claude-code-plugins # Gitワークフロー
security-guidance@claude-code-plugins # セキュリティチェック
pr-review-toolkit@claude-code-plugins # PR自動化
typescript-lsp@claude-plugins-official # TSインテリジェンス
hookify@claude-plugins-official # フック作成
code-simplifier@claude-plugins-official
feature-dev@claude-code-plugins
explanatory-output-style@claude-code-plugins
code-review@claude-code-plugins
context7@claude-plugins-official # ライブドキュメント
pyright-lsp@claude-plugins-official # Python型
mgrep@Mixedbread-Grep # より良い検索
MCP 服务器¶
已配置(用户级别):
{
"github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] },
"firecrawl": { "command": "npx", "args": ["-y", "firecrawl-mcp"] },
"supabase": {
"command": "npx",
"args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=YOUR_REF"]
},
"memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] },
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
},
"vercel": { "type": "http", "url": "https://mcp.vercel.com" },
"railway": { "command": "npx", "args": ["-y", "@railway/mcp-server"] },
"cloudflare-docs": { "type": "http", "url": "https://docs.mcp.cloudflare.com/mcp" },
"cloudflare-workers-bindings": {
"type": "http",
"url": "https://bindings.mcp.cloudflare.com/mcp"
},
"clickhouse": { "type": "http", "url": "https://mcp.clickhouse.cloud/mcp" },
"AbletonMCP": { "command": "uvx", "args": ["ableton-mcp"] },
"magic": { "command": "npx", "args": ["-y", "@magicuidesign/mcp@latest"] }
}
关键点 — 我配置了 14 个 MCP,但每个项目只启用 5 到 6 个。这样可以保持上下文窗口健康。
主要钩子¶
{
"PreToolUse": [
{ "matcher": "npm|pnpm|yarn|cargo|pytest", "hooks": ["tmuxリマインダー"] },
{ "matcher": "Write && .mdファイル", "hooks": ["README/CLAUDE以外はブロック"] },
{ "matcher": "git push", "hooks": ["レビュー用にエディタを開く"] }
],
"PostToolUse": [
{ "matcher": "Edit && .ts/.tsx/.js/.jsx", "hooks": ["prettier --write"] },
{ "matcher": "Edit && .ts/.tsx", "hooks": ["tsc --noEmit"] },
{ "matcher": "Edit", "hooks": ["grep console.log 警告"] }
],
"Stop": [
{ "matcher": "*", "hooks": ["変更ファイルのconsole.logチェック"] }
]
}
自定义状态栏¶
显示用户、目录、带脏指示器的 Git 分支、剩余上下文百分比、模型、时间和 Todo 计数:
Mac 根目录中的状态栏示例
规则结构¶
~/.claude/rules/
security.md # 必須セキュリティチェック
coding-style.md # イミュータビリティ、ファイルサイズ制限
testing.md # TDD、80%カバレッジ
git-workflow.md # Conventional Commits
agents.md # サブエージェント委任ルール
patterns.md # APIレスポンス形式
performance.md # モデル選択(Haiku vs Sonnet vs Opus)
hooks.md # フックドキュメント
子代理¶
~/.claude/agents/
planner.md # 機能の分解
architect.md # システム設計
tdd-guide.md # テストを先に書く
code-reviewer.md # 品質レビュー
security-reviewer.md # 脆弱性スキャン
build-error-resolver.md
e2e-runner.md # Playwrightテスト
refactor-cleaner.md # デッドコード除去
doc-updater.md # ドキュメントの同期維持
重要要点¶
- 不要过度复杂化 — 将配置视为微调,而不是架构
- 上下文窗口很宝贵 — 禁用未使用的 MCP 和插件
- 并行执行 — 分叉会话,使用 Git 工作树
- 自动化重复操作 — 用于格式化、Lint 和提醒的钩子
- 限制子代理的作用范围 — 有限的工具 = 专注的执行
参考资料¶
注意: 这只是细节的一部分。高级模式请参阅长文指南。
在 NYC 的 Anthropic x Forum Ventures 黑客松中,与 @DRodriguezFX 一起构建 zenith.chat 并获胜
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 ev/ECC