Claude Code 实战技巧速查

来自 ykdojo/claude-code-tips — 46 条从入门到精通的技巧

10 大类别 46 条技巧 可搜索 / 可筛选 2026-03 整理
GitHub 原始仓库 →
10
必做(Essential)
18
实用(Useful)
12
进阶(Advanced)
6
特定场景(Niche)

立即行动 Top 5

投入产出比最高的 5 条技巧,10 分钟即可全部配置完成

#15 懒加载 MCP 工具

系统提示词省 50% Token,MCP 工具按需加载而非全部塞进上下文

// settings.json { "env": { "ENABLE_TOOL_SEARCH": "true" } }

#7 设置终端别名

每天用无数次的命令,一个字母搞定

alias c='claude' alias ch='claude --chrome' # c -c 继续对话 | c -r 恢复会话

#8 HANDOFF.md 交接

上下文快满时,让 Claude 写交接文档,新对话无缝继续

# 对话中说: "把当前进度写到 HANDOFF.md" # 新对话中说: "读 HANDOFF.md 继续"

#33 审查危险命令

扫描已授权的 sudo、rm -rf、chmod 777 等高危命令

npx cc-safe ~/projects

#38 输入框快捷键

掌握这些快捷键,编辑体验提升一个档次

Ctrl+G → 外部编辑器编辑长提示 Ctrl+V → 粘贴图片 \+Enter → 输入框换行 Ctrl+W → 删除一个词

#45 一键安装脚本

交互式配置所有最佳实践,一步到位

