前置 MCP 描述默认改成 4096
Claude Code 2.1.296 把事先送上的 MCP 工具描述,以及 MCP 服务器说明的默认上限,从 2048 个字符改成 4096。环境变量没在这句里出现。工具搜索路径在 2.1.295 仍是 16384,这句没有改它。

事先塞进提示的 MCP 说明,默认帽加长了一倍。Claude Code 2.1.296 把「事先送出的 MCP 工具描述」和「MCP 服务器说明」的默认上限,从 2,048 个字符改成 4,096。mcp 描述默认 4096 指的是没另设上限时的新默认值。
2048 那条环境变量还在不在,这句没说
2.1.280 引入 CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH,用来改工具描述和服务器说明的字符上限,当时默认 2048。细节见 MCP 描述长度。2.1.296 只写默认值改成 4096,没有提到这个变量。已经把它设成别的数字的会话,不要假设升级会清掉你的值,也不要假设 4096 会盖过一个更小的设置。没设变量时,按这句,默认是 4096 个字符。
字符不是 token。中文描述更吃 token。帽从 2048 放到 4096,第一次把这些说明送进模型的那一轮会更长。说明没有写超出之后是截断还是整段丢掉,2.1.280 同样没写。
工具搜索的 16384 是另一条路径
2.1.295 把模型经工具搜索加载的 MCP 描述截到 16,384 个字符,见 工具搜索里的 16384。2.1.296 的主语是事先送出的描述和服务器说明,没有写搜索路径。搜索仍按 295 的 16384 理解,除非你自己的环境变量把更短的帽加在所有路径上。这句没有承诺变量对搜索无效。
工具名超过 128 个字符导致请求失败,是 2.1.292 的名字长度,和描述字符数无关。描述变长不会修好一个过长的工具名。
服务器说明和每个工具的描述都吃这个默认帽。2.1.280 已写过:一个服务器挂很多工具、各自写长段落,很容易顶满当时的 2048。默认变成 4096 之后,同样的段落更可能完整送出,但几十个工具仍可能超过 4096。把必须遵守的句子放在描述开头,仍然比指望新默认一定够用更稳。搜索路径若仍按 16384 截断,事先送出的那一段才是 4096。模型第一次选工具时看到的,是事先送出的那段。