Claude Code 2.1.329 更新日志:网关 max_tokens、/tasks、/code-review 与修复

Claude Code 2.1.329 于 2026 年 11 月 19 日发布,移除了网关后的 max_tokens 自动重试,将定时任务与对话分支纳入 /tasks,调整无目标 /code-review 默认对比默认分支审查整条分支,新增 hooks 来源信任提示,并修复 ~/.claude.json 重置以及 macOS、VS Code 登出和用量额度问题。本文整理了升级步骤、网关接入路线及同日 2.1.328 的关键变更。

本文内容
Claude Code 2.1.329 更新日志:网关 max_tokens、/tasks、/code-review 与修复

Claude Code 2.1.329 已于 2026 年 11 月 19 日发布,移除了网关后的 max_tokens 自动重试,扩展了 /tasks,调整了 /code-review 与已保存的定时任务行为,并修复了 ~/.claude.json 被重置以及 macOS 和 VS Code 异常登出的问题。这些变更影响在终端、VS Code 和 Claude Desktop 中使用 Claude Code 的开发者,以及依赖 LLM 网关或 Pro、Max 用量额度的团队。请先运行 claude --version 和 claude update 完成升级;如果所用网关的输出上限更低,还需配置 CLAUDE_CODE_MAX_OUTPUT_TOKENS。

为 Claude Code 2.1.329 选择接入路线

升级到 2.1.329 会直接涉及网关输出 token 上限、自托管网关的 allow_cidrs 启动警告,以及 Pro 或 Max 月度额度的显示逻辑。在修改本地或团队配置之前,先对照当前可行的几条接入路线。

接入路线账号与地区要求计费单位适用场景
Claude Pro / Max 订阅付费 claude.ai 账号(Pro、Max、Ultra、Team 或 Enterprise;不含免费版 claude.ai),且位于 Anthropic 支持的地区订阅内含用量,可选额外用量额度需要 Remote Control、语音输入,或同时使用网页端与 CLI 打包用量
直连 Anthropic Console APIClaude Console 账号(platform.claude.com,使用 API Key 或 Console 登录),且位于 Anthropic 支持的地区按 API token 按量付费希望不经代理,直接由 Anthropic API 计费
组织或自托管网关组织托管的代理服务(如集成企业 IdP 登录的 Claude apps gateway),配合上游 API 或云平台凭证按 token 计入上游 Anthropic Console、Bedrock、Agent Platform 或 Foundry 账号团队需要集中预算控制、模型访问权限、审计日志与托管配置
BetterToken 按量付费 API 网关BetterToken 账号与控制台 API Key;调用 API 无需提供 claude.ai 账号按 token 按量付费(已购买的付费余额不会按月清零)需要兼容 Anthropic 协议的 Claude API 或多模型选择,且不想自行搭建网关

将 Claude Code 2.1.329 接入 BetterToken

BetterToken 是独立的多模型 API 平台,并非 Anthropic 官方产品。其面向 Claude Code 的 Anthropic 兼容 Base URL 为 https://bettertoken.ai。配置 ANTHROPIC_BASE_URL 时请不要附加 /v1,因为 Claude Code 会自动拼接 /v1/messages。

截至 2026-11-20,BetterToken 的 Anthropic 兼容接口已上架 claude-sonnet-5-5、claude-opus-5-5、claude-haiku-5-5 和 claude-fable-5-2(均支持 1M token 上下文窗口与 128K 最大输出,其中 Sonnet 5.5、Opus 5.5 和 Haiku 5.5 为同步输出上限),同时提供 claude-haiku-4-5-20251001(200K 上下文与 64K 最大同步输出)。开始高负载会话前,请先查看当前价格,确认实时输入、输出及缓存费率。

在 Bash 中以不回显的方式读取 API Key,并导出测试会话所需的环境变量:

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"

发送一条单次提示词验证连接:

claude -p "Reply with only: OK"

