目录

背景：Claude Code 用久了都会遇到什么问题？

这个项目是什么？

核心技巧一：上下文管理三件套

/rewind — 方案跑偏了别纠正，直接回退

/fork — 分叉新会话验证新思路

/btw — 临时提问不污染对话历史

核心技巧二：命令速查 + 快捷键大全

核心技巧三：中文配置指南

核心技巧四：高效工作流模板

核心技巧五：模型选择 + 省钱策略

安装与使用

项目地址

---

背景：Claude Code 用久了都会遇到什么问题？

先看看你有没有遇到过这些场景：

1. AI 改了一堆代码，你完全没审查就提交了 — 功能看着没问题，但有没有引入安全漏洞、是否改了不该改的文件，你根本不知道

2. 对话到后半段，AI 回答质量明显下降 — 纠正了好几次、临时插入了几个无关问题，这些「垃圾对话」已经吃掉了 20-30% 的上下文窗口

3. 一个方案试了一半发现不对，只能硬着头皮继续纠正 — 越纠正上下文越混乱，整个会话很快就废了

4. 每次新会话都要交代「请用中文回答」「我们的技术栈是 XXX」 — 重复性工作浪费大量精力

这些问题不是 Claude Code 的 bug，而是使用方式的问题。这个项目就是解决这些痛点的。

---

这个项目是什么？

claude-code-guide 是一份面向中文开发者的 Claude Code 日常操作指南，涵盖命令速查、键盘快捷键、配置技巧和高效工作流。它和官方文档的区别在于：从实战出发，告诉你不只是「怎么用」，更是「什么时候该用什么」和「为什么这样做」。

核心内容包括：

• 所有斜杠命令的分类速查表

• 上下文管理三件套（/rewind、/fork、/btw）的深度讲解

• 键盘快捷键大全

• 全局中文配置和状态栏定制

• 功能开发流 / 调试流 / 重构流的完整 SOP

• 模型选择策略和成本控制技巧

---

核心技巧一：上下文管理三件套

这是整个指南最精华的部分。Claude Code 的每一次对话都会永久写入会话历史，你的纠正消息、临时提问、半途而废的尝试，都会持续占用 token 空间，在后续每一轮对话中被模型读取，干扰输出质量。一次长会话中，纠正性消息和临时提问能吃掉 20-30% 的上下文窗口。

/rewind — 方案跑偏了别纠正，直接回退

当 AI 理解错需求、试了个失败的方案，或者你给了一段模糊指令导致跑偏——不要发消息纠正。纠正消息本身就是新的上下文噪音。

直接用 /rewind（或双击 Esc Esc）回退到出错之前的检查点，AI 会像什么都没发生过一样重新开始。

支持三种回退粒度：

选项	效果
仅回退代码	代码还原，对话保留（AI 仍记得哪条路走不通）
仅回退对话	代码保留，对话回滚
两者同时回退	代码和对话都回滚

注意：/rewind 只能回退通过文件编辑工具产生的代码更改，不能回退 rm -rf 等 Bash 命令造成的副作用。

/fork — 分叉新会话验证新思路

实现到一半想到另一个方案可能更好？直接在当前会话试有风险——如果新方案不行，历史里又多了一段无效上下文。

用 /fork 从当前位置分叉出独立会话，继承完整历史，独立验证新想法。确认可行后，用 /resume 回到主会话，用更好的指令重做。

/btw — 临时提问不污染对话历史

主任务做到一半，突然想查个不相关的知识点。直接问会写入对话历史占用 token，忍到结束再问可能已经忘了。

/btw TypeScript 的 Record 和 Map 有什么区别？
/btw 这个重试逻辑是干什么的？

问答只展示一次（带 [btw] 前缀），绝不写入主对话历史。复用了主会话的 prompt cache，成本极低。

---

核心技巧二：命令速查 + 快捷键大全

项目按类别整理了所有常用操作，看一眼就懂：

斜杠命令按功能分组：

分类	命令
基础对话	/help、/clear、/compact、/context、/cost、/model
工作模式	/plan、/fast、/thinking、/btw
代码审查	/diff、/review、/simplify、/security-review
Git 操作	/commit、/commit-push-pr、/clean-gone
自动化	/loop、/permissions、/statusline、/config

键盘快捷键精选：

快捷键	功能
Shift + Tab	循环切换权限模式（default → acceptEdits → plan → auto）
Ctrl + C  /  Esc	中断当前响应或工具调用，保留已完成的工作。双击 Ctrl+C Ctrl+C 强制退出 Claude Code，双击 Esc Esc 打开回退/检查点菜单
\ + Enter	多行换行不发送

对话中常用操作：

操作	说明
@src/auth.ts	精确引用文件，支持 Tab 自动补全
! git status	在对话中直接执行 Shell 命令
# 使用 JWT 认证	快速将内容写入 CLAUDE.md 记忆文件

---

核心技巧三：中文配置指南

全局默认中文回答： 在 ~/.claude/CLAUDE.md 中添加语言偏好，每次新会话自动使用简体中文：

## 语言偏好
- 始终使用简体中文回答所有问题
- 代码注释和文档也默认使用中文（除非明确要求英文）
- 所有解释、分析、建议均以中文输出

状态栏显示上下文占用： 编辑 ~/.claude/settings.json，终端底部实时显示上下文百分比，方便在快满时及时 compact：

{
  "statusLine": {
    "type": "command",
    "command": "python -c \"import sys,json; d=json.load(sys.stdin); p=d['context_window']['used_percentage']; m=d['model']['display_name']; print(f' Context {p}% | {m} ')\""
  }
}

效果：

Context 37% | claude-sonnet-4-6

---

核心技巧四：高效工作流模板

功能开发流：

claude → /init → /memory 补充规范 → 描述需求 → /diff 审查改动 → !npm test → /cost → git commit

调试流：

claude -c → 粘贴错误信息 → AI 调查（/btw 附带提问）→ /diff → 测试验证 → /compact

大规模重构流：

Shift+Tab (切计划模式) → 描述重构目标 → 审查方案 → 确认后执行 → /diff → /simplify → /compact

并行开发流： 同时开 3-5 个终端，各自在独立 git worktree 中跑不同的 Claude 会话，互不阻塞：

# 终端 1：主力开发
cd project && claude
# 终端 2：同步跑 Code Review
cd project && claude -w
# 终端 3：同步研究技术方案
cd project && claude -w --tmux

---

核心技巧五：模型选择 + 省钱策略

场景	推荐模型	原因
日常编码、功能开发、重构	Sonnet	速度快、质量好，日常全能
复杂架构决策、困难调试	Opus	推理能力强，质量优先
简单编辑、格式化、查日志	Haiku	速度最快、成本最低

推荐策略：用 Opus 做计划，用 Sonnet 执行——性价比最高的组合。

---

安装与使用

项目本身是一个纯文档仓库，直接访问即可使用：

# 克隆到本地（可选）
git clone https://github.com/20kiki/claude-code-guide.git
​
# 或直接在线浏览
# https://github.com/20kiki/claude-code-guide

内容全部在 README.md 中，离线也能查看。MIT 协议开源，欢迎补充和修正。

---

项目地址

github.com/20kiki/claude-code-guide

如果这份指南帮你省掉了不必要的纠正对话或避免了一次上下文污染，不妨点个 Star ⭐ — 也欢迎 PR 补充你日常使用中的技巧。