使用Claude Code两个月以来学到的一切
使用Claude Code两个月以来学到的一切
使用Claude Code两个月以来学到的一切 使用Claude Code两个月以来学到的一切 Modified March 30 • 身份认证与授权漏洞 按风险等级出具检测结果,并提供具体修复方案。 请参考@DETAILED GUIDE.md 查看我方安全规范。 当你说出“审查此拉取请求的安全问题”时,Claude 会读取相关描述,识别匹配条件后自动调用该技能;你也可以直接输入指令触发:/security review。 技能与普通指令的核心区别:技能可将配套文件一并打包整合。@DETAILED GUIDE.md 引用的是与 SKILL.md 同级目录下的详细文档。普通指令仅为单个文件,而技能是完整的功能包。 在社交平台 X 上走红的 /last30days 技能就是绝佳案例:开发者打造的这款技能可扫描近30天内 Reddit 与 X 平台上任意话题的内容,整合社群总结的观点,并生成可直接使用的提示词。输入 /last30days 法律问题提示技巧,它就会输出真实律师与资深用户实际在用的框架方案。这便是借助技能能够实现的功能。 个人技能存放于 /.claude/skills/ 目录,可在所有项目中通用。 规划模式:先思考,再构建 这个功能无数次帮我避免了失误。 在让 Claude 执行大型代码重构前: Code block Plain Text Copy hit twice to enter plan mode claude "analyze the database layer and propose a migration to TypeORM" Claude会浏览你的代码库,读取相关文件,分析架构,随后给出一套方案。不会进行任何修改,也不会改动任何内容,仅做分析并提出可行思路。 你可以对方案进行审阅、调整、提出疑问、指出漏洞。等你确认无误后,批准执行即可。 这能避免出现“我没让Claude重写整个项目,结果它全改了”的情况。相信我,这种体验一点都不好。永远遵循先规划、后开发的原则。 记忆系统:使用次数越多,它就越智能 Claude会自动在不同会话间保留记忆。 你只需纠正一次,比如“本项目不要使用类组件,我们用钩子函数”,它就会保存该偏好设置。下次会话时,它会自动记住,无需你重复说明。 可通过/memory指令管理记忆,文件存储路径为 /.claude/projects/<项目名 /memory/。 CLAUDE.md(团队知识库)搭配自动记忆(个人学习记录),让Claude的能力不断迭代升级。你使用得越多,它就越出色。同一个项目里,第一周的Claude和第八周的Claude,表现截然不同。 计算机操控功能 这款工具于2026年3月推出,效果十分惊艳。 Claude现在可以直接操控你的电脑: • 打开应用程序 • 浏览浏览器 • 填写电子表格 • 与任意图形用户界面进行交互 • 截取屏幕截图并根据所见内容作出响应 无需安装设置,可通过手机远程操控使用。 我目前还未深入研究,仍在测试阶段,但其带来的影响堪称颠覆性。试想一下,你让Claude“打开Figma,截取最新设计稿,再用React实现它”,而我们正一步步实现这一场景。 高级用户工作流 这些模式让我从“使用claude code”变成了“使用claude code很危险”这些都不在文档中。 审查技巧 要启动一个复杂项目?别写一大段提示词。别试图提前把所有事情都想周全。只需这样说: Code block Plain Text Copy claude "interview me in detail about what i want to build" 让Claude来向你提问。它会询问技术栈、需求、边界情况、现有代码、部署目标、用户类型这些你在提示词里容易遗漏的内容。短短十分钟的来回沟通,能为Claude提供远比五百字提示词更充分的上下文信息。 现在我开发每一个新功能都会用这个方法,无一例外。 调研与实施分离原则 永远不要让Claude在尚未理解需求的情况下直接进行开发实现。 Code block Plain Text Copy phase 1: twice → plan mode → review the analysis. make sure it actually gets it. phase 2: “先动手开发”与“先理解透彻再动手开发”之间的质量差异天差地别。尤其是在遗留代码库中,一切都和你预想的位置截然不同。 利用工作树并行开展工作 Code block Plain Text Copy terminal 1: terminal 2: 每个会话都会分配一个独立的Git分支。两个不同的Claude会话可同时开发两项功能,完成后再进行合并。 我有时会开启3个工作树:终端1处理认证功能,终端2开发API接口,终端3运行测试套件。所有任务并行执行,且彼此隔离。效率高得惊人。 上下文管理之道 这是区分普通Claude代码使用者与顶尖高手的核心技能。 上下文窗口约有20万token,听起来体量很大,但深入对话后就会发现远远不够。当上下文被占满时: • 较早的工具输出会被优先清除 • 对话内容会被自动摘要 • 最初的指令可能会丢失 请主动管理上下文: Code block Plain Text Copy — manually summarize the conversation to save space — fresh start between unrelated tasks — see what's eating your tokens and where use subagents for verbose operations (test output, log analysis, large file reads) put recurring instructions in CLAUDE.md, not in conversation 黄金法则:某件事尝试两次均失败后,就停下来,不要再继续。输入/clear 指令,重新编写一份更优质的初始提示词。一个提示词清晰、上下文全新的对话,往往比充斥着失败尝试、混乱不堪的上下文效果好得多。我为此浪费了大约6个小时才领悟到这一点。 感叹号前缀技巧 在任意命令前输入 !,即可不通过Claude直接在你的终端中运行该命令: Code block Plain Text Copy !git status !npm test !cat src/config.ts 输出结果会自动添加到Claude的上下文中。无需让Claude执行命令并等待权限提示,就能快速向其展示当前情况,非常实用。 适用于长提示词的外部编辑器 按下Ctrl+G即可打开系统默认编辑器(如Vim、VS Code等)。你可以编写带语法高亮的复杂多行提示词,保存并关闭后,内容会直接发送给Claude。 这比在终端单行输入框里输入大段文字好用得多。现在只要提示词超过两句话,我都会用这个功能。 双击Esc键回退功能 这个技巧非常实用,却很少有人提及。 如果Claude的回答偏离了方向?连续按两次Esc键,就会调出回退菜单。你可以撤销上一步操作、回退更多步骤,或选择“从此处开始总结”——该功能会压缩失败的对话内容,同时保留有用的上下文。这比执行/clear命令好得多,因为你不会丢失全部内容,只需舍弃错误部分即可。 打印这张表格,把它贴在你的显示器上。 权限模式 Claude Code 具备不同等级的自主操作权限,了解每种权限的适用场景至关重要: 先从默认模式开始。等你熟悉之后再切换到接受编辑模式(我大概用了一周时间)。在进行大规模重构前,可使用规划模式进行探索。 你也可以在 .claude/settings.json 文件中对特定命令设置白名单与黑名单: Code block Plain Text Copy { "permissions": { "allow": [ "Bash(npm run )", "Bash(git status)", "Bash(git diff )", "Read", "Write", "Edit" ], "deny": [ "Bash(rm rf )", "Bash(curl )", "Read(./.env)", "Read(./.env. )" ] } } 白名单中的指令会直接执行,无需询问;黑名单中的指令会被完全拦截。不在两个名单内的操作,Claude 都会先征求你的同意。这种折中设计是有意为之——既能提供安全保障,又不用对每条命令都进行微观管理。 Claude Code 对比 Cursor 对比 Copilot 一次客观公正的对比,不带粉丝滤镜,仅基于我的实际使用体验: Claude Code:原生基于终端,具备真正的智能体能力。可通读整个代码库,自主完成多文件修改。 适用场景:复杂代码重构、架构设计、全代码库级修改、棘手问题调试,以及所有涉及3个以上文件的开发工作。 使用感受:就像一位沉稳的资深工程师,不知疲倦,也不会对你的代码评头论足。 Cursor:原生集成于IDE(基于VS Code 二次开发)。是日常开发中代码补全、行内建议的最佳工具,在编辑器内的反馈流程更紧凑。自主性较弱,但小幅度修改时速度更快。 • 身份认证与授权漏洞 按风险等级出具检测结果,并提供具体修复方案。 请参考@DETAILED GUIDE.md 查看我方安全规范。 当你说出“审查此拉取请求的安全问题”时,Claude 会读取相关描述,识别匹配条件后自动调用该技能;你也可以直接输入指令触发:/security review。 技能与普通指令的核心区别:技能可将配套文件一并打包整合。@DETAILED GUIDE.md 引用的是与 SKILL.md 同级目录下的详细文档。普通指令仅为单个文件,而技能是完整的功能包。 在社交平台 X 上走红的 /last30days 技能就是绝佳案例:开发者打造的这款技能可扫描近30天内 Reddit 与 X 平台上任意话题的内容,整合社群总结的观点,并生成可直接使用的提示词。输入 /last30days 法律问题提示技巧,它就会输出真实律师与资深用户实际在用的框架方案。这便是借助技能能够实现的功能。 个人技能存放于 /.claude/skills/ 目录,可在所有项目中通用。 规划模式:先思考,再构建 这个功能无数次帮我避免了失误。 在让 Claude 执行大型代码重构前: Claude会浏览你的代码库,读取相关文件,分析架构,随后给出一套方案。不会进行任何修改,也不会改动任何内容,仅做分析并提出可行思路。 你可以对方案进行审阅、调整、提出疑问、指出漏洞。等你确认无误后,批准执行即可。 这能避免出现“我没让Claude重写整个项目,结果它全改了”的情况。相信我,这种体验一点都不好。永远遵循先规划、后开发的原则。 记忆系统:使用次数越多,它就越智能 Claude会自动在不同会话间保留记忆。 你只需纠正一次,比如“本项目不要使用类组件,我们用钩子函数”,它就会保存该偏好设置。下次会话时,它会自动记住,无需你重复说明。 可通过/memory指令管理记忆,文件存储路径为 /.claude/projects/<项目名 /memory/。 CLAUDE.md(团队知识库)搭配自动记忆(个人学习记录),让Claude的能力不断迭代升级。你使用得越多,它就越出色。同一个项目里,第一周的Claude和第八周的Claude,表现截然不同。 计算机操控功能 这款工具于2026年3月推出,效果十分惊艳。 Claude现在可以直接操控你的电脑: • 打开应用程序 • 浏览浏览器 • 填写电子表格 • 与任意图形用户界面进行交互 • 截取屏幕截图并根据所见内容作出响应 无需安装设置,可通过手机远程操控使用。 我目前还未深入研究,仍在测试阶段,但其带来的影响堪称颠覆性。试想一下,你让Claude“打开Figma,截取最新设计稿,再用React实现它”,而我们正一步步实现这一场景。 高级用户工作流 这些模式让我从“使用claude code”变成了“使用claude code很危险”这些都不在文档中。 审查技巧 要启动一个复杂项目?别写一大段提示词。别试图提前把所有事情都想周全。只需这样说: 让Claude来向你提问。它会询问技术栈、需求、边界情况、现有代码、部署目标、用户类型这些你在提示词里容易遗漏的内容。短短十分钟的来回沟通,能为Claude提供远比五百字提示词更充分的上下文信息。 现在我开发每一个新功能都会用这个方法,无一例外。 调研与实施分离原则 永远不要让Claude在尚未理解需求的情况下直接进行开发实现。 “先动手开发”与“先理解透彻再动手开发”之间的质量差异天差地别。尤其是在遗留代码库中,一切都和你预想的位置截然不同。 利用工作树并行开展工作 每个会话都会分配一个独立的Git分支。两个不同的Claude会话可同时开发两项功能,完成后再进行合并。 我有时会开启3个工作树:终端1处理认证功能,终端2开发API接口,终端3运行测试套件。所有任务并行执行,且彼此隔离。效率高得惊人。 上下文管理之道 这是区分普通Claude代码使用者与顶尖高手的核心技能。 上下文窗口约有20万token,听起来体量很大,但深入对话后就会发现远远不够。当上下文被占满时: • 较早的工具输出会被优先清除 • 对话内容会被自动摘要 • 最初的指令可能会丢失 请主动管理上下文: 黄金法则:某件事尝试两次均失败后,就停下来,不要再继续。输入/clear 指令,重新编写一份更优质的初始提示词。一个提示词清晰、上下文全新的对话,往往比充斥着失败尝试、混乱不堪的上下文效果好得多。我为此浪费了大约6个小时才领悟到这一点。 感叹号前缀技巧 在任意命令前输入 !,即可不通过Claude直接在你的终端中运行该命令: 输出结果会自动添加到Claude的上下文中。无需让Claude执行命令并等待权限提示,就能快速向其展示当前情况,非常实用。 适用于长提示词的外部编辑器 按下Ctrl+G即可打开系统默认编辑器(如Vim、VS Code等)。你可以编写带语法高亮的复杂多行提示词,保存并关闭后,内容会直接发送给Claude。 这比在终端单行输入框里输入大段文字好用得多。现在只要提示词超过两句话,我都会用这个功能。 双击Esc键回退功能 这个技巧非常实用,却很少有人提及。 如果Claude的回答偏离了方向?连续按两次Esc键,就会调出回退菜单。你可以撤销上一步操作、回退更多步骤,或选择“从此处开始总结”——该功能会压缩失败的对话内容,同时保留有用的上下文。这比执行/clear命令好得多,因为你不会丢失全部内容,只需舍弃错误部分即可。 打印这张表格,把它贴在你的显示器上。 权限模式 Claude Code 具备不同等级的自主操作权限,了解每种权限的适用场景至关重要: 先从默认模式开始。等你熟悉之后再切换到接受编辑模式(我大概用了一周时间)。在进行大规模重构前,可使用规划模式进行探索。 你也可以在 .claude/settings.json 文件中对特定命令设置白名单与黑名单: 白名单中的指令会直接执行,无需询问;黑名单中的指令会被完全拦截。不在两个名单内的操作,Claude 都会先征求你的同意。这种折中设计是有意为之——既能提供安全保障,又不用对每条命令都进行微观管理。 Claude Code 对比 Cursor 对比 Copilot 一次客观公正的对比,不带粉丝滤镜,仅基于我的实际使用体验: Claude Code:原生基于终端,具备真正的智能体能力。可通读整个代码库,自主完成多文件修改。 适用场景:复杂代码重构、架构设计、全代码库级修改、棘手问题调试,以及所有涉及3个以上文件的开发工作。 使用感受:就像一位沉稳的资深工程师,不知疲倦,也不会对你的代码评头论足。 Cursor:原生集成于IDE(基于VS Code 二次开发)。是日常开发中代码补全、行内建议的最佳工具,在编辑器内的反馈流程更紧凑。自主性较弱,但小幅度修改时速度更快。 适用场景:快速编辑、行内代码补全、保持编码流畅度进行开发。 GitHub Copilot:以插件形式接入。免费版体验最佳(每月10美元),也是企业场景中最稳妥的选择。智能体能力在持续提升,但仍落后于 Claude Code 和 Cursor。 很多人都没意识到:你不必只选一个。 组合使用才是实用方案,也是多数高阶开发者的真实做法——用 Cursor 完成日常代码补全和行内编辑,用 Claude Code 处理繁重的代码重构、新功能开发、调试和架构设计。 数据也印证了这一点:资深开发者平均会使用2.3款AI编程工具。核心不是用一个替代另一个,而是让合适的工具做合适的事。 Claude Code 在不到一年的时间里,从无到有成为最受欢迎的AI编程工具第一名。2026年初的调查显示,46%的开发者将其评为最爱;95%的开发者每周都会使用AI工具,75%的开发者一半以上的编码工作依靠AI完成。 行业规则已经永久改变。问题不再是“要不要用AI编程工具”,而是“你能多快熟练掌握它们”。 Claude Code 生态体系 社区围绕 Claude Code 构建了大量实用工具,以下是值得了解的几款: Superpowers(obra/superpowers):一套面向AI编程智能体的完整开发方法论,在GitHub上收获超11.7万星标。它会改变智能体的编码逻辑,强制其先进行思路梳理,制定详细的实施方案,启动子智能体协作开发,并在完成前开展两轮代码审查。如果你觉得 Claude Code 有时会写出杂乱无章的代码,这款工具能解决问题。 GSD(Get Shit Done):面向 Claude Code 的元提示与上下文管理系统,轻量却强大,可解决上下文衰减问题。 awesome claude code:社区整理的优质资源合集,涵盖技巧、智能体和MCP服务器,是探索 Claude Code 生态的起点。 /last30days 技能:一款爆红的工具。可检索近30天内Reddit、X、YouTube、黑客新闻及全网任意主题内容,将社区经验整合为可直接使用的提示词。输入/last30days 冷邮件框架,它就能找到3P框架、ADA原则、意图触发逻辑等你自行难以发现的干货,再基于实战经验生成可直接使用的提示词。开源免费,采用MIT协议。 Claude How To:可视化、案例驱动的 Claude Code 精通指南,适合偏好结构化教程的视觉型学习者。 Claude Mem:持久化记忆层,适用于内置记忆系统无法满足工作流需求的场景。 UI UX Pro Max:面向 Claude Code 的设计向工具,让 Claude 不仅关注功能实现,更注重界面视觉效果。 n8n MCP:将 Claude Code 与n8n工作流自动化工具打通,如果你已在使用n8n,这款集成工具必不可少。 整个生态发展迅猛,每周都有新工具上线。以下仅为我实际使用过、或见证过实际效果的工具,而非大而全的清单,只推荐当下真正有用的几款。 常见误区(这些错误我全都犯过) 1. 在CLAUDE.md里写长篇大论 内容控制在200行以内,具体且可执行。如果 Claude 无视你的指令,多半是CLAUDE.md篇幅过长。我曾写过400行的说明,几乎等同于一份宣言,精简到150行后,效果大幅提升。 2. 任务切换时不使用/clear指令 修复CSS样式bug的对话上下文,对实现新API接口毫无用处,残留的上下文反而会降低执行效率。每次切换任务都清空上下文,重新开始。 3. 强行纠正而非重新启动 两次尝试失败后,上下文已被错误思路污染,Claude 会不断引用自身错误。输入/clear并优化提示词,全新的上下文往往能一次性解决问题。我曾为此浪费6小时才明白这个道理。 4. 不使用子智能体 在主对话中运行完整测试套件,会让上下文充斥数百行输出内容。将这类任务交给子智能体,保持主对话简洁,聚焦核心工作。 5. 所有任务都用Opus模型 Sonnet 足以完美处理90%的工作,Opus 仅适用于10%需要深度推理的场景——复杂架构设计、高难度调试、细微逻辑错误。你的钱包会感谢这个选择,我的确实如此。 6. 大规模修改时忽略规划模式 任何涉及3个以上文件的修改,务必先制定方案。花5分钟审核方案,能避免因 Claude 偏离方向而耗费2小时清理问题。 7. 不主动管理上下文 上下文窗口是一种资源,要合理利用。内容过长时使用/compact压缩,繁琐操作交给子智能体,用CLAUDE.md统一存放指令,而非每次会话重复输入。擅长管理上下文的开发者,获得的效果远优于其他人。 总结 Claude Code 不只是一款工具,更是一名队友。 它能通读你的整个代码库,遵循你的编码规范,运行测试用例,创建拉取请求,记住你的使用偏好,对接所有工具,且越用越智能。 我接触它仅两个月,完成了相关课程、考取了认证,每天都在实战开发。我可以十分肯定地说:学会与 Claude Code 协同工作,而非单纯粘贴代码的开发者,其交付速度在一年前是难以想象的。 2026年,你拥有一款能自主遍历5万行代码库、精准完成多文件修改、运行测试、自主修复bug、附带文档生成拉取请求的AI智能体。这是前人梦寐以求的能力。 别再收藏AI相关文章,动手用它创造价值。 如果这篇内容对你有帮助,分享给还在往ChatGPT里复制粘贴代码的人,他们比你更需要这些。 find me → @axel bitblaze69 @axel bitblaze69 🔗 原文链接: https://x.com/Axel bitblaze69/statu... https://x.com/Axel bitblaze69/statu... 现在是2026年3月,如果你还在把代码复制粘贴到ChatGPT里,那我们真得好好聊聊了。 过去两个月,我一直在深度使用Claude Code,不是随便玩玩,而是每天都在实战一线深耕。我完成了相关课程,考取了认证,用它搭建项目,搞砸过功能,再逐一修复,接着开发更多功能。我在终端里和Claude交流的时间,甚至比和现实中的人交谈还要多。 这不是一篇罗列“十大AI工具”的水文,而是我全部的实战心得:那些鲜有人提及的功能、真正高效可用的工作流、让我耗费数小时才踩完的坑,以及帮我节省数天时间的技巧。 收藏好这篇内容,你以后肯定不止一次用得上。 Claude Code究竟是什么 首先我要破除一个最大的误区:Claude Code不是Copilot,不是你用来粘贴代码的聊天机器人,也不是加强版的代码自动补全工具。 它是一个智能体,一个真正的自主智能体,能够: • 通读你的整个代码库 • 规划实现方案 • 编辑整个项目中的各类文件 • 运行你的测试程序 • 发现失败问题并进行修复 • 反复迭代直至任务完成 核心关键词是智能体化。它以循环模式运行:收集上下文、执行操作、验证结果、不断重复。你只需告诉它你的目标,它会自行规划实现路径。你们并非协同编写代码,而是你将任务委派给一个真正能理解所读内容的实体。 它运行在你的终端中。这并非局限,恰恰是其设计核心。终端是你设备上最强大的交互界面,Claude Code 正是为此而生。 运行环境: Claude code 不再只是一款命令行工具,它无处不在。 • 终端:经典原生版本。功能完整,速度最快。奇迹在此发生。 • VS Code 扩展:支持行内差异对比、@提及、侧边栏对话。适合重度依赖编辑器的开发者。 • JetBrains 插件:功能同上,专为 IntelliJ 系列用户打造。 • 桌面应用(Claude Cowork):可视化差异评审、多会话管理、定时任务。无需使用终端,专为“不使用命令行”的用户设计。 • 网页应用(claude.ai/code):无需本地配置。随时随地运行耗时任务,打开浏览器即可使用。 • 移动端远程控制:在笔记本电脑上启动会话,通过手机进行操控。 • Slack:在工作区中@Claude,即可在聊天中将问题转化为拉取请求。 • GitHub Actions:在拉取请求评论中@claude,它将直接返回可落地的代码修改。 • GitLab CI/CD:为 GitLab 团队提供相同能力。 远程控制功能一直被低估,鲜有人提及。你正在吃午饭时,收到一条关于程序漏洞的Slack消息,掏出手机,让Claude修复这个问题。代码会在你家中的电脑上运行,你在手机上查看代码差异,确认通过,任务完成。伙计们,未来已来。 开始使用 安装: 然后: 就是这样。无需配置文件,无需安装向导,不用安装47个扩展插件,告别繁琐的YAML配置。只需进入你的项目目录,输入claude即可。 你需要做的第一件事: 看着它遍历你的代码库、读取文件、解析架构,然后为你生成总结。当它首次精准概括一个超两万行代码的代码仓库时,你会瞬间恍然大悟。那一刻你才明白,这绝非普通的代码补全。 模型说明 Claude Code 基于 Anthropic 旗下的 Claude 模型系列运行。选对模型、用对场景,就成功了一半: • Claude Opus 4.6:智慧核心,推理能力顶尖。适用于复杂架构决策、高难度调试、涉及10个以上文件的大规模重构等需要深度思考的场景。 • Claude Sonnet 4.6:主力模型,默认首选。在日常编程任务中,速度、成本与效果达到最优平衡,是日常开发的核心选择。 • Claude Haiku:极速模型,经济高效。适合简单任务与子代理调用,处理快速查询时表现出色,不容小觑。 可随时切换模型: 我是通过惨痛教训总结出的经验:让投入的算力与问题难度相匹配。别把Opus的令牌浪费在修改变量名这种小事上,也别用Haiku去重新设计你的认证系统。刚使用的第一周,我因为觉得Opus“更智能”,不管什么任务都用它,大概浪费了200美元。而Sonnet能以几乎相同的效果完成90%的任务。 你还可以独立于模型之外,自主控制思考深度: 定价(实话实说) 咱们坦诚聊聊费用问题,毕竟没人会这么直白地说: 来自Anthropic官方的真实数据:开发者日均花费约6美元,90%用户日均花费低于12美元。 有一组惊人数据彻底说服了我:有一位开发者在8个月内使用了100亿个Token,若按API计费标准计算,费用约为15000美元;而选用最高套餐,仅需800美元。如果你每天都在使用(本就该如此),最高套餐在第二周就能回本。 当你达到最高套餐的使用限额时,可开启“超额使用”功能,费用按API费率计算,不会硬性断连,也不会出现“抱歉,请明日再试”的提示。 这些成本管理技巧,我真希望第一天就知道: .claude 文件夹——你的项目控制中心 大多数人都会在这里白白浪费掉80%的潜在价值。.claude 文件夹并非黑箱,它是 Claude 在你的项目中运行行为的控制中心。 而大多数人并未意识到:.claude 目录其实有两个,而非一个。 第一个位于你的项目内部(会提交至 Git,与团队共享);第二个则存放在 /.claude/ 路径下(用于存储个人偏好、本机状态和会话历史)。 CLAUDE.md:至关重要的核心文件 启动Claude代码会话时,它首先读取的就是CLAUDE.md文件,并将其内容直接加载到系统提示词中。文件里的所有指令,Claude都会在每一次会话中始终如一地遵守。 如果你要求Claude在实现功能前先编写测试用例,它就会照做;如果你规定“禁止使用console.log,改用自定义日志工具”,它每次都会严格遵守。 应写入的内容: • 构建、测试与代码检查命令(如npm run test、make build) • 关键架构决策(例如“我们采用搭配Turborepo的单体仓库架构”) • 容易被忽略的注意事项(例如“已开启TypeScript严格模式,未使用变量会报错”) • 导入规范、命名规则、错误处理风格 • 核心模块的文件与文件夹结构 不应写入的内容: • 本应配置在代码检查工具或格式化工具中的内容(这些由Prettier等工具处理,而非CLAUDE.md) • 已有可链接地址的完整文档 • 长篇大论的理论阐述 请将内容控制在200行以内。文件过长会占用过多上下文空间,反而会降低Claude对指令的执行效果。我曾有过惨痛教训:一份400行的CLAUDE.md经常被Claude忽略一半内容,精简到150行后,效果明显改善。 以下是一份优质CLAUDE.md文件的示例: 这一共20行内容,为Claude提供了在该代码库中高效工作所需的全部信息,无需反复进行说明确认。 CLAUDE.local.md:个人专属配置项 有时你会有仅适用于自己、而非团队通用的偏好设置。比如你可能更倾向使用另一款测试运行工具,或是希望Clau