如果直接返回 OK,且没有出现 401、连接失败或模型报错,说明鉴权已生效。接着启动 claude 并运行 /status,确认 Anthropic base URL 显示为 https://bettertoken.ai,且认证行显示为 ANTHROPIC_AUTH_TOKEN 而非 claude.ai 登录态。如果启动时提示存在凭证来源冲突,请运行 /logout 清除已保存的 claude.ai 会话;若当前终端环境还设置了 ANTHROPIC_API_KEY,也请一并清除。

如需在多个会话间持久化这些变量,请将它们写入 ~/.claude/settings.json(Windows 路径为 %USERPROFILE%\.claude\settings.json)中的 "env" 代码块,然后完全重启 Claude Code。完整配置示例可参考 BetterToken Claude Code 配置指南或 Claude Code API 接入说明。仅当你选用的模型输出上限低于 Claude Code 请求大小时,才需要额外配置 CLAUDE_CODE_MAX_OUTPUT_TOKENS。如果启用了可选变量 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1,自动更新会被关闭,后续需手动运行 claude update。Remote Control 和语音输入依赖 claude.ai 账号登录,在使用 API Key 与自定义 Base URL 时不可用。

领取企业折扣价目表

如果团队已经部署了自有代理或 Claude apps gateway,保留现有托管配置即可,或按 Anthropic 官方的将 Claude Code 连接到 LLM 网关文档,配合 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 或 apiKeyHelper 配置 ANTHROPIC_BASE_URL。

网关 max_tokens 报错与 allow_cidrs 启动警告

Claude Code 2.1.329 移除了 2.1.326 引入的一项自动重试机制。在 2.1.326 中,当请求的 max_tokens 超过模型上限时,Claude Code 会自动按 API 报错中返回的最大值重试。根据 Claude Code 官方更新日志,2.1.329 已取消这一重试行为。

这一调整会影响通过网关调用较低输出上限模型的团队。按照 Claude Code 环境变量参考文档,未识别的自定义模型 ID 默认使用 32000 输出 token,上限为 128000。当网关将该 ID 映射到输出上限更低的模型时,请求现在会直接因 max_tokens 失败,不再静默重试。

在终端或 ~/.claude/settings.json 中将 CLAUDE_CODE_MAX_OUTPUT_TOKENS 设为该模型确认支持的输出上限:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS="16384"

将 16384 替换为模型的实际输出上限,重启 Claude Code,再发送一条简短提示词确认 max_tokens 报错已消失。如果网关拒绝请求的原因是输入长度而非输出长度,可参考我们的修复 Claude Code 1M 上下文窗口网关报错指南。

运维 Anthropic 自托管 Claude apps gateway 的团队也会收到更明显的启动警告。当 access_control.allow_cidrs 为空时,2.1.329 每次启动都会输出带边框的日志提示:never expose the gateway to the public internet(如果网关仅绑定回环地址且未设置 trusted_proxies 和 public_url,则不会触发该启动警告)。根据 Claude apps gateway 配置指南,同时留空两个 access_control 列表(allow_cidrs 和 deny_cidrs)会让网关接受任意客户端地址,只能依靠外层网络限制访问。这一点风险很高,因为网关能够下发在开发者机器上执行命令的托管配置。请在 access_control.allow_cidrs 中填入内网网段,并确保网关及其前置组件均无法从公网访问。如果有负载均衡、端口转发或隧道转发流量,仅当前端会追加每条入站连接的真实来源地址、确保开发者无法伪造最后一个 X-Forwarded-For 条目时,才应将其加入 listen.trusted_proxies。切勿将开发者发起连接时使用的来源 IP 地址或网段加入 listen.trusted_proxies;但如果漏配符合条件的中继节点,网关看到的将是中继地址而非客户端地址。修改完成后重启网关,确认警告不再出现。

/tasks、已保存的定时任务与 /code-review 行为变更

2.1.329 调整了 /tasks 展示当前会话任务的方式,以及 /code-review 计算代码差异的逻辑。在恢复定时任务或执行分支审查前,请先确认以下变化。

