用了半年 Claude Code,我总结了 10 条血泪教训
| 实战与进阶

用了半年 Claude Code,我总结了 10 条血泪教训

你是不是这样用 Claude Code 的?

提问题 → 得到答案 → 改代码 → 再提问……

恭喜你,你只用了它 30% 的能力。

半年时间,我用 Claude Code 完成了十几个实战项目:工具网站通过 AdSense 验证、常用脚本改造成 Agent Skills、DeepSeek OCR 网站追踪技术热点、自动化流程编写公众号内容……

这些实践让我明白一件事:Claude Code 不是聊天机器人,而是一整套编程工作流系统。

以下 10 条经验,全部来自真实踩坑。 CleanShot 2026-01-13 at 16.41.33.png


第一部分:配置优化

技巧 1:CLAUDE.md —— 让 AI 记住你的项目

每次启动都要重复说明项目结构、常用命令、代码风格?

这是在浪费生命。

在项目根目录创建 CLAUDE.md 文件,Claude 启动时会自动加载。执行 /init 命令可以自动扫描项目并生成。

一个实际项目的配置示例:

# 项目概览
个人作品集网站 - ben-pathfinder

## 技术栈
- React 18 + TypeScript + Vite
- shadcn/ui 组件库
- Tailwind CSS
- Supabase 后端
- Astro 博客子系统(在 /blog 目录)

## 常用命令
npm run dev          # 主站开发
npm run dev:all      # 同时启动主站+博客
cd blog && pnpm dev  # 只启动博客
npm run build        # 生产构建

## 博客发布注意事项(重要)
- pubDatetime 必须是过去时间,不能是未来
- 图片必须放在 blog/src/assets/images/
- 引用格式:../../assets/images/xxx.png

效果:管理几十个网站项目,每个打开 Claude Code 都能自动识别技术栈,无需重复说明。AI 理解更准确,出错率大幅降低。

技巧 2:自动批准权限,减少交互摩擦

默认情况下,Claude 每次读文件、写代码、跑命令都要手动点允许。

这种频繁确认会打断心流。

启动时加参数:

claude --dangerously-skip-permissions

更便捷的方式是配置 alias:

alias cc="claude --dangerously-skip-permissions"

之后直接输入 cc 即可。

注意:个人项目和熟悉的工作流可以放心用,处理不熟悉的代码时需要谨慎。

技巧 3:自定义 Slash 命令,固化工作流

重复性任务每次都要详细描述?

把它变成一键命令。

创建 .claude/commands/ 文件夹,然后创建命令文件(例如 部署.md):

---
name: 部署到生产环境
description: 自动化 GitHub 和 Vercel 部署流程
---

## 部署步骤
- [ ] Step 1: 运行 `pnpm run build` 检查构建
- [ ] Step 2: 创建 GitHub 私有仓库(可选,已有仓库则跳过)
- [ ] Step 3: Push 代码到 GitHub
- [ ] Step 4: 部署到 Vercel
- [ ] Step 5: 验证部署结果

**重要**:只有 build 成功后才能继续

使用时只需输入 /部署,完整流程自动执行。

实战数据:这个命令已经成功部署了十几个网站项目,流程稳定可靠。

技巧 4:Agent Skills —— 杀手级特性

这是我发现的最值得投入时间的功能

Agent Skills 的核心理念:给 Claude 配置专业技能包,一次配置长期使用。

系统采用渐进式披露设计,分三层加载:

  • Level 1 元数据(约 100 token):判断何时调用
  • Level 2 主指令(< 5000 token):匹配时读取
  • Level 3 详细资源(无限制):按需加载

实际案例:Google SEO Skill

Google SEO Guide 内容庞杂细碎,很难完全记住。我将官方文档批量下载并制作成 skill,在开发新网站或优化现有网站时,让 Claude Code 调用这个 skill 进行细节审查。


第二部分:效率提升

技巧 5:/clear vs /compact —— 别搞混了

Claude Code 提供 200K tokens 上下文,但会逐渐填满。两个命令适用于不同场景:

命令作用适用场景
/clear清空对话,保留 CLAUDE.md开始新任务、切换功能模块
/compact压缩历史,保留关键信息上下文快满但需要保留讨论内容

