上下文检查
透视 Claude Code 的"大脑"
上下文检查让你能够看见 Claude 看见的，理解它是如何理解你的项目的。就像医生通过 X 光片看透人体一样，上下文检查让你透视 Claude Code 的"思考过程"。
什么是上下文检查？
核心概念
上下文检查是一种诊断工具，帮你了解：
- 📊 当前上下文使用情况 - 用了多少，还剩多少
- 📁 包含了哪些文件 - Claude 能看到什么信息
- 🧠 Claude 的理解程度 - 它是如何解读你的项目的
- ⚠️ 潜在的问题点 - 哪些地方可能影 响效果
检查工具
# 基础上下文检查
> /context
# 详细的上下文分析
> /context --detailed
# 特定方面的检查
> /context --files
> /context --tokens
> /context --understanding
上下文检查报告解读
典型的检查报告
> /context
📊 上下文使用报告
====================
📈 Token 使用情况：
- 已使用：45,237 tokens (22.6%)
- 剩余：154,763 tokens (77.4%)
- 状态：✅ 健康
📁 包含文件 (12个)：
✅ CLAUDE.md (1,234 tokens)
✅ src/components/UserProfile.tsx (2,891 tokens)
✅ src/services/authService.ts (1,567 tokens)
✅ package.json (456 tokens)
⚠️ node_modules/... (12,345 tokens) - 建议忽略
❌ build/bundle.js (15,678 tokens) - 应该排除
🧠 项目理解度：
- 技术栈识别：✅ React + TypeScript + Node.js
- 架构理解：✅ 前后端分离，REST API
- 编码规范：✅ ESLint + Prettier
- 业务逻辑：⚠️ 部分理解，缺少业务文档
💡 优化建议：
1. 添加 .claudeignore 排除 node_modules 和 build
2. 在 CLAUDE.md 中补充业务逻辑说明
3. 当前上下文使用效率良好 ，可以继续添加相关文件
具体检查维度
1. Token 分布分析 📊
# 详细的 token 分布
> /context --tokens
Token 分布分析：
==================
📊 按文件类型：
- TypeScript 文件: 24,567 tokens (54%)
- JavaScript 文件: 8,234 tokens (18%)
- 配置文件: 3,456 tokens (8%)
- 文档文件: 2,890 tokens (6%)
- 其他: 6,090 tokens (14%)
📈 Token 密度排行：
1. src/utils/helpers.ts - 89 tokens/行 (过于复杂)
2. CLAUDE.md - 12 tokens/行 (信息密集)
3. src/components/UserList.tsx - 8 tokens/行 (正常)
⚠️ 警告：
- helpers.ts 文件过于复杂，建议拆分
- 有 3 个文件包含重复的工具函数
2. 文件相关性分析 🔗
# 文件相关性检查
> /context --files
文件相关性分析：
================
🔗 强相关文件组：
Group 1: 用户认证模块
- src/auth/AuthService.ts
- src/auth/TokenManager.ts
- src/components/LoginForm.tsx
相关度: 95% ✅
Group 2: 用户界面模块
- src/components/UserProfile.tsx
- src/components/UserList.tsx
- src/types/User.ts
相关度: 87% ✅
❌ 孤立文件：
- src/utils/legacy.js (无引用，建议移除)
- config/old-webpack.config.js (已废弃)
🔄 循环依赖：
- AuthService ↔ UserService (需要重构)
3. 理解质量评估 🧠
# 理解质量检查
> /context --understanding
Claude 项目理解评估：
====================
✅ 技术理解 (95/100)：
- 框架使用：React 18 + Hooks ✅
- 状态管理：Redux Toolkit ✅
- 路由：React Router v6 ✅
- 构建工具：Vite ✅
⚠️ 业务理解 (60/100)：
- 用户系统：✅ 基本理解
- 权限模型：⚠️ 部分理解
- 数据流程：❌ 不够清晰
- 业务规则：❌ 缺少文档
🔧 架构理解 (80/100)：
- 分层结构：✅ 清晰
- API 设计：✅ RESTful
- 数据库设计：⚠️ 需要 ER 图
- 部署架构：❌ 缺少说明
💡 改进建议：
1. 在 CLAUDE.md 中添加业务流程图
2. 补充数据库 ER 图
3. 说明部署架构和环境配置
实时监控技巧
1. 上下文健康监控 🏥
# 设置上下文健康检查
> /context --monitor
启用上下文监控...
=================
📊 实时指标：
- Token 使用率：实时显示
- 文件变化：自动检测
- 理解偏差：智能警告
⚠️ 预警阈值：
- Token 使用 > 85%：黄色警告
- Token 使用 > 95%：红色警告
- 文件数量 > 20：建议精简
- 重复内容 > 15%：建议去重
🔔 通知设置：
- 上下文即将溢 出时提醒
- 发现无关文件时建议
- 理解质量下降时警告
2. 效率优化建议 ⚡
# 上下文效率分析
> /context --optimize
上下文优化分析：
================
🎯 效率问题：
1. 重复信息过多 (18% 重复率)
- package.json 在 3 处重复引用
- 类型 定义在多个文件中重复
2. 无关文件过多 (12 个无关文件)
- 测试文件占用 15% token
- 配置文件过于详细
3. 信息密度不均
- CLAUDE.md 信息密度过低
- 某些核心文件缺失
🚀 优化方案：
1. 立即优化 (预计节省 30% token)：
- 创建 .claudeignore 文件
- 精简 CLAUDE.md 内容
- 移除测试和构建文件
2. 结构优化 (预计提升 40% 理解质量)：
- 补充关键的业务逻辑文件
- 添加架构说明文档
- 统一代码注释风格
3. 长期改进：
- 建立上下文使用规范
- 定期清理无用文件
- 维护文档一致性
问题诊断指南
常见问题模式
问题 1：Claude 给出不一致的建议
症状：同样的问题在不同时候得到不同答案
诊断：
> /context --consistency
发现问题：
- 上下文中包含冲突的代码模式
- CLAUDE.md 描述与实际代码不符
- 项目规范在不同文件中定义不一致
解决方案：
1. 统一代码风格和模式
2. 更新 CLAUDE.md 与实际情况同步
3. 建立单一的规范文档
问题 2：响应速度变慢
症状：Claude 响应时间明显增长
诊断：
> /context --performance
发现问题：
- Token 使用率 > 90%
- 包含大量重复信息
- 文件数量过多 (>25个)
解决方案：
1. 立即清理：移除无关文件
2. 压缩信息：使用摘要替代完整文件
3. 分阶 段处理：将大任务分解
问题 3：理解偏差
症状：Claude 误解项目需求或技术架构
诊断：
> /context --understanding
发现问题：
- 关键架构文档缺失
- 业务逻辑表述不清
- 技术选型原因不明
解决方案：
1. 补充架构文 档 (ADR)
2. 明确业务规则和流程
3. 说明技术决策的背景
高级检查技巧
1. 差异化检查 🔍
# 对比检查 - 分析前后变化
> /context --diff since:last-session
上下文变化分析：
================
📊 变化统计：
- 新增文件：3 个 (+2,456 tokens)
- 修改文件：5个 (+1,234 tokens)
- 删除文件：1个 (-890 tokens)
- 净变化：+2,800 tokens
📈 影响评估：
- 理解质量：+5% (新增文档帮助)
- Token 效率：-8% (新增冗余内容)
- 整体评分：7.2/10 → 7.5/10
💡 建议：
- 新增的测试文件建议移除
- UserService.ts 的修改提升了清晰度
- 考虑将工具函数移到单独模块
2. 智能建议系统 🤖
# AI 驱动的上下文优化建议
> /context --ai-suggestions
智能优化建议：
==============
🎯 基于你的使用模式：
- 你经常处理用户认证相关功能
- 建议保留 auth/ 目录下的所有文件
- 可以暂时排除 admin/ 目录
🔍 基于项目特征：
- React + TypeScript 项目
- 建议包含 tsconfig.json 和 eslint 配置
- 组件文件比工具文件更重要
📊 基于统计分析：
- 80% 的对话涉及前端组件
- 建议优先包含 components/ 目录
- API 相关文件使用频率较低
🚀 个性化建议：
- 为你创建专用的 .claudeignore 模板
- 建议的 CLAUDE.md 结构优化
- 针对你的工作流的上下文配置
团队协作中的上下文检查
1. 团队标准化 👥
# 团队上下文标准检查
> /context --team-standard
团队上下文合规检查：
==================
✅ 符合团队标准：
- CLAUDE.md 格式规范 ✅
- 文件命名约定 ✅
- 注释风格一致 ✅
⚠️ 需要改进：
- 缺少 API 文档链接
- 部署配置不够详细
- 测试覆盖率说明缺失
❌ 不符合标准：
- 包含个人配置文件
- 硬编码的本地路径
- 过时的依赖版本信息
📋 团队检查清单：
- [ ] 移除个人配置
- [ ] 更新部署文档
- [ ] 添加 API 文档链接
- [ ] 检查依赖版本
2. 知识传承 📚
# 项目知识检查
> /context --knowledge-audit
项目知识审计：
==============
📚 文档完整性：
- 技术文档：85% ✅
- 业务文档：60% ⚠️
- 运维文档：40% ❌
🧠 隐性知识识别：
- 发现 3 处"只有老员工知道"的逻辑
- 5 个未文档化的业务规则
- 2 个技术债务需要说明
💡 知识传承建议：
1. 将隐性知识显性化
2. 补充缺失的业务文档
3. 建立定期文档更新机制
最佳实践
✅ 高效的上下文检查习惯
- 定期检查 - 每次开始新任务前运行检查
- 问题导向 - 根据具体问题选择检查维度
- 持续优化 - 基于检查结果持续改进项目结构
- 团队共享 - 将检查结果和优化方案分享给团队
❌ 要避免的陷阱
- 过度检查 - 不要为了检查而检查
- 忽视警告 - 不重视检查报告中的警告信息
- 一次性优化 - 不进行持续的上下文维护
- 孤立使用 - 不结合实际开发需求使用检查功能
记住：上下文检查不是为了追求完美的数字，而是为了确保 Claude Code 能够最好地理解和帮助你的项目。定期检查，持续优化，让 AI 成为你更好的开发伙伴。
继续学习：动态内存 - 了解 Claude Code 如何管理和利用项目记忆。