AI Code With
开发教程

Claude Code 后台子 Agent 更省额度了：2.1.316 状态行改由 Haiku 5.5 写，怎么升级、怎么确认、子 Agent 模型怎么配

据 Anthropic 官方 @ClaudeDevs，Claude Code 后台子 Agent 每 30 秒刷新一次的状态行，以前每次都要重读子 Agent 的整段对话，现在改由 Haiku 5.5 根据简短笔记来写，每次刷新消耗约降 99%，用到后台子 Agent 的会话约少用 5% 额度、同样额度约多 6% 提示，需要 v2.1.316+。本文讲清这条改动对谁生效、怎么升级和确认版本，附用 API Key 接 Claude Code 2.1.318 跑后台子 Agent 的实测，以及 CLAUDE_CODE_SUBAGENT_MODEL、agents 文件、/tasks 的子 Agent 模型配置方法。

8 分钟阅读
Claude Code 后台子 Agent 更省额度了：2.1.316 状态行改由 Haiku 5.5 写，怎么升级、怎么确认、子 Agent 模型怎么配

先说结论：

  • 据 Anthropic 官方账号 @ClaudeDevs（北京时间 11 月 5 日凌晨发布）：后台子 Agent 运行时每 30 秒刷新一次状态行，以前每次刷新都要重读子 Agent 的整段对话，现在改由 Haiku 5.5 根据简短笔记来写，每次刷新的消耗约降 99%。
  • 据官方后续说明：子 Agent 本身仍用它自己的模型；用到后台子 Agent 的会话约少用 5% 的额度，同样额度约多 6% 的提示；已对大多数 Pro、Max、Ultra 用户和所有 Team、Enterprise 用户开放，需要 Claude Code v2.1.316 或更新版本。
  • 你要做的只有一件事：claude --version 看版本，低于 2.1.316 就升级。据 AlphaSignal 报道，这次改动不需要改任何配置。
  • 我们 11 月 5 日用 aicodewith 的 API Key 接 Claude Code 2.1.318 实测：后台子 Agent 的状态行确实约 30 秒换一次（「Reading shop and test files」→「Re-running tests on test_shop.py」），子 Agent 1 分 46 秒跑完并给出正确的 file:line。走 API Key 时，我们抓到的状态行刷新请求用的是子 Agent 自己的模型；想让子 Agent 和它的状态行都跑在 Haiku 5.5 上，设 CLAUDE_CODE_SUBAGENT_MODEL 即可，/tasks 里能直接看到「Haiku 5.5」。

创建 API Key，在 Claude Code 里跑后台子 Agent →

发生了什么

项目以前v2.1.316 起（官方说明）
状态行刷新频率后台子 Agent 运行中约每 30 秒一次不变
刷新时读什么子 Agent 的整段对话，越跑越长子 Agent 边做边记的简短笔记
谁来写这一行子 Agent 自己的模型Haiku 5.5
每次刷新的消耗随对话变长而增加约降 99%
整个会话—约少用 5% 额度，约多 6% 提示
子 Agent 干活用的模型你配置的模型不变

以上来自 @ClaudeDevs 的主帖和跟帖。据 METAL 报道，官方同时发了一段 6.6 秒的说明视频；据 AlphaSignal 报道，这条帖子发布于美国时间 11 月 4 日。

这里说的「状态行」，不是你用 /statusline 自定义的底部状态栏，而是输入框下方子 Agent 面板里，每个后台子 Agent 后面那一句「它现在在干什么」。据开发者 Gabriel Anhaia 在 DEV 上的整理，这一句以前是把子 Agent 的对话发给子 Agent 自己的模型，让它用三五个词概括最近的动作；只在后台子 Agent 正在工作时触发，空闲的不触发。所以子 Agent 开得越多、跑得越久，这部分消耗越明显。

Claude Code 更新日志里，这一句此前也被修过几次：2.1.128 修复了进度摘要没命中提示缓存的问题，2.1.274 修复了摘要变成长段落的问题，最新的 2.1.318 修复了后台子 Agent 运行时「Now using usage credits」提示约每 30 秒重复弹出的问题。