最佳实践:结束一个任务后不要在原对话继续提新需求,用 /clear 开始新任务。就像睡醒后工作状态更佳一样。

踩坑经验:解决复杂问题时,如果 Claude 长时间无法解决,考虑新开对话让全新的 AI 状态来处理。

技巧 6:Plan Mode —— 避免方向性错误

直接让 Claude 处理复杂任务,经常做到一半才发现方向错误。

Plan Mode 可以避免这个问题。

触发方式:

  • 明确说「先给我一个计划」
  • 按几次 Shift+Tab 切换到 Plan 模式

这个模式不会直接写代码,而是先调研和规划,你审核通过后才开始执行。

建议:开发新网站或添加新功能时,优先使用 Plan 模式。

技巧 7:Think Mode —— 激活深度思考

某些问题 Claude 的第一反应可能不正确,需要更深入的思考。

Think Mode 提供四个层级:

层级深度
think基础思考
think hard更深入
think harder很深入
ultrathink最深入

触发方式:按 Tab 键切换 think 开关,增加级别可用关键词。

适用场景

  • 遇到难题且第一个方案不奏效
  • 需要多方案对比
  • 架构设计决策

注意:简单任务用 ultrathink 会浪费时间和 token,别滥用。

技巧 8:核心快捷键

这些小技巧每天能节省数分钟,累积效果显著:

操作快捷键
引用文件Shift + 拖拽
停止执行Escape(不是 Ctrl+C!)
查看历史消息双击 Escape
表单提交方向键切换到右侧,按回车

常见错误

  • 代码执行失控时按 Ctrl+C 会导致 Claude 直接退出,正确做法是按 Escape
  • 想查看之前的对话往上翻很费力,应该双击 Escape 直接跳转

第三部分:实战应用

技巧 9:让 Claude 管理 Git 工作流

前提:安装好 GitHub CLI。

然后 Claude 可以自动完成:

  • 创建 GitHub 仓库(公开或私有)
  • 编写规范的 commit message
  • Push 代码
  • 创建 Pull Request

标准工作流

告诉 Claude「帮我把这个项目提交到 GitHub,创建私有仓库」。

Claude 会:

  1. 查看 git statusgit diff
  2. 参考项目的 commit 历史
  3. 生成规范的 commit message
  4. 执行完整的 add、commit、push 流程

实战数据:我管理的几十个网站项目都是由 Claude 完成 Git 提交。Commit message 规范详细,能够准确总结改动内容,远比手动编写的「fix bug」「update」更有价值。

最佳实践:在 CLAUDE.md 中添加一句「Commit message 用中文,参考项目历史 commit 风格」,Claude 就能理解并遵循。

技巧 10:代码 Review 的血泪教训

这是我付出最大代价学到的经验。

labubu 壁纸网站在 3 天内获得 8000 UV 流量,但一夜之间流量归零。

问题出在哪?

添加多语言功能时,让 Cursor 修改代码后只看了预览就直接 accept。没想到 Cursor 顺手将 head 标签中的 title、description 改成了中文。

这些元数据标签在网页上不可见,但搜索引擎会读取。网站从英文网站变成中文网站,英文用户搜索自然找不到。

教训:Vibe coding 一时爽,缺少 review 全盘皆输。

避免类似问题的方法

  1. 关键代码必须 review

    • SEO 相关(title、description、keywords)
    • 数据库操作
    • 支付流程
    • 权限控制
  2. 让 Claude 解释改动

    • 不确定时问「你刚才改了什么,为什么这样改」
  3. 本地验证

    • 部署前用 pnpm run build 检查报错
  4. 定期检查源代码

    • Chrome 开发者工具 → Elements 面板 → head 标签
    • 确认 title、description、Open Graph 标签正确

总结

这 10 条经验的核心只有一句话:

Claude Code 不是用来”问问题”的,而是用来”建系统”的。

  • CLAUDE.md 是你的项目记忆
  • Slash 命令是你的工作流固化
  • Agent Skills 是你的专业技能包
  • Plan Mode 是你的方向保险
  • Git 工作流是你的提交自动化

把这些配置好,你就不再是”一个人在写代码”,而是”一个人在指挥一支军队”。

去配置你的第一个 CLAUDE.md 吧。