跳转至

Everything Claude Code 简明指南

页眉:Anthropic 黑客松获胜者 - 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/       # チェックリストベースのスキル

钩子

钩子是触发器式自动化,会在特定事件上触发。与技能不同,它们受限于工具调用和生命周期事件。

钩子类型:

  1. PreToolUse - 工具执行前(验证、提醒)
  2. PostToolUse - 工具完成后(格式化、反馈循环)
  3. UserPromptSubmit - 消息提交时
  4. Stop - Claude 响应完成时
  5. PreCompact - 上下文压缩前
  6. 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 钩子反馈 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 文件。有两种方法:

  1. 单一 CLAUDE.md - 将所有内容放在一个文件中(用户或项目级别)
  2. 规则文件夹 - 按关注点分组的模块化 .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 列出表 Supabase MCP 列出 public 架构中表的示例

Claude 内的 Chrome: 一个内置插件 MCP,让 Claude 自主控制浏览器 — 点击即可确认其运行。

重要:上下文窗口管理

请精选 MCP。虽然我将所有 MCP 放入用户设置中,但禁用了所有未使用的 MCP。前往 /plugins 滚动查看,或运行 /mcp。

/plugins 界面 使用 /plugins 查看 MCP 的安装情况和状态

即使压缩前的 200k 上下文窗口,如果启用的工具过多,也可能只剩下 70k。性能会大幅下降。

参考: 在设置中保留 20 到 30 个 MCP,同时启用少于 10 个 / 活动工具少于 80 个。

# 有効なMCPを確認
/mcp

# 未使用のものを ~/.claude/settings.json または現在のリポジトリの .mcp.json で無効化

插件

插件将工具打包,以便轻松安装,替代繁琐的手动设置。插件可以是技能 + MCP 的组合,也可以是钩子/工具的捆绑包。

插件安装:

# マーケットプレイスを追加
# @mixedbread-ai による mgrep プラグイン
claude plugin marketplace add https://github.com/mixedbread-ai/mgrep

# Claudeを開き、/plugins を実行、新しいマーケットプレイスを見つけてインストール

显示 mgrep 的市场选项卡 新安装的 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。每个工作树是独立的检出
git worktree add ../feature-branch feature-branch
# 各ワークツリーで別々のClaudeインスタンスを実行

用于长时间运行命令的 tmux

流式传输和监控 Claude 执行的日志/bash 进程:

tmux new -s dev
# Claudeがここでコマンドを実行、デタッチして再アタッチ可能
tmux attach -t dev

mgrep > grep

mgrep 是 ripgrep/grep 的重大改进。从插件市场安装,并使用 /mgrep 技能。支持本地搜索和 Web 搜索。

mgrep "function handleSubmit"  # ローカル検索
mgrep --web "Next.js 15 app router changes"  # Web検索

其他实用命令

  • /rewind - 返回先前状态
  • /statusline - 使用分支、上下文 %、待办事项自定义
  • /checkpoints - 文件级别的撤销点
  • /compact - 手动触发上下文压缩

GitHub Actions CI/CD

在 GitHub Actions 中为 PR 设置代码审查。设置后,Claude 可以自动审查 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 键位

带有自定义命令的 Zed 编辑器 使用 CMD+Shift+R 显示自定义命令下拉菜单的 Zed 编辑器。右下角以靶心形式显示跟随模式。

不依赖编辑器的提示:

  1. 分屏 — 一侧是 Claude Code 终端,另一侧是编辑器
  2. Ctrl + G — 在 Zed 中快速打开 Claude 当前正在处理的文件
  3. 自动保存 — 启用自动保存,确保 Claude 读取的文件始终最新
  4. Git 集成 — 使用编辑器的 Git 功能,在提交前审查 Claude 的变更
  5. 文件监视器 — 大多数编辑器会自动重新加载已修改的文件,请确认其已启用

VSCode / Cursor

这也是一个实用选择,能与 Claude Code 良好配合。你可以选择通过 \ide 启用 LSP 功能的终端形式(插件方式略显冗长),或者选择由编辑器深度集成、UI 匹配的扩展。

VS Code Claude Code 扩展 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 根目录中的状态栏示例

affoon:~ ctx:65% Opus 4.5 19:52
▌▌ plan mode on (shift+tab to cycle)

规则结构

~/.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       # ドキュメントの同期維持

重要要点

  1. 不要过度复杂化 — 将配置视为微调,而不是架构
  2. 上下文窗口很宝贵 — 禁用未使用的 MCP 和插件
  3. 并行执行 — 分叉会话,使用 Git 工作树
  4. 自动化重复操作 — 用于格式化、Lint 和提醒的钩子
  5. 限制子代理的作用范围 — 有限的工具 = 专注的执行

参考资料


注意: 这只是细节的一部分。高级模式请参阅长文指南。


在 NYC 的 Anthropic x Forum Ventures 黑客松中,与 @DRodriguezFX 一起构建 zenith.chat 并获胜

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 ev/ECC