在 /tasks 中管理定时任务、/loop 唤醒与对话分支

/tasks 现已整合显示当前会话的定时任务、/loop 唤醒、当前目标以及本次对话的分支。选中任意条目后按 x,经确认即可停止。/tasks 顶部标题与底部状态栏的后台计数也合并为同一个数字,统一统计终端任务、监控任务、MCP 调用、智能体、工作流和定时任务。

旧版本保存的定时任务在升级后需要手动处理。在新的已登录会话中,由更早版本保存的大多数定时任务必须重新调度;不过使用 claude --resume 恢复原会话时,这些旧任务仍会继续运行。现在选择 Exit and stop tasks 会终止当前会话的定时任务,避免恢复会话时再次启动,但如果在 Claude 正在生成回复期间退出则除外。若想对比 Cloud、Desktop 与 /loop 三种定时方式,可阅读 Claude Code 定时任务调度指南。

/code-review 默认分支差异与拉取请求校验

在大多数模型上,不带目标参数直接运行 /code-review 现在会将整条当前分支与默认分支进行对比审查。本次更新同时修复了多提交分支上 /code-review 丢失差异的问题。

拉取请求审查的校验也更加严格。此前 /code-review <pr number> 有时会在不提示的情况下,静默审查本地检出的分支而非目标拉取请求。在 2.1.329 中,它会通过 gh pr diff 读取拉取请求内容,无法读取时明确提示原因。当 gh pr diff 失败或被拒绝时,/code-review <pr number> --fix 以及传入拉取请求 URL 的 /code-review 都会直接中止,不再继续审查。

大多数模型上的另外两处审查异常也已修复:/code-review 不再因为查找不存在的 ~/.claude/CLAUDE.md 而停在权限确认弹窗;以中等级别执行的审查,其结果卡片也不再误标为 high。

Hooks 信任警告、MCP 诊断信息与 /status 更新

Claude Code 2.1.329 加强了目录 hooks、远程 HTTP MCP 服务器、托管插件市场以及 Code Mode 的诊断与提示能力:

  • 目录与托管 hooks:信任对话框现在会明确标出某个目录的 hooks 声明位置。在 Claude Desktop 及其他非交互宿主中,托管配置里的 hooks 加载失败时会在对话内直接发出警告。在 VS Code 中,拒绝信任提示后,消息输入框上方会出现一行带 Review trust 按钮的提示,无需重载窗口即可重新打开信任对话框。如需排查来历不明的项目 hooks 或远程 MCP 服务器,可参考我们的 Claude Code hooks 与 MCP 连接审计指南。
  • 远程 HTTP MCP 诊断:/mcp 中的服务器详情页新增 Server message 行,用于在远程 HTTP MCP 服务器拒绝连接时展示 JSON-RPC 错误信息。2.1.329 还会自动重连大多数停留在旧协议版本的 HTTP MCP 服务器,避免后台 MCP 任务卡死。此外,修复了服务端客户端注册已下线(HTTP 410 Gone)时 claude mcp login 与 /mcp 误报服务不接受来自 Claude Code 的登录的问题,并防止在清除认证后因正在进行的 token 刷新而被重新登录。
  • 插件市场自动更新状态:/status 新增 Marketplace auto-update 行,列出不会自动更新的托管插件市场及其原因。
  • Code Mode 遥测与 hooks:现在可以在开启 OpenTelemetry 事件与指标的同时启用 Code Mode,代码触发的每次工具调用都会上报对应事件,不过开启链路追踪时 Code Mode 仍会保持关闭。当遥测、非必要流量或功能开关关闭时,Code Mode 现也可正常启动,但管理员仍可通过托管配置将其禁用。出错的 PreToolUse hook 不再默认拒绝 Code Mode 脚本的工具调用,除非在命令、HTTP 或 MCP 工具 hook 上明确设置 "onFailure": "block"。Code Mode 现也会拒绝超过 256 MiB 的行范围读取,并在死循环耗尽内存前将其终止。

~/.claude.json 重置、异常登出与用量额度修复

