实用教程:让你的AI编程助手从”临时工”变成”项目合伙人”
如果你还在把Claude Code当成一个"问答机器人",那你就错过了它最强大的功能!项目根目录下的.claude/文件夹,就是让Claude Code从"临时工"变成"项目合伙人"的秘密武器。
简单来说:这个文件夹决定了Claude在你的项目里会:
- ✅ 遵守什么规则
- ✅ 执行什么命令
- ✅ 调用什么技能
- ✅ 记住什么偏好
- ✅ 按什么方式协作
项目根目录/.claude/
作用:团队规则、项目规范、共享命令
建议:纳入Git版本控制
用户主目录/.claude/
作用:个人偏好、全局命令、本机状态
一句话总结:
- 项目级:"这个项目里Claude应该怎么工作"
- 全局级:"你个人希望Claude怎么配合你"
# 项目:电商API 开发命令 npm run dev # 开发服务器 npm run test # 运行测试 npm run build # 构建生产版本 架构说明 - Express REST API - PostgreSQL + Prisma - 业务逻辑在src/services/ 编码规范 - 使用zod进行请求验证 - 返回格式统一{data, error} - 使用logger,不用console.log
- 🔥 控制在200行以内:只写高频使用的关键信息
- 🔥 避免大段理论:Claude能读懂你的代码结构
- 🔥 重点突出:把容易踩坑的地方明确标出
当你的CLAUDE.md超过100行时,就该考虑拆分规则了!
.claude/rules/ ├── code-style.md # 代码风格 ├── api-conventions.md # API规范 ├── testing.md # 测试规范 └── security.md # 安全规范
在规则文件开头添加:
--- paths: - "src/api//*.ts" # 只在API文件生效 - "src/handlers//*.ts" # 只在handler文件生效 --- # API设计规则 - 所有handler返回{data, error} - 使用zod进行请求验证 - 不暴露内部错误详情
好处:不同代码区域有不同的约束,避免规则污染!
每个markdown文件就是一个命令:
review.md→ 输入/project:reviewdeploy.md→ 输入/project:deploy
review.md(代码审查命令)
# 代码审查命令 请审查当前的代码改动,重点关注: - 代码风格一致性 - 潜在的性能问题 - 安全风险 - 测试覆盖情况 当前git diff: }
deploy.md(部署命令)
# 部署流程检查 请检查部署前的准备工作: - 环境变量配置 - 数据库迁移 - 静态资源构建 - 健康检查端点
不只是快捷输入,而是带上下文的完整工作流!
- 命令:你手动调用
- 技能:Claude自动识别使用
.claude/skills/ ├── security-review/ # 安全审查技能 │ ├── SKILL.md │ └── templates/ └── code-refactor/ # 代码重构技能 ├── SKILL.md └── patterns/
- 🔒 安全漏洞扫描
- 📊 性能优化建议
- 📝 文档自动生成
- 🔄 代码重构指导
当任务太复杂,一个会话搞不定时!
.claude/agents/ ├── code-reviewer.md # 代码审查专家 └── security-auditor.md # 安全审计专家
- 🎯 专业分工:不同agent专注不同领域
- 🧠 上下文隔离:复杂任务不干扰主会话
- 🔐 权限控制:安全agent只给读权限
.claude/ ├── CLAUDE.md # 核心配置 ├── rules/ # 规则分层 │ ├── code-style.md │ ├── api-conventions.md │ └── security.md ├── commands/ # 自定义命令 │ ├── review.md │ └── deploy.md ├── skills/ # 技能封装 │ └── security-review/ └── agents/ # 任务代理 └── code-reviewer.md
CLAUDE.md
# 项目:React + Node.js全栈应用 技术栈 前端:React + TypeScript + Vite 后端:Node.js + Express + PostgreSQL 开发命令 前端 npm run dev # 开发服务器 npm run build # 生产构建 npm run preview # 预览构建结果 后端 npm run dev # 开发服务器 npm run test # 运行测试 npm run db:migrate # 数据库迁移 项目结构 前端:/frontend/ 后端:/backend/ 共享类型:/shared/types/ 编码规范 - TypeScript严格模式 - ESLint + Prettier统一代码风格 - 组件使用函数式写法 - API错误处理统一格式
commands/review.md
# 代码审查流程 请按照以下标准审查代码: 代码质量 - [ ] 变量命名清晰易懂 - [ ] 函数职责单一 - [ ] 没有重复代码 - [ ] 错误处理完善 性能考虑 - [ ] 避免不必要的重渲染 - [ ] API调用有缓存机制 - [ ] 大数据量有分页处理 安全风险 - [ ] 输入验证完善 - [ ] 敏感信息不硬编码 - [ ] SQL注入防护 当前改动文件: {{git status}} 具体改动内容: }
- 创建CLAUDE.md文件
- 添加基本的开发命令
- 定义项目结构
- 根据项目特点创建rules/目录
- 设置路径限定规则
- 测试规则生效情况
- 创建常用的自定义命令
- 测试命令的上下文注入
- 优化命令的实用性
- 识别重复性任务
- 创建对应的技能
- 测试技能自动触发
- 根据需要创建agent
- 配置权限和职责分离
- 整体测试和优化
不要一次性配置所有功能,从CLAUDE.md开始,逐步添加需要的功能。
项目级配置纳入Git,个人配置放在全局目录,避免冲突。
每月review一次配置,删除过时的规则,添加新的**实践。
避免配置过多无关规则,保持配置的精简和高效。
A:使用rules/目录拆分,按功能模块组织规则。
A:项目级配置纳入Git版本控制。
A:当任务复杂度高,需要专业分工时。
.claude/文件夹是Claude Code从”问答工具”向”工程协作系统”转变的关键。通过合理配置,你可以:
- ✅ 让Claude真正理解你的项目
- ✅ 建立标准化的开发流程
- ✅ 提高团队协作效率
- ✅ 沉淀项目知识和经验
现在就开始配置你的.claude/文件夹,让Claude Code成为你真正的开发伙伴吧!
如果这篇对你有帮助,以下文章你也会喜欢:
- VS Code 安装配置 Claude Code 插件教程(3分钟搞定)
- 2026全网首个企业级claude中转服务平台使用说明
- 好用的claude国内中转平台来了,小伙伴们无脑上车
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/252865.html