当前位置： 首页 > article >正文

CLAUDE.md：90%人用错了

article 2026/4/20 2:15:07
CLAUDE.md90%人用错了我用这个文件让AI记住我项目的所有秘密。先讲个故事上周团队新来一个实习生。我让他帮改个功能3小时没搞定。后来我自己上10分钟改完了。差距在哪不是我比他强是我知道这个项目的所有破事。哪个文件是干什么的、哪些代码碰不得、接口在哪、全局变量叫什么——我全清楚。AI也一样。CLAUDE.md 是什么简单说给AI看的项目说明书。你创一个文件叫CLAUDE.md扔项目根目录。每次启动Claude Code它自动就读。就这对但90%人写不对。常见错误1. 当 README 写❌# 这个项目叫XXX使用React Node 安装npminstall这不是给AI看的是给人看的。2. 写得太简略❌项目技术栈Next.jsAI需要知道的是哪个目录是干嘛的哪些接口能动、哪些不能动编码规范是什么怎么跑测试3. 一次写完不更新项目变了CLAUDE.md没变。久了就不准了。正确写法基础版# 项目概述 这是一个给朋友做的思维导图工具... # 技术栈 - Next.js 14App Router - Tailwind CSS - AI接口OpenAI # 目录结构 /src/app 页面路由 /src/components 组件 /src/lib 工具函数 # 重要文件 - src/app/page.tsx 首页禁止乱改 - src/lib/ai.ts AI调用逻辑 # 规范 - 组件用 .tsx .module.css - 不用的代码直接删别注释进阶版再加这些# 编码规范 - 组件名用 PascalCase - CSS用 BEM 或模块化 - API错误要捕获 # 常见问题 - 导出功能有时失灵可能是API超时 - 用户登录态存localStorage # 测试 - 测试文件放 __tests__ - 跑测试npm test核心心法把AI当新人教。你招一个新人你会告诉他这里是哪干嘛的什么能碰什么不能出了问题找谁CLAUDE.md就写这些。我的习惯每次接新需求我会先更新CLAUDE.md加需求背景——这次要做啥标新文件——要新增/改哪些列风险——哪块可能坑久而久之AI比我更懂这个项目你CLAUDE.md怎么写的评论区聊聊。

相关文章：

CLAUDE.md：90%人用错了

CLAUDE.md：90%人用错了 我用这个文件，让AI记住我项目的所有秘密。先讲个故事 上周，团队新来一个实习生。 我让他帮改个功能，3小时没搞定。后来我自己上，10分钟改完了。 差距在哪？ 不是我比他强，…...

编程日记 2026/4/20 2:15:07

Canvas水印实战：5分钟搞定前端图片防盗，附完整代码与避坑指南

Canvas水印实战：5分钟实现前端图片版权保护 在数字内容爆炸式增长的今天，图片盗用已成为困扰创作者的核心痛点。最近一位独立摄影师发现，其发布于社交平台的作品被某电商商家直接盗用，导致每月损失近万元订单。这样的案例并非孤例…...

编程日记 2026/4/20 2:15:07

2026年，泉州创业者资源对接会哪个好用？

创业这条道路，就像是在茫茫大海中航行，充满了未知和挑战。对于泉州的创业者们来说，找到靠谱的资源对接会，就如同找到了一座明亮的灯塔，能指引我们少走弯路。最近就有不少朋友问我，2026年泉州创业者资源对接…...

编程日记 2026/4/20 2:15:07

告别龟速下载！Hugging Face预训练模型（BERT/RoBERTa）手动下载与本地加载保姆级教程

突破网络限制：Hugging Face模型高效下载与本地化实战指南 1. 为什么我们需要离线加载Hugging Face模型？ 国内开发者在尝试使用Hugging Face的预训练模型时，经常会遇到下载速度极慢甚至完全无法连接的问题。这种情况在高校网络环境或某些特定…...

编程日记 2026/4/20 2:15:05

从光敏电阻到麦克风：用单片机AD/DA和运放搞定传感器信号采集（附电路分析）

从光敏电阻到麦克风：用单片机AD/DA和运放搞定传感器信号采集（附电路分析） 当我们需要将现实世界中的光强、温度或声音信号转化为数字信号进行处理时，传感器信号采集系统就成为了连接物理世界与数字世界的桥梁。本文将带你从零开始…...

编程日记 2026/4/20 2:13:05

Vibe Coding 完全实战手册：2026年 AI 辅助编程工作流从入门到精通

什么是 Vibe Coding？ Vibe Coding（氛围编程）是 2025 年由 Andrej Karpathy 提出、2026 年已被 91% 工程团队采用的 AI 辅助编程范式。它的核心思想是：用自然语言描述意图，让 AI 写代码，人负责审查和方向把控…...

编程日记 2026/4/20 2:13:05

Ostrakon-VL像素终端部署：离线环境无网络依赖运行方案

