适合谁
- 经常使用 Claude Code、Codex CLI、Gemini CLI 或其他支持集成的 AI 编程 CLI 的开发者。
- 希望减少大型代码库、长日志、截图和技能文件带来的上下文消耗的用户。
- 能够接受工具修改本地 AI 客户端配置并创建索引、缓存的用户。
T
43FMRS · D
这是一个面向 AI 编程 CLI 的本地 token 优化和钩子工具，不是证据充分的独立 MCP server：来源没有提供 server manifest、MCP transport 或工具清单。其主要价值是减少上下文噪声和重复读取；部署时应重点审查配置修改、文件访问、缓存留存以及各客户端桥接的验证状态。
Token-Goat 是一个基于 Node.js 的 CLI 与自动化钩子工具，用于压缩终端输出、缩小图片、拦截重复读取、提取代码或文档片段、生成压缩清单、缓存 Bash/Web/MCP 输出，并扫描网页内容中的提示注入模式。README 声称可减少 40–90% 的 AI token 使用或成本；这些数字来自项目描述和测试基准，实际效果取决于工作流。
工具能力
暂未整理工具清单。
安装接入
需要 Node.js 22 或更高版本。运行 npm install -g token-goat，然后运行 token-goat install 和 token-goat doctor。Codex CLI 可使用 token-goat install --codex；Gemini、Qwen、Copilot、OpenCode、pi、Grok CLI 分别有对应安装选项。安装后重启 AI 会话。后台索引器不会由 install 自动启动，如需使用可运行 token-goat worker start。
选型与风险
不适合谁
- 需要标准 MCP server manifest、明确 MCP transport 或可直接连接的 MCP 工具列表的用户。
- 不希望安装全局 npm 包、注册钩子或修改客户端配置的用户。
- 需要 macOS 已验证支持的生产环境用户；README 将 macOS 标为未测试。
所需权限
- 需要安装 Node.js/npm 全局包。
- 需要写入相应 AI 客户端的用户配置和钩子文件，例如 Claude Code、Gemini、Qwen、Copilot 或 Grok 的配置目录。
- 需要读取项目文件、Git 信息及会话相关内容，以建立索引、缓存和压缩清单。
- 后台 worker 如启用，需要在本地作为后台进程运行。
风险与副作用
- 钩子会拦截或改写读取、Bash、截图和其他工具调用，可能改变原始输出呈现方式。
- 索引、缓存和会话清单会在本地保存项目或工具输出；README 未提供完整的数据保留或加密说明。
- README 声称会扫描网页内容并阻挡提示注入，但该安全能力不应替代人工审查或客户端自身的安全控制。
- 部分桥接器并未在真实运行实例上验证，包括 Qwen、OpenClaw 和 pi 的相关集成说明；Copilot 的钩子错误可能导致整个会话拒绝工具调用。
- 项目元数据中的许可证为 NOASSERTION，而 README 徽章显示 PolyForm Noncommercial；使用前应核对仓库许可证文件。
常见排障
- 运行 `token-goat doctor`，确认钩子和 `sharp` 显示正常。
- 如果图片处理失败，检查 doctor 输出中的 `sharp: ok`；README 指出 Alpine musl 和部分 ARM 环境可能需要从源码编译。
- 安装或更新钩子后完全重启 AI CLI 会话，尤其是 Copilot CLI。
- 使用 `token-goat worker status` 检查索引 worker；必要时运行 `token-goat worker start` 或 `stop`。
- 若索引过时，可运行 `token-goat index`，或对单个读取命令使用 `--force-refresh`。
使用场景
压缩 pytest、npm、Docker、Git、编译器和其他开发工具的冗长输出。
通过 `token-goat read`、`section`、`symbol` 或 `skeleton` 获取代码和文档的局部内容。
在会话压缩前保存编辑文件、访问过的符号和关键读取记录。
缩小截图并缓存重复的 Bash、网页和 MCP 输出。
为支持的 AI CLI 注册读取、压缩和会话相关钩子。
支持客户端
Claude Code完整支持
Codex CLI完整支持
Gemini CLI完整支持
Qwen Code完整支持
Copilot CLI部分支持
OpenCode部分支持
pi部分支持
Grok CLI部分支持