如何教 Claude 识别并使用公司内部的代码规范?

胖磊小哥_3520

胖磊小哥_3520

2026-05-03

405人浏览

原创

应通过五步解决:一、用/init生成含项目语义的claude.md;二、在文件末尾添加# company code standards区块,写入“做什么+为什么”的专属规范;三、遇违规代码时按#键将错误作为训练信号追加至claude.md;四、在claude.md中添加自动运行npm run lint校验指令;五、在templates/下创建standard-dev.md模板,嵌入规范钩子并用/template调用。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如何教 claude 识别并使用公司内部的代码规范?

如果您希望 Claude 在开发过程中自动识别并遵循公司内部的代码规范,但当前它仍按通用风格生成代码,则说明 CLAUDE.md 中尚未注入规范约束或未建立有效反馈机制。以下是解决此问题的步骤:

一、初始化项目并生成基础 CLAUDE.md

CLAUDE.md 是 Claude Code 每次会话启动时优先读取的核心配置文件,它决定了 AI 对项目上下文的理解深度与行为边界。必须通过 /init 命令触发自动生成,而非手动创建空文件,否则无法绑定项目结构语义。

1、在终端中进入项目根目录,确保 package.json、tsconfig.json、.eslintrc.cjs 等关键配置文件存在。

2、输入 /init 并回车,等待 Claude 扫描完成并输出初始 CLAUDE.md 内容。

3、检查生成的文件是否包含技术栈识别(如 “TypeScript + React + ESLint”)、目录结构摘要(如 “components/ 下为函数组件,hooks/ 存放自定义 Hook”)等上下文锚点。

二、注入公司专属规范条目

规范条目必须聚焦“项目特有”“非标准”“易出错”三类内容,避免重复通用规则(如“使用分号”),而应强调团队约定的例外情形和强制逻辑。

1、打开 CLAUDE.md,在末尾新增一个名为 # Company Code Standards 的区块。

2、逐条写入不可协商的规范,每条需含“做什么”+“为什么”,例如:
“禁止在 hooks/ 目录下使用 export default,必须用 export const useXxx = …;因为 Storybook 预览器依赖命名导出解析”。

3、对命名规则添加反例对比:
“API 请求函数统一以 fetch 开头,如 fetchUserProfile;禁止使用 get / load / request 等前缀,因 CI 流水线中的 linter 规则仅匹配 fetch* 正则模式”。

三、用真实错误驱动规范固化

当 Claude 违反规范生成代码时,不直接修改输出,而是将该错误作为训练信号写入 CLAUDE.md,使 AI 形成条件反射式规避能力。

1、运行一次任务后,若发现其生成了 class 组件(而团队已禁用),立即按下 # 键。

One API key for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
One API key for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more

统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。

下载

2、在弹出的指令框中输入:
"禁止生成 class 组件;所有新组件必须是函数组件 + React.memo + TypeScript 接口定义;因为我们已移除所有 legacy lifecycle 方法且测试覆盖率工具不支持 class 快照"。

3、确认提交后,Claude 会将该条指令追加至 CLAUDE.md,并在后续所有会话中优先加载。

四、构建规范验证闭环

仅靠文本约束不足以保障执行,需引入可执行校验环节,让 Claude 主动调用本地工具链验证自身输出是否合规。

1、在 CLAUDE.md 中添加指令:
"每次生成代码后,必须运行 npm run lint -- --fix 并报告错误数;若错误数 > 0,需重新生成直至零错误"。

2、确保项目中已配置 ESLint 插件 @company/eslint-config,并在 package.json 的 scripts 中定义 lint 命令。

3、在 Claude Code 中执行任意代码生成任务后,观察其是否自动调用 lint 命令并展示结果;若未触发,说明 CLI 权限未开启或路径配置异常。

五、设置规范感知型提示词模板

在 templates/ 目录下创建 standard-dev.md,内嵌带规范钩子的自然语言指令,供日常开发直接调用,避免每次重复描述。

1、新建文件 Claude-Workspace/templates/standard-dev.md。

2、写入以下内容:
"请严格按公司代码规范实现:① 使用函数组件 + React.memo;② Props 类型定义在 interface Props { ... } 中;③ 所有副作用封装进自定义 Hook;④ 提交前运行 eslint --fix 并确认无报错。请先输出计划,等待我确认后再执行。"

3、今后开发新组件时,在 Claude Code 中输入 /template standard-dev 即可激活整套规范流程。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

claude 代码规范

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Claude 新手入门教程
Claude 新手入门教程

本专题围绕 Claude 的基础使用与实际应用展开,面向零基础用户与初学者,系统梳理从“认识工具”到“高效使用”的完整路径。

2026.03.27

2571

19

Claude 提示词使用指南
Claude 提示词使用指南

本专题聚焦 Claude 的提示词(Prompt)设计与优化方法,围绕“如何让 AI 更准确理解需求并输出高质量结果”这一核心问题展开。内容从基础结构入手,逐步深入到复杂场景下的提示词构建策略,帮助用户建立清晰、可复用的提示词体系。

2026.03.27

474

20

Claude 进阶使用指南
Claude 进阶使用指南

本专题面向已经具备基础使用经验的用户,深入解析 Claude 在复杂场景中的高阶应用方式,重点解决“如何让 AI 真正参与到实际工作流程中”的问题。让 Claude 成为日常工作中可持续复用的效率引擎,在内容创作、开发实践与信息处理等多个领域实现显著提效。

2026.03.27

419

16

AI Agent 实战指南:从评测到落地
AI Agent 实战指南:从评测到落地

全面评测 Manus AI 与 ChatGPT、Claude、OpenAI Operator 等 AI Agent 产品,分析自动化能力、工作流与实际生产力差异。

2026.05.29

373

15

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

60

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

20

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

20

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

20

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Claude Code 快速上手核心指南
Claude Code 快速上手核心指南

共0课时 | 0人学习

Claude Code 官方文档
Claude Code 官方文档

共0课时 | 0人学习

Claude Code 官方中文文档
Claude Code 官方中文文档

共0课时 | 0人学习