Documentation 2026-10-10 23:01 UTC to 2026-10-11 11:58 UTC

300* **您停止了回合**：Claude Code 會取消切換並顯示 `Backgrounding cancelled — the turn was stopped.` 例如，當您 [使用 `Esc` 中斷 Claude](/docs/zh-TW/interactive-mode#general-controls)、在主對話的權限提示上 [不附註解](/docs/zh-TW/permissions#add-a-comment-when-you-answer-a-permission-prompt) 選擇 **No**，或在主對話中對 Claude 提出的問題按 `Esc` 時，回合就會停止。再按一次 `←` 即可將工作階段移至背景。300* **您停止了回合**：Claude Code 會取消切換並顯示 `Backgrounding cancelled — the turn was stopped.` 例如，當您 [使用 `Esc` 中斷 Claude](/docs/zh-TW/interactive-mode#general-controls)、在主對話的權限提示上 [不附註解](/docs/zh-TW/permissions#add-a-comment-when-you-answer-a-permission-prompt) 選擇 **No**，或在主對話中對 Claude 提出的問題按 `Esc` 時，回合就會停止。再按一次 `←` 即可將工作階段移至背景。

301* **佇列中的訊息無法移動**：您 [在 Claude 工作時加入佇列](/docs/zh-TW/interactive-mode#queue-messages-while-claude-works) 的訊息會隨對話移至背景工作階段。當其中某則訊息無法移動時，工作階段會留在前景，而 Claude Code 會顯示如 `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.` 的通知。301* **佇列中的訊息無法移動**：您 [在 Claude 工作時加入佇列](/docs/zh-TW/interactive-mode#queue-messages-while-claude-works) 的訊息會隨對話移至背景工作階段。當其中某則訊息無法移動時，工作階段會留在前景，而 Claude Code 會顯示如 `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.` 的通知。

302 302 

303當 Claude Code 將工作階段移至背景時（無論是在約十秒後，還是在您再按一次 `←` 後），它會停止 Claude 仍在前景執行的 shell 命令。Claude Code 不會針對該命令顯示 `Background this session?` 對話框。在背景工作階段中，Claude 沒有該命令曾經啟動的記錄，因此 Claude 可能會再次執行該命令。若要在工作階段移動時讓命令繼續執行，請在 Claude Code 仍在等待時按 `Ctrl+B` [將其轉為背景命令](/docs/zh-TW/interactive-mode#background-bash-commands)。

304 

303即使對話尚無任何訊息，按 `←` 也會建立該工作階段的列，因此 `→` 仍可返回該工作階段。305即使對話尚無任何訊息，按 `←` 也會建立該工作階段的列，因此 `→` 仍可返回該工作階段。

304 306 

305您可以使用 `/config` 中的 [`leftArrowOpensAgents`](/docs/zh-TW/settings-reference#leftarrowopensagents) 設定，為前景工作階段關閉此快捷鍵。307您可以使用 `/config` 中的 [`leftArrowOpensAgents`](/docs/zh-TW/settings-reference#leftarrowopensagents) 設定，為前景工作階段關閉此快捷鍵。

90 90 

91當您的計畫限制請求失敗時（通常是因為使用情況端點受到速率限制），`/usage` 會顯示它在過去 60 分鐘內在此機器上載入的最後使用情況列，以及一個 `Showing last-known usage` 備註，說明該資料是多久前取得的。按 `r` 重試；成功重試會用新資料取代最後已知的列。如果沒有過去 60 分鐘內的快照，`/usage` 會報告使用情況端點受到速率限制，並提供相同的重試快捷方式。在 v2.1.208 之前，在尚未載入使用情況的工作階段中受到速率限制的請求始終會顯示錯誤，沒有任何列。91當您的計畫限制請求失敗時（通常是因為使用情況端點受到速率限制），`/usage` 會顯示它在過去 60 分鐘內在此機器上載入的最後使用情況列，以及一個 `Showing last-known usage` 備註，說明該資料是多久前取得的。按 `r` 重試；成功重試會用新資料取代最後已知的列。如果沒有過去 60 分鐘內的快照，`/usage` 會報告使用情況端點受到速率限制，並提供相同的重試快捷方式。在 v2.1.208 之前，在尚未載入使用情況的工作階段中受到速率限制的請求始終會顯示錯誤，沒有任何列。

92 92 

93<h3 id="read-the-token-count-beside-the-spinner">

94 閱讀旋轉指示器旁的 token 計數

95</h3>

96 

97Claude 在主要對話中工作時，旋轉指示器旁的那一行結尾可能會顯示經過時間和 token 計數，例如 `Deciphering… (10m 27s · ↓ 5.5k tokens)`。這是目前回合到目前為止所產生輸出的即時近似計數。在輸出陸續抵達或工具執行期間，計數旁的箭頭會朝下。

98 

99* **涵蓋範圍**：回合產生的輸出，例如 Claude 串流回傳的文字和工具呼叫、其思考，以及在[前景](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)執行的 subagent 的輸出

100* **不包含的內容**：Claude Code 傳送給模型的內容，因此您的提示詞、對話歷史記錄以及其餘上下文不會使其變動

101* **重設時機**：每個回合開始時，以及 Claude Code [壓縮對話](/docs/zh-TW/prompt-caching#compacting-the-conversation)時

102* **隱藏時機**：在輸出開始抵達之前、該列太窄無法容納時，以及在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中

103 

104它不會與 `/usage` Session 區塊中的 `Usage by model` 輸出數字相符，因為後者加總的是整個工作階段，而非單一回合。它也與[詳細模式新增](/docs/zh-TW/statusline#notifications-share-the-status-line-row)的 token 計數不同，因為該計數衡量的是您上下文的大小，而非單一回合的輸出。

105 

93<h3 id="analyze-your-usage-patterns">106<h3 id="analyze-your-usage-patterns">

94 分析您的使用情況模式107 分析您的使用情況模式

95</h3>108</h3>

127| `settings.json` 值似乎被忽略 | 相同的鍵在 `settings.local.json` 中設定 | `settings.local.json` 會覆寫 `settings.json`，兩者都會覆寫 `~/.claude/settings.json`。請參閱 [settings 優先順序](/docs/zh-TW/settings#settings-precedence)。 |127| `settings.json` 值似乎被忽略 | 相同的鍵在 `settings.local.json` 中設定 | `settings.local.json` 會覆寫 `settings.json`，兩者都會覆寫 `~/.claude/settings.json`。請參閱 [settings 優先順序](/docs/zh-TW/settings#settings-precedence)。 |

128| Skill 未出現在 `/skills` 中 | Skill 檔案位於 `.claude/skills/name.md` 而不是在資料夾中 | 使用包含 `SKILL.md` 的資料夾：`.claude/skills/name/SKILL.md`。 |128| Skill 未出現在 `/skills` 中 | Skill 檔案位於 `.claude/skills/name.md` 而不是在資料夾中 | 使用包含 `SKILL.md` 的資料夾：`.claude/skills/name/SKILL.md`。 |

129| Skill 出現在 `/skills` 中，但 Claude 從未叫用它 | Skill 在其 frontmatter 中有 `disable-model-invocation: true`，或其描述與您提出請求的方式不符 | 檢查 `/skills` 中的徽章：「user-only」標籤表示 Claude 不會自動觸發它。請參閱 [skill 叫用](/docs/zh-TW/skills)。 |129| Skill 出現在 `/skills` 中，但 Claude 從未叫用它 | Skill 在其 frontmatter 中有 `disable-model-invocation: true`，或其描述與您提出請求的方式不符 | 檢查 `/skills` 中的徽章：「user-only」標籤表示 Claude 不會自動觸發它。請參閱 [skill 叫用](/docs/zh-TW/skills)。 |

130| 子目錄 `CLAUDE.md` 指示似乎被忽略 | 子目錄檔案按需載入，而不是在工作階段開始時載入 | 請參閱 [子目錄檔案何時載入](/docs/zh-TW/memory#how-claude-md-files-load)。在 v2.1.288 之前，只有 Read 工具會載入它們。 |130| 子目錄 `CLAUDE.md` 指示似乎被忽略 | 子目錄檔案按需載入，而不是在工作階段開始時載入 | 若要載入子目錄的 `CLAUDE.md`，請要求 Claude 讀取該子目錄中的另一個檔案。請參閱 [子目錄檔案何時載入](/docs/zh-TW/memory#how-claude-md-files-load)。 |

131| 子代理忽略 `CLAUDE.md` 指示 | 內建的 Explore 和 Plan 代理會跳過 `CLAUDE.md`。自訂子代理的載入方式與主對話相同，除非其定義設定 [`omitClaudeMd`](/docs/zh-TW/sub-agents#supported-frontmatter-fields) | 對於 Explore 或 Plan，在您的委派提示中重新陳述指示。對於設定 `omitClaudeMd` 的子代理，移除該欄位。對於任何其他自訂子代理，將關鍵指示放在代理檔案本文中，該本文會成為代理的系統提示。請參閱 [啟動時載入的內容](/docs/zh-TW/sub-agents#what-loads-at-startup)。 |131| 子代理忽略 `CLAUDE.md` 指示 | 內建的 Explore 和 Plan 代理會跳過 `CLAUDE.md`。自訂子代理的載入方式與主對話相同，除非其定義設定 [`omitClaudeMd`](/docs/zh-TW/sub-agents#supported-frontmatter-fields) | 對於 Explore 或 Plan，在您的委派提示中重新陳述指示。對於設定 `omitClaudeMd` 的子代理，移除該欄位。對於任何其他自訂子代理，將關鍵指示放在代理檔案本文中，該本文會成為代理的系統提示。請參閱 [啟動時載入的內容](/docs/zh-TW/sub-agents#what-loads-at-startup)。 |

132| 清理邏輯在工作階段結束時永遠不會執行 | 未設定 `SessionEnd` hook | 在 `settings.json` 中新增 `SessionEnd` hook。請參閱 [hook 事件列表](/docs/zh-TW/hooks#hook-events)。 |132| 清理邏輯在工作階段結束時永遠不會執行 | 未設定 `SessionEnd` hook | 在 `settings.json` 中新增 `SessionEnd` hook。請參閱 [hook 事件列表](/docs/zh-TW/hooks#hook-events)。 |

133| `.mcp.json` 中的 MCP 伺服器永遠不會載入 | 檔案位於 `.claude/` 下，或其伺服器位於頂層 `servers` 鍵下（如 VS Code 的 `mcp.json`），而不是 `mcpServers` | 專案 MCP 設定位於存放庫根目錄的 `.mcp.json`，而不是在 `.claude/` 內，伺服器位於 `mcpServers` 鍵下。請參閱 [MCP 設定](/docs/zh-TW/mcp)。 |133| `.mcp.json` 中的 MCP 伺服器永遠不會載入 | 檔案位於 `.claude/` 下，或其伺服器位於頂層 `servers` 鍵下（如 VS Code 的 `mcp.json`），而不是 `mcpServers` | 專案 MCP 設定位於存放庫根目錄的 `.mcp.json`，而不是在 `.claude/` 內，伺服器位於 `mcpServers` 鍵下。請參閱 [MCP 設定](/docs/zh-TW/mcp)。 |

256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 可停用所有背景任務功能，包括 Bash 與 subagent 工具上的 `run_in_background` 參數、自動背景化，以及 Ctrl+B 快速鍵 |256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 可停用所有背景任務功能，包括 Bash 與 subagent 工具上的 `run_in_background` 參數、自動背景化，以及 Ctrl+B 快速鍵 |

257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | 設定為 `1` 可阻止 Claude Code 將缺少或為空 `Content-Type` 標頭的 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應視為 Amazon Bedrock 的二進位事件串流。預設情況下，Claude Code 假設是閘道從原本未經修改的回應中移除了該標頭，因此會解碼本文，讓串流持續運作。僅針對也會將串流重新輸出為 server-sent events 的閘道設定此變數；Claude Code 隨後會將沒有標頭的本文讀取為 server-sent events。需要 Claude Code v2.1.239 或更新版本 |257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | 設定為 `1` 可阻止 Claude Code 將缺少或為空 `Content-Type` 標頭的 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應視為 Amazon Bedrock 的二進位事件串流。預設情況下，Claude Code 假設是閘道從原本未經修改的回應中移除了該標頭，因此會解碼本文，讓串流持續運作。僅針對也會將串流重新輸出為 server-sent events 的閘道設定此變數；Claude Code 隨後會將沒有標頭的本文讀取為 server-sent events。需要 Claude Code v2.1.239 或更新版本 |

258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | 設定為 `1` 可略過檢查 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應是否帶有 `application/vnd.amazon.eventstream` content-type。若未設定此變數，當回應帶有不同的 content-type 時，Claude Code 會使請求失敗，並顯示指出該類型的錯誤，這表示[閘道或代理伺服器正在轉換回應](/docs/zh-TW/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)。請將閘道設定為原封不動地轉送 `Content-Type` 標頭與本文，而非設定此變數。需要 Claude Code v2.1.208 或更新版本 |258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | 設定為 `1` 可略過檢查 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應是否帶有 `application/vnd.amazon.eventstream` content-type。若未設定此變數，當回應帶有不同的 content-type 時，Claude Code 會使請求失敗，並顯示指出該類型的錯誤，這表示[閘道或代理伺服器正在轉換回應](/docs/zh-TW/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)。請將閘道設定為原封不動地轉送 `Content-Type` 標頭與本文，而非設定此變數。需要 Claude Code v2.1.208 或更新版本 |

259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | 設定為 `1` 可在 [supervisor](/docs/zh-TW/agent-view#the-supervisor-process) 停止、重新啟動或更新[背景工作階段](/docs/zh-TW/agent-view)的程序時，停止該工作階段正在執行的背景 shell 命令、動態工作流程，以及（自 v2.1.198 起）背景 subagent，而非將它們交給該工作階段的下一個程序。僅影響此交接：使用 `←` 或 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段移至背景時，仍會延續進行中的工作，而 `CLAUDE_DISABLE_ADOPT` 會同時關閉兩者。需要 Claude Code v2.1.196 或更新版本 |259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | 設定為 `1` 可在 [supervisor](/docs/zh-TW/agent-view#the-supervisor-process) 停止、重新啟動或更新[背景工作階段](/docs/zh-TW/agent-view)的程序時，停止該工作階段正在執行的背景 shell 命令、動態工作流程，以及（自 v2.1.198 起）背景 subagent，而非將它們交給該工作階段的下一個程序。僅影響該交接：使用 `←` 或 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段移至背景時，仍會延續進行中的背景工作，而 `CLAUDE_DISABLE_ADOPT` 會同時關閉兩者。需要 Claude Code v2.1.196 或更新版本 |

260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | 設定為 `1` 可阻止 Claude Code 在記憶體壓力下終止[背景 shell 命令](/docs/zh-TW/interactive-mode#background-bash-commands)。預設情況下，在 macOS 與 Linux 上，當作業系統回報嚴重記憶體壓力，且工作階段已閒置 30 分鐘、沒有任何回合或 subagent 正在執行時，Claude Code 會終止背景 shell。Windows 沒有記憶體壓力訊號，因此此變數在該平台上沒有作用。需要 Claude Code v2.1.193 或更新版本 |260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | 設定為 `1` 可阻止 Claude Code 在記憶體壓力下終止[背景 shell 命令](/docs/zh-TW/interactive-mode#background-bash-commands)。預設情況下，在 macOS 與 Linux 上，當作業系統回報嚴重記憶體壓力，且工作階段已閒置 30 分鐘、沒有任何回合或 subagent 正在執行時，Claude Code 會終止背景 shell。Windows 沒有記憶體壓力訊號，因此此變數在該平台上沒有作用。需要 Claude Code v2.1.193 或更新版本 |

261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設定為 `1` 可停用 Claude Code 隨附的 [skill](/docs/zh-TW/skills) 與工作流程：隨附的 skill 與工作流程會被完全移除，而 `/init` 等內建命令仍可輸入，但會對模型隱藏。`/doctor` 與內建命令一樣仍可輸入；請改用 `DISABLE_DOCTOR_COMMAND` 將其隱藏。來自外掛、`.claude/skills/` 與 `.claude/commands/` 的 skill 不受影響。等同於 [`disableBundledSkills`](/docs/zh-TW/settings-reference#disablebundledskills) 設定 |261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設定為 `1` 可停用 Claude Code 隨附的 [skill](/docs/zh-TW/skills) 與工作流程：隨附的 skill 與工作流程會被完全移除，而 `/init` 等內建命令仍可輸入，但會對模型隱藏。`/doctor` 與內建命令一樣仍可輸入；請改用 `DISABLE_DOCTOR_COMMAND` 將其隱藏。來自外掛、`.claude/skills/` 與 `.claude/commands/` 的 skill 不受影響。等同於 [`disableBundledSkills`](/docs/zh-TW/settings-reference#disablebundledskills) 設定 |

262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 設定為 `1` 可讓 [Claude in Chrome](/docs/zh-TW/chrome) 瀏覽器工具保持可用，同時省略系統提示詞中的 Chrome 區段與 `/claude-in-chrome` [隨附 skill](/docs/zh-TW/skills#bundled-skills)。適用於嵌入 Claude Code 並自行提供瀏覽器指引的主機。需要 Claude Code v2.1.257 或更新版本 |262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 設定為 `1` 可讓 [Claude in Chrome](/docs/zh-TW/chrome) 瀏覽器工具保持可用，同時省略系統提示詞中的 Chrome 區段與 `/claude-in-chrome` [隨附 skill](/docs/zh-TW/skills#bundled-skills)。適用於嵌入 Claude Code 並自行提供瀏覽器指引的主機。需要 Claude Code v2.1.257 或更新版本 |

1308在[全螢幕呈現](/docs/zh-TW/fullscreen)外，Claude Code 在與您的狀態列相同行上顯示通知。在全螢幕呈現中，Claude Code 為通知提供自己的行。1308在[全螢幕呈現](/docs/zh-TW/fullscreen)外，Claude Code 在與您的狀態列相同行上顯示通知。在全螢幕呈現中，Claude Code 為通知提供自己的行。

1309 1309 

1310* 系統通知（如 MCP 伺服器錯誤和自動更新）顯示在行的右側。暫時性通知（例如 context-low 警告）也會在此區域循環。1310* 系統通知（如 MCP 伺服器錯誤和自動更新）顯示在行的右側。暫時性通知（例如 context-low 警告）也會在此區域循環。

1311* 啟用詳細模式會在此區域新增 token 計數器1311* 啟用詳細模式會在此區域新增 token 計數器，顯示最後一次 API 回應所報告的上下文大小，而非[旋轉指示器旁的每輪計數](/docs/zh-TW/costs#read-the-token-count-beside-the-spinner)

1312* 在狹窄的終端機上，這些通知可能會截斷您的狀態列輸出1312* 在狹窄的終端機上，這些通知可能會截斷您的狀態列輸出