Claude Code的上下文工程应用

除了自定义命令，Claude Code还有一个重要特性就是上下文机制，通过CLAUDE.md文件来存储上下文信息。这个机制分为三个层级：全局、项目和模块，形成了一个完整的知识管理体系。

全局上下文：~/.claude/CLAUDE.md

全局上下文存放所有项目通用的开发规范和标准。这里放的是你个人或团队的编码哲学，不管做什么项目都要遵守的铁律。

典型内容：

## 通用编码规范
### 代码质量标准- 单个文件代码不超过1000行- 单个函数不超过50行- 必须有完整的注释，包括函数说明、参数说明、返回值说明- 变量命名必须有意义，禁止使用a、b、c这种无意义命名- 复杂逻辑必须有注释解释
### 错误处理原则- 所有可能的错误都必须处理- 错误信息要明确，便于调试- 不允许空catch块- 关键路径必须有日志记录
### 性能要求- 数据库查询必须有索引支持- 循环内不允许执行数据库操作- 大数据量处理必须分批进行- 缓存策略要明确
### 安全规范- 所有用户输入必须验证- 密码必须加密存储- API接口必须有权限控制- 敏感信息不能记录到日志

这些规则会被所有项目继承，Claude Code在生成代码时会自动遵守这些约束。

项目上下文：./CLAUDE.md

项目上下文存放当前项目的特定信息，包括技术栈、开发流程、部署方式等。如果项目根目录没有这个文件，需要用/init命令生成。

以Go后端项目为例：

## 项目基本信息- 语言：Go 1.21- 框架：Gin + GORM- 数据库：PostgreSQL 15- 缓存：Redis 7- 消息队列：RabbitMQ
## 开发环境配置# 安装依赖go mod tidy
# 运行测试go test ./...
# 代码检查make lint
# 本地启动make run
## 项目结构规范
cmd/          # 应用入口internal/     # 内部代码  handler/    # HTTP处理器  service/    # 业务逻辑  repository/ # 数据访问  model/      # 数据模型config/       # 配置文件docs/         # 文档

## 代码规范- 使用官方Go代码规范- 错误处理使用pkg/errors包- HTTP状态码使用标准定义- 数据库操作必须在事务中- 不要重复造轮子，优先使用成熟的第三方库
## 测试要求- 单元测试覆盖率不低于80%- 集成测试覆盖主要业务流程- 使用testify作为测试框架- Mock使用gomock生成
## 部署流程- 提交代码前必须通过make lint- 必须有对应的单元测试- Pull Request需要至少一人Review- 部署前必须在测试环境验证

模块上下文：各模块的CLAUDE.md

每个功能模块都有自己的上下文文件，记录该模块的具体实现细节、业务规则、接口定义等。这是最细粒度的上下文信息。

以用户认证模块为例：

## 用户认证模块
### 功能描述负责用户注册、登录、JWT令牌管理、密码重置等功能
### 核心组件- UserHandler: HTTP接口层- UserService: 业务逻辑层- UserRepository: 数据访问层- JWTUtil: JWT令牌工具
### 数据表结构CREATE TABLE users (    id SERIAL PRIMARY KEY,    username VARCHAR(50) UNIQUE NOT NULL,    email VARCHAR(100) UNIQUE NOT NULL,    password_hash VARCHAR(255) NOT NULL,    created_at TIMESTAMP DEFAULT NOW(),    updated_at TIMESTAMP DEFAULT NOW());
### API接口- POST /api/auth/register - 用户注册- POST /api/auth/login - 用户登录- POST /api/auth/logout - 用户退出- POST /api/auth/refresh - 刷新令牌- POST /api/auth/reset-password - 密码重置
### 业务规则- 用户名3-50字符，只能包含字母数字下划线- 密码最少8位，必须包含大小写字母和数字- JWT令牌有效期2小时，refresh token有效期7天- 连续登录失败5次锁定账户30分钟- 密码重置链接有效期15分钟
### 依赖模块- Email服务：发送验证邮件- Redis缓存：存储令牌黑名单- 日志服务：记录认证事件
### 测试要点- 正常登录注册流程- 各种异常情况处理- 令牌过期和刷新- 并发登录处理- 安全攻击防护