Claude Code 开新会话 Token 浪费 90%？这个小工具帮你省回来

你是不是也这样？开了一个 Claude Code 会话，还没开始写代码，光加载项目文档就烧掉了大几千 token。

一个中大型项目，光 README、旧的 session 记录、已完成任务的日志，就能吃掉你 11000 个 token——换算成 Claude 4 Sonnet 的价格，大概 0.02 美元一次会话打水漂。

claude-token-optimizer 就是来解决这个问题的。

它的思路很简单

与其让 Claude 无差别地加载所有文件，不如只让它加载最关键的 4 个文件：

• CLAUDE.md — 项目入口说明
• COMMON_MISTAKES.md — 你最常犯的 5 个 bug
• QUICK_START.md — 常用命令速查
• ARCHITECTURE_MAP.md — 项目结构地图

这 4 个加起来大约 800 tokens，比之前少了 90%。

剩下的文档怎么办？需要的时候再加载，不访问就不算 token。

它还帮你做了两件事

1. .claudeignore — 相当于 .gitignore，告诉 Claude 哪些旧文档不要自动加载。

2. 支持 13 种主流框架的模板 — Express.js、Next.js、Vue、Nuxt、Angular、Django、Rails、NestJS、Laravel、Remix、SvelteKit、FastAPI、Rails……每种都给你准备好了该忽略什么、该保留什么。

实际效果大概是这样：

Before： 加载所有文档 8000 tokens + 历史 session 2000 tokens + 任务记录 1000 tokens = ~11000 tokens
After： CLAUDE.md 450 + COMMON_MISTAKES 350 + QUICK_START 100 + ARCHITECTURE_MAP 150 = ~800 tokens

安装方式（三选一）

方式一：npx（无需安装）

npx claude-token-optimizer init

方式二：一行 curl（全局别名 cto）

curl -fsSL https://raw.githubusercontent.com/nadimtuhin/claude-token-optimizer/main/install.sh | bash
cto init

方式三：npm 全局

npm install -g claude-token-optimizer
cto init

装完运行 cto measure 可以先看看你项目当前浪费了多少 token，再决定要不要优化。

适合谁用

• 项目文档巨多、每次开新会话 Claude 都”读半天”的同学
• 想省点 API 费用的人（token 少了，账单自然少）
• 需要保持 Claude 长期在项目里工作、但不想被历史上下文淹没的团队

一个 MIT 许可证的开源小工具，作者是 nadimtuhin，GitHub 423 颗星，更新挺活跃的。

👉 GitHub 链接：https://github.com/nadimtuhin/claude-token-optimizer

GitHub: https://github.com/nadimtuhin/claude-token-optimizer