Ostrakon-VL像素终端部署：离线环境无网络依赖运行方案 1. 项目背景与特点 1.1 像素特工终端简介 Ostrakon-VL像素终端是一款专为零售与餐饮场景设计的离线多模态识别系统。它基于Ostrakon-VL-8B模型开发，采用独特的8-bit像素风格界面，将复…...

编程日记 2026/4/20 2:13:04

从STRIDE到EVITA：聊聊车载网络威胁建模中，那个更适合你的安全属性模型

车载网络安全建模：STRIDE与EVITA模型的深度对比与应用指南 当工程师第一次面对车载网络威胁建模时，往往会被各种安全属性模型的选择所困扰。就像一位汽车设计师需要根据车辆用途选择不同的材料——跑车需要轻量化碳纤维，越野车需要高强度钢架…...

编程日记 2026/4/20 2:13:04

NLP学习笔记13：BERT系列模型——从预训练到 RoBERTa 与 ALBERT

NLP学习笔记13：BERT系列模型——从预训练到 RoBERTa 与 ALBERT 作者：Ye Shun 日期：2026-04-19 一、前言 在现代自然语言处理的发展历程中，BERT（Bidirectional Encoder Representations from Transformers） …...

编程日记 2026/4/20 2:12:59

别再让视频裸奔了！手把手教你用PolyV思路给m3u8视频上三道锁（含动态Key实战）

企业级视频版权保护实战：构建动态加密的三重防御体系 最近帮一家在线教育平台做技术咨询时，他们刚上线的付费课程视频不到一周就被扒得干干净净——各种下载工具直接抓取m3u8清单，批量下载ts切片，甚至有人把完整课程挂在二手平台低…...

编程日记 2026/4/20 2:10:59

OCR数据集哪家强？ICDAR/CTW/Total-Text等8大主流数据集实战评测与下载指北

OCR数据集实战评测：ICDAR/CTW/Total-Text等8大主流数据集深度解析 当我们需要构建一个OCR系统时，数据集的选择往往决定了模型的性能上限。面对市面上众多的OCR数据集，工程师们常常陷入选择困难：究竟哪个数据集最适合我的项目需求&…...

编程日记 2026/4/20 2:10:59

UE4/UE5委托实战避坑：从触发器交互到UI响应，手把手教你四种委托的正确用法

UE4/UE5委托实战避坑指南：从触发器交互到UI响应的四种委托深度解析 在虚幻引擎开发中，委托系统是实现对象间通信的核心机制之一。很多开发者虽然了解基础语法，但在实际项目中面对触发器交互、UI响应等具体场景时，常常陷入选择困境…...

编程日记 2026/4/20 2:10:59

告别DrawCall卡顿！Unity 2022最新Sprite Atlas图集打包保姆级教程（含旧版本迁移指南）

Unity 2022 Sprite Atlas图集优化全攻略：从原理到性能调优实战 最近在优化一个Unity项目时，发现UI界面在低端设备上频繁出现卡顿。通过Profiler分析，发现DrawCall数量高达200，而其中大部分都来自UI精灵的渲染。这让我重新审视了Sp…...

编程日记 2026/4/20 2:10:58

TypeScript的template literal types实现SQL查询的类型安全

在现代Web开发中，TypeScript因其强大的类型系统而备受青睐。数据库操作中的SQL查询仍然是一个容易出错的领域，尤其是拼接字符串时容易引发SQL注入或字段名错误。TypeScript 4.1引入的template literal types为解决这一问题提供了新思路，它允许…...

编程日记 2026/4/20 2:10:58

面试官问我CSMA/CD的‘截断二进制指数规避算法’怎么算，我用这个例子讲明白了

面试官问我CSMA/CD的‘截断二进制指数规避算法’怎么算，我用这个例子讲明白了 在计算机网络面试中，CSMA/CD协议及其核心算法——截断二进制指数规避算法，几乎是必考的知识点。记得我第一次被问到"碰撞11次后随机数r的取值范围是多少&quo…...

编程日记 2026/4/20 2:08:58

条款04：确定对象被使用前已先被初始化

