Claude Code v2.1.217：表情符號短碼自動完成、子代理並行與巢狀上限，以及對話記錄寫入警告

Claude Code v2.1.217 新增數項面向使用者的功能，並限制子代理能展開的範圍。重點包括提示輸入框中的表情符號短碼自動完成、同時執行之子代理的預設上限、預設不再產生巢狀子代理，以及無法儲存對話記錄時的警告。修正部分涵蓋背景工作階段隔離、Windows 自動更新、Bedrock 上的自動壓縮，以及 Claude Desktop 的網路設定。

新功能

表情符號短碼自動完成

提示輸入框現在支援表情符號短碼自動完成：輸入 :heart: 會插入 ❤️，輸入 :hea 則會顯示建議。可透過 emojiCompletionEnabled 設定停用。

子代理展開上限

新增同時執行之子代理的上限（預設 20 個，可用 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 覆寫），避免單一訊息無限制地展開背景代理；子代理預設也不再產生巢狀子代理，若要允許更深的巢狀層級，請設定 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH。此外，--max-budget-usd 現在也會停止背景子代理：一旦達到上限，新的產生請求會被拒絕，執行中的背景代理也會被停止。

無法儲存對話記錄時發出警告

當對話記錄寫入失敗（例如磁碟已滿），或因繼承的環境變數而關閉了工作階段儲存時，Claude Code 現在會發出警告，而不是悄悄遺失對話記錄。

可點擊的 PR 徽章連結

即使無法偵測終端機的支援情況（例如透過 ssh/tmux 連線），頁尾的 PR 徽章連結現在也會是可點擊的超連結。設定 FORCE_HYPERLINK=0 即可停用。

登入到期警告的顯示時間

登入到期警告現在會在到期前 3 天顯示，而不是 5 天前。

修正與改進

記憶體：被截斷的 MCP 工具輸出，不再於工作階段剩餘期間將完整未截斷的結果保留在記憶體中。
背景工作階段：工作階段隔離現在會將符號連結的工作目錄正規化，先前這個問題可能讓工作階段跳出其工作區資料夾。將工作階段送到背景（/background 或 ←）後，或在高負載機器上結束工作階段時，背景 shell 不再偶爾無法停止（此問題在 Windows 上最明顯）。附加到正在啟動的背景工作階段時，對話記錄預覽現在會與即時版面保留相同的一行間距，因此工作階段接手時對話記錄不再跳動。
Windows：自動更新失敗不再可能導致 claude.exe 遺失；更新失敗時現在會自動還原保留的執行檔。
Bedrock：在 Bedrock 上使用 Claude Opus 4.8 時，自動壓縮現在會觸發，超過上限後 /compact 也不再失敗。
Claude Desktop：在 Claude Desktop 工作階段中，企業的 mTLS、TLS 驗證、OAuth 範圍與代理伺服器設定不再被忽略。
恢復工作階段：當對話記錄含有格式錯誤的附件項目時，--resume/--continue 與 /resume 不再以 TypeError 失敗。
Remote Control：在權限提示或對話框出現之後才連線的檢視者，現在也能在 Remote Control 工作階段中看到這個待處理的提示或對話框。
遙測：設定了 OTEL_EXPORTER_OTLP_ENDPOINT 的受管設定現在會管轄所有訊號；較低範圍的特定訊號覆寫，不再將遙測導離受管端點。
啟動：CLAUDE.md 或 SKILL.md 的 paths frontmatter 值含有大量大括號群組時，不再導致 CLI 在啟動時因記憶體不足而被終止或停滯，因為大括號展開現在有預算上限。
無障礙：螢幕閱讀器模式的啟動朗讀不再被第一次提示渲染打斷，思考狀態列也不再每隔幾秒就為了更新經過時間與權杖數而重新渲染。
提示訊息：frontend-design 外掛的建議提示現在在整個使用期間最多只顯示 3 次，而不是無限重複。

如何更新

檢查目前安裝的版本：claude --version
直接就地更新：claude update
子代理預設不再產生巢狀子代理，且預設最多同時執行 20 個；如果您的工作流程需要更多，請調整 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 或 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS。

新功能