跳到主要内容

上下文检查

透视 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. 建立定期文档更新机制

最佳实践​

✅ 高效的上下文检查习惯​

  1. 定期检查 - 每次开始新任务前运行检查
  2. 问题导向 - 根据具体问题选择检查维度
  3. 持续优化 - 基于检查结果持续改进项目结构
  4. 团队共享 - 将检查结果和优化方案分享给团队

❌ 要避免的陷阱​

  1. 过度检查 - 不要为了检查而检查
  2. 忽视警告 - 不重视检查报告中的警告信息
  3. 一次性优化 - 不进行持续的上下文维护
  4. 孤立使用 - 不结合实际开发需求使用检查功能

记住：上下文检查不是为了追求完美的数字，而是为了确保 Claude Code 能够最好地理解和帮助你的项目。定期检查，持续优化，让 AI 成为你更好的开发伙伴。

继续学习：动态内存 - 了解 Claude Code 如何管理和利用项目记忆。