在 2.1.329 更新日志列出的 91 项缺陷修复中,有四项稳定性修复直接针对高频会话中断问题。

第一,修复了因网络卡顿或文件锁导致 ~/.claude.json 在保存过程中无法读取并被清空、进而重置为默认配置的问题。升级可以保护后续写入,但如果旧版本已经清空了你的配置文件,仍需手动恢复或重新应用设置。

第二,修复了 macOS 和 VS Code 中的循环登出问题。在 macOS 上,登录续期现在会先通过 Claude Code-write-check 条目测试钥匙串(Keychain)写入权限;当 Claude Code 能读取钥匙串但无法写入时,仅当前会话会在过期后停止并说明原因,其他会话保持登录状态。在 VS Code 中,当登录服务器需要 10 到 30 秒才能响应扩展发起的 token 刷新请求时,Claude Code 不再将所有窗口和终端同时登出。X 平台上的早期社区笔记(如 @alexmichael 的帖文,2026-11-19 22:17 UTC)也重点提及了这些登出和 ~/.claude.json 修复以及 /tasks、/code-review 变化,与官方更新日志一致。

第三,Pro 和 Max 的用量额度提示更加可靠。/usage-credits 在打开浏览器后不再要求 Pro 和 Max 用户重新登录;当浏览器未能打开且任务因额度暂停时,链接也不会再在 8 秒后消失。此外,/usage 不再把额度用尽或触及月度上限的情况误报为用量额度已关闭,/model 现在也会在月度上限拦截需消耗用量额度的模型时向 Pro 和 Max 用户给出明确提示。当订阅限额暂停正在进行的任务时,可按我们的 Claude Code 用量限额恢复工作流先保存 Git 检查点再切换接入路线。

第四,修复了两项编辑器缺陷。通过 IDE 差异视图接受修改时,不再截掉文件末尾换行符,也不会在 VS Code 中丢失字节顺序标记(BOM)。/terminal-setup 也不再破坏 VS Code 配置文件或快捷键文件中块注释附近的内容,同时修复了 keybindings.json 含未闭合字符串时误报成功却丢失 Shift+Enter 绑定的问题。

11 月 19 日同日发布:Claude Code 2.1.328 关键变更

Anthropic 于 2026 年 11 月 19 日稍早时间(01:14:04Z)发布了 v2.1.328,比 v2.1.329(22:14:41Z)早约 21 小时。从 2.1.327 直接升级到 2.1.329 的团队也会同时获得以下 2.1.328 更新:

  • 网关超时与 Beta 请求头:CLAUDE_STREAM_IDLE_TIMEOUT_MS 现在可以正确延长网关、自定义 Base URL 和云平台上的 5 分钟连接时长限制。在拒绝 beta 请求头的网关后,或在 Bedrock、Agent Platform、Foundry 及 Claude apps gateway 上启用 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 时,Claude Desktop 之外的自动模式不再每轮必败。输入结构定义以 anyOf、oneOf 或 allOf 开头的 MCP 工具,在第三方服务商上或关闭遥测、功能开关时也不再消失。
  • 更聚焦的 /code-review 报告:在大多数模型上,/code-review 现在只报告代码缺陷与违反 CLAUDE.md 的问题;如需代码复用和精简清理建议,请运行 /simplify。在大多数模型上,每条问题会被标记为 Important、Pre-existing 或 Nit,并在摘要末尾附上修复建议;未发现问题时输出 "Code review found no issues."。
  • 定时任务保护与 MCP hooks:在第三方服务商上或关闭遥测、功能开关时,如果定时任务文件暂时无法读取,保存新定时任务不再抹掉同项目的其他已保存任务。此外,mcp_tool hooks 现与命令、HTTP hooks 一样支持 "onFailure": "block"。
BetterToken · 企业采购
企业专属价
支持开发票对公转账 / 支付宝 / 微信支付全系列文本 / 编程、图像、视频模型
文本 / 编程
图像
视频
专属技术支持领取企业折扣价目表 →