CLAUDE_CODE_MAX_OUTPUT_TOKENS 详解：Claude Code 2.1.265 中的输出限制和插件文件夹

claude_code_max_output_tokens 控制什么

环境变量参考文档将 CLAUDE_CODE_MAX_OUTPUT_TOKENS 描述为用于设置“大多数请求的最大输出 token 数”。这一表述很重要：它描述的是请求的输出预算，其默认值和上限因模型而异。

因此，在排查 Claude Code 的输出限制时，这个变量具有参考价值。不应将其视为适用于 Claude Code 所处理的所有类型数据的通用限制。2.1.265 版本还为已保存的工具结果引入了磁盘容量限制，但该限制以 GB 衡量存储的工具数据，而非以 token 衡量生成的输出。

使用配置文档时，需要注意其历史适用性。 环境变量参考文档 持续更新，但未能找回其 9 月 10 日的确切修订版本。文档中的描述解释了该变量的用途，但该页面并不能确定 Claude Code 2.1.265 当时适用的所有默认值。

对于一篇有明确日期的文章，最有力的数值证据来自带版本标签的发行说明。这些说明可以证实此前的具体变更，无需从实时文档中推断完整的默认值表。

需要区分的三种限制

排查限制时，首先要确定涉及的是哪一种限制。token 预算设置与磁盘存储上限需要分别理解，即使二者在同一次开发会话中出现。

已核实的默认值和最大输出限制

该 v2.1.77 发行说明发布于 2026 年 3 月 17 日，记录了两项相关变更：Claude Opus 4.6 的默认输出 token 数提高到 64k，Opus 4.6 和 Sonnet 4.6 的上限提高到 128k token。这些变更也保留在带有 v2.1.265 标签的更新日志中。

这些证据表明，不能将“默认值为 32,000，最大值为 64,000”表述为 Claude Code 的通用规则。它们也不足以支持补全其他模型缺失的默认值。

需要明确区分文档记录的变更与完整的配置参考。3 月的发行说明证实了上述变更；现有的有日期来源并未提供 v2.1.265 完整的逐模型默认值表。

较新模型的规格不能确定 CLI 默认值

该 模型发行说明 记载了 Claude Sonnet 5、Claude Opus 5 和 Claude Fable 5.1 的最大输出为 128k，上下文窗口为 1 百万 token。它们对应的确切 API ID 为 claude-sonnet-5, claude-opus-5，以及 claude-fable-5-1，依次对应上述模型。

这些公告在文章发布截止日期之前已可查阅：Sonnet 5 于 6 月 30 日发布，Opus 5 于 7 月 24 日发布，Fable 5.1 于 2026 年 9 月 1 日发布。不过，这些模型规格并不能证明 Claude Code 的默认请求预算。

对于正在选择模型的开发者， Claude Code 模型指南 提供了相关阅读材料。请将模型公布的最大值与 CLI 使用的默认输出预算区分开来。

设置变量并理解上下文压缩

当前文档支持在启动以下程序之前设置该变量： claude，或将其放在以下键下： env ，该键位于 settings.json中。由于未能找回 9 月 10 日可查阅的确切文档修订版本，下面的示例属于文档中记载的配置方式，但其历史适用性需作上述保留。

Shell 配置

所提供的 shell 示例将输出预算设置为 64,000 token：

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

文档记载的方式是在启动 Claude Code 之前设置该变量。此示例中的数值是选定的配置值，并不表示 64,000 是每个模型的默认值或最大值。

为项目或故障排查会话记录配置时，请同时注明所选模型和请求的预算。没有模型信息，单凭一个数值无法判断它是否与文档记载的默认值一致，或是否处于文档记载的上限之内。

在 settings.json 中配置

所提供的等效 JSON 示例将该变量放在以下键下： env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

在此示例中，该值是一个字符串。与 shell 设置一样，这段代码表达的是请求的预算，并不能证明某个模型的默认值。

有关命令行用法的相关信息，请参阅 Claude Code CLI 参考文档。这里的历史证据支持该变量的作用和所提供的配置示例，但仍无法确定 v2.1.265 的完整默认值。

关于上下文压缩，哪些信息已得到核实？

带有 v2.1.265 标签的更新日志记录了 v2.1.69 中的一项早期修复，解决了 CLAUDE_CODE_MAX_OUTPUT_TOKENS 在对话压缩期间被忽略的问题。这证实了该设置与压缩行为之间的关联。

当前的环境变量参考文档还解释，提高该设置的值会减少自动压缩前可用的有效上下文。该说明的发布日期尚不确定，因此不能将其表述为 9 月 10 日已核实的描述。

因此，不应将该设置描述为能够扩大模型公布的上下文窗口。有日期的证据证实了它是输出预算控制项，并证实了一项与压缩有关的修复；这些证据并未确定 v2.1.265 中每个模型的精确压缩阈值。

Claude Code 2.1.265 如何加载插件文件夹

Claude Code v2.1.265 于 2026 年 9 月 8 日发布，发布提交为 8e02f6d。其文件夹加载变更允许 --plugin-dir 指向一个包含多个插件的文件夹。

所提供的调用方式如下：

claude --plugin-dir ./plugins

发行说明直接描述了发现规则：“每个包含清单的子文件夹都会被加载”。说明还指出，Claude Code 运行期间会检测新增和移除的插件。