C并不能保证每个对象在定义时都被自动初始化。就像书中第一条提到的一样，C包含多种子语言，例如定义一个C风格的整型数组(int[])时，其中就可能包含非零初始化的元素，而在定义标准库(STL)中的容器时，例如一个整型向量(st…...

编程日记 2026/4/20 2:08:58

STM32 IAP升级后中断失灵？别慌，检查一下BootLoader里这个寄存器

STM32 IAP升级后中断失灵？深入解析FAULTMASK寄存器的关键作用 最近在嵌入式开发社区中，不少工程师反馈在进行STM32的IAP（In-Application Programming）升级后，应用程序的主循环能够正常运行，但所有中断都无法…...

编程日记 2026/4/20 2:08:57

MySQL触发器实现级联删除效果_MySQL触发器替代外键操作

在 MySQL 中，订单表的 DELETE 触发器无法删除关联的订单项，因触发器禁止修改自身触发表；唯一可行方案是在 orders 表上创建 AFTER DELETE 触发器执行子表删除，但其不参与事务回滚，易致数据不一致，故推荐优先…...

编程日记 2026/4/20 2:06:57

R3nzSkin国服换肤工具：英雄联盟国服免费皮肤修改器完整教程

R3nzSkin国服换肤工具：英雄联盟国服免费皮肤修改器完整教程 【免费下载链接】R3nzSkin-For-China-Server Skin changer for League of Legends (LOL) 项目地址: https://gitcode.com/gh_mirrors/r3/R3nzSkin-For-China-Server R3nzSkin国服特供版是一款专为英…...

编程日记 2026/4/20 2:06:57

第三章 10.11.12上机实践

import math 输入三条边 a float(input("请输入三角形的边A: ")) b float(input("请输入三角形的边B: ")) c float(input("请输入三角形的边C: ")) 判断是否能构成三角形 if a > 0 and b > 0 and c > 0 and a b > c and a c &g…...

编程日记 2026/4/20 2:06:57

深度剖析成都奥迪 A6L 的 AP 卡钳升级之路

# 深度剖析成都奥迪A6L的AP卡钳升级之路 在汽车改装领域，制动系统的升级对于提升车辆性能与安全性至关重要。对于成都的奥迪A6L车主而言，AP卡钳升级成为优化驾驶体验的热门选择。但一个关键问题浮现：奥迪AP卡钳升级在成都哪里做呢&#xff1f…...

编程日记 2026/4/20 2:06:57

Day03：ReAct架构概述：从_军师_到_将军_的进化

文章目录一、ReAct架构概述：从"军师"到"将军"的进化一、ReAct 架构概述：从 "军师" 到 "将军" 的进化二、ReAct 的工作模式：让 AI 像人类一样思考和行动2.1 核心循环机制：Thought-Action-…...

编程日记 2026/4/20 2:06:57

LLM 推理加速实战：vLLM 与 TensorRT-LLM 深度对比

LLM 推理加速实战：vLLM 与 TensorRT-LLM 深度对比 前言：随着大语言模型在生产环境中的广泛应用，推理性能成为关键瓶颈。一个 70B 参数的模型，单次推理可能需要数秒甚至数十秒。本文将深入剖析两大主流推理加速框架——vLLM 和 TensorRT-LLM，从原理到实践，帮助你选择最适合…...

编程日记 2026/4/20 2:05:11

别再死记硬背了！用一张图+实战案例，彻底搞懂BGP选路12条规则（华为设备）

可视化拆解BGP选路：从决策树到实战负载均衡 第一次接触BGP选路规则时，看着密密麻麻的12条规则列表，我的大脑就像路由器遇到路由环路一样陷入死循环。直到在项目中出现多路径选择错误，才意识到死记硬背的规则根本经不起真实网络的考…...

编程日记 2026/4/20 2:05:11

补码：计算机减法变加法的魔法（深入剖析）

1. 为什么计算机需要补码？ 我第一次接触补码这个概念时，也是一头雾水。计算机明明可以直接用二进制表示数字，为什么还要搞出源码、反码、补码这么复杂的东西？后来在实际项目中遇到一个简单的减法运算问题，才真正理解了…...

编程日记 2026/4/20 2:05:10

OpenCV中solvePnP的EPnP选项到底是怎么工作的？一个代码与公式的对照解析

OpenCV中solvePnP的EPnP选项到底是怎么工作的？一个代码与公式的对照解析 当你在计算机视觉项目中调用cv::solvePnP函数并选择SOLVEPNP_EPNP标志时，是否曾好奇这个黑箱内部究竟发生了什么？本文将以代码实现与数学公式双重视角，为你…...

编程日记 2026/4/20 2:05:09

技术人如何从肯尼迪就职演说中学习高效沟通与演讲技巧（附英文原文精读）

技术人如何从肯尼迪就职演说中学习高效沟通与演讲技巧 当技术人站在会议室白板前讲解架构设计，或在行业峰会聚光灯下演示创新成果时，有多少人思考过：为什么有些技术分享令人昏昏欲睡，而有些却能引发全场共鸣？肯尼迪196…...

编程日记 2026/4/20 2:05:07

如何查询SQL数据库的连接数状态_查询全局运行参数

查MySQL连接数应根据需求选择：SHOW STATUS LIKE Threads_connected获当前打开连接数（含空闲），轻量适合监控；SHOW PROCESSLIST列线程详情（含SQL、用户、状态），但权限受限且默认仅前10…...

编程日记 2026/4/20 2:01:17

python kics

## 关于 Python KICS，一次不那么官方的漫谈 最近在几个基础架构和安全相关的项目里，又遇到了那个老生常谈的问题：如何在代码部署前，就发现那些隐藏在基础设施即代码（IaC）配置里的安全隐患？像 Te…...

编程日记 2026/4/20 2:01:17

python tfsec

## 关于 Python 中的 tfsec：一个安全工程师的视角 如果你在 Python 项目中处理过 Terraform 代码，或者你的团队同时维护着基础设施即代码和应用程序代码，那么你很可能遇到过这样一个问题：如何确保那些定义云资源的 .tf 文件是安全…...

编程日记 2026/4/20 2:01:16