bash <(curl -s https://raw.githubusercontent.com\ /ykdojo/claude-code-tips/main/scripts/setup.sh)

配置层级速查

层级加载方式适用场景Token 消耗
CLAUDE.md每次对话自动加载全局规则、项目规范始终占用
Skills按需调用 (/skill)可复用工作流仅调用时
Slash Commands用户手动触发常用操作快捷方式仅触发时
Plugins安装后可用完整功能套件按需

上下文管理

Claude Code 的性能与上下文长度直接相关,管理好上下文是最高优先级

Tip 5 上下文像牛奶 — 要新鲜
核心

上下文越长,模型性能越差、速度越慢。两个信号说明该开新对话了:

  • 话题切换 — 不同任务开不同对话,避免不相关上下文干扰
  • 速度变慢 — 明显感觉响应变慢时果断开新会话

经验法则:一个对话专注一个任务。做完就关,下个任务开新的。

Tip 8 HANDOFF.md — 上下文交接
核心工作流

大任务做到一半需要开新对话时,让 Claude 写一份交接文档:

# 对话快满时说: "把当前进度、已解决的问题、下一步计划写到 HANDOFF.md" # 新对话中说: "读 HANDOFF.md 继续上次的工作"

更多技巧:

  • /config 中关闭自动压缩,手动控制上下文空间
  • /handoff 命令自动化交接(dx 插件提供)
  • /plan 模式为下一个 Agent 收集结构化上下文
Tip 23 Fork / Clone 对话
实用
命令效果
/fork分叉当前对话,两条线独立发展,原对话不受影响
/compact压缩当前上下文,保留关键信息
claude -c继续上一次对话
claude -r选择恢复某个历史会话

场景:调试一个问题,想同时试两个方向 → /fork 出一个分支试方案 B,原对话继续方案 A。

Tip 13 搜索历史对话
实用

所有对话记录存储在 ~/.claude/projects/ 下(目录名基于项目路径):

# 按关键词搜索历史 grep -l -i "keyword" ~/.claude/projects/*/*.jsonl # 或者直接在对话中说: "搜索我之前的对话,找关于 xxx 的解决方案"

性能优化

减少 Token 消耗,加快响应速度

Tip 15 瘦身系统提示词 — 省 50% Token
核心Token

默认系统提示词约 19k Token,通过以下配置可缩减到 ~9k:

// settings.json { "env": { "ENABLE_TOOL_SEARCH": "true", // MCP 工具按需加载 "DISABLE_AUTOUPDATER": "1" // 禁用自动更新检查 } }

效果:MCP 工具不再全部塞进系统提示词,而是通过 ToolSearch 按需加载。

进阶:用 --system-prompt-file 参数可完全替换系统提示词,极致精简。

Tip 17 手动指数退避轮询
Token 节省

检查长时间运行的任务(如 GitHub CI)时,不要持续轮询:

  • 第 1 次检查:1 分钟
  • 第 2 次检查:2 分钟
  • 第 3 次检查:4 分钟

每次轮询都消耗完整的上下文 Token,指数退避能显著降低 CI 等待场景的 Token 开销。

Tip 30 保持 CLAUDE.md 简洁
配置

CLAUDE.md 每次对话都加载,臃肿的配置浪费 Token 且降低指令遵循率:

  • 最小配置开始,只加重复用到的规则
  • 重复超过 3 次的指令才值得写进 CLAUDE.md
  • 定期清理过时内容
  • 详细内容放到按需加载的 Skills 里,不要塞在 CLAUDE.md

工作流与任务管理

高效组织和执行编码任务

Tip 3 拆解大问题
核心方法论

不要试图 A → B 一步到位,而是拆成小步:

A → A1 → A2 → A3 → B

每一步都小到可以验证、可以回滚。Claude 在小任务上的准确率远高于大任务。

Tip 9 完成写-测循环
核心验证

写完代码不算完,必须验证。给 Claude 提供验证手段:

  • tmux — 交互式测试,Claude 在一个 pane 写代码,另一个跑测试
  • Playwright MCP — 自动化 Web UI 测试
  • 非 main 分支开 CI — 推到临时分支触发 CI 验证
  • 单元测试 — 写完功能直接跑测试
Tip 14 多 Tab 并行任务
并行

"级联"方法:新任务在右边开 Tab,从左到右扫描各 Tab 状态。

经验:同时并发不超过 3-4 个任务,太多会导致注意力分散和合并冲突。

Tip 36 后台运行命令 (Ctrl+B)
并行

长时间运行的 bash 命令按 Ctrl+B 移到后台。

同时可以派多个子 Agent 并行处理大任务,不需要等前一个完成。

Tip 34 TDD — 先写测试再实现
核心质量

让 Claude 先写测试,再实现代码。好处:

  • 测试即规格说明,行为契约清晰
  • Claude 写的测试能发现 Claude 写的 bug
  • 防止实现偏离预期
Tip 39 先规划再动手 (Shift+Tab)
Plan Mode

Shift+Tab 进入 Plan Mode:

  • Claude 只读代码、搜索信息,不做修改
  • 输出结构化的实施计划
  • 你确认后再执行

适合技术选型、架构决策、复杂功能的前期规划。

Tip 40 简化过度复杂的代码
代码质量

Claude 生成的代码可能过度工程化,主动要求简化:

  • "简化这段代码,解释每处改动"
  • "这一行是做什么的?"
  • 理解 > 跳过 review

配置与系统优化

CLAUDE.md、Skills、Plugins 的使用策略

Tip 25 四种配置抽象层
架构
类型特点适用场景
CLAUDE.md简单,每次对话都加载全局/项目规则
Skills结构化,按需调用,省 Token可复用的工作流
Slash Commands用户主动触发常用操作快捷方式
Plugins打包 Skills + Commands + Agents + Hooks + MCP完整功能套件

原则:常量放 CLAUDE.md,流程放 Skills,操作做 Commands,套件用 Plugins。

Tip 4 禁用 commit 署名
Git
// settings.json { "attribution": { "commit": "", "pr": "" } }

去掉 Claude 自动添加的 "Co-Authored-By" 签名。

Tip 44 安装 dx 插件
Plugin
claude plugin marketplace add ykdojo/claude-code-tips claude plugin install dx@ykdojo

包含的功能:

  • /dx:gha — GitHub Actions 失败自动排查
  • /dx:handoff — 自动上下文交接
  • /dx:clone / /dx:half-clone — 对话分叉
  • reddit-fetch skill — 抓取 Reddit 内容
Tip 45 一键安装最佳实践
快速开始
bash <(curl -s https://raw.githubusercontent.com/ykdojo/claude-code-tips/main/scripts/setup.sh)

交互式配置:DX 插件、cc-safe、状态栏、MCP 懒加载、别名、权限。一步到位。

Tip 0 自定义状态栏
UI

在终端底部状态栏显示:当前模型、目录、Git 分支、未提交文件数、Token 使用百分比。

支持 10 种颜色主题。通过脚本配置,可显示上一条消息摘要。

Git & DevOps

版本控制、CI/CD、Pull Request 工作流

Tip 16 Git Worktrees 并行工作
并行Git

为不同分支创建独立工作目录,同时处理多个功能:

# 创建 worktree git worktree add ../feature-auth feature/auth git worktree add ../fix-bug fix/login-bug # 每个目录独立,互不干扰 # 不需要 stash/switch branch

优势:避免 stash 丢失、避免切换分支的上下文切换成本。

Tip 26 交互式 PR Review
GitHub

gh 获取 PR 信息,然后让 Claude 逐文件或逐行审查:

# 获取 PR diff gh pr diff 123 # 让 Claude 审查 "审查这个 PR 的安全性和代码质量"

自己控制审查粒度和节奏,比 AI 自动审查更有针对性。

Tip 29 DevOps 排查 — CI 失败分析
CI/CD

Claude Code 擅长排查 GitHub Actions 失败的根因:

  • 检测 flaky 测试
  • 找到引入 bug 的具体 commit
  • 分析 CI 日志定位问题

安装 dx 插件后用 /gha/dx:gha 命令自动化。

界面 & 输入体验

快捷键、语音输入、终端配置

Tip 38 输入框快捷键
核心效率
快捷键功能
Ctrl+G在外部编辑器(VS Code / Vim)编辑长提示
Ctrl+V粘贴图片
\ + Enter输入框换行
Ctrl+A / E跳到行首 / 行尾
Option+/按词跳转
Ctrl+W删除前一个词
Ctrl+U删除到行首
Tip 7 设置终端别名
核心
# ~/.zshrc 或 ~/.bashrc alias c='claude' alias ch='claude --chrome' alias gb='github' alias co='code'

常用操作:

  • c -c — 继续上次对话
  • c -r — 恢复最近会话
  • c "fix the bug" — 一行启动并下达任务
Tip 2 语音输入
输入方式

安装 SuperWhisperMacWhisper 进行本地语音转文字。

  • Claude 能智能理解转录错误
  • 戴耳机说话,飞机上也能安静使用
  • 适合思路清晰但打字慢的场景

研究与内容获取

让 Claude 帮你收集和整理信息

Tip 10 Cmd+A 复制任意内容
通用

对于 Claude 无法直接访问的页面内容:

  • 终端输出 — 全选复制粘贴
  • Reddit 帖子 — 打印预览 → Cmd+A → 复制
  • Gmail 对话 — 同理
  • 任何网页 — 选中内容粘贴给 Claude

简单粗暴但极其有效。

Tip 11 用 Gemini CLI 作为备用抓取器
多 Agent

Claude 无法访问的网站,利用 Gemini CLI 的网络访问能力:

# 让 Claude 调用 Gemini 抓取 gemini "总结这个 Reddit 帖子的内容: https://reddit.com/r/..."

也可以安装 reddit-fetch skill 专门处理 Reddit 内容。

Tip 27 Claude Code 作研究工具
研究

结合多种手段做深度研究:

  • 终端访问 — 运行脚本、调用 API
  • MCP 服务器 — GitHub、搜索引擎等
  • 浏览器集成 — --chrome 模式
  • Cmd+A 方法 — 任意内容粘贴

适合:GitHub Issue 分析、Reddit 用户情感调研、代码库技术栈评估。

安全与风险控制

防止 Claude 搞破坏

Tip 33 审查已批准的危险命令
核心安全
npx cc-safe ~/projects

扫描你已经授权 Claude 运行的命令,发现高危操作:

  • sudo — 提权操作
  • rm -rf — 递归删除
  • chmod 777 — 权限放开
  • docker --privileged — 特权容器
Tip 21 容器化运行高风险任务
Docker

在容器中运行危险或长时间任务:

  • 使用 --dangerously-skip-permissions 标志(仅在容器内!)
  • 隔离宿主系统,防止误操作
  • 可用 tmux 编排多个 Claude Worker 实例

警告--dangerously-skip-permissions 只在隔离环境中使用,永远不要在宿主机上用。

Tip 24 用 realpath 获取绝对路径
路径安全
realpath some/relative/path # → /Users/you/projects/some/relative/path

跨目录引用文件时避免路径错误,尤其是在 CLAUDE.md 和 Skills 中引用文件时。

思维方式与长期习惯

元认知 — 如何更好地使用 AI 编程工具

Tip 12 投资自己的工作流
方法论

花时间优化以下内容,产生复利效应:

  • 完善 CLAUDE.md 配置
  • 学习新特性和快捷键
  • 构建自定义 Skills 和工具
  • 建立个人的验证流程
Tip 22 最好的提升是持续使用
方法论

大量实践建立直觉。追求高 Token 消耗来加速学习曲线。

多并发会话 + 合理价格(Max Plan)使高频使用成为可行。

Tip 32 选择合适的抽象层级
策略
层级描述适用场景
Vibe Coding高层次指令,信任模型原型、个人项目、探索
协作编码给方向,审查输出日常开发
深度审查逐行粒度安全敏感、核心逻辑

根据任务重要性选择合适深度,不必每次都逐行审查。

Tip 37 个性化软件的时代
愿景

几小时即可为个人需求构建自定义工具:

  • 自定义转录 App
  • 专用 CLI 工具
  • 数据可视化仪表盘
  • 交互式模板生成器

不再需要"将就"通用工具,每个人都可以拥有定制软件。

Tip 41 自动化的自动化
进化

逐级进化,每一级减少手动摩擦:

手动执行命令 → 脚本化 → Skills 封装 → 自定义工具 → 子 Agent 协作

当你发现自己重复做同一件事 3 次以上,就该提升一个抽象层级。

全部 46 条技巧

按编号排列,快速索引

#技巧级别类别
0自定义状态栏 — 显示模型、分支、Token 等信息特定配置
1关注社区 — 加入 Discord、关注 YouTube 频道获取最新技巧特定社区
2语音输入 — SuperWhisper / MacWhisper 本地语音转文字特定输入
3拆解大问题 — A→A1→A2→A3→B 逐步完成必做工作流
4禁用 commit 署名 + 允许自动 pull 禁止自动 push特定Git
5上下文像牛奶 — 变慢就开新对话必做上下文
6Claude Code 入门概述实用入门
7终端别名 — alias c='claude'必做效率
8HANDOFF.md — 上下文交接工作流必做上下文
9写-测循环 — 提供验证手段必做工作流
10Cmd+A 复制任意内容粘贴给 Claude实用研究
11Gemini CLI 作为备用网页抓取器进阶多 Agent
12投资自己的工作流 — 产生复利效应实用方法论
13搜索历史对话 — grep ~/.claude/projects/实用上下文
14多 Tab 并行 — 级联方法,不超过 3-4 个实用并行
15懒加载 MCP + 禁用自动更新 — 省 50% Token必做性能
16Git Worktrees — 并行处理多分支进阶Git
17指数退避轮询 — 检查 CI 状态省 Token实用性能
18管理权限 — 细粒度控制 Claude 可执行的操作实用安全
19Hooks — 用 shell 命令响应工具调用事件实用自动化
20子 Agent — 派出专门的 Agent 处理子任务进阶并行
21容器化运行 — Docker 隔离高风险任务进阶安全
22持续使用是最好的提升实用方法论
23/fork 分叉对话 — 同时试两个方向实用上下文
24realpath — 获取绝对路径避免错误特定安全
25四种配置抽象层 — CLAUDE.md / Skills / Commands / Plugins实用配置
26交互式 PR Review — gh + Claude 协作进阶Git
27Claude Code 作研究工具进阶研究
28MCP 服务器 — 扩展 Claude 的能力边界进阶扩展
29DevOps 排查 — CI 失败根因分析实用DevOps
30CLAUDE.md 保持简洁 — 只加重复用到的规则实用配置
31自定义 Slash Commands进阶配置
32选择抽象层级 — Vibe Coding 到深度审查进阶方法论
33cc-safe 审查危险命令 — sudo / rm -rf 等必做安全
34TDD — 先写测试再实现必做质量
35多文件编辑 — 让 Claude 跨文件重构实用编辑
36Ctrl+B 后台运行 — 长命令不阻塞实用并行
37个性化软件时代 — 定制工具只需几小时进阶愿景
38输入框快捷键 — Ctrl+G / Ctrl+V / \+Enter必做效率
39Shift+Tab Plan Mode — 先规划再动手实用工作流
40简化代码 — 要求 Claude 解释和精简实用质量
41自动化的自动化 — 手动→脚本→Skills→Agent进阶进化
42图片输入 — 截图、设计稿、错误信息实用输入
43Claude Max Plan 的价值评估特定成本
44dx 插件 — /gha /handoff /clone 等命令进阶插件
45一键安装脚本 — 交互式配置最佳实践实用快速开始
Learning Hub