因此，在统一管理多个插件时，父文件夹是一个实用的管理单位。文档承诺的行为针对包含清单的子文件夹；发行说明没有说明会进行递归发现。不要假定系统会搜索任意深度嵌套的目录树。

清单布局及历史适用性说明

当前的插件参考文档将清单放在 .claude-plugin/plugin.json ，并将以下组件目录放在插件根目录： skills/, commands/，以及 hooks/ 。未能找回该参考文档带有日期的 v2.1.265 快照。

对于 9 月 10 日的文章，应将当前的布局指导与该版本明确保证的行为区分开来：包含清单的子文件夹会被加载。发行说明证实了多插件文件夹发现功能，但并未证实同期布局文档中的每个细节。

该版本包含的插件修复

2.1.265 版本还修复了三个插件问题：

• 包含反斜杠的插件路径可能绕过 macOS 和 Linux 上的符号链接路径边界检查。
• 以两个点开头的目录曾被错误地拒绝。
• 不可读取的默认组件文件夹此前会被静默跳过；现在会显示在 /plugin 中，并附带错误代码。

这些修复涉及插件路径和组件加载。如果插件文件夹无法加载，它们可提供相关的版本背景，但输出 token 设置并不能解释这些目录处理问题。

已保存工具结果的 1 GB 上限是一项独立限制

2.1.265 版本为保存到磁盘的工具结果增加了 1 GB 的容量上限。对话预览会报告截断情况。

此限制涉及存储的工具数据。 CLAUDE_CODE_MAX_OUTPUT_TOKENS 涉及的是大多数请求的最大输出 token 数。发行说明并未将该环境变量描述为磁盘容量上限的控制项，因此不应将提高其值表述为解决已保存工具结果被截断的方法。

发行说明也没有说明 1 GB 上限是针对每个结果、每个会话，还是其他分组。记录该行为时，应保留这一不确定性：“保存到磁盘的工具结果有 1 GB 上限”是已核实的描述。

排查问题时，一个有用的区分依据是开发者看到的具体信息。对话预览报告截断，与新的结果保存行为有关。关于模型生成输出预算的问题，应结合所选模型和 token 设置来分析。如果插件错误代码出现在 /plugin 中，则应归入插件加载问题。

这些是在同一版本发布背景下引入或讨论的独立控制项和诊断信息。将它们分别看待，可以避免用令牌配置变更来解释无关的存储或文件夹行为。

截至九月 10 日已发布的网关后续版本

版本 2.1.266 也于九月 8 日发布，因此在本文的截止日期范围内。该 v2.1.266 发行说明 修复 v2.1.265 中涉及以下内容的网关身份验证回归问题 CLAUDE_CODE_USE_GATEWAY.

相关错误为“未登录 Cloud 网关”。发布说明指出，无需更改配置。

对于在 v2.1.265 上遇到这一特定回归问题的开发者，后续版本与该问题直接相关。提高输出令牌预算或重新整理插件文件夹并不是文档中给出的修复方法。

同样的工作流也可以通过 AI Prime Tech 等 API 网关运行；请参阅 使用 API 密钥运行 Claude Code 以获取相关设置指导。AI Prime Tech 独立运营，与 Anthropic 或 OpenAI 无隶属关系。

要点

• CLAUDE_CODE_MAX_OUTPUT_TOKENS 设置大多数请求的最大输出令牌数；默认值和上限因模型而异。
• v2.1.77 将 Opus 4.6 的默认值提高至 64k，并将 Opus 4.6/Sonnet 4.6 的上限提高至 128k。完整的 v2.1.265 默认值表仍未得到核实。
• 模型最大输出量、模型上下文容量以及已保存的工具结果存储空间是彼此独立的限制。
• 在 v2.1.265 中， --plugin-dir 可以从包含清单文件的子文件夹中加载多个插件，并在运行时检测插件的添加和移除。
• v2.1.265 引入了 1 GB 的已保存工具结果容量上限；v2.1.266 修复了网关身份验证回归问题，无需更改配置。

常见问题

CLAUDE_CODE_MAX_OUTPUT_TOKENS 控制什么？

CLAUDE_CODE_MAX_OUTPUT_TOKENS 设置大多数请求的最大输出令牌数。其默认值和上限因模型而异，并且与 v2.1.265 对保存到磁盘的工具结果设置的 1 GB 容量上限相互独立。

默认和最大输出限制是多少？

v2.1.77 将 Claude Opus 4.6 的默认输出令牌数提高至 64k，并将 Opus 4.6/Sonnet 4.6 的上限提高至 128k。已审阅的带日期来源并未确定 Sonnet 4.6 的默认值，也未提供 v2.1.265 按模型列出的完整默认值表。

提高此设置会扩大上下文窗口吗？

文档中说明的用途是设置输出令牌预算，而不是扩大模型公布的上下文窗口。v2.1.69 修复了压缩期间忽略该变量的问题，但当前在线文档中关于它如何影响自动压缩的说明，其发布日期尚不确定。

--plugin-dir 如何发现多个插件？

在 Claude Code 2.1.265 中， --plugin-dir 可以指向父文件夹，其中每个包含清单文件的子文件夹都会被加载。Claude Code 运行期间会检测插件的添加和移除；发布说明未明确是否支持递归发现。