前言
用 Cursor、Claude、Copilot 等 AI 编程助手时，你有没有遇到过这些问题：
- AI 不了解你的项目架构，生成的代码风格和项目不一致
- 手写
.cursorrules或CLAUDE.md太麻烦，写完还容易过时 - 每个 AI 工具需要不同格式的上下文文件
今天分享一个我做的开源工具 Code2Context，一条命令解决所有问题。
快速开始
# 扫描项目，生成结构化上下文
npx code2context init
# 导出为 Cursor 格式
npx code2context export --format cursor # → .cursorrules
# 导出为 Claude 格式
npx code2context export --format claude # → CLAUDE.md
# 代码变了？增量更新
npx code2context update
它和模板工具有什么不同？
Code2Context 不是模板生成器，它真正分析你的代码：
1. 真实代码分析
- 解析
import/export语句，构建模块依赖图 - 识别入口文件、核心模块、最常被引用的依赖
- 检测命名规范、文件组织模式、代码风格
2. Git 智能分析
- 热点文件（最频繁修改的文件）
- 开发方向（团队在做新功能、修 bug 还是重构？）
- 贡献者分析
- 最近提交摘要
3. AI 增强分析（可选）
- 架构决策提取
- 编码规范生成
- AI 常见错误提醒（gotchas）
- 支持任意 OpenAI 兼容 API：OpenAI、DeepSeek、OpenRouter、Ollama、Groq 等
不配置任何 API Key 也能完美运行，所有代码分析都在本地完成。
性能表现
| 项目 | 语言 | 文件数 | 模块数 | 上下文大小 | 耗时 |
|---|---|---|---|---|---|
| Next.js app | TypeScript | 58 | 46 | 18.8KB | 0.4s |
| Express.js | JavaScript | 213 | 22 | 13.0KB | 0.1s |
| FastAPI | Python | 2,984 | 758 | 54.5KB | 0.5s |
| Vue Core | TypeScript | 702 | 283 | 55.4KB | 0.3s |
生成效果
生成的 .cursorrules 包含：
- 项目概览和技术栈
- 模块结构和依赖关系
- 编码规范和命名约定
- AI 使用注意事项（gotchas）
这些信息都是从你的真实代码中提取的，不是模板填充。
链接
- GitHub: github.com/Jamesfish/c…
- npm: www.npmjs.com/package/cod…
MIT 开源，欢迎 Star ⭐ 和提 Issue！