对谁有影响

你的情况影响
Pro、Max、Ultra 订阅，常开后台子 Agent据官方，大多数用户已生效，升到 2.1.316+ 后同样额度能多发约 6% 的提示
Team、Enterprise据官方，全部开放
基本不用子 Agent几乎没有变化，这次只改了后台子 Agent 的状态行
用 API Key 接 Claude Code（ANTHROPIC_BASE_URL）按 token 计量，不占订阅额度；我们实测时刷新请求仍跟随子 Agent 的模型，想省 token 就把子 Agent 设成 Haiku 5.5（见下文）

额度怎么算、5 小时窗口和周额度怎么叠加，可以看《Claude Code 用量上限与 Max 20x 说明》。

升级到 2.1.316+ 并确认版本

先看当前版本：

bash
claude --version
2.1.318 (Claude Code)

低于 2.1.316 就按你的安装方式升级。据 Claude Code 安装文档，原生安装会在后台自动更新，Homebrew、WinGet 默认不自动更新：

bash
# 原生安装或 npm 安装：升级到最新版
claude update
# Homebrew：claude-code 是 stable 通道，一般晚约一周；想马上拿到新版用 @latest
brew upgrade claude-code@latest
# Windows WinGet
winget upgrade Anthropic.ClaudeCode
# 查看安装方式、自动更新状态和上次更新结果
claude doctor

升级后重新打开终端，再跑一次 claude --version。官方帖子没有给出新的开关或设置项，升级完直接开后台子 Agent 用即可。

实测：用 API Key 接 Claude Code，跑一个后台子 Agent

测试时间 2026 年 11 月 5 日，Claude Code 2.1.318（Linux），主会话 Opus 5.5。为了不碰本机已有配置，我们用一个干净的 HOME 目录。

第 1 步：创建 API Key 并接入 Claude Code

  1. 在 aicodewith.ai 注册并登录，点左侧导航栏的「密钥管理」。
  2. 点「创建密钥」，起一个好认的名字，比如「Claude Code 子 Agent」。
  3. 马上复制完整的 Key 存好，窗口关掉就再也看不到完整的 Key。详细说明见创建 API Key 文档。

创建 API Key →

把 Key 写进 ~/.claude/settings.json：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key"
  }
}

其他接入方式见《Claude Code 如何接入第三方 API》。

第 2 步：准备一个会跑一会儿的任务

演示仓库是一个小 Python 项目：shop/ 下 3 个文件、tests/ 下 7 个测试，每个测试的 setUp 故意等 6 秒，整套测试跑一次约 42 秒；shop/pricing.py 里藏了一个「满 10 件打折」写成 qty > 10 的边界错误。在 Claude Code 里发这段话：

text
Use a general-purpose subagent in the background for a read-only review of this repo:
first run python3 -m unittest discover -s tests -v (about 45 seconds), then read every
file in shop/ and tests/ one by one, then run the test suite a second time, and finally
report each failing test with file:line, a one-line fix, and two other risks you notice.
The subagent must not edit any file. While it runs, just tell me it started.

第 3 步：看后台子 Agent 的状态行

主会话立刻回「已开始」，输入框下方出现子 Agent 面板。下面是同一行在不同时间的样子（按时间顺序摘录）：

text
● Agent(Read-only repo review)
  ⎿  Backgrounded agent (↓ to manage · ctrl+o to expand)
✻ Waiting for 1 background agent to finish

  ● main
  ◯ general-purpose  Read-only repo review                 48s · ↓ 12.0k tokens
  ◯ general-purpose  Reading shop and test files        1m 10s · ↓ 14.0k tokens
  ◯ general-purpose  Re-running tests on test_shop.py   1m 40s · ↓ 14.1k tokens

● Agent "Read-only repo review" finished · 1m 46s

一开始显示的是任务名「Read-only repo review」；1 分 10 秒时变成「Reading shop and test files」，1 分 40 秒时变成「Re-running tests on test_shop.py」，两次变化间隔正好约 30 秒，最后 1 分 46 秒跑完。另一次只跑一遍测试的任务（子 Agent 用主会话的 Opus 5.5）59 秒跑完，状态行从任务名变成了「Preparing shop unittest discovery run」。

