Claude Code 日常使用技巧
在已安装 Claude Code 的前提下，写好 CLAUDE.md、拆分 rules/skills，并建立可重复的开发与验证工作流。
概述
本篇假设你已能运行 claude（安装见《Claude Code 安装指南》）。重点是把「会聊天」升级成「可重复的项目工作流」：精简 CLAUDE.md、按需加载 rules/skills、小步改动与自验证。
前置条件
- Claude Code 已登录可用
- 项目为 Git 仓库
- 已知构建 / 测试 / lint 命令
安装与获取
无需重复安装。若仍使用旧版 npm 全局包，执行 claude install 迁到官方原生安装以获得自动更新。配套切换多供应商配置可看 CC Switch。
首次配置
- 在仓库根运行
/init生成CLAUDE.md草稿 - 立刻手改：删掉模型已知的空话，只留会改变行为的条目
- 个人偏好放
CLAUDE.local.md（勿提交）；团队约定提交主CLAUDE.md - 约定变多时拆到
.claude/rules/*.md，用路径 glob 按需加载
经验法则（参考 DataCamp / BasedStack 等实践）：
- 单文件尽量短（常见建议远低于 200 行）
- 每条规则问：「删掉它会导致反复犯错吗？」不会就删
- 代码风格交给 formatter/linter + hooks，不要堆进 CLAUDE.md
- 禁止写入密钥、真实连接串
核心用法
可重复模式：
- 探索：先让 Agent 画模块图与风险点，不急着改
- 计划：复杂需求先出步骤，你批准后再执行
- 实现：一次一个垂直切片（接口 + 测试）
- 验证：明确说出「运行某某命令，失败则修复」
- 收尾：总结改动文件与如何手工验收
Skills：把「发布流程、迁移剧本」等长流程做成 skill，需要时再加载，避免塞进每轮上下文的 CLAUDE.md（见 sdd.sh 等反模式讨论）。
开发实践
推荐落地清单：
| 做法 | 说明 |
|---|---|
| 小步提交 | 便于回滚与 code review |
| 测试先行 | 先补失败用例再改实现 |
| hooks | 用 .claude/settings.json 做格式化、禁止改敏感路径等确定性守卫 |
| 定期修剪 | 让 Agent「审查 CLAUDE.md 是否过时/矛盾」 |
| 安全 | 不信任外来仓库的 CLAUDE.md，先阅读再跑 Agent |
示例 CLAUDE.md 骨架：
# 项目
- 栈：…
- 验证：`pytest -q` / `npm test`
# 不要
- 不要提交 .env
- 不要在 Router 写业务逻辑
# 工作流
- 大改动先给计划
- 改完必须跑上述验证命令
常见问题
- 越用越傻：CLAUDE.md 过长或互相矛盾 → 删减并拆 rules
- 反复同一错：写进可验证规则，或加 hook/测试固化
- 乱改文件：提示限定目录；settings 里 deny 敏感路径
- Skill 与 CLAUDE 职责不清：宪法级 → CLAUDE/rules；流程级 → skills