nadimtuhin/claude-token-optimizer

解决的问题

Claude Code 经常在启动时加载过多的文档、会话笔记和任务历史，消耗了上下文窗口的大部分空间。本项目提供了一种系统，将项目文档重新组织，使 Claude 仅在启动时加载必要文件，从而为实际代码释放数千个 token。

工作原理

该工具通过特定的文件层级结构和 .claudeignore 文件实现结构化文档方法，防止自动加载不必要的文档。它将单一的庞大文档文件替换为四个核心文件：CLAUDE.md、COMMON_MISTAKES.md、QUICK_START.md 和 ARCHITECTURE_MAP.md。

主要功能包括：

• 框架感知初始化：cto init 自动检测项目框架（如 Next.js、Django、Go），并应用相关最佳实践和常见错误。
• 令牌测量：cto measure 估算自动加载文件的令牌成本。
• 维护工具：cto compress 和 cto prune 使用确定性规则减少 CLAUDE.md 的大小。
• 上下文注入钩子：可集成到 Claude Code 钩子中的 Shell 脚本，根据用户提示动态从 docs/learnings/ 加载特定主题文档，确保未使用文件的零令牌成本。

适用人群

希望将自动加载文档改为按需加载系统，以优化上下文窗口并减少令牌使用的 Claude Code 用户。

亮点

• 显著减少令牌使用：典型情况下启动时令牌使用量减少 83-87%。
• 框架支持：为 13 个流行框架提供预定义模式。
• CI 友好审计：cto audit 提供文档结构的健康检查，并以机器可读的 JSON 格式输出，适用于 CI/CD 流水线。
• 动态上下文注入：钩子可将用户提示与 docs/learnings/ 中的文件名匹配，仅在需要时注入上下文。