Claude Code 子代理上限 20：能調高，關不掉

如果你有一個會一口氣派十幾二十個子代理的 Claude Code 流程，這幾天它可能開始有東西開不出來了。

Anthropic 在 7 月 19 日到 7 月 23 日（台北時間）之間發了三個版本，每一版都收一點代理人的自主權。 2.1.215 那版整份 changelog 只有一條：Claude 不再自己跑 /verify 和 /code-review，要你叫才跑。 2.1.217 給同時在跑的子代理加了預設 20 的併發上限，並且把「子代理可以再開子代理」從預設開改成 預設關。2.1.218 再把 /deep-research 改成只在手動呼叫時啟動。

三件事的方向一樣：開大工程的決定權，從模型手上回到你手上。

滿了會怎樣，changelog 沒寫，官方 docs 寫了。同時 20 個在跑的時候，第 21 個不會排隊， Agent 工具直接失敗回 Concurrent subagent limit reached，錯誤訊息還會叫 Claude 不要重試； 要等在跑的數量掉下來才開得成。有兩個路徑會偷偷佔掉格子：你自己用 /subtask 開的 in-session fork 佔一格但永遠不會被擋，而 resume 一個已經跑完的子代理會拿到新格子且不檢查上限—— 官方明寫這會把數量推過上限。另外，開著 ultracode 的對話豁免，這道閘在那裡不生效。

深度那道值得單獨看。預設 1 的意思是子代理不准再開子代理，而官方的做法不是攔呼叫，是 把 Agent 工具整個從子代理的工具清單裡抽掉。只有 fork 例外——它繼承父層的完整工具清單， Agent 還在裡面，但呼叫回錯誤。要放開就在 settings.json 的 env 裡寫層數：

{
  "env": {
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
  }
}

👉 這裡有個共同設計，把三個上限擺在一起才看得出來。併發 20、深度 1、每場 200，三個環境變數的 官方說明用了同一句話：接受正整數，其他值一律忽略，所以這個變數可以調高，不能關掉。 同一版還修好了 --max-budget-usd 管不到背景子代理的問題——現在錢燒到上限，新的不准開， 正在跑的背景代理也會被停下來。你能調的是刻度，不是有沒有這道閘。

至於為什麼 2.1.212 已經有每場對話 200 個子代理的總量上限（本站 7 月 17 日報過的那一集）了，還要再加併發與深度，官方沒有解釋。我的讀法是總量擋的是失控迴圈、 併發擋的是單一訊息瞬間把機器灌爆，但這是我的讀法，不是官方說法。

今天可以做的四件事：claude --version 看自己在哪個版本（查看時 npm 的 stable 還停在 2.1.206、latest 是 2.1.218，差了十二個版本十三天，走 stable 的人這三版都還沒拿到）； 要更寬的 fan-out 就設 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS；有 context: fork 的自訂 skill 不想被丟到背景跑，在該 skill 的 frontmatter 加 background: false（2.1.218 才有這個欄位）； 原本仰賴 Claude 自動跑 /verify、/code-review、/deep-research 的流程，改成自己叫。

本篇是官方 changelog、官方 docs 與 npm registry 的文件檢視，我們沒有真的開第 21 個子代理去 撞那道牆。