子 Agent 的最终报告（节选）：

text
Tests: 7 ran and 1 failed. Both runs gave the same results, so nothing looks flaky.
Failing test: test_bulk_at_threshold (tests/test_shop.py:10)
- It expects 10 units at 1.0 to total 9.5, but the code returns 10.0.
- The cause is shop/pricing.py:3, which uses if qty > 10.
- Fix: change > to >= at shop/pricing.py:3.
Two other risks:
1. Overselling (shop/inventory.py:4-7): reserve() checks stock and then sets it with no lock.
2. Missing input checks (shop/cart.py:5, shop/cart.py:9).

报告指出的 shop/pricing.py:3 和 > 改 >= 都是对的，而且全程没有改任何文件。

第 4 步：抓包看状态行刷新用的是谁

我们在本机加了一层只记录模型名和消息条数的转发，结果如下：

时间点请求模型带的对话输出
1 分 10 秒前后状态行刷新claude-haiku-5-5（子 Agent 的模型）子 Agent 当前对话 7 条消息「Reading shop and test files」，10 个 token
1 分 40 秒前后状态行刷新claude-haiku-5-5（子 Agent 的模型）子 Agent 当前对话 8 条消息「Re-running tests on test_shop.py」，15 个 token

也就是说，在我们这次用 API Key 走 ANTHROPIC_BASE_URL 的测试里，状态行刷新仍是「带上子 Agent 当前对话、交给子 Agent 自己的模型」，和官方描述的旧做法一致；官方说新做法已对大多数订阅用户开放，没有提到 API Key 接入。对 API Key 用户来说，最直接的办法是把子 Agent 设成 Haiku 5.5：子 Agent 干活和状态行刷新都会跑在 Haiku 5.5 上。

子 Agent 模型怎么配

据 Claude Code 子 Agent 文档，子 Agent 的模型按这个顺序决定：

  1. Claude 发起这次调用时传的 model 参数；
  2. 子 Agent 定义文件里的 model 字段（inherit 表示跟主会话一样）；
  3. 环境变量 CLAUDE_CODE_SUBAGENT_MODEL；
  4. 主会话的模型。

方法一：给所有子 Agent 一个默认模型

在 ~/.claude/settings.json 的 env 里加一行，这就是我们第 3 步实测用的配置：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-5-5"
  }
}

注意它只是「默认值」：定义文件里写了 model 的子 Agent、Claude 调用时指定了模型的，都会覆盖它；单独设它也不会改变内置 Explore、Plan 子 Agent 的模型。

方法二：给某一个子 Agent 指定模型

在项目的 .claude/agents/ 或个人的 ~/.claude/agents/ 下建一个 Markdown 文件：

markdown
---
name: test-runner
description: Runs the test suite and reports failing tests with file:line. Read-only.
tools: Read, Grep, Glob, Bash
model: haiku
effort: medium
---
Run the tests, read only the files you need, and report each failing test
with file:line and a one-line fix. Never edit files.

model 可以写 haiku、sonnet、opus、inherit 或完整模型 ID（如 claude-haiku-5-5）。更完整的只读子 Agent 写法见《Claude Code 子 Agent 用 Haiku 5.5：配置方法》。

方法三：所有子 Agent 强制同一个模型

