1. 当 MCP 工具定义把上下文吃掉一半问题到底出在哪如果你在 Claude Code 里挂了 Playwright、GitHub、Exa、Context7、Notion 再加几个数据库工具启动后第一件事大概率是敲/context看一眼。我见过最夸张的一次8 个 MCP 服务工具定义直接占了 67000 tokens200K 的窗口还没开始对话就没了三分之一。用 Opus 跑复杂任务时10 到 15 分钟就得 compact 一次思路刚接上就被打断。这个现象的根源在于Claude Code 默认会把所有已连接 MCP 服务的工具描述tool schema在启动时全量注入系统提示。每个工具的名称、参数、描述、枚举值都要占 token服务越多、工具越细注入量就越大。这些定义不管你这次任务用不用得上都先塞进上下文里待命。Tool Search 就是冲着这个来的。它的逻辑是不再启动时预加载全部工具定义改成按需检索。当 MCP 工具定义总量超过上下文窗口的某个阈值官方给的参考是 10%Tool Search 自动激活你需要某个工具时Claude 通过关键词做语义搜索只把那一个工具的定义加载进来。不用的时候基本是 0 占用切换任务时上下文也跟着切换不会有一堆无关工具定义堆在那里。ENABLE_TOOL_SEARCH就是控制这个开关的环境变量。这篇要交付的是一个可复制的settings.json骨架配合 TaoToken 统一 Key/API 通道接入 Claude Code把 Tool Search 打开并给出开启前后上下文占用的对比验证动作。适合已经在用 Claude Code、连了多个 MCP 服务、被上下文挤占困扰的人。2. 前置准备TaoToken 统一 Key 与 API 通道在动settings.json之前先把 API 通道理顺。Claude Code 需要一个 Anthropic 兼容的接入点TaoToken 提供统一的 Key 和 API 地址这样你多个 MCP 服务、多个模型调用都走同一个通道不用每个服务单独配一套凭证。第一步去控制台拿 Key。打开https://taotoken.net/console登录后在 API Keys 页面创建一个新 Key复制出来。这个 Key 后面会写进settings.json的env字段里。第二步确认 API 基地址。TaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带任何查询参数直接作为ANTHROPIC_BASE_URL的值使用。第三步如果你还没装 Claude Code先装好。已经装了的跳过这步。装完之后确认版本Tool Search 需要较新的版本才支持建议升到 2.1.7 及以上npm install -g anthropic-ai/claude-code claude --version版本低于 2.1.7 的话ENABLE_TOOL_SEARCH可能不生效先升级再继续。这里有个容易踩的点TaoToken 是统一通道不是让你绕过什么它就是把 Key 和 API 地址集中管理。你所有 MCP 服务的调用、模型对话都通过这一个入口走配置一次到处能用。接入文档在https://taotoken.net/doc里面有各客户端的接入示例遇到字段对不上可以去翻。3. 可复制的 settings.json 骨架Claude Code 的配置分两层全局配置在~/.claude/settings.json项目级配置在项目根目录的.claude/settings.json。Tool Search 的开关和 API 通道建议放全局MCP 服务列表可以按项目放。下面这个骨架你可以直接抄把 Key 换成你自己的。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ENABLE_TOOL_SEARCH: true }, mcpServers: { playwright: { command: npx, args: [-y, playwright/mcplatest] }, github: { command: npx, args: [-y, modelcontextprotocol/server-github], env: { GITHUB_PERSONAL_ACCESS_TOKEN: 你的GitHub Token } }, context7: { command: npx, args: [-y, upstash/context7-mcp] }, exa: { command: npx, args: [-y, exa-mcp-server], env: { EXA_API_KEY: 你的Exa密钥 } } } }几个关键字段说明。env里的ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口ANTHROPIC_API_KEY填你在控制台创建的 KeyENABLE_TOOL_SEARCH设为字符串true注意是字符串不是布尔值JSON 里环境变量值都得是字符串。mcpServers里每个服务是一个对象command加args决定怎么启动需要凭证的服务在各自的env里单独配。如果你不想改全局配置也可以只设环境变量临时验证用export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ENABLE_TOOL_SEARCHtrue claude写进 shell 配置文件让它持久化echo export ENABLE_TOOL_SEARCHtrue ~/.zshrc echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc echo export ANTHROPIC_API_KEYsk-你的TaoToken密钥 ~/.zshrc source ~/.zshrc注意settings.json里的env优先级高于 shell 环境变量。如果你两处都配了以settings.json为准。建议只在一处配避免排查时搞混。配置改完重启 Claude Code 让设置生效。MCP 服务列表里我放了四个常用的你可以按需增删。服务越多Tool Search 的价值越明显。4. 验证请求与上下文占用对比配置生效后第一件事是确认 Tool Search 真的开了。启动 Claude Code输入/context看输出。如果 MCP tools 那一行显示的是loaded on-demand而不是具体的 token 数字说明按需加载已经生效。这里有个坑要提前说如果你走的是 TaoToken 这类统一 API 通道/context的 token 统计可能显示不全或者不准因为统计逻辑依赖官方通道的返回字段。这不代表 Tool Search 没生效。判断标准换成行为验证当你调用某个 MCP 工具时界面上会显示工具搜索的过程而不是一上来就列出全部工具定义。做一个开启前后的对比最直观。先临时关掉 Tool Search 跑一次ENABLE_TOOL_SEARCHfalse claude启动后/context记下 MCP tools 占用的 token 数。然后退出正常启动Tool Search 开启再/context一次对比两次的数字。我实测下来四个 MCP 服务在关闭状态下工具定义占 18000 到 22000 tokens开启后降到接近 0只有实际调用某个工具时才加载那一个的定义通常几百到一千多 tokens。再做一个功能验证确认按需检索能正确找到工具。在对话里直接提需求比如「帮我用 Playwright 打开 example.com 截个图」观察 Claude 是否通过搜索定位到 Playwright 工具并执行。如果它能找到并调用说明语义搜索工作正常。# 验证 API 通道是否通 curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 100, messages: [{role: user, content: 回复 ok}] }返回里有正常的内容响应说明 Key 和通道没问题。这一步能帮你把「通道问题」和「Tool Search 问题」分开排查省得混在一起找不到原因。5. 本篇常见错误排查/context看不到loaded on-demand。先确认版本claude --version低于 2.1.7 就升级。再确认ENABLE_TOOL_SEARCH的值是字符串true写成布尔true在 JSON 里会解析失败。如果走统一通道导致统计显示异常改用行为验证别死磕/context的输出。工具调用时报找不到工具。Tool Search 是按需检索如果 Claude 没搜到可能是工具描述里的关键词和你提问的措辞对不上。试着在提问里带上工具名或服务名比如「用 GitHub MCP 查一下这个仓库的 issue」给它更明确的检索线索。MCP 服务启动失败。多半是command或args写错或者npx拉包超时。单独在终端跑一遍npx -y modelcontextprotocol/server-github看报什么错。需要凭证的服务检查env里的 Token 是否有效、有没有多余空格。改了settings.json不生效。JSON 语法错误是最常见原因用编辑器或python -m json.tool ~/.claude/settings.json校验一下。另外确认你改的是全局还是项目级两处同名配置项目级优先。改完必须重启 Claude Code。上下文还是被吃掉很多。检查是不是有服务没走 MCP 而是用了其他注入方式或者系统提示本身就很长。Tool Search 只管 MCP 工具定义这一块对话历史、系统提示、文件内容这些它管不了。如果 MCP 定义已经降下来了但总量还是高往其他方向查。6. 把通道和开关一次配好Tool Search 解决的是工具定义全量注入的问题TaoToken 解决的是 Key 和 API 通道分散管理的问题两件事配在一起Claude Code 的接入才算干净。你现在可以放开连 MCP 服务了不用再数着个数用。具体动作去https://taotoken.net/api-keys确认你的 Key 还在有效期内然后照着第 3 节的settings.json骨架把ENABLE_TOOL_SEARCH和 API 通道写进去。接入过程中如果字段对不上翻https://taotoken.net/doc的接入文档里面有各客户端的完整示例。想先验证模型通道是否正常用https://taotoken.net/models里的模型对话页面发一条测试消息最快。如果你打算长期用 Claude Code 跑编码和 Agent 任务https://taotoken.net/coding-plan里有针对性的方案配合 Tool Search 一起用上下文能省下不少。