json
{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1",
    "CLAUDE_CODE_SUBAGENT_EFFORT": "medium"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 会忽略定义文件里的 model（需要 v2.1.257+）。CLAUDE_CODE_SUBAGENT_EFFORT 是 2.1.316 新加的，用来设定子 Agent 默认的 effort，不再跟着主会话走。

怎么确认生效

子 Agent 运行时输入 /tasks，选中它就能看到实际模型。我们实测的输出：

text
/tasks
  general-purpose › Read-only repo review
  1m 1s · 14.0k tokens · 8 tools · Haiku 5.5
  Progress
    Read(shop/cart.py)
    Read(shop/inventory.py)
    Read(shop/pricing.py)
    Read(tests/test_shop.py)
  › Bash(python3 -m unittest discover -s tests -v 2>&1; echo "EXIT=$?")

第二行末尾的「Haiku 5.5」就是子 Agent 实际在用的模型。Haiku 5.5 和 Sonnet 5.5 各适合什么活，可以参考《Claude Haiku 5.5 vs Sonnet 5.5》。

还能怎么少用额度

常见问题

需要改什么设置才能用上？

官方只要求升级到 v2.1.316 或更新版本，帖子里没有提到新开关。据 AlphaSignal 报道，不需要任何配置改动。

子 Agent 会因此变成 Haiku 吗？

不会。据官方，Haiku 5.5 只负责写那一行状态，子 Agent 干活仍用你配置的模型。想让子 Agent 本身也用 Haiku，要自己设 CLAUDE_CODE_SUBAGENT_MODEL 或在定义文件里写 model: haiku。

「省 99%」和「省 5%」是什么关系？

99% 是每一次状态行刷新的消耗，5% 是整个会话的额度。状态行在整个会话里只占一小部分，所以落到会话上是约 5%，同样额度约多 6% 的提示。

怎么看后台子 Agent 在干什么？

输入框下方的子 Agent 面板，每个后台子 Agent 一行，带状态、耗时和 token 数；用 ↓ 选中、Enter 打开它的记录，/tasks 能看到模型、工具调用和进度。

用 API Key 接入能用上这次的新做法吗？

官方说明里只提到 Pro、Max、Ultra、Team、Enterprise。我们用 API Key 实测 2.1.318 时，状态行刷新仍跟随子 Agent 的模型；把子 Agent 设成 Haiku 5.5 后，刷新也跑在 Haiku 5.5 上。

创建 API Key，开始用 Claude Code 后台子 Agent →

相关阅读

相关文章

Conductor 停服怎么办？不用 Conductor 也能并行跑多个 Claude Code / Codex：git worktree 实测教程

Conductor 停服怎么办？不用 Conductor 也能并行跑多个 Claude Code / Codex：git worktree 实测教程

Meta 收购 Conductor，据官方公告 Conductor Cloud 11 月 13 日只读、11 月 20 日停服并开始删除云端数据，本地 Mac 版更新到 2027 年初。本文先讲清时间线和要导出的东西，再给出不用 Conductor 的替代做法：git worktree 一个任务一个目录，各开一个 Claude Code / Codex 会话，配好 API Key，最后合并、验收、清理；附 claude --worktree、codex --worktree 原生用法、合并冲突处理实测，以及 Orca、Emdash、Claude Squad 等可替代工具。

Postman 偷偷给 Claude Code / Codex 装插件？3 步自查与删除（plugins、hooks、MCP、config.toml）

Postman 偷偷给 Claude Code / Codex 装插件？3 步自查与删除（plugins、hooks、MCP、config.toml）

据 GitHub issue #14370 和 The New Stack 报道，Postman 桌面版（macOS 12.33.4、12.35.1）在老用户升级时自动给 Claude Code 和 Codex 装了 Postman 插件，还在 ~/.codex/config.toml 里写了一条 trusted_hash，让自家的 SessionStart hook 直接生效。本文讲清事情经过和 Postman 的回应，给出 Claude Code、Codex、Cursor 的 3 步自查命令、官方删除命令和删不干净的残留，并附我们用 Postman 官方安装器在隔离目录里复现、删除、再跑通任务的实测。

DeepSeek Harness Creator Mode 怎么用？安装、接入第三方 API 和写第一个插件实测

DeepSeek Harness Creator Mode 怎么用？安装、接入第三方 API 和写第一个插件实测

DeepSeek Harness 官方 11 月 2 日推出 Creator Mode 演示：用一句话描述需求，智能体就写好插件、装进 Harness 并验证。本文讲清 Creator Mode 是什么、怎么用 npx 安装 Harness、怎么把 OpenAI 兼容的第三方 API（aicodewith Base URL + Key）接进来用 Claude、GPT 和 DeepSeek 模型，再用 Creator Mode 实际做一个 todo_scan 插件，附实测输出、常见报错和 Claude Code / Codex 的对应做法。