> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 環境變數
> 控制 Claude Code 行為的環境變數參考。
環境變數可以控制 Claude Code 的行為，例如模型選擇、身份驗證、請求路由和功能切換。許多相同的行為也可以透過[設定檔](/docs/zh-TW/settings)欄位、[CLI 旗標](/docs/zh-TW/cli-reference)或工作階段內命令（如 `/model`）進行設定。
本頁涵蓋以下內容：
* [在您的 shell 或設定檔中設定環境變數](#set-environment-variables)
* [當行為可以透過多種方式設定時，檢查哪個值適用](#precedence)
* [查詢 Claude Code 讀取的變數](#variables)
* [查看當變數關閉功能旗標擷取時，哪些功能停止運作](#features-that-need-feature-flag-fetching)
設定環境變數
您在 shell 中設定的變數只在該終端機工作階段期間有效，而設定檔中的變數則在每次執行 `claude` 時都會套用。
在 shell 中設定變數
在啟動 `claude` 之前設定變數：
```bash theme={null}
export API_TIMEOUT_MS="1200000"
claude
```
若要在每個工作階段都設定它，請將 `export` 行新增到 `~/.bashrc`、`~/.zshrc` 或您的 shell 設定檔。
```powershell theme={null}
$env:API_TIMEOUT_MS = "1200000"
claude
```
若要在每個工作階段都設定它，請執行 `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")` 並開啟新的終端機。
```batch theme={null}
set API_TIMEOUT_MS=1200000
claude
```
若要在每個工作階段都設定它，請執行 `setx API_TIMEOUT_MS "1200000"` 並開啟新的終端機。
指派行在成功時不會列印任何內容。若要確認變數已設定，請在同一個 shell 中將其列印出來：
```bash theme={null}
echo $API_TIMEOUT_MS
```
```powershell theme={null}
echo $env:API_TIMEOUT_MS
```
```batch theme={null}
echo %API_TIMEOUT_MS%
```
在設定檔中設定變數
在 `settings.json` 檔案的 `env` 鍵下新增變數，如果檔案不存在則建立它。Claude Code 會直接從檔案讀取它們，因此無論如何啟動 `claude`，它們都會生效。執行中的工作階段會在您儲存檔案時將新的和已變更的值套用到其環境，但在啟動時讀取其變數一次的功能（例如 [OpenTelemetry 監控](/docs/zh-TW/monitoring-usage)）會保留其啟動值，直到您重新啟動為止。從檔案中移除變數不會在執行中的工作階段中取消設定它；移除會在您下次啟動 `claude` 時生效。
```json ~/.claude/settings.json theme={null}
{
"env": {
"API_TIMEOUT_MS": "1200000",
"BASH_DEFAULT_TIMEOUT_MS": "300000"
}
}
```
Claude Code 會依原樣將這些值複製到其環境中。這些值不會經過任何 shell 處理，因此 `~` 或 `$HOME` 等簡寫會保持輸入時的樣子。對於接受路徑的變數（例如 `CLAUDE_CONFIG_DIR`），請寫入絕對路徑：`"CLAUDE_CONFIG_DIR": "/home/you/.claude-work"`。
您選擇的檔案控制變數套用的對象：
| 檔案 | 套用對象 |
| :- | :- |
| `~/.claude/settings.json` | 您，在每個專案中 |
| `.claude/settings.json` | 在專案中工作的所有人，簽入原始碼控制 |
| `.claude/settings.local.json` | 您，僅在此專案中，當 Claude Code 將設定儲存到它時會被 gitignore；如果您手動建立它，請將其新增到您的 gitignore |
| 受管理的設定 | 您組織中的所有人，由管理員部署 |
請參閱 [設定檔](/docs/zh-TW/settings#where-settings-live) 以了解每個檔案的位置，以及 [設定優先順序](/docs/zh-TW/settings#settings-precedence) 以了解當多個檔案設定相同變數時它們如何結合。
優先順序
某些行為同時具有環境變數和專用設定鍵，Claude Code 讀取哪一個的順序因鍵而異。對於 `ANTHROPIC_MODEL` 和 `CLAUDE_CODE_AUTO_CONNECT_IDE`，Claude Code 會先讀取變數，只有在變數未設定時才使用 `model` 或 `autoConnectIde` 設定。對於您要設定的配對，請檢查下方變數的列，以及 [設定參考](/docs/zh-TW/settings-reference) 上的鍵項目。
當相同的變數同時在您的 shell 和設定檔 `env` 區塊中設定時，設定檔值會在大多數工作階段中套用。Claude Code 會將每個 `env` 項目寫入程序環境，取代從 shell 繼承的值。[`env` 值如何與您的 shell 互動](/docs/zh-TW/settings-reference#how-env-values-interact-with-your-shell) 涵蓋保留繼承值的工作階段，以及 [`env` 設定](/docs/zh-TW/settings-reference#when-claude-code-applies-env-values) 說明何時套用它們。少數變數有特殊處理；[`env` 設定](/docs/zh-TW/settings-reference#env) 列出例外。
在設定檔中，您可以設定變數，但無法移除變數。若要覆寫無法取消設定的變數，例如由您無法控制的 shell 設定檔匯出的過時 `CLAUDE_CODE_USE_VERTEX`，請在 `env` 區塊中將其設定為空字串：`"CLAUDE_CODE_USE_VERTEX": ""`。Claude Code 將空值視為未設定以進行提供者選擇。子程序仍會繼承空值。
在設定檔之間，`env` 值遵循 [設定優先順序](/docs/zh-TW/settings#settings-precedence)，因此受管設定項目會覆寫使用者或專案設定中的相同變數。專案和本機設定無法設定某些變數，例如 `CLAUDE_CONFIG_DIR` 和 OpenTelemetry 匯出器變數。[Claude Code 在 `env` 中忽略的變數](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env) 列出它們，以及仍然適用的 OpenTelemetry 關閉值。
環境變數如何與 CLI 旗標和工作階段內命令互動因功能而異：`--model` 和 `/model` 會覆寫 `ANTHROPIC_MODEL`，而 `CLAUDE_CODE_EFFORT_LEVEL` 會覆寫 `--effort` 和 `/effort`。當變數與另一個設定來源互動時，[變數](#variables) 列表中的其列會說明優先順序或連結到記錄該項目的頁面。
Claude Code 在啟動時讀取 shell 環境變數，因此對它們的變更會在您下次啟動 `claude` 時生效。在設定檔中 `env` 鍵下設定的變數會在檔案變更時重新套用到執行中的工作階段，但 [在設定檔中設定變數](#in-settings-files) 所述的僅啟動時例外除外。
變數
數值型變數（例如逾時、token 預算與重試次數）除了純數字外，也接受科學記號與數字分隔符號寫法，除非該變數的列中註明僅接受純數字。例如，Claude Code 會將 `2e3` 讀取為 2000，將 `64_000` 讀取為 64000。在 v2.1.211 之前，這些寫法可能會在無提示的情況下設定成小得多的值，例如 `1e6` 會將逾時設定為 1。
對於開啟或關閉某項行為的變數，設定 `1`、`true`、`yes` 或 `on` 即可開啟，設定 `0`、`false`、`no` 或 `off` 即可關閉，不區分大小寫。
有些變數只判斷是否已設定，因此任何非空值（包括 `0`）都會開啟該行為，而要關閉該行為，需取消設定該變數或將其設為空值。以下變數採用此方式：
* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`
* `DISABLE_TELEMETRY`
* `DISABLE_ERROR_REPORTING`
* `CLAUDE_CODE_TMUX_TRUECOLOR`
* `FALLBACK_FOR_ALL_PRIMARY_MODELS`
* `IS_DEMO`
另有一個變數有自己的規則：`FORCE_HYPERLINK` 讀取的是數字，因此只有 `0` 會將其關閉。每個變數的列中也會說明其自己的規則。
| 變數 | 用途 |
| :- | :- |
| `ANTHROPIC_API_KEY` | 以 `X-Api-Key` 標頭傳送的 API 金鑰。設定後，即使您已登入，也會使用此金鑰而非您的 Claude Pro、Max、Team 或 Enterprise 訂閱。在非互動模式（`-p`）下，只要存在此金鑰就一律會使用。在互動模式下，系統會提示您核准此金鑰一次，之後它才會覆寫您的訂閱。若要改用您的訂閱，請執行 `unset ANTHROPIC_API_KEY` |
| `ANTHROPIC_AUTH_TOKEN` | `Authorization` 標頭的自訂值（您在此設定的值會加上 `Bearer ` 前綴） |
| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的工作區 API 金鑰，於 AWS Console 中產生。以 `x-api-key` 傳送，且優先於 AWS SigV4 |
| `ANTHROPIC_AWS_BASE_URL` | 覆寫 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 端點 URL。用於自訂區域或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。預設為 `https://aws-external-anthropic.{region}.api.aws`。Claude Code 解析區域時採用[與 Amazon Bedrock 相同的優先順序](/docs/zh-TW/amazon-bedrock#3-configure-claude-code) |
| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的必要設定。在每個請求中以 `anthropic-workspace-id` 標頭傳送 |
| `ANTHROPIC_BASE_URL` | 覆寫 API 端點，以透過代理伺服器或閘道路由請求。設定為非第一方主機時，[MCP tool search](/docs/zh-TW/mcp#scale-with-mcp-tool-search) 預設會停用。若您的代理伺服器會轉送 `tool_reference` 區塊，請設定 `ENABLE_TOOL_SEARCH=true`。自 v2.1.196 起，當此變數指向 `api.anthropic.com` 以外的主機時，[Remote Control](/docs/zh-TW/remote-control#requirements) 會停用，與其在 Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 上的行為一致 |
| `ANTHROPIC_BEDROCK_BASE_URL` | 覆寫 Amazon Bedrock 端點 URL。用於自訂 Amazon Bedrock 端點或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) |
| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | 覆寫 Amazon Bedrock Mantle 端點 URL。請參閱 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) |
| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Claude Code 優先嘗試的跨區域推論設定檔前綴（`us`、`eu`、`apac`、`jp`、`au` 或 `global`），而非從 AWS 區域推導出的前綴。在 AWS GovCloud 區域中會被忽略。需要 Claude Code v2.1.224 或更新版本。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#cross-region-inference-profile-prefixes) |
| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [服務層級](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex` 或 `priority`）。以 `X-Amzn-Bedrock-Service-Tier` 標頭傳送。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#service-tiers) |
| `ANTHROPIC_BETAS` | 要包含在 API 請求中的額外 `anthropic-beta` 標頭值，以逗號分隔。Claude Code 已會傳送其所需的 beta 標頭；在 Claude Code 加入原生支援之前，可使用此變數選擇加入 [Anthropic API beta](https://platform.claude.com/docs/en/api/beta-headers)。不同於需要 API 金鑰身分驗證的 [`--betas` 旗標](/docs/zh-TW/cli-reference#cli-flags)，此變數適用於所有驗證方式，包括 Claude.ai 訂閱 |
| `ANTHROPIC_CUSTOM_HEADERS` | 要加入請求的自訂標頭（`Name: Value` 格式，多個標頭以換行分隔）。若名稱或值包含 HTTP 標頭無法承載的字元，例如彎引號或零寬空格，請求會失敗，並顯示依位置識別該組名稱與值的錯誤。需要 Claude Code v2.1.227 或更新版本。[Invalid request header value](/docs/zh-TW/errors#invalid-request-header-value) 列出確切的字元集以及檢查執行的位置。若值設定的是憑證、組織或租用戶、路由或 API 行為相關的標頭，例如 `Authorization` 或 `Host`，當由伺服器受管設定傳遞時，它會被視為[需要核准的設定](/docs/zh-TW/server-managed-settings#environment-variables-and-the-approval-dialog)。若來自專案或本機設定，此類值會遵循[何時套用 `env` 值的規則](/docs/zh-TW/settings-reference#when-claude-code-applies-env-values) |
| `ANTHROPIC_CUSTOM_MODEL_OPTION` | 要在 `/model` 選擇器中新增為自訂項目的模型 ID。使用此變數可讓非標準或閘道專屬的模型可供選擇，而不需取代內建別名。請參閱[模型設定](/docs/zh-TW/model-config#add-a-custom-model-option) |
| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 選擇器中自訂模型項目的顯示說明。未設定時預設為 `Custom model ()` |
| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 選擇器中自訂模型項目的顯示名稱。未設定時，若 Claude Code [能辨識該 ID](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，項目會顯示模型名稱，否則顯示模型 ID |
| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 自訂模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` 別名解析成的模型 ID，也是 Claude Code 在第三方提供者上為[自動模型備援](/docs/zh-TW/model-config#automatic-model-fallback)辨識為 Fable 模型的 ID。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` 選擇器中固定的 Fable 模型的顯示說明。未設定時，該列會顯示以 `Custom Fable model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` 選擇器中固定的 Fable 模型的顯示名稱。未設定時，若 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 固定的 Fable 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` 別名解析成的模型 ID，也用於[背景功能](/docs/zh-TW/costs#background-token-usage)。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` 選擇器中固定的 Haiku 模型的顯示說明。未設定時，該列會顯示以 `Custom Haiku model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` 選擇器中固定的 Haiku 模型的顯示名稱。未設定時，若 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 固定的 Haiku 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_MODEL` | 新工作階段預設啟動時使用的模型。需要 Claude Code v2.1.236 或更新版本。請參閱[為新工作階段設定預設模型](/docs/zh-TW/model-config#set-a-default-model-for-new-sessions) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` 別名解析成的模型 ID，也是 Plan Mode 啟用時 `opusplan` 所使用的模型。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` 選擇器中固定的 Opus 模型的顯示說明。未設定時，該列會顯示以 `Custom Opus model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` 選擇器中固定的 Opus 模型的顯示名稱。未設定時，若 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 固定的 Opus 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` 別名解析成的模型 ID，也是 Plan Mode 未啟用時 `opusplan` 所使用的模型。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` 選擇器中固定的 Sonnet 模型的顯示說明。未設定時，該列會顯示以 `Custom Sonnet model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` 選擇器中固定的 Sonnet 模型的顯示名稱。未設定時，若 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 固定的 Sonnet 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的聯合規則 ID。當您將其與 `ANTHROPIC_ORGANIZATION_ID` 一起設定時，Claude Code 會選用聯合憑證，其排序高於您的 `/login` 憑證。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |
| `ANTHROPIC_FOUNDRY_API_KEY` | 用於 Microsoft Foundry 身分驗證的 API 金鑰（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |
| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | 用於 Microsoft Foundry 身分驗證的 Bearer token，例如 Microsoft Entra 存取 token。Claude Code 會將其作為 `Authorization: Bearer` 標頭傳送。優先於 `ANTHROPIC_FOUNDRY_API_KEY` 與 Azure 預設憑證鏈。請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)。需要 Claude Code v2.1.203 或更新版本 |
| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 資源的完整基礎 URL（例如 `https://my-resource.services.ai.azure.com/anthropic`）。可替代 `ANTHROPIC_FOUNDRY_RESOURCE`（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |
| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 資源名稱（例如 `my-resource`）。Claude Code [會拒絕 URL 或主機名稱](/docs/zh-TW/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name)。若未設定 `ANTHROPIC_FOUNDRY_BASE_URL` 則為必要（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |
| `ANTHROPIC_MODEL` | 要使用的模型設定名稱（請參閱[模型設定](/docs/zh-TW/model-config#environment-variables)） |
| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的組織 ID。請與 `ANTHROPIC_FEDERATION_RULE_ID` 一起設定。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |
| `ANTHROPIC_PROFILE` | 用於身分驗證的 Anthropic 設定檔名稱，例如由 [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) 建立，或由[在沒有 API 金鑰的情況下登入 Console 帳戶](/docs/zh-TW/authentication#sign-in-without-an-api-key)所建立的設定檔。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |
| `ANTHROPIC_SMALL_FAST_MODEL` | \[已棄用] [用於背景任務的 Haiku 級模型](/docs/zh-TW/costs)名稱 |
| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | 使用 Amazon Bedrock 或 Amazon Bedrock Mantle 時，覆寫 Haiku 級模型的 AWS 區域。在 Amazon Bedrock 上，只有同時設定 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 或已棄用的 `ANTHROPIC_SMALL_FAST_MODEL` 時才會生效，因為否則 Amazon Bedrock 會在工作階段區域中以[預設 Sonnet 模型或主要模型](/docs/zh-TW/amazon-bedrock#4-pin-model-versions)執行背景任務 |
| `ANTHROPIC_VERTEX_BASE_URL` | 覆寫 Google Cloud's Agent Platform 端點 URL。用於自訂 Google Cloud's Agent Platform 端點或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。請參閱 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) |
| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform 請求所指向的 GCP 專案 ID。請參閱[設定 GCP 憑證](/docs/zh-TW/google-vertex-ai#3-configure-gcp-credentials) |
| `ANTHROPIC_WORKSPACE_ID` | [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的工作區 ID。當您的聯合規則範圍涵蓋多個工作區時設定此變數，讓 token 交換知道要指向哪個工作區 |
| `API_FORCE_IDLE_TIMEOUT` | 覆寫 5 分鐘的本文閒置逾時，此逾時會在沒有任何位元組抵達時中止串流模型回應。設定為 `0` 可關閉逾時，例如當緩慢的[閘道](/docs/zh-TW/llm-gateway)或本機模型在區塊之間暫停超過 5 分鐘時；設定為 `1` 則可對所有提供者保持開啟。未設定時，此逾時會在直接 Anthropic API、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws)，以及設定了 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` 的 Amazon Bedrock 以外的提供者上啟用。[串流監視機制](/docs/zh-TW/network-config#streaming-idle-watchdogs)獨立於此執行，即使您在此設定 `0`，仍會中止長時間的靜默暫停 |
| `API_TIMEOUT_MS` | API 請求的逾時時間，單位為毫秒（預設：600000，即 10 分鐘；最大值：2147483647）。在網路緩慢或透過代理伺服器路由而導致請求逾時時，請調高此值。超過最大值的值會使底層計時器溢位，導致請求立即失敗 |
| `AWS_BEARER_TOKEN_BEDROCK` | 用於身分驗證的 Amazon Bedrock API 金鑰（請參閱 [Amazon Bedrock API 金鑰](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)） |
| `BASH_DEFAULT_TIMEOUT_MS` | 前景 Bash 或 PowerShell 工具命令的預設逾時，單位為毫秒（預設：120000，即 2 分鐘）。若值高於[背景命令的預設時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)，則會在無人值守的工作階段中取代該預設值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |
| `BASH_MAX_OUTPUT_LENGTH` | Claude Code 讀回命令結果中的 bash 輸出最大字元數（預設：30000；最大值：150000）。若您設定了 [`bashOutputMaxChars`](/docs/zh-TW/settings-reference#bashoutputmaxchars) 設定，Claude Code 會忽略此變數。請參閱[輸出限制](/docs/zh-TW/tools-reference#output-limits) |
| `BASH_MAX_TIMEOUT_MS` | 模型可為前景 Bash 或 PowerShell 工具命令設定的最大逾時，單位為毫秒（預設：600000，即 10 分鐘）。實際上限為此值與 `BASH_DEFAULT_TIMEOUT_MS` 中較大者。超過 2 小時的實際上限也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的最大值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |
| `BETA_TRACING_ENDPOINT` | 用於[詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)的 OTLP/HTTP 端點：搭配 `ENABLE_BETA_TRACING_DETAILED=1` 時，日誌與追蹤會傳送至此處，而非已設定的匯出器。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |
| `CCR_FORCE_BUNDLE` | 設定為 `1` 可強制 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github) 打包並上傳您的本機儲存庫，而非從其遠端複製 |
| `CLAUDECODE` | 在 Claude Code 產生的子程序中設定為 `1`（Bash 與 PowerShell 工具、tmux 工作階段、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令、stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序）。IDE 擴充功能也會在其整合式終端機中設定此變數。用於偵測腳本是否在 Claude Code 產生的子程序中執行。若要檢查目前程序是否由工具呼叫或 hook 直接產生，而非在 Claude Code 啟動的 stdio MCP 伺服器內，請改用 `CLAUDE_CODE_CHILD_SESSION` |
| `CLAUDE_AFK_COUNTDOWN_MS` | 在未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話框自動繼續之前多少毫秒，螢幕上會出現倒數計時。預設 `20000`（20 秒），上限為自動繼續逾時。除非已開啟自動繼續，否則沒有作用；請參閱 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定與 `CLAUDE_AFK_TIMEOUT_MS`。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。需要 Claude Code v2.1.198 或更新版本 |
| `CLAUDE_AFK_TIMEOUT_MS` | 未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話框在閒置多少毫秒後，會在沒有您的情況下自動繼續。自動繼續預設為關閉；請透過 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定選擇加入。此變數是供示範與自動化測試使用的覆寫：設定後，它會優先於該設定，即使該設定未設定或為 `never`，也會開啟自動繼續。設定 `0` 不會關閉逾時，而是會立即關閉對話框。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。在 v2.1.200 之前，自動繼續預設為開啟，逾時為 `60000`（60 秒）。需要 Claude Code v2.1.198 或更新版本 |
| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 設定為 `1` 可停用所有內建 [subagent](/docs/zh-TW/sub-agents) 類型，例如 Explore 與 Plan。僅適用於非互動模式（`-p` 旗標）。適合想要從零開始的 SDK 使用者。這也會移除 `general-purpose`，也就是當 Agent 工具呼叫省略 `subagent_type` 時 Claude Code 執行的 subagent。此類呼叫隨後會因 [`subagent_type is required`](/docs/zh-TW/errors#subagent-type-is-required) 而失敗 |
| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 設定為 `1` 可略過 SDK 建立的 MCP 伺服器工具名稱上的 `mcp____` 前綴。工具會使用其原始名稱。僅限 SDK 使用 |
| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | subagent 的停滯逾時，單位為毫秒。在 Claude Code v2.1.286 或更新版本中也涵蓋[工作流程 agent](/docs/zh-TW/workflows#when-an-agent-stalls-and-restarts)。預設 `600000`（10 分鐘）；若您在串流監視機制開啟時調高 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`，預設值也會隨之提高，如[處理緩慢或停滯的 API 回應](/docs/zh-TW/agent-sdk/typescript#handle-slow-or-stalled-api-responses)所述 |
| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 設定自動壓縮視窗中觸發自動壓縮的百分比（1-100）。使用較低的值（例如 `50`）可提早壓縮；此變數無法提高閾值，因此高於預設百分比的值會被忽略。它僅適用於[在模型上下文限制之前壓縮](/docs/zh-TW/model-config#context-window-and-auto-compaction)的工作階段。同時適用於主要對話與 subagent |
| `CLAUDE_AUTO_BACKGROUND_TASKS` | 設為 `1` 可強制啟用長時間執行的 agent 任務自動移至背景。啟用後，[subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) 在執行約兩分鐘後會移至背景。如果 Claude 在 subagent 之後排入了工具呼叫（例如檔案編輯），subagent 會在該呼叫開始前於前景完成。在 Claude Code v2.1.212 或更新版本上，也會在非互動模式中啟用[長時間 MCP 工具呼叫的自動背景化](/docs/zh-TW/mcp#automatic-backgrounding-of-long-tool-calls) |
| `CLAUDE_AX_PREPARK_MS` | 在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中，Claude Code 寫入新的或變更的行之前等待的毫秒數。預設 `0`，因此 Claude Code 不會等待。在 v2.1.287 之前，預設值為 `50`。Claude Code 將等待時間上限設為 `5000`。需要 Claude Code v2.1.233 或更新版本 |
| `CLAUDE_AX_SCREEN_READER` | 設定為 `1` 可呈現適合螢幕閱讀器的輸出：不含裝飾性邊框或動畫的平面文字。設定為 `0` 可強制關閉螢幕閱讀器模式，即使 [`axScreenReader`](/docs/zh-TW/settings-reference#axscreenreader) 為 `true`。[`--ax-screen-reader`](/docs/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 |
| `CLAUDE_AX_STARTUP_QUIET_MS` | 在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中，Claude Code 在啟動確認行之後延遲第一次介面呈現的毫秒數，讓您的螢幕閱讀器能在新輸出打斷之前完整唸出該行。預設 `3000`。設定 `0` 可立即呈現。Claude Code 將延遲上限設為 `600000`（10 分鐘）。您的第一次按鍵會提早結束延遲。需要 Claude Code v2.1.217 或更新版本 |
| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主要工作階段中，每個 Bash 或 PowerShell 命令執行後返回原始工作目錄 |
| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | 位元組層級串流閒置監視機制的逾時，單位為毫秒；設定後，對於該監視機制，它優先於 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`，且不會變更事件層級的監視機制。Claude Code 會將此變數限制在 10 秒到 30 分鐘之間。需要 Claude Code v2.1.210 或更新版本 |
| `CLAUDE_CLIENT_PRESENCE_FILE` | 一個檔案的路徑，由外部工具（例如螢幕鎖定監聽器）在您解鎖螢幕時建立、在您鎖定螢幕時刪除。檔案存在期間，Claude Code 會略過 [Remote Control 行動推播通知](/docs/zh-TW/remote-control#mobile-push-notifications)，因此您在主動使用電腦時不會收到推播。檔案不存在或無法讀取時，通知會照常傳送。Claude Code 會在每個觸發推播的事件發生時檢查一次檔案，而非輪詢。需要 Claude Code v2.1.181 或更新版本 |
| `CLAUDE_CODE_ACCESSIBILITY` | 設定為 `1` 可讓原生終端機游標保持可見，並停用反白文字游標指示器。可讓 macOS 縮放等螢幕放大鏡追蹤游標位置 |
| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 設定為 `1` 可從以 `--add-dir` 指定的目錄載入記憶檔案。會載入 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 與 `CLAUDE.local.md`。預設情況下，額外目錄不會載入記憶檔案 |
| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中每個影格重繪整個畫面，而非傳送增量更新。若全螢幕模式顯示過時或錯位的文字片段，請使用此設定。Claude Code 會在 Windows 上為背景工作階段與 [agent view](/docs/zh-TW/agent-view) 自動啟用此設定 |
| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 設為 `1` 可在每個請求中傳送 [effort](/docs/zh-TW/model-config#adjust-effort-level) 參數，即使 Claude Code 無法辨識該模型 ID 支援 effort。透過 [LLM 閘道](/docs/zh-TW/llm-gateway)或以自訂識別碼提供模型的第三方供應商路由時使用。在 API 層拒絕 effort 參數的模型（包括 Claude Opus 4.1、Claude Sonnet 4.5、Claude Haiku 4.5 及更早的模型）仍會被排除，以免請求失敗 |
| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 應重新整理憑證的間隔，單位為毫秒（使用 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 時） |
| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設定為 `0` 可阻止 Claude Code 在發布新的 [artifact](/docs/zh-TW/artifacts#create-an-artifact) 時自動開啟瀏覽器 |
| `CLAUDE_CODE_ARTIFACT_COMMENTS` | 設定為 `0` 可阻止 Claude 讀取及回覆 [artifact 上的留言](/docs/zh-TW/artifacts#collect-comments-on-an-artifact)。當 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 已[關閉 artifact](/docs/zh-TW/artifacts#availability) 時沒有作用。需要 Claude Code v2.1.221 或更新版本 |
| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | 設定為 `0` 可阻止 Claude [自行回覆傳送給它的留言](/docs/zh-TW/artifacts#let-claude-reply-to-comments-on-its-own)。需要 Claude Code v2.1.228 或更新版本 |
| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | 設為 `0` 可阻止 Claude 在發布 [artifact](/docs/zh-TW/artifacts#update-an-artifact) 時一併對其檔案套用小幅變更。Claude 會改用其檔案編輯工具編輯該檔案，並以獨立步驟發布。需要 Claude Code v2.1.300 或更新版本 |
| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 可從系統提示詞開頭省略[歸屬區塊](/docs/zh-TW/llm-gateway-protocol#system-prompt-attribution-block)，該區塊包含用戶端版本與提示詞指紋。無論如何，直接連線至 Anthropic API 時的快取都不受影響。在某些直接連線設定中，即使您設定了 `0`，Claude Code 仍會在[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器請求中保留此區塊。請在[系統提示詞歸屬區塊](/docs/zh-TW/llm-gateway-protocol#system-prompt-attribution-block)中查看此情況涵蓋哪些連線與憑證。在 v2.1.181 之前，此區塊在自訂基礎 URL 與 Microsoft Foundry 連線上包含每個請求專屬的 token，因此在這些版本上，當您的 LLM 閘道依請求本文進行快取或將請求轉送至第三方提供者時，或當您直接連線至 Microsoft Foundry 時，請將其設定為 `0` |
| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | 已於 v2.1.283 移除。請改用 `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定[自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)，單位為 token，範圍從 `100000` 到 `1000000`。僅接受純整數，例如 `500000`：像 `500k` 這樣的值會被讀取為 `500`，並被限制為 100K 最小值。實際視窗也以模型的上下文視窗為上限。優先於 `/autocompact` 命令、`--autocompact` 旗標與 `autoCompactWindow` 設定。狀態列的 `used_percentage` 一律以模型的完整上下文視窗為基準，因此一旦設定此變數，該百分比就不再代表壓縮何時會執行 |
| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆寫自動 [IDE 連線](/docs/zh-TW/vs-code)。預設情況下，在支援的 IDE 整合式終端機中啟動時，Claude Code 會自動連線。設定為 `false` 可防止此行為。設定為 `true` 可在自動偵測失敗時（例如 tmux 遮蔽了父終端機）強制嘗試連線。優先於 [`autoConnectIde`](/docs/zh-TW/settings-reference#autoconnectide) 全域設定 |
| `CLAUDE_CODE_AUTO_MODE_SERVER` | 控制 Claude Code 是否要求伺服器[審查自動模式動作](/docs/zh-TW/permission-modes#server-side-classifier-review)。設定為 `0` 可改用 Claude Code 自己的分類器請求。直接連線至 Anthropic API 時，需要 v2.1.281 或更新版本。連結的章節列出了變數未設定時哪些工作階段會詢問伺服器，以及從哪個版本開始。需要 Claude Code v2.1.271 或更新版本 |
| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code 等待 AWS 預設憑證提供者鏈產生憑證的時間，單位為毫秒，超過後請求會因 [`AWS default-chain credential resolve timed out`](/docs/zh-TW/errors#aws-default-chain-credential-resolve-timed-out) 而失敗（預設：`60000`）。當您的鏈中某個步驟確實需要更長時間時（例如透過 `aws-vault` 等包裝工具進行含 MFA 的瀏覽器型 SSO 登入），請調高此值。適用於 Amazon Bedrock、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 與 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)。請參閱[憑證快取與解析逾時](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)。需要 Claude Code v2.1.207 或更新版本 |
| `CLAUDE_CODE_BASH_EDIT_DIFF` | 設定為 `0` 可關閉 [Bash 命令執行期間所變更檔案的差異](/docs/zh-TW/hooks#bash)，或設定為 `1` 以在每種權限模式下記錄。優先於 [`bashEditDiffEnabled`](/docs/zh-TW/settings-reference#basheditdiffenabled) 設定。需要 Claude Code v2.1.269 或更新版本 |
| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 設定為 `0` 可讓非互動工作階段在每個回合結束時向其主機回報閒置狀態，即使背景工作仍在執行。預設情況下，當背景 agent 或[工作流程](/docs/zh-TW/workflows)執行等背景工作仍在進行時，工作階段在回合結束後會持續回報執行中狀態。這可避免監看狀態的主機（例如遠端工作階段清單）在工作進行中宣告 Claude 正在等待您的輸入。背景 shell 命令（例如開發伺服器）不會維持執行中狀態。執行中狀態的預設行為與 `0` 退出選項需要 Claude Code v2.1.269 或更新版本；在較早版本中，請設定 `1` 以維持執行中狀態 |
| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 當工作階段有作用中的 [Remote Control](/docs/zh-TW/remote-control) 連線時，會在 Bash 工具與 [hook 命令](/docs/zh-TW/hooks)子程序中自動設定，並在連線結束時移除。其值為 `session_` 形式的工作階段 ID，與出現在工作階段 `claude.ai/code` URL 中的識別碼相同，因此腳本可以連結回執行它的工作階段。需要 Claude Code v2.1.199 或更新版本。在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中，請改為讀取 `CLAUDE_CODE_REMOTE_SESSION_ID` |
| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | 設定為 `0` 可讓 Claude Code 將 `0x08` 位元組（也寫作 `^H`）讀取為一般 Backspace，設定為 `1` 則讀取為 Ctrl+Backspace。任一值都會取代平台預設值。預設情況下，Claude Code 在 Windows 上將其讀取為 Ctrl+Backspace（`TERM_PROGRAM` 為 `mintty` 或 `TERM` 為 `cygwin` 時除外），在 macOS 與 Linux 上則讀取為一般 Backspace。在 [Backspace 會刪除整個單字](/docs/zh-TW/terminal-config#fix-backspace-deleting-a-whole-word-on-windows)的 Windows 終端機中請設定 `0` |
| `CLAUDE_CODE_CERT_STORE` | TLS 連線的 CA 憑證來源清單，以逗號分隔。`bundled` 是隨 Claude Code 提供的 Mozilla CA 集合。`system` 是作業系統信任存放區，僅在具有 `tls.getCACertificates` 的執行環境中讀取：原生二進位檔，或 npm 安裝時的 Node 22.15 或更新版本。請參閱 [CA 憑證存放區](/docs/zh-TW/network-config#ca-certificate-store)。預設為 `bundled,system` |
| `CLAUDE_CODE_CHILD_SESSION` | 在 Claude Code 透過 Bash、PowerShell 與 Monitor 工具、[hook](/docs/zh-TW/hooks) 命令及[狀態列](/docs/zh-TW/statusline)命令產生的子程序中設定為 `1`。不會為 stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序設定，因為這些子程序長期存在，且會比產生它們的工作階段存活更久。不同於 `CLAUDECODE`，此變數僅由 Claude Code 本身在啟動子程序時設定，而不會由 IDE 擴充功能設定，因此能可靠地區分巢狀工作階段與在 IDE 整合式終端機中啟動的頂層 `claude`。以此方式啟動的巢狀互動式 `claude` TUI 會自動從 `--resume`、`--continue`、向上鍵歷史記錄與 `claude agents` 清單中排除。非互動 `claude -p` 工作階段仍會保存。設定 `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` 可覆寫此排除。需要 Claude Code v2.1.172 或更新版本 |
| `CLAUDE_CODE_CLIENT_CERT` | 用於 mTLS 身分驗證的用戶端憑證檔案路徑 |
| `CLAUDE_CODE_CLIENT_KEY` | 用於 mTLS 身分驗證的用戶端私密金鑰檔案路徑 |
| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 已加密的 CLAUDE\_CODE\_CLIENT\_KEY 的密碼片語（選用） |
| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | 已於 v2.1.186 移除，現在不會有任何作用。先前用於為串流 API 請求的連線、TLS 與回應標頭階段設定個別逾時。請使用 `API_TIMEOUT_MS` 設定每個請求的逾時。關於串流請求的回應標頭階段，請參閱 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |
| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆寫偵錯日誌檔案路徑。儘管名稱如此，這是檔案路徑，而非目錄。需要另外透過 `--debug`、`/debug` 或 `DEBUG` 環境變數啟用偵錯模式：僅設定此變數並不會啟用日誌記錄。[`--debug-file`](/docs/zh-TW/cli-reference#cli-flags) 旗標可同時完成這兩件事。預設為 `~/.claude/debug/.txt` |
| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最低日誌等級。值：`verbose`、`debug`（預設）、`info`、`warn`、`error`。設定為 `verbose` 可包含大量診斷資訊，例如完整的狀態列命令輸出；或提高至 `error` 以減少雜訊 |
| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 可關閉 [1M 上下文視窗](/docs/zh-TW/model-config#extended-context)支援。Claude Code 會從模型選擇器中移除 `[1m]` 模型變體，並將預設以 1M 視窗執行的模型限制為 200K 視窗。請參閱[關閉 1M 上下文](/docs/zh-TW/model-config#turn-off-1m-context)。適用於有合規要求的企業環境。關於其在修正無法辨識的 `[1m]` 模型 ID 視窗方面的作用，請參閱[修正閘道或自訂模型 ID 的視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |
| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 設定為 `1` 可在 Opus 4.6 與 Sonnet 4.6 上停用[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)，並改用由 `MAX_THINKING_TOKENS` 控制的固定思考預算。對 [Fable 模型](/docs/zh-TW/model-config#extended-thinking)、Sonnet 5 及更新版本、Haiku 5.5 或 Opus 4.7 及更新版本沒有作用，這些模型一律使用自適應推理 |
| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | 設定為 `1` 可阻止 Claude Code 跨管理來源逐鍵合併[受管設定](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)的 `env` 區塊，因此只會套用最高優先順序來源的整個 `env` 區塊，與 v2.1.223 之前相同。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.223 或更新版本 |
| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 設定為 `1` 可停用 [advisor 工具](/docs/zh-TW/advisor)。`/advisor` 命令將無法使用，任何已設定的 `advisorModel` 都會被忽略，而 `--advisor` 旗標會被接受但沒有作用，因此傳遞此旗標的現有腳本仍可繼續運作而不會出錯 |
| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 可關閉[背景 agent 與 agent view](/docs/zh-TW/agent-view)：`claude agents`、`--bg`、`/background` 以及隨需啟動的 supervisor。等同於 [`disableAgentView`](/docs/zh-TW/settings-reference#disableagentview) 設定 |
| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 可停用[全螢幕呈現](/docs/zh-TW/fullscreen)並使用傳統的主畫面呈現器。對話會保留在終端機的原生捲動緩衝區中，因此 `Cmd+f` 與 tmux 複製模式可照常運作。優先於 `CLAUDE_CODE_NO_FLICKER` 與 [`tui`](/docs/zh-TW/settings-reference#tui) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/docs/zh-TW/agent-view) 開啟的背景工作階段，這些工作階段一律使用全螢幕呈現 |
| `CLAUDE_CODE_DISABLE_ARTIFACT` | 設定為 `1` 可關閉 [Artifact](/docs/zh-TW/artifacts) 工具，該工具會將工作階段輸出發布為 claude.ai 上的私人網頁。一旦設定，任何設定檔都無法重新開啟此工具。若要改從設定檔關閉此工具，請將 [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) 設定為 `false`；已棄用的 [`disableArtifact`](/docs/zh-TW/settings-reference#disableartifact) 鍵也會將其關閉 |
| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 設定為 `1` 可停用附件處理。使用 `@` 語法的檔案提及會以純文字傳送，而不會展開為檔案內容。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |
| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | 設定為 `1` 可讓 Claude Code 程序自行執行其 [`gcpAuthRefresh`](/docs/zh-TW/settings-reference#gcpauthrefresh) 或 [`awsAuthRefresh`](/docs/zh-TW/settings-reference#awsauthrefresh) 命令，而非在另一個程序執行時等待。需要 Claude Code v2.1.286 或更新版本 |
| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 設定為 `1` 可停用[自動記憶](/docs/zh-TW/memory#auto-memory)。設定為 `0` 可強制開啟自動記憶，即使 `--bare` 模式或 [`autoMemoryEnabled: false`](/docs/zh-TW/settings-reference#automemoryenabled) 原本會將其停用。停用時，Claude 不會建立或載入自動記憶檔案 |
| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 可停用所有背景任務功能，包括 Bash 與 subagent 工具上的 `run_in_background` 參數、自動背景化，以及 Ctrl+B 快速鍵 |
| `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 或更新版本 |
| `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 或更新版本 |
| `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 或更新版本 |
| `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 或更新版本 |
| `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) 設定 |
| `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 或更新版本 |
| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 設定為 `1` 可防止將任何 CLAUDE.md 記憶檔案載入上下文，包括使用者、專案與自動記憶檔案 |
| `CLAUDE_CODE_DISABLE_CRON` | 設定為 `1` 可停用[排程任務](/docs/zh-TW/scheduled-tasks)。`/loop` skill 與 cron 工具將無法使用，任何已排程的任務都會停止觸發，包括已在工作階段中途執行的任務 |
| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 設定為 `1` 可關閉[關鍵路徑移除](/docs/zh-TW/permission-modes#critical-paths)提示的時間限制。在 `auto` 模式下，Claude Code 隨後會將這些移除操作改交給分類器；在 `bypassPermissions` 模式下，提示會等待您的回答。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 設定為 `1` 可從 API 請求中移除預先發行的 `anthropic-beta` 請求標頭、與其搭配的本文欄位，以及 `defer_loading` 與 `eager_input_streaming` 等 beta 工具結構描述欄位。當代理伺服器閘道因 `anthropic-beta` 標頭而以 `Unexpected value(s)` 錯誤拒絕請求，或出現 `Extra inputs are not permitted` 錯誤時使用。[停用預先發行功能](/docs/zh-TW/llm-gateway-protocol#disable-pre-release-capabilities)列出此變數移除的項目（包括 [MCP tool search](/docs/zh-TW/mcp#scale-with-mcp-tool-search)）以及 Claude Code 持續傳送的項目 |
| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 設定為 `1` 可停用內建的 [Explore 與 Plan subagent](/docs/zh-TW/sub-agents#built-in-subagents)。Claude 會改用其搜尋工具或 general-purpose subagent 進行探索，而 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 會直接讀取檔案，而非啟動 Explore 與 Plan agent。名為 `Explore` 或 `Plan` 的自訂 subagent 不受影響。若要在 Agent SDK 或非互動模式中移除所有內建 subagent 類型，請改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更新版本 |
| `CLAUDE_CODE_DISABLE_FAST_MODE` | 設定為 `1` 可停用[快速模式](/docs/zh-TW/fast-mode) |
| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 設定為 `1` 可停用「How is Claude doing?」工作階段品質問卷。當設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 時，問卷也會停用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新選擇加入。若要設定取樣率而非直接停用，請使用 [`feedbackSurveyRate`](/docs/zh-TW/settings-reference#feedbacksurveyrate) 設定。請參閱[工作階段品質問卷](/docs/zh-TW/data-usage#session-quality-surveys) |
| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 設定為 `1` 可停用檔案[檢查點功能](/docs/zh-TW/checkpointing)。`/rewind` 命令將無法還原程式碼變更。覆寫 [`fileCheckpointingEnabled`](/docs/zh-TW/settings-reference#filecheckpointingenabled) 設定 |
| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | 設為 `1` 可阻止 Claude Code 展開檔案和目錄的 [`@` 提及](/docs/zh-TW/common-workflows#reference-files-and-directories)。Claude 會改為取得所提及的路徑，並附上請它使用檔案工具讀取這些路徑的說明。在[專案和本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。需要 Claude Code v2.1.299 或更新版本 |
| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 設定為 `1` 可從 Claude 的上下文中移除內建的提交與 PR 工作流程指令以及 git 狀態快照。在使用您自己的 git 工作流程 skill 時很有用。設定時優先於 [`includeGitInstructions`](/docs/zh-TW/settings-reference#includegitinstructions) 設定 |
| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | 設定為 `1` 可阻止 Claude Code 讀取以 `-c` 傳遞給 shell 的腳本（例如 `bash -c 'rm -rf ~'`）來檢查[關鍵路徑](/docs/zh-TW/permission-modes#removals-inside-nested-commands-and-inline-scripts)移除。Claude Code 仍會檢查這些腳本中的 shell 變數與位置參數目標，其他關鍵路徑檢查也會持續執行。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.288 或更新版本 |
| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | 設為 `1` 可防止在 Anthropic API 上將 Opus 4 和 Opus 4.1 自動重新對應至目前的 Opus 版本。當您刻意想要固定使用較舊的模型時使用。重新對應不會在 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 上執行 |
| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | 設定為 `1` 可阻止 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#when-a-model-is-disabled-mid-session) 與 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai#when-a-model-is-disabled-mid-session) 上的 Claude Code 在您的帳戶於工作階段中途失去對該工作階段模型的存取權時改用較舊的模型；被拒絕的請求會立即失敗。您設定的[備援模型鏈](/docs/zh-TW/model-config#fallback-model-chains)仍會在該拒絕發生時切換，而[啟動模型檢查](/docs/zh-TW/amazon-bedrock#startup-model-checks)仍會在啟動時改用備援。需要 Claude Code v2.1.285 或更新版本 |
| `CLAUDE_CODE_DISABLE_MOUSE` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用滑鼠追蹤。使用 `PgUp` 與 `PgDn` 的鍵盤捲動仍可運作。使用此設定可保留終端機原生的選取即複製行為 |
| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用點擊、拖曳與懸停處理，同時保留滑鼠滾輪捲動。當您希望滾輪捲動在 Claude Code 中運作，但不希望點擊會定位游標、展開工具輸出或開啟連結時使用。同時設定兩者時，`CLAUDE_CODE_DISABLE_MOUSE` 優先。需要 Claude Code v2.1.195 或更新版本 |
| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 設定為 `1` 可阻止 Claude Code 在 API 請求因連線層級錯誤（例如連線重設或 TLS 交握錯誤）而失敗時重新讀取 [mTLS 用戶端憑證與金鑰](/docs/zh-TW/network-config#mtls-authentication)。停用重新載入後，Claude Code 只會在下次套用設定時或下次啟動時載入已輪替的檔案。需要 Claude Code v2.1.232 或更新版本 |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 設定為任何非空值（例如 `1`）可停用非必要的網路流量：自動更新、遙測、錯誤回報、`/feedback` 命令、[Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)、版本資訊、[PR 與 MR 狀態徽章](/docs/zh-TW/interactive-mode#pr-review-status)檢查，以及[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)檢查等可用性檢查。它也會停止[外掛 `command` 來源的背景執行](/docs/zh-TW/plugins/loading#when-a-command-source-re-runs)；這些是本機命令而非網路流量，但因為它們可能觸發相依套件安裝，所以也會停止。**設定為 `0` 或 `false` 仍會停用這些流量**，這與大多數開關型變數不同；請取消設定此變數以重新允許。也會停用功能旗標擷取，使 [Remote Control](/docs/zh-TW/remote-control#requirements) 以及其他[需要功能旗標擷取的功能](#features-that-need-feature-flag-fetching)無法使用。官方外掛市集自動安裝不在涵蓋範圍內；請使用 `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` 停用。不會影響[閘道模型探索](/docs/zh-TW/llm-gateway-connect#add-gateway-models-to-the-model-picker)，該功能有其自己的選擇加入機制 |
| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 設定為 `1` 可在串流請求於中途失敗時停用非串流備援。串流錯誤會改為傳遞至重試層。當代理伺服器或閘道導致備援產生重複的工具執行時很有用 |
| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | 設定為 `1` 可讓 `PushNotification` 工具即使在您正在終端機中輸入或終端機處於焦點時，也傳送桌面通知。預設情況下，當工具偵測到最近的鍵盤活動或終端機焦點時，會同時略過桌面通知與[行動推播](/docs/zh-TW/remote-control#mobile-push-notifications)。此變數僅停用該本機檢查，因此當伺服器偵測到您處於活動狀態時，仍可抑制行動推播。需要 Claude Code v2.1.193 或更新版本 |
| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 設定為 `1` 可停用官方外掛市集的自動註冊。Claude Code 會在即將註冊市集時讀取此變數，通常是在電腦首次互動式啟動期間。若當時已設定此變數，Claude Code 會永久略過註冊。之後取消設定此變數並不會撤銷此略過。隨時執行 `claude plugin marketplace add anthropics/claude-plugins-official` 即可註冊市集 |
| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | 在 Claude Code 將權限請求傳送至 Agent SDK 的 `canUseTool` 回呼的工作階段中（Claude Desktop 與 VS Code 擴充功能即是以此方式託管 Claude Code），設定為 `1` 可阻止 Claude Code 執行您的[針對未回答權限請求的 `Notification` hook](/docs/zh-TW/hooks#notification)。在終端機工作階段中沒有作用。需要 Claude Code v2.1.233 或更新版本 |
| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 設定為 `1` 可略過從系統層級受管 skill 目錄載入 skill。適用於不應載入營運者佈建之 skill 的容器或 CI 工作階段 |
| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | 設定為 `1` 可關閉 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)的一項檢查，該檢查會拒絕在[系統路徑](/docs/zh-TW/permission-modes#remove-item-in-powershell)（例如磁碟機根目錄或您的家目錄）上使用 `cmd` 內建命令 `rd`、`rmdir`、`del` 與 `erase`。Claude Code 會忽略設定檔 `env` 區塊中的此變數。需要 Claude Code v2.1.283 或更新版本 |
| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | 設定為 `1` 可關閉[安全分類器標記請求時的自動模型切換](/docs/zh-TW/model-config#automatic-model-fallback)，也就是 [`switchModelsOnFlag`](/docs/zh-TW/settings-reference#switchmodelsonflag) 設定所控制的行為 |
| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | 設定為 `1` 可阻止 Claude Code 傳送結構化輸出的 `output_config.format` 欄位與其搭配的 `anthropic-beta` 值，適用於上游會拒絕這些內容的 [LLM 閘道](/docs/zh-TW/llm-gateway-protocol#feature-pass-through)。這會讓 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/zh-TW/llm-gateway-protocol#disable-pre-release-capabilities) 所關閉的其他預先發行功能保持開啟。需要 Claude Code v2.1.288 或更新版本 |
| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | 設定為 `1` 可關閉針對遞迴 `rm` 的[關鍵路徑](/docs/zh-TW/permission-modes#critical-paths)檢查，該檢查適用於目標完全是命令替換輸出的情況，例如 `rm -rf "$(pwd)"`。其他關鍵路徑檢查會持續執行。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |
| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 設為 `1` 可停用根據對話上下文自動更新終端機標題。這也會略過[產生工作階段標題](/docs/zh-TW/sessions#name-your-sessions)的背景小型/快速模型請求，並關閉[向終端機回報狀態](/docs/zh-TW/terminal-config#see-session-status-in-your-terminal) |
| `CLAUDE_CODE_DISABLE_THINKING` | 設定為 `1` 可從 API 請求中完全省略 `thinking` 參數。這是針對拒絕此參數的代理伺服器與閘道的相容性選項。在預設會思考的模型上，省略此參數代表模型仍可能思考。若要在 Anthropic API 上明確停用[延伸思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)，請改用 `MAX_THINKING_TOKENS=0`。兩個變數都無法在 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型上關閉思考，這些模型無法關閉思考。在[第三方提供者](/docs/zh-TW/third-party-integrations)上，`MAX_THINKING_TOKENS=0` 同樣會省略此參數，因此兩個變數在那裡的行為相同 |
| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | 設定為 `1` 可在 Claude Code 無法辨識模型 ID（例如 [LLM 閘道](/docs/zh-TW/llm-gateway)別名）時略過主動[自動壓縮](/docs/zh-TW/costs#reduce-token-usage)。若未設定此變數，Claude Code 會在其為該 ID 假設的上下文視窗處進行壓縮。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` 可改為修正假設的視窗；關於各變數的適用時機，請參閱[修正閘道或自訂模型 ID 的視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。需要 Claude Code v2.1.223 或更新版本 |
| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用虛擬捲動，並呈現逐字稿中的每則訊息。若在全螢幕模式中捲動時，應顯示訊息的地方出現空白區域，請使用此設定 |
| `CLAUDE_CODE_DISABLE_WEB_FETCH` | 設定為 `1` 可關閉 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 工具。[WebSearch](/docs/zh-TW/tools-reference#websearch-tool-behavior) 工具仍可使用。需要 Claude Code v2.1.285 或更新版本 |
| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設定為 `1` 可在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令，而非透過 `cmd.exe` 啟動器。預設情況下，啟動器可讓[在背景執行](/docs/zh-TW/tools-reference#background-commands)的 PowerShell 命令[延續至工作階段的下一個程序](/docs/zh-TW/agent-view#the-supervisor-process)，例如當您[將工作階段移至背景](/docs/zh-TW/agent-view#from-inside-a-session)時。若您設定此變數，移至背景的 PowerShell 命令會在工作階段的程序結束時停止。Bash 命令不受影響。需要 Claude Code v2.1.269 或更新版本 |
| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設定為 `1` 可停用[工作流程](/docs/zh-TW/workflows#turn-workflows-off)。等同於 [`disableWorkflows`](/docs/zh-TW/settings-reference#disableworkflows) 設定 |
| `CLAUDE_CODE_EFFORT_LEVEL` | 設定支援模型的 effort 等級。值：`low`、`medium`、`high`、`xhigh`、`max`，或使用 `auto` 以採用模型預設值。可用等級取決於模型。優先於 `--effort`、`/effort`，以及 `modelSettings` 與 `effortLevel` 設定。[`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) 上限仍適用。請參閱[調整 effort 等級](/docs/zh-TW/model-config#adjust-effort-level) |
| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | 設為 `1` 可將攜帶工作階段狀態的 [`session_state_changed`](/docs/zh-TW/agent-sdk/typescript#sdksessionstatechangedmessage) 訊息加入訊息串流。需要 [Agent SDK](/docs/zh-TW/agent-sdk/overview)，或同時使用 `--print`、`--output-format stream-json` 與 `--verbose` |
| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 為了與舊版相容而接受，但沒有任何作用。自動模式在每個供應商上皆預設可用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry，以及已登入的 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)工作階段。在 v2.1.158 至 v2.1.206 中，必須將此變數設為 `1`，才能在這些供應商上使用[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) |
| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆寫[工作階段回顧](/docs/zh-TW/interactive-mode#session-recap)的可用性。設為 `0` 可強制關閉回顧，不論 `/config` 切換開關為何。設為 `1` 可在 [`awaySummaryEnabled`](/docs/zh-TW/settings-reference#awaysummaryenabled) 為 `false` 時強制開啟回顧。優先於該設定與 `/config` 切換開關 |
| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設為 `1` 可在[非互動模式](/docs/zh-TW/headless)中，於背景安裝完成後在回合交界處重新整理外掛狀態。預設為關閉，因為重新整理會在工作階段中途變更系統提示詞，使該回合的[提示快取](/docs/zh-TW/prompt-caching)失效 |
| `CLAUDE_CODE_ENABLE_CFC` | 設為 `1` 可在開啟 [Chrome 整合](/docs/zh-TW/chrome)的情況下啟動 CLI 工作階段，設為 `0` 則以關閉狀態啟動。優先於 [`claudeInChromeDefaultEnabled`](/docs/zh-TW/settings-reference#claudeinchromedefaultenabled) 設定。`--chrome` 與 `--no-chrome` 旗標優先於兩者。Claude Code [會忽略專案與本機設定中的 `1`](/docs/zh-TW/chrome#project-settings-can’t-turn-on-chrome) |
| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 設為 `1` 可在傳往 Anthropic 的非必要流量遭封鎖時，將「How is Claude doing?」工作階段品質問卷導向您自己的 [OpenTelemetry collector](/docs/zh-TW/monitoring-usage)。問卷評分僅會以 OTEL 事件的形式發送至您設定的 collector。在此模式下，不會將任何問卷資料傳送給 Anthropic。在設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 時適用，否則沒有作用。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 與組織產品意見回饋政策優先於此變數 |
| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 控制工具呼叫輸入是否在 Claude 產生時即從 API 串流傳送。關閉時，大型工具輸入（例如長檔案寫入）只會在 Claude 產生完畢後才送達，看起來可能像是卡住了。在 Anthropic API 上預設啟用。在 Amazon Bedrock 與 Google Cloud's Agent Platform 上，會依模型在部署的容器支援時啟用。設為 `0` 可選擇退出。透過 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 經由代理伺服器路由時，設為 `1` 可強制開啟。在 Microsoft Foundry 與[閘道](/docs/zh-TW/llm-gateway)連線上預設為關閉 |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 當 `ANTHROPIC_BASE_URL` 指向與 Anthropic 相容的閘道（例如 LiteLLM、Kong 或內部代理伺服器）時，設為 `1` 可從閘道的 `/v1/models` 端點填入 `/model` 選擇器。預設為關閉，因為若非如此，由共用 API 金鑰支援的閘道會向每位使用者顯示該金鑰可存取的每個模型。探索到的模型仍會依工作階段收到的 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels) 允許清單進行篩選；請透過 [MDM 或受管設定檔](/docs/zh-TW/managed-settings#delivery-mechanisms)提供該清單，因為[伺服器管理的提供方式不適用於閘道設定](/docs/zh-TW/server-managed-settings#platform-availability) |
| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | 已於 v2.1.142 移除，當時[快速模式](/docs/zh-TW/fast-mode)的預設模型從 Opus 4.6 改為 Opus 4.7 |
| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 設為 `false` 可關閉提示詞建議，即出現在提示詞輸入框中的灰色預測文字。優先於 [`promptSuggestionEnabled`](/docs/zh-TW/settings-reference#promptsuggestionenabled) 設定，也就是 `/config` 中 **Prompt suggestions** 切換開關所寫入的設定。Claude Code 也會[在您的帳戶接近或達到用量上限時暫停建議](/docs/zh-TW/interactive-mode#when-claude-code-skips-suggestions)。設為 `true` 可讓建議持續開啟，直到您達到上限為止。需要 Claude Code v2.1.238 或更新版本。請參閱[提示詞建議](/docs/zh-TW/interactive-mode#prompt-suggestions) |
| `CLAUDE_CODE_ENABLE_TASKS` | 選擇 Claude Code 在[具備這些工具的工作階段](/docs/zh-TW/tools-reference#task-tool-availability)中提供哪些任務追蹤工具。預設情況下，Claude Code 提供 Task 工具 `TaskCreate`、`TaskUpdate`、`TaskGet` 與 `TaskList`。設為 `0` 則改為取得舊版 `TodoWrite` 工具。請參閱[任務清單](/docs/zh-TW/interactive-mode#task-list) |
| `CLAUDE_CODE_ENABLE_TELEMETRY` | 設為 `1` 以啟用 OpenTelemetry 資料收集，用於指標與日誌。設定 OTel 匯出器之前必須先設定此變數。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | 設為 `1` 可在每個模型上取得任務追蹤工具。若未設定，Claude Code 預設只會在 [Task 工具可用性](/docs/zh-TW/tools-reference#task-tool-availability)下列出的模型上提供這些工具。`CLAUDE_CODE_ENABLE_TASKS` 仍會決定使用 Task 工具或 `TodoWrite`。需要 Claude Code v2.1.233 或更新版本 |
| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 查詢迴圈進入閒置後、自動結束前要等待的時間（毫秒）。適用於使用 SDK 模式的自動化工作流程與指令碼 |
| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 設為 `1` 以啟用 [agent team](/docs/zh-TW/agent-teams)。agent team 為實驗性功能，預設為停用 |
| `CLAUDE_CODE_EXTRA_BODY` | 要合併至每個 API 請求主體最上層的 JSON 物件。適用於傳遞 Claude Code 未直接公開的供應商專屬參數。在 shell 中匯出的值也會套用至您以 `claude agents` 或 `--bg` 分派的[背景工作階段](/docs/zh-TW/agent-view)。在 v2.1.206 之前，背景工作階段會忽略 shell 匯出的值，並使用背景監督程序所繼承的副本 |
| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 覆寫[檔案讀取](/docs/zh-TW/tools-reference#large-files)的預設 token 上限，即 25,000 個 token。適用於需要完整讀取較大檔案時。當上下文視窗仍有空間時，Claude 使用 `allow_large` 參數進行的讀取可以超過此上限 |
| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 設為 `1` 可強制保存逐字稿、提示詞歷史與 `claude agents` 註冊，即使這個 `claude` 是從另一個 Claude Code 工作階段內部啟動的。當繼承的 `CLAUDE_CODE_CHILD_SESSION` 值（例如來自 `screen` 工作階段，或最初由 Claude Code 的 Bash 工具啟動的背景啟動器）導致真正的最上層工作階段被誤判為巢狀工作階段時使用。自 v2.1.178 起，Claude Code 會自動偵測 tmux 的情況並忽略繼承的標記，因此 tmux 不再需要此變數。在 v2.1.169 及更早版本中也有效；在 v2.1.170 與 v2.1.171 中沒有作用，因為其所覆寫的巢狀工作階段偵測在這些版本中已被移除 |
| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | 設為 `1` 可在終端機支援但未被自動偵測到時（例如透過 SSH 且未轉送 `TERM_PROGRAM`），強制將 Claude 回應中的 `~~text~~` 呈現為刪除線。若未設定，未被偵測到的終端機會顯示字面上的 `~~` 標記，而不會將文字呈現為刪除線。需要 Claude Code v2.1.186 或更新版本 |
| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 設為 `1` 可在終端機支援但未被自動偵測到時，強制啟用 DEC private mode 2026 [同步輸出](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)。適用於實作 BSU/ESU 但不回應功能探測的模擬器，例如 Emacs `eat`。在 tmux 下沒有作用。不同於會切換至[全螢幕呈現](/docs/zh-TW/fullscreen)的 `CLAUDE_CODE_NO_FLICKER`，此變數不會變更呈現器 |
| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | 設為 `1` 可在終端機以 Unicode 預留位置繪製 kitty graphics protocol 圖片但未被自動偵測到時，將 [mod `Image` 元素](/docs/zh-TW/plugins/mods/reference#elements)繪製為圖片。請參閱 [Claude Code 會偵測哪些終端機](/docs/zh-TW/plugins/mods/gallery#image-and-client)，以及為何此變數在 tmux 或 screen 內無效 |
| `CLAUDE_CODE_FORK_SUBAGENT` | 控制 [fork 模式](/docs/zh-TW/sub-agents#turn-fork-mode-on-or-off)，此模式讓 Claude 能自行產生 [fork 的 subagent](/docs/zh-TW/sub-agents#fork-the-current-conversation)，且僅在互動式工作階段中預設開啟。設為 `1` 可在 `claude -p` 與 Agent SDK 中也開啟，或設為 `0` 在所有類型的工作階段中關閉。無論 fork 模式是否開啟，您都可以執行 `/subtask`。互動式預設值需要 Claude Code v2.1.232 或更新版本；在較早版本中，請將變數設為 `1` 以開啟 fork 模式 |
| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | 設為 `1` 可在 `claude -p --output-format stream-json` 輸出中發出 [subagent](/docs/zh-TW/sub-agents) 文字與思考區塊，行為與 [`--forward-subagent-text`](/docs/zh-TW/cli-reference#cli-flags) 旗標相同。當叫用 `claude` 的 harness 無法自行傳遞旗標時使用此變數。該旗標在非互動模式搭配 stream-json 輸出以外的情況下會以錯誤結束，但此變數在這些情況下會被忽略，因此在整個程序範圍設定時，巢狀叫用仍可正常運作。需要 Claude Code v2.1.211 或更新版本 |
| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | 設為 `1` 可在自訂代理伺服器或第三方供應商（例如 Amazon Bedrock 或 Claude Platform on AWS）上傳送[閘道提示標頭](/docs/zh-TW/llm-gateway-protocol#gateway-hint-headers)，例如 `x-claude-code-request-class` 與 `x-claude-code-compaction`。設為 `0` 可停止在每個連線上傳送這些標頭，包括直接連線至 Anthropic API 的情況，Claude Code 在該情況下預設會傳送它們。需要 Claude Code v2.1.273 或更新版本 |
| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | 由 `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` 開啟的[閘道模型探索](/docs/zh-TW/llm-gateway-protocol#model-discovery)請求的逾時時間（毫秒）（預設：`3000`）。當您的閘道在啟動時需要超過三秒才能回應 `/v1/models` 時，請調高此值。僅接受純數字；`0`、負值及其他寫法會保留預設值。需要 Claude Code v2.1.269 或更新版本 |
| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows：Git Bash 執行檔（`bash.exe`）的路徑。當 Git Bash 已安裝但不在您的 PATH 中時使用。若路徑不存在，或檔案名稱不是 `bash.exe`、`sh.exe`、`bash` 或 `sh`，Claude Code 會忽略此變數，如同未設定般自動偵測 Git Bash，並記錄一則可透過 `--debug` 看到的警告。在 v2.1.219 之前，當路徑不存在時，Claude Code 會在啟動時結束，且會將任何現有檔案當作 shell 使用，而不檢查其是否為 bash 或 sh。請參閱 [Windows 設定](/docs/zh-TW/setup#set-up-on-windows) |
| `CLAUDE_CODE_GLOB_HIDDEN` | 設為 `false` 可在 Claude 叫用 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)時將點檔案排除在結果之外。預設會包含。不影響 `@` 檔案自動完成、`ls`、Grep 或 Read |
| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設為 `false` 可讓 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)遵循 `.gitignore` 模式。預設情況下，Glob 會傳回所有符合的檔案，包括被 gitignore 的檔案。不影響 `@` 檔案自動完成，其有自己的 [`respectGitignore` 設定](/docs/zh-TW/settings-reference#respectgitignore) |
| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob 工具檔案探索的逾時時間（秒）。在大多數平台上預設為 20 秒，在 WSL 上為 60 秒 |
| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | 背景工作可讓進行中的目標等待多少分鐘，之後 Claude Code 會[要求 Claude 檢查該目標](/docs/zh-TW/goal#background-work-defers-evaluation)。預設為 `30`。設為 `0` 可關閉檢查。請以純數字提供整數分鐘數，最多 `10080`，即一週。Claude Code 會將任何其他值視為未設定並使用預設值。需要 Claude Code v2.1.234 或更新版本 |
| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | 設為 `0` 可關閉傳送至 `api.anthropic.com` 的 Claude API、遙測與 [artifact](/docs/zh-TW/artifacts) 發佈請求主體的 gzip 壓縮。預設情況下，Claude Code 會在直接連線時壓縮大型請求主體，並在您透過代理伺服器傳送請求、設定用戶端憑證或設定 `NODE_EXTRA_CA_CERTS` 時略過壓縮。若 Claude Code 無法偵測到的 [TLS 檢查代理伺服器](/docs/zh-TW/network-config#ca-certificate-store)錯誤處理壓縮請求，請使用 `0` |
| `CLAUDE_CODE_HIDE_CWD` | 設為 `1` 可在啟動標誌中隱藏工作目錄。適用於路徑會暴露您作業系統使用者名稱的螢幕分享或錄影 |
| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | 覆寫用於連線至 IDE 擴充功能的主機位址。預設情況下，Claude Code 會自動偵測正確的位址，包括 WSL 至 Windows 的路由 |
| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設為 `1` 可略過 IDE 擴充功能的自動安裝。等同於將 [`autoInstallIdeExtension`](/docs/zh-TW/settings-reference#autoinstallideextension) 設為 `false` |
| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 設為 `1` 可在連線期間略過 IDE 鎖定檔項目的驗證。當 IDE 正在執行但自動連線仍找不到它時使用 |
| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | [閒置壓縮](/docs/zh-TW/settings-reference#idlecompaction)套用至對話時的上下文大小（以 token 為單位）（預設：`200000`）。接受正整數，其他任何值都會被忽略。低於 `100000` 的值會提高至 `100000`，即最低閾值。符合條件的對話預設會開啟閒置壓縮。若要關閉，請將 `idleCompaction` 設為 `false`。需要 Claude Code v2.1.290 或更新版本 |
| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | 在 Agent 工具拒絕再產生另一個 subagent 之前，一個工作階段中可同時執行的 [subagent](/docs/zh-TW/sub-agents#concurrent-subagent-limit) 數量（預設：20）。接受純數字的正整數；其他任何值都會被忽略，因此此變數可調整上限，但無法停用上限。需要 Claude Code v2.1.217 或更新版本 |
| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆寫 Claude Code 為作用中模型假設的上下文視窗大小。自 v2.1.193 起，其套用方式取決於 Claude Code 如何解析模型 ID；請參閱[為閘道或自訂模型 ID 修正視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。當透過 `ANTHROPIC_BASE_URL` 路由至某個模型，而其上下文視窗與其名稱對應的內建大小不符時使用 |
| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code 傳送給模型的 MCP 工具描述和 MCP 伺服器指令的最大長度（字元數）。您設定的值會取代兩個[預設上限](/docs/zh-TW/mcp#for-mcp-server-authors)：4096，以及 Claude 透過工具搜尋載入的工具描述所用的 16384。接受以純數字表示的正整數。其他任何值都會被忽略並套用預設值。需要 Claude Code v2.1.280 或更新版本 |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值與上限因模型而異；請參閱[最大輸出 token 數](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。Claude Code 會將超過模型上限的值降至上限。對於 Claude Code 無法解析為已知模型的模型 ID，預設值為 32000，上限為 128000。增加此值會減少觸發[自動壓縮](/docs/zh-TW/costs#reduce-token-usage)之前可用的有效上下文視窗 |
| `CLAUDE_CODE_MAX_RETRIES` | 覆寫失敗 API 請求的重試次數（預設：10）。自 v2.1.186 起上限為 15；自 v2.1.199 起，`CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。對於需要等候較長服務中斷的無人值守工作階段，請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` |
| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | 已於 v2.1.224 移除，現在不具作用。先前用於限制 Claude 在一個工作階段中可透過 Agent 工具產生的 [subagent](/docs/zh-TW/sub-agents) 總數（預設：200）；超過上限的產生會以 `Subagent spawn limit reached` 失敗。[同時執行的 subagent 上限](/docs/zh-TW/sub-agents#concurrent-subagent-limit)與[深度上限](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)仍然適用 |
| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | 主對話下方允許的 [subagent 層數](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents) （預設：3）。在預設值下，subagent 可以產生自己的 subagent，而位於第三層的 subagent 無法再進一步產生；設為 `1` 可關閉巢狀。在 v2.1.217 至 v2.1.218 中，預設值為 1，因此除非您提高上限，否則 subagent 無法產生自己的 subagent；v2.1.219 將預設值提高為 3。接受純數字的正整數；其他任何值都會被忽略，因此上限可以調整但無法移除。需要 Claude Code v2.1.217 或更新版本 |
| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可平行執行的唯讀工具與 subagent 的最大數量（預設：10）。較高的值會提高平行度，但會消耗更多資源 |
| `CLAUDE_CODE_MAX_TURNS` | 在未傳遞明確上限時，限制 agentic 回合數。等同於傳遞 [`--max-turns`](/docs/zh-TW/cli-reference#cli-flags)，兩者皆設定時以該旗標為優先。非正整數的值會在啟動時以錯誤拒絕，而不會被視為無上限 |
| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/zh-TW/tools-reference#session-search-limit) 呼叫次數的上限（預設：200）。當 Claude 達到上限時，後續的 WebSearch 呼叫會傳回一則通知，告訴它以已收集的資訊繼續。接受沒有上限的正整數。其他任何值都會被忽略並套用預設值，因此此上限可以提高但無法關閉。需要 Claude Code v2.1.212 或更新版本 |
| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設為 `1` 可讓 stdio MCP 伺服器僅以安全的基準環境加上該伺服器設定的 `env` 啟動，而不是繼承您的 shell 環境 |
| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 仍在執行的 MCP 工具呼叫[移至背景任務](/docs/zh-TW/mcp#automatic-backgrounding-of-long-tool-calls)之前經過的時間（毫秒）（預設：120000，即 2 分鐘）。設為 `0` 可關閉自動背景執行。需要 Claude Code v2.1.212 或更新版本 |
| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非互動](/docs/zh-TW/headless)工作階段的第一個回合等待仍在連線中之 MCP 伺服器的時間（毫秒），取代預設的[第一回合等待](/docs/zh-TW/agent-sdk/mcp#connection-timing)。設定後，等待會涵蓋所有待處理的伺服器；在[自行託管環境](/docs/zh-TW/self-hosted-environments-configuration#connection-timing)中，只會變更等待持續的時間。設為 `0` 可略過等待。無論此值為何，[`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 伺服器都會保留自己的 `MCP_TIMEOUT` 等待。需要 Claude Code v2.1.274 或更新版本 |
| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP 工具呼叫的閒置逾時（毫秒）。當 stdio、HTTP、SSE、WebSocket 或 [claude.ai 連接器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在這段時間內沒有傳送任何回應或進度通知時，工具呼叫會以錯誤中止，而不會等待整體的 `MCP_TOOL_TIMEOUT`。覆寫各傳輸方式的預設值：網路伺服器為 300000（5 分鐘），stdio 伺服器為 1800000（30 分鐘）。設為 `0` 可停用閒置檢查。低於 1000 的值會提高為一秒，且此值的上限為有效的 `MCP_TOOL_TIMEOUT`。`.mcp.json` 中至少為 1000 的個別伺服器 `timeout` 會將該伺服器的閒置時間窗提高至至少為 `timeout` 值。不適用於 IDE 伺服器或 SDK 同程序伺服器。需要 Claude Code v2.1.187 或更新版本。在 v2.1.203 之前，stdio 伺服器不受閒置逾時限制 |
| `CLAUDE_CODE_MESSAGING_SOCKET` | 由 Claude Code 設定，而非由您設定：在繫結[收件匣 socket](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 的工作階段中，Claude Code 會在繫結 socket 時將該 socket 的路徑匯出給 hook 與 Bash 命令。在以開啟訊息功能啟動的工作階段中，Claude Code 會在任何 hook 執行之前繫結 socket。機器上的其他工作階段會將訊息傳遞至此路徑。每個工作階段會匯出自己的 socket，而非從父工作階段繼承的 socket，且抵達該 socket 的訊息會經過工作階段的[傳入控制](/docs/zh-TW/cross-session-messaging#control-inbound-messages)。設定的 `env` 區塊無法設定此變數。需要 Claude Code v2.1.224 或更新版本 |
| `CLAUDE_CODE_MESSAGING_TOKEN` | 由 Claude Code 設定，而非由您設定：在繫結[收件匣 socket](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 的工作階段中，Claude Code 會將此工作階段專屬的 token 與 `CLAUDE_CODE_MESSAGING_SOCKET` 一起匯出給 hook 與 Bash 命令。張貼至 socket 的指令碼可傳送 `{"type":"auth","token":""}` 作為第一行，以證明其屬於該工作階段。在原生 Windows 上，Claude Code 要求此行，並會關閉任何未以有效此行開頭的連線。[own-child 規則](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket)說明 Claude Code 何時會參考此 token。每個工作階段會匯出自己的 token，絕不會是從父工作階段繼承的 token。設定的 `env` 區塊無法設定此變數。需要 Claude Code v2.1.228 或更新版本 |
| `CLAUDE_CODE_NATIVE_CURSOR` | 設為 `1` 可在輸入插入點顯示終端機本身的游標，而非繪製的方塊。游標會遵循終端機的閃爍、形狀與焦點設定。設定 `0` 與未設定此變數的效果相同，因此在終端機本身游標已開啟的工作階段中，它不會讓繪製的方塊恢復 |
| `CLAUDE_CODE_NEW_INIT` | 設為 `1` 可讓 `/init` 執行互動式設定流程。此流程會在探索程式碼庫並寫入檔案之前，詢問要產生哪些檔案，包括 CLAUDE.md、skill 與 hook。若未設定此變數，`/init` 會自動產生 CLAUDE.md，不會提示 |
| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 設為 `1` 可透過第二個非阻塞檔案描述元寫入終端機輸出，讓停止讀取的終端機（例如暫停的 tmux control-mode 窗格或停滯的 SSH 連線）無法在工作階段中途凍結 Claude Code。在 stdout 為終端機時，適用於 macOS、Linux 與 WSL。需要 Claude Code v2.1.261 或更新版本 |
| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | 限制 Claude Code 重新傳送逾時的[非串流請求](/docs/zh-TW/errors#streaming-response-ended-before-any-complete-data-was-received)的次數。設為 `0` 時，請求會在第一次逾時時失敗。關於逾時時間，請參閱[調整重試行為](/docs/zh-TW/errors#tune-retry-behavior)。需要 Claude Code v2.1.285 或更新版本 |
| `CLAUDE_CODE_NO_FLICKER` | 設為 `1` 以啟用[全螢幕呈現](/docs/zh-TW/fullscreen)，這是一項研究預覽功能，可減少閃爍並在長對話中保持記憶體用量穩定。覆寫 [`tui`](/docs/zh-TW/settings-reference#tui) 設定；您也可以使用 `/tui fullscreen` 切換 |
| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | 用於 Claude.ai 身分驗證的 OAuth refresh token。設定後，`claude auth login` 會直接交換此 token，而不會開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。適用於在自動化環境中佈建身分驗證 |
| `CLAUDE_CODE_OAUTH_SCOPES` | 以空格分隔、核發 refresh token 時所使用的 OAuth 範圍，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必要 |
| `CLAUDE_CODE_OAUTH_TOKEN` | 用於 claude.ai 身分驗證的 OAuth access token。在 SDK 與自動化環境中可取代 `/login`。優先於儲存在鑰匙圈中的憑證。使用 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 產生。除非您執行 [`/login`](/docs/zh-TW/authentication#authentication-precedence)，否則 Claude Code 會在整個工作階段中使用您設定的 token。若要取代已過期的 token，請產生新的 token 並重新啟動 |
| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 已於 v2.1.160 移除，現在不具作用。先前會將[快速模式](/docs/zh-TW/fast-mode)固定為 Claude Opus 4.6，而非目前的預設值。Opus 4.6 已不再支援快速模式 |
| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | 承載內容的 OpenTelemetry 屬性（模型回應、工具內容、系統提示詞、原始 API 主體）的最大長度，包含截斷標記，以 UTF-16 碼元計算（預設：61440，即 60 KB）。僅在您的遙測後端接受大於 64 KB 的屬性值時才調高，或調低以減少遙測量。需要 Claude Code v2.1.214 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `CLAUDE_CODE_OTEL_DIAG_STDERR` | 設為 `1` 可將 OpenTelemetry 匯出器的診斷錯誤寫入 stderr。預設情況下，這些錯誤只會在使用 `--debug` 時出現，因此設定錯誤的匯出器（例如 Prometheus 連接埠衝突）否則會無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 清空擱置中 OpenTelemetry span 的逾時時間（毫秒）（預設：5000）。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 重新整理動態 OpenTelemetry 標頭的間隔（毫秒）（預設：1740000／29 分鐘）。請參閱[動態標頭](/docs/zh-TW/monitoring-usage#dynamic-headers) |
| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成作業的逾時時間（毫秒）（預設：2000）。若指標在結束時遺失，請調高此值。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | 當 API 以 `529` overloaded 錯誤拒絕請求時，該請求[自動重試](/docs/zh-TW/errors#tune-retry-behavior)之間指數退避的起始延遲（毫秒），取代預設的 500。在 API 容量已滿時，調高此值可將重試分散在較長的時間範圍內。請以純數字提供 500 至 32000 之間的整數毫秒數；Claude Code 會將任何其他值視為未設定。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設為 `1`，或被拒絕的請求是在[快速模式](/docs/zh-TW/fast-mode#handle-rate-limits)中傳送時，沒有作用。需要 Claude Code v2.1.292 或更新版本 |
| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | 對於 API 以 `529` overloaded 錯誤拒絕的請求，其[自動重試](/docs/zh-TW/errors#tune-retry-behavior)之間指數退避的上限（毫秒），取代預設的 32000。提高此值，可讓後續重試在 API 滿載時持續拉開間隔。以純數字提供 32000 至 64000 的整數毫秒數；Claude Code 會將任何其他值視為未設定。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或遭拒的請求是在[快速模式](/docs/zh-TW/fast-mode#handle-rate-limits)中傳送時，沒有作用。需要 Claude Code v2.1.296 或更新版本 |
| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 設為 `1` 可讓 Claude Code 在有新版本可用時，於背景執行套件管理員的升級命令。適用於 Homebrew 與 WinGet 安裝。其他套件管理員仍會顯示升級命令而不執行。請參閱[自動更新](/docs/zh-TW/setup#auto-updates) |
| `CLAUDE_CODE_PERFORCE_MODE` | 設為 `1` 以啟用可感知 Perforce 的寫入保護。設定後，若目標檔案缺少擁有者寫入位元，Edit、Write 與 NotebookEdit 會失敗並提示 `p4 edit `；Perforce 會清除已同步檔案的此位元，直到 `p4 edit` 開啟它們為止。這可防止 Claude Code 繞過 Perforce 變更追蹤 |
| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 覆寫外掛根目錄。儘管名稱如此，此變數設定的是上層目錄，而非快取本身：市集與外掛快取位於此路徑下的子目錄中。預設為 `~/.claude/plugins` |
| `CLAUDE_CODE_PLUGIN_DIRS` | 要為工作階段載入的外掛目錄，每個目錄的載入方式與 [`--plugin-dir`](/docs/zh-TW/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) 旗標相同。在 Unix 上以 `:` 分隔多個路徑，在 Windows 上以 `;` 分隔。請以絕對路徑提供每個路徑，或以 `~` 開頭，因為 Claude Code 會略過相對路徑。需要 Claude Code v2.1.280 或更新版本。請參閱[為單一工作階段載入外掛](/docs/zh-TW/plugins/create#load-a-directory-or-archive-for-one-session) |
| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | 控制 Claude Code 是否在 [mod](/docs/zh-TW/plugins/mods/overview) 的檔案變更時重新載入該 mod。重新載入適用於您使用 `--plugin-dir` 從目錄載入的 mod，且在互動式工作階段中預設為開啟。設為 `1` 可在非互動式工作階段中也開啟，或設為 `0` 在所有工作階段中關閉。需要 Claude Code v2.1.287 或更新版本。請參閱 [mod 設定與環境變數](/docs/zh-TW/plugins/mods/reference#settings-and-environment-variables) |
| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 複製或重新整理外掛市集的逾時時間（毫秒）（預設：120000）。對於大型儲存庫或緩慢的網路連線，請調高此值。請參閱 [Git clone timed out](/docs/zh-TW/plugins/troubleshooting#git-clone-timed-out-after-120s) |
| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 設為 `1` 可在市集重新整理無法連線至遠端或無法通過遠端身分驗證時，略過重新複製的嘗試並繼續使用現有的市集 checkout。適用於離線或氣隙隔離環境，在這類環境中重新複製也會以相同方式失敗。請參閱[市集更新在離線環境中失敗](/docs/zh-TW/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |
| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設為 `1` 可透過 HTTPS 而非 SSH 複製 GitHub `owner/repo` 簡寫來源。適用於外掛安裝與更新，以及 `/plugin marketplace add` 與 `update`。適用於 CI 執行器、容器，或任何未為 `github.com` 設定 SSH 金鑰的環境 |
| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一或多個唯讀外掛種子目錄的路徑，在 Unix 上以 `:` 分隔，在 Windows 上以 `;` 分隔。使用此變數可將預先填入的外掛目錄打包至容器映像中。Claude Code 會在啟動時從這些目錄註冊市集，並使用預先快取的外掛而無需重新複製。請參閱[為容器預先填入外掛](/docs/zh-TW/plugins/org#seed-containers-and-ci) |
| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設為 `1` 可讓 Claude Code 在為工具呼叫、hook 與狀態列命令產生 PowerShell 時不再傳遞 `-ExecutionPolicy Bypass`，改為遵循機器的有效執行原則。預設情況下，Claude Code 會在程序範圍略過執行原則，讓 `.ps1` 指令碼與模組匯入能在預設為 Restricted 的 Windows 安裝上運作。無論此設定為何，程序範圍的略過絕不會覆寫群組原則 `MachinePolicy` 或 `UserPolicy` |
| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | 在使用 `-p` 旗標的[非互動模式](/docs/zh-TW/headless#background-tasks-at-exit)中，最後一個回合之後閒置等待背景工作（例如 subagent 與工作流程）的上限（毫秒）。每當 Claude 進行一個回合來處理背景結果時，閒置等待都會重新開始計算。預設：`600000`，即 10 分鐘。當閒置等待達到上限時，Claude Code 會停止等待其餘的背景任務。由主對話啟動且正在執行的背景命令會讓該次執行在超過上限後仍保持開啟。設為 `0` 可無限期等待。需要 Claude Code v2.1.182 或更新版本 |
| `CLAUDE_CODE_PROCESS_WRAPPER` | 透過以 argv 前綴（例如 `/opt/corp/launcher`）提供的企業啟動器，啟動 Claude Code 從自身二進位檔啟動的程序，例如承載 [agent view](/docs/zh-TW/agent-view) 工作階段的背景服務。請在使用者設定或[受管設定](/docs/zh-TW/managed-settings)的 `env` 區塊中設定，而非以 shell 匯出方式設定，如此分離的背景服務才會繼承它；專案與本機設定無法設定此變數。等同於 [`processWrapper` 設定](/docs/zh-TW/settings-reference#processwrapper)，該設定需要 Claude Code v2.1.210 或更新版本；兩者皆設定時，以此變數為優先。VS Code 擴充功能會透過其 `claudeProcessWrapper` 設定另外設定自己的啟動器。在 Windows 上會被忽略。關於值的格式、啟動器涵蓋的範圍，以及啟動器必須滿足的約定，請參閱[在企業啟動器後方執行 Claude Code](/docs/zh-TW/corporate-launcher)。需要 Claude Code v2.1.208 或更新版本 |
| `CLAUDE_CODE_PROJECT_DIR_NAME` | 與 `CLAUDE_CONFIG_DIR` 一起設定，以選擇 Claude Code 儲存該工作階段逐字稿與自動記憶所用的 `projects/` 目錄名稱，取代從工作目錄路徑推導出的名稱。例如，以 `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` 啟動 Claude Code 會將它們儲存在 `/srv/tenant-a/projects/work/` 下。當 `CLAUDE_CONFIG_DIR` 未設定時，Claude Code 會忽略此變數，且只會從您啟動 `claude` 的環境中讀取，絕不會從[設定檔的 `env` 區塊](#in-settings-files)讀取。請參閱[自行命名專案目錄](/docs/zh-TW/sessions#name-the-project-directory-yourself)。需要 Claude Code v2.1.234 或更新版本 |
| `CLAUDE_CODE_PROMPT_CACHE_TTL` | 設定 `5m` 或 `1h`（Claude Code 僅接受這兩個值），以選擇主對話的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)：包括您的互動式、`-p` 與 SDK 回合，以及與其內嵌執行的輔助程序。優先於 `promptCacheTtl` 設定與 `ENABLE_PROMPT_CACHING_1H`，而 `FORCE_PROMPT_CACHING_5M` 會覆寫它。API 對 1 小時快取寫入以較高費率計費。需要 Claude Code v2.1.242 或更新版本 |
| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | 設為 `1` 可在 `ANTHROPIC_BASE_URL` 指向自訂代理伺服器時傳播 W3C trace context。傳播範圍涵蓋模型與 HTTP MCP 請求上的 `traceparent` 標頭，以及 Bash、PowerShell 與 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下，僅在直接連線至 Anthropic API 時啟用傳播。於 v2.1.152 新增。請參閱[追蹤（beta）](/docs/zh-TW/monitoring-usage#traces-beta) |
| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由內嵌 Claude Code 並代為管理模型供應商路由的主機平台設定。設定後，Claude Code 會忽略設定檔中的供應商選擇、端點與身分驗證變數，例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 與 `ANTHROPIC_API_KEY`，讓使用者設定無法覆寫主機的路由。Claude Code 也會忽略[受管設定](/docs/zh-TW/managed-settings)中的模型選擇鍵，例如 `model`、`fallbackModel` 與 `modelOverrides`，無論由哪個受管來源提供，因此主機的模型設定會優先於過時的受管模型固定設定。Claude Code 也會忽略受管 `env` 區塊中的模型選擇變數，例如 `ANTHROPIC_MODEL` 與 `ANTHROPIC_DEFAULT_*_MODEL` 系列；受管設定中的 [`availableModels`](/docs/zh-TW/model-config#restrict-model-selection) 允許清單仍然適用，除非主機提供自己的允許清單。Claude Code 也會略過其原本在第三方供應商（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform 與 Microsoft Foundry）上套用的自動遙測選擇退出，因此遙測會遵循標準的 `DISABLE_TELEMETRY` 選擇退出。請參閱[依 API 供應商區分的預設行為](/docs/zh-TW/data-usage#default-behaviors-by-api-provider) |
| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 設為 `1` 可讓代理伺服器執行 DNS 解析，而非由呼叫端執行。適用於應由代理伺服器處理主機名稱解析之環境的選擇性啟用設定 |
| `CLAUDE_CODE_REMOTE` | 當 Claude Code 以[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)執行時自動設為 `true`。可從 hook 或設定指令碼讀取此值，以偵測是否處於雲端工作階段中 |
| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中自動設為目前工作階段的 ID。讀取此值可建構返回工作階段逐字稿的連結。請參閱[將輸出連結回工作階段](/docs/zh-TW/cloud-environments#link-output-back-to-the-session) |
| `CLAUDE_CODE_RESTRICTED` | 設為 `1` 可以受限模式啟動工作階段，等同於傳遞 [`--restricted`](/docs/zh-TW/cli-reference#cli-flags)。Claude Code 會忽略設定檔 `env` 區塊中的此變數。需要 Claude Code v2.1.248 或更新版本 |
| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設為 `1` 可在上一個工作階段於回合中途結束時自動繼續。用於 SDK 模式，讓模型無需 SDK 重新傳送提示詞即可繼續。若要關閉，請取消設定此變數或將其設為 `0`。關於 VS Code 聊天面板，請參閱[重新載入後繼續對話](/docs/zh-TW/vs-code#continue-conversations-after-a-reload) |
| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | 對於在回合中途結束的工作階段，若要在繼續時自動接續，其最後一則逐字稿訊息的最大存在時間（毫秒）。當最後一則訊息比此界限更舊時，Claude Code 會略過 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 自動繼續及其 `CLAUDE_CODE_RESUME_PROMPT` 接續訊息，且工作階段會以閒置狀態啟動，讓您明確地繼續。未設定或設為 `0` 表示不設界限，但某些回合只會在其最後一則訊息後六小時內繼續，例如以 API 錯誤結束的回合。正值會為每個回合設定界限，包括那些回合；負值或非數值會套用一小時的界限。長時間執行之 agent 的產生指令碼可以設定此變數，讓針對舊逐字稿的重新啟動不會重新執行過時的提示詞。當 Claude Code 重新啟動從互動式工作階段繼承對話的已當機 [agent view](/docs/zh-TW/agent-view) 工作階段時，會自行設定一小時的界限。需要 Claude Code v2.1.211 或更新版本 |
| `CLAUDE_CODE_RESUME_PROMPT` | 覆寫當 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 接續中斷的回合而非重新傳送其提示詞時，或當您以 `-p` 繼續[延後的工具呼叫](/docs/zh-TW/hooks#defer-a-tool-call-for-later)時，Claude Code 傳送給 Claude 的接續訊息。預設為 `Continue from where you left off.`。空字串會使用預設值 |
| `CLAUDE_CODE_RETRY_WATCHDOG` | 針對無人值守的工作階段（例如 eval harness、CI 作業或遠端 worker）設為 `1`。無限期重試 `429` 與 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。當標準速度請求收到回報支出上限或用量點數已用盡的 `429` 時，Claude Code 會立即失敗，即使是來自會依排程重設的[閘道支出上限](/docs/zh-TW/errors#spend-limit-reached)也是如此。在 v2.1.239 之前，watchdog 會無限期重試這些錯誤。關於快速模式請求，請參閱[處理速率限制](/docs/zh-TW/fast-mode#handle-rate-limits)。watchdog 在每次嘗試之間最多退避 5 分鐘，或在回應攜帶速率限制重設時間時等到限制重設為止，因此達到用量上限的工作階段會等候剩餘的時間範圍。在 v2.1.199 或更新版本中，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時與中斷的連線）的預設重試次數提高至 300 次，約為三小時的退避時間，並在您明確設定 `CLAUDE_CODE_MAX_RETRIES` 時移除其 15 次的上限。需要 Claude Code v2.1.186 或更新版本 |
| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | 設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，每個 API 請求等候 `429` 與 `529` 錯誤的最長時間（毫秒）。用完該時間後，下一個此類錯誤會結束請求。請以純數字提供正整數，例如 `1800000` 代表 30 分鐘。未設定時，等待沒有上限。需要 Claude Code v2.1.295 或更新版本 |
| `CLAUDE_CODE_SAFE_MODE` | 設為 `1` 以安全模式啟動：CLAUDE.md、skill、外掛、hook、MCP 伺服器、自訂命令與 agent、輸出風格、工作流程、自訂佈景主題、自訂快捷鍵、狀態列與檔案建議命令、LSP 伺服器以及自動記憶都不會載入，用於疑難排解損壞的設定。受管設定原則仍然適用，包括原則設定的 hook、狀態列與檔案建議命令；受管外掛、受管 skill、受管 CLAUDE.md 與原則設定的 MCP 伺服器則不會載入。等同於傳遞 [`--safe-mode`](/docs/zh-TW/cli-reference#cli-flags)。直接產生的子程序會繼承此變數 |
| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件，在設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被叫用的次數。鍵為與命令文字比對的子字串；值為整數呼叫上限。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對以子字串為基礎，因此像 `./scripts/deploy.sh $(evil)` 這類 shell 展開技巧仍會計入上限。透過 `xargs` 或 `find -exec` 的執行時期擴散不會被偵測到；這是一項縱深防禦控制 |
| `CLAUDE_CODE_SCROLL_SPEED` | 設定[全螢幕呈現](/docs/zh-TW/fullscreen#mouse-wheel-scrolling)中的滑鼠滾輪捲動倍數。接受最大為 20 的任何正值，包括低於 1 的小數值，例如 `0.5`，以在已放大滾輪事件的終端機中減慢加速的觸控板與滾輪捲動。若您的終端機每一格只傳送一個滾輪事件且未放大，請設為 `3` 以與 `vim` 一致。在 JetBrains IDE 終端機中會被忽略，Claude Code 在其中使用自己的捲動處理 |
| `CLAUDE_CODE_SEND_FEEDBACK` | 設為 `0` 可為工作階段關閉 [Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)。設為 `1` 可在您的帳戶已具備存取權時開啟；此變數本身無法授予存取權，其他關閉意見回饋的開關（例如 `DISABLE_FEEDBACK_COMMAND` 與 [`feedbackDrafts`](/docs/zh-TW/settings-reference#feedbackdrafts) 設定的 `off` 值）仍然適用 |
| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆寫 [SessionEnd](/docs/zh-TW/hooks#sessionend) hook 的時間預算（毫秒）。此值也是每個未自行設定 `timeout` 之 hook 的逾時時間。適用於工作階段結束、`/clear`，以及透過互動式 `/resume` 切換工作階段。預設預算為 1.5 秒，會自動提高至設定檔中所設定的最高個別 hook `timeout`，最多 60 秒。外掛提供之 hook 上的逾時不會提高預算 |
| `CLAUDE_CODE_SESSION_ID` | 在 Bash 與 PowerShell 工具子程序、[hook 命令](/docs/zh-TW/hooks)子程序以及 stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序中自動設為目前的工作階段 ID。對於 Bash、PowerShell 與 hook，此值與 hook JSON 輸入中的 `session_id` 欄位相符，並會在 `/clear` 時更新。MCP 伺服器子程序會保留其產生時的 ID。使用 `--resume ` 時，它會收到繼續的 ID，與 hook 和 Bash 一致。使用 `--continue` 或未指定明確 ID 的 `--resume` 時，它可能會改為收到初始啟動 ID。用於將指令碼與外部工具關聯至啟動它們的 Claude Code 工作階段 |
| `CLAUDE_CODE_SHELL` | 設定 Claude Code 用來執行 Bash 工具命令的 shell。接受 `bash` 或 `zsh` 二進位檔的路徑，例如 `/opt/homebrew/bin/bash`。不支援其他 shell，例如 `fish`。若值不是可運作的 `bash` 或 `zsh` 路徑，Claude Code 會忽略它並改用自動偵測。自動偵測會在您的 `$SHELL` 指向 `bash` 或 `zsh` 時使用它，否則會在您的 `PATH` 與標準安裝位置中，先選擇找到的第一個可運作的 `zsh`，其次為 `bash` |
| `CLAUDE_CODE_SHELL_PREFIX` | 包裝 Claude Code 所產生之 shell 命令的命令前綴：Bash 工具呼叫、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令，以及 stdio [MCP 伺服器](/docs/zh-TW/mcp)啟動命令。PowerShell hook 與 exec 形式的 hook 執行時不會加上前綴。適用於記錄或稽核。設定純執行檔路徑（例如 `/path/to/logger.sh`）會將每個命令以 `/path/to/logger.sh ''` 的形式執行。包裝程式會在 `$1` 中以單一經 shell 引號括住的引數接收命令列，因此包裝程式必須使用 shell 重新評估 `$1`，例如 `exec bash -c "$1"`。將 `$1` 視為純執行檔路徑，會導致傳遞 `npx -y ` 等引數的 stdio MCP 伺服器無法運作。對於 Bash 工具呼叫，`$1` 包含 Claude Code 組合的完整 shell 叫用內容，包括環境設定，而不僅是 Claude 執行的命令 |
| `CLAUDE_CODE_SIMPLE` | 設為 `1` 以最精簡的系統提示詞執行，且僅提供 Bash、檔案讀取與檔案編輯工具。來自 `--mcp-config` 的 MCP 工具仍可使用。停用 hook、skill、自訂命令、subagent、已安裝外掛、MCP 伺服器、自動記憶與 CLAUDE.md 的自動探索。您以 `--add-dir` 傳遞的目錄中的 skill 仍會載入。不會讀取 OAuth token 與鑰匙圈憑證，因此 Anthropic 身分驗證必須來自 `ANTHROPIC_API_KEY` 或 `--settings` 中的 `apiKeyHelper`。等同於傳遞 [`--bare`](/docs/zh-TW/headless#start-faster-with-bare-mode) |
| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 在 Claude Code 的完整系統提示詞與工具描述經過縮減的較短提示詞之間選擇。未設定時，Haiku 4.5、Sonnet 5、Opus 4.7 以及這些系列中的較早模型預設使用完整提示詞，較新的模型則使用較短的提示詞。設為 `1` 可在任何模型上使用較短的提示詞。設為 `0`、`false`、`no` 或 `off` 可在任何模型上使用完整提示詞，即使實驗或伺服器設定原本會選擇較短的提示詞也是如此。兩種提示詞都保留完整的工具集、hook、MCP 伺服器與 CLAUDE.md 探索 |
| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 略過 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的用戶端身分驗證，適用於自行簽署請求的閘道 |
| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | 設為 `1` 可關閉從 AWS 預設憑證提供者鏈解析之憑證的程序內快取，讓 Claude Code 在每個 API 請求時都解析該鏈。關閉快取時，以 SSO 為基礎的設定檔會在每個請求時向 IAM Identity Center 請求憑證。請參閱[憑證快取與解析逾時](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)。需要 Claude Code v2.1.207 或更新版本 |
| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | 略過 Amazon Bedrock 的 AWS 身分驗證（例如使用 LLM 閘道時） |
| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | 設為 `1` 可將失敗的[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)可用性檢查視為可用，適用於封鎖該檢查對 `api.anthropic.com` 之直接請求的網路。Claude Code 仍會遵循「disabled by your organization」回應 |
| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | 設為 `1` 可略過用戶端的[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)可用性檢查，適用於攔截而非拒絕該檢查請求的代理伺服器。當您的組織已停用快速模式時，API 仍會拒絕快速模式請求 |
| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 略過 Microsoft Foundry 的 Azure 身分驗證，適用於注入自己 `Authorization` 標頭的代理伺服器或閘道。Claude Code 會在不附帶 Azure 憑證的情況下傳送請求，並保留您提供的 `Authorization` 標頭，例如透過 `ANTHROPIC_CUSTOM_HEADERS` 提供的標頭。設定 `ANTHROPIC_FOUNDRY_API_KEY` 或 `ANTHROPIC_FOUNDRY_AUTH_TOKEN` 時會被忽略。在 v2.1.203 之前，除非同時設定了 API 金鑰，否則此變數會導致 Microsoft Foundry 用戶端無法傳送請求 |
| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | 略過 Amazon Bedrock Mantle 的 AWS 身分驗證（例如使用 LLM 閘道時） |
| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 與 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 上的[啟動模型檢查](/docs/zh-TW/amazon-bedrock#startup-model-checks)會在這台機器上記住它們發現您的帳戶無法叫用的模型，最長一天。設為 `1` 可關閉此記憶。需要 Claude Code v2.1.285 或更新版本 |
| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 設為 `1` 可略過將提示詞歷史與工作階段逐字稿寫入磁碟。設定此變數後啟動的工作階段不會出現在 `--resume`、`--continue` 或向上鍵歷史中。適用於暫時性的指令碼工作階段 |
| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | 略過 Google Cloud's Agent Platform 的 Google 身分驗證（例如使用 LLM 閘道時） |
| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | 設為 `1` 可讓以 `--output-format stream-json` 啟動的工作階段，針對原本僅以 stderr 結束的啟動失敗，寫入一則[說明 Claude Code 拒絕啟動原因的結果訊息](/docs/zh-TW/agent-sdk/typescript#startup_failure_reason)。需要 Claude Code v2.1.274 或更新版本 |
| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/zh-TW/hooks#stop) 或 [SubagentStop](/docs/zh-TW/hooks#subagentstop) hook 可連續阻止回合結束的最大次數，超過後 Claude Code 會覆寫它並仍然結束回合（預設：8）。設為 `0` 可停用此上限。若您的 hook 確實需要更多次迭代才能完成，請調高此值 |
| `CLAUDE_CODE_SUBAGENT_MODEL` | [subagent](/docs/zh-TW/sub-agents#choose-a-model)、[agent team](/docs/zh-TW/agent-teams#specify-teammates-and-models) 隊員與[工作流程](/docs/zh-TW/workflows) agent 在未透過其他方式指派模型時所使用的預設模型。接受別名（例如 `haiku`）或完整模型名稱。有兩個來源優先於它：Claude 產生 agent 時傳遞的模型，以及 agent 定義中的 `model` 欄位，包括 `inherit`。若要改變此行為，請設定 [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model)。完整順序請參閱[選擇模型](/docs/zh-TW/sub-agents#choose-a-model)。將其設為 `inherit` 與未設定相同。在 v2.1.251 之前，此變數會同時覆寫每次叫用的模型與定義中的 `model` 欄位 |
| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | 設為 `1` 可強制 subagent、隊員與工作流程 agent 使用同一個模型。[在同一個模型上執行每個 subagent](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model) 說明了是哪個模型。需要 Claude Code v2.1.257 或更新版本 |
| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | 設定 `5m` 或 `1h`（Claude Code 僅接受這兩個值），以選擇主對話以外請求（例如 [subagent](/docs/zh-TW/sub-agents)、工作流程與背景工作）的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)。優先於 `subagentPromptCacheTtl` 設定與 `ENABLE_PROMPT_CACHING_1H`，而 `FORCE_PROMPT_CACHING_5M` 會覆寫它。API 對 1 小時快取寫入以較高費率計費。需要 Claude Code v2.1.242 或更新版本 |
| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 設為 `1` 可從 Claude Code 啟動之子程序（例如 Bash 命令、hook 與 stdio MCP 伺服器）的環境中移除憑證。清除機制會依變數名稱或其值辨識憑證，並保留 GitHub token 與代理伺服器設定。請參閱[子程序環境清除會移除哪些內容](#what-the-subprocess-environment-scrub-removes)。設定 `allowed_non_write_users` 時，`claude-code-action` 會自動設定此變數 |
| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 在非互動模式（`-p` 旗標）中設為 `1`，以在第一個查詢之前等待外掛安裝完成。若未設定，外掛會在背景安裝，且可能在第一個回合無法使用。可搭配 `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` 來限制等待時間 |
| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同步外掛安裝的逾時時間（毫秒）。超過時，Claude Code 會在沒有外掛的情況下繼續並記錄錯誤。沒有預設值：若未設定此變數，同步安裝會等到完成為止 |
| `CLAUDE_CODE_SYNC_SKILLS` | 在使用 `-p` 旗標的非互動模式中設為 `1`，讓 Claude Code 在該次執行中下載您 claude.ai 帳戶已啟用的 skill，並在執行第一個查詢之前等待其清單，最長為 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`。需要 claude.ai 身分驗證。以 claude.ai 帳戶登入的終端機工作階段無需此變數即可[同步這些 skill](/docs/zh-TW/skills#where-synced-skills-load)，因此僅在 `-p` 執行需要在第一個查詢中使用您目前的 skill 時才設定 |
| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | 當以 [Agent SDK](/docs/zh-TW/agent-sdk/typescript#query-object) 建置的應用程式重新載入 skill 時，在工作階段中途執行之 skill 重新同步的逾時時間（毫秒）（預設：30000）。超過時，重新載入會以已到達的 skill 繼續，其餘下載則在背景完成 |
| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | 設定 `CLAUDE_CODE_SYNC_SKILLS` 時，第一個查詢等待初始 skill 清單的逾時時間（毫秒）（預設：5000）。超過時，第一個查詢會以已到達的 skill 執行。無論如何，下載都會在背景完成，且 Claude 在叫用某個 skill 時會等待該 skill 下載完成 |
| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | 設為 `false` 可停用差異輸出中的語法醒目提示。在顏色干擾您的終端機設定時很有用。若也要停用程式碼區塊與檔案預覽中的醒目提示，請使用 [`syntaxHighlightingDisabled`](/docs/zh-TW/settings-reference#syntaxhighlightingdisabled) 設定 |
| `CLAUDE_CODE_TASK_LIST_ID` | 在工作階段之間共用任務清單。在多個 Claude Code 執行個體中設定相同的 ID，以在[具備 Task 工具的工作階段](/docs/zh-TW/tools-reference#task-tool-availability)中協調共用的任務清單。請參閱[任務清單](/docs/zh-TW/interactive-mode#task-list) |
| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 以毫秒覆寫非互動式工作階段在結束時等待其 [agent team](/docs/zh-TW/agent-teams) 完成拆除的時間。接受 1000 至 60000；超出範圍的值會被忽略並套用預設值 10000。需要 Claude Code v2.1.206 或更新版本 |
| `CLAUDE_CODE_TMPDIR` | 覆寫用於內部暫存檔的暫存目錄。Claude Code 在 Unix 上會於此路徑附加 `/claude-{uid}/`，在 Windows 上附加 `/claude/`。預設：macOS 上為 `/tmp`，Linux 與 Windows 上為 `os.tmpdir()`。在 macOS 與 Linux 上，當您的覆寫值為長路徑時，[沙箱化](/docs/zh-TW/sandboxing)的 Bash 子程序會收到位於系統預設位置下的簡短備援 `$TMPDIR`，因為某些工具在暫存路徑過長時會失敗。未沙箱化的 Bash 命令會在您 shell 的 `$TMPDIR` 已設定時繼承它。在原生 Windows 上，當您的 shell 未設定 `$TMPDIR` 時，參照 `$TMPDIR` 的 Bash 命令會收到您的覆寫值，若您未設定覆寫值則收到 `%TEMP%`。Claude Code 自身的暫存檔一律使用您的覆寫值。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |
| `CLAUDE_CODE_TMUX_TRUECOLOR` | 設為任何非空值（例如 `1`）以允許在 tmux 內輸出 24 位元真彩色。**設為 `0` 或 `false` 仍會允許真彩色**，這與大多數開關變數不同；取消設定此變數可恢復 256 色限制。預設情況下，當設定了 `$TMUX` 時，Claude Code 會限制為 256 色，因為除非經過設定，否則 tmux 不會傳遞真彩色跳脫序列。請在將 `set -ga terminal-overrides ',*:Tc'` 加入您的 `~/.tmux.conf` 之後設定此變數。其他 tmux 設定請參閱[終端機設定](/docs/zh-TW/terminal-config) |
| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | 在 Linux 與 WSL 上，設為以逗號分隔的程序類型清單，Claude Code 會將這些類型[排除在工具記憶體上限之外](/docs/zh-TW/tools-reference#memory-limit-on-linux-and-wsl)，例如 `mcp` 或 `lsp`。設為 `none` 可限制所有類型，或設為 `all-new` 僅限制 Bash、PowerShell 與 Monitor 工具命令。無論您列出什麼，Claude Code 都會讓 Bash、PowerShell 與 Monitor 工具命令受上限約束。需要 Claude Code v2.1.246 或更新版本 |
| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | 在 Linux 與 WSL 上，設為 `4G` 等大小，以[限制 Bash 與 PowerShell 工具命令可使用的記憶體](/docs/zh-TW/tools-reference#memory-limit-on-linux-and-wsl)，在 v2.1.246 或更新版本中也包括 Monitor 工具命令。請以純數字寫入大小，單獨使用代表位元組數，或加上 `K`、`M`、`G` 或 `T` 後綴。設為 `0` 或 `off` 可關閉上限。一旦 Claude Code 啟動的第一個程序已開啟或關閉上限，變更後的值會在您下次啟動 `claude` 時生效。需要 Claude Code v2.1.233 或更新版本 |
| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | 設為 `1` 可限制長時間 `-p` 或 Agent SDK 工作階段的[逐字稿檔案](/docs/zh-TW/sessions#where-transcripts-are-stored)成長的大小。每次壓縮後，當檔案大於 5 MB 時，Claude Code 會移除該次壓縮之前的歷史記錄。無論檔案是否經過修剪，繼續工作階段都會還原相同的對話。請在您啟動 Claude Code 的環境中設定，因為設定的 `env` 區塊無法開啟此功能。需要 Claude Code v2.1.287 或更新版本 |
| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code 取消轉送至遠端用戶端（例如 [Remote Control](/docs/zh-TW/remote-control) 或 SDK 主機）的對話框，或[被暫留的跨工作階段訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)之核准對話框前的期限（毫秒）；權限提示與 `AskUserQuestion` 問題使用各自的流程，不受此變數控制。在 Claude Code v2.1.236 或更新版本中，它也會限制可能在無人看管狀態下執行的工作階段中，於工作階段中途出現的 [Fable 用量點數同意提示](/docs/zh-TW/model-config#fable-and-usage-credits)。[控制傳入訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)與[非互動工作階段](/docs/zh-TW/cross-session-messaging#non-interactive-sessions)涵蓋完整的暫留訊息到期規則，包括期限不適用的情況。覆寫 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 設定。`0` 或負值會停用期限。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |
| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | 使用 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) |
| `CLAUDE_CODE_USE_BEDROCK` | 使用 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) |
| `CLAUDE_CODE_USE_FOUNDRY` | 使用 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) |
| `CLAUDE_CODE_USE_MANTLE` | 使用 Amazon Bedrock [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) |
| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | 設定為 `1` 以使用 Node.js 檔案 API 而非 ripgrep 來探索自訂命令、subagent 與輸出風格。若內建的 ripgrep 二進位檔在您的環境中無法使用或遭封鎖，請設定此變數。不會影響 Grep 或檔案搜尋工具 |
| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具。在未安裝 Git Bash 的 Windows 上，此工具會自動啟用；設定為 `0` 可停用。在已安裝 Git Bash 的 Windows 上，claude.ai 與 Console 帳戶預設會開啟此工具；設定為 `1` 可在 Amazon Bedrock、Google Cloud's Agent Platform 與 Microsoft Foundry 工作階段中啟用，或設定為 `0` 將其關閉。在 Linux、macOS 與 WSL 上，設定為 `1` 可啟用，這需要 `PATH` 中有 `pwsh`。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不必透過 Git Bash 轉送。請參閱 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool) |
| `CLAUDE_CODE_USE_VERTEX` | 使用 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) |
| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | 設定 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 將每個已擷取 URL 的回應保留在快取中的毫秒數。預設值為 `900000`，即 15 分鐘。僅接受純數字；`0`、小數或任何其他寫法都會保留預設值。Claude Code 每次啟動時只讀取一次此值，因此在設定的 `env` 區塊中所做的變更會在您下次啟動 `claude` 時生效。需要 Claude Code v2.1.233 或更新版本 |
| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 等待頁面下載完成（包括其所跟隨的任何重新導向）的時間上限（毫秒）。屆時仍未完成的下載會以期限錯誤失敗。預設值為 `300000`，即五分鐘。設定為 `0` 可移除限制。僅接受純數字；小數或任何其他寫法都會保留預設值。需要 Claude Code v2.1.268 或更新版本 |
| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | 工作階段的 [WebSearch 上限](/docs/zh-TW/tools-reference#session-search-limit)的補充速率，單位為每小時呼叫次數。在互動式終端機工作階段中預設值為 `100`。在[非互動](/docs/zh-TW/headless)工作階段中預設值為 `0`，即關閉補充。僅接受純數字；任何其他寫法都視為未設定。需要 Claude Code v2.1.290 或更新版本 |
| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | 當 `CLAUDE_AUTO_BACKGROUND_TASKS` 設定為 `1` 時，Claude Code 在每次提醒 Claude 檢查仍在執行中的[背景 subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)之前等待的時間。接受一個或多個以逗號分隔、以整數秒表示且介於 `1` 到 `86400` 之間的等待時間，例如 `600` 或 `600,1800,3600`。每個值都是下一次提醒前的等待時間，最後一個值會重複使用。僅接受純數字；任何其他值或寫法都視為未設定。未設定時不會有提醒。需要 Claude Code v2.1.283 或更新版本 |
| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 單次[工作流程](/docs/zh-TW/workflows)執行同時執行的 agent 數量，範圍為 `1` 到 `256`。預設情況下，一次執行最多同時執行 16 個 agent，當 Claude Code 可用的 CPU 較少時會更少；排入佇列的 `agent()` 呼叫會等待空閒的位置。每個執行中 agent 的逐字稿都會保留在 Claude Code 的記憶體中，因此較高的值會增加記憶體使用量。僅接受純數字；超出範圍的值與其他寫法會保留預設值。需要 Claude Code v2.1.269 或更新版本 |
| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [工作流程](/docs/zh-TW/workflows) agent 在送出自己的第一個請求之前，等待具有相同前綴的同層 agent 開始第一個回應的時間上限（毫秒）。當扇出啟動多個共用[提示快取前綴](/docs/zh-TW/workflows#prompt-caching-in-a-fan-out)的 agent 時，Claude Code 會將第一個以外的所有 agent 暫停最多這段時間，讓其餘 agent 讀取已快取的前綴，而不是各自在未快取的情況下處理。預設值為 `5000`。設定為 `0` 可停用等待。設定 `DISABLE_PROMPT_CACHING` 時，agent 永遠不會等待。需要 Claude Code v2.1.229 或更新版本 |
| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | 設為 `1` 可在提示詞上方，為 [You should know mod](/docs/zh-TW/interactive-mode#you-should-know-suggestions) 在此工作階段中進行的最近三次檢查各顯示一行。可用於在沒有出現任何提示時，確認該 mod 是否正在進行檢查。需要 Claude Code v2.1.287 或更新版本 |
| `CLAUDE_CONFIG_DIR` | 覆寫設定目錄（預設：`~/.claude`）。所有設定、工作階段歷史記錄與外掛都儲存在此路徑下。關於憑證，請參閱 [Claude Code 儲存憑證的位置](/docs/zh-TW/authentication#credential-management)。適用於並行執行多個帳戶：例如 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。請在您的 shell、使用者設定或受管設定中設定。在設定檔中，請寫入[絕對路徑](#in-settings-files)。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |
| `CLAUDE_DISABLE_ADOPT` | 設定為 `1`，在您按下 `←` 或使用 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段移至背景時，停止進行中的背景工作，而不是將其延續。Claude Code 會在移至背景前要求您確認，然後停止原本會延續的任務。需要 Claude Code v2.1.195 或更新版本 |
| `CLAUDE_EFFORT` | 在 Bash 工具子程序與 hook 命令中自動設定為子程序啟動時生效的 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。與傳遞給 [hook](/docs/zh-TW/hooks) 的 `effort.level` 欄位相符。僅在目前模型支援 effort 參數時設定 |
| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 設定為 `1` 可強制啟用位元組層級串流閒置監視器，設定為 `0` 可強制停用。`0` 也會在執行[首位元組期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)的連線上關閉該期限。未設定時，此監視器預設會針對直接 Anthropic API 與 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 連線，以及透過 `ANTHROPIC_BASE_URL` 或 `ANTHROPIC_AWS_BASE_URL` 連到的[閘道](/docs/zh-TW/gateways)連線上的串流回應啟用；在 v2.1.222 之前，它不會在這些閘道連線上執行，因此即使 keep-alive ping 持續抵達，事件層級監視器仍可能在那裡回報停滯。關於逾時以及各計時器如何交互作用，請參閱[串流閒置監視器](/docs/zh-TW/network-config#streaming-idle-watchdogs) |
| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | 設定為 `1` 可在 Amazon Bedrock `vnd.amazon.eventstream` 回應上啟用位元組層級串流閒置監視器，這也會在 Bedrock 串流請求上啟用[首位元組期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)。預設為關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 設定逾時 |
| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 設定為 `0` 可強制停用事件層級串流閒置監視器，設定為 `1` 可強制啟用。未設定時，此監視器預設對所有提供者開啟。在 v2.1.196 之前，未設定時的預設值在直接 Anthropic API 上由伺服器控制，在其他提供者上則為關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 設定逾時；關於與此監視器一同執行的其他停滯計時器，請參閱[串流閒置監視器](/docs/zh-TW/network-config#streaming-idle-watchdogs) |
| `CLAUDE_ENV_FILE` | shell 指令碼的路徑，Claude Code 會在每個 Bash 命令之前於同一 shell 程序中執行其內容，因此檔案中的 export 對該命令可見。用於在命令之間保留 virtualenv 或 conda 的啟用狀態。在 v2.1.296 或更新版本中，PowerShell 命令也會收到其變數，條件請參閱 [PowerShell 命令中的保留變數](/docs/zh-TW/hooks#persisted-variables-in-powershell-commands)。也會由 [SessionStart](/docs/zh-TW/hooks#persist-environment-variables)、[Setup](/docs/zh-TW/hooks#setup)、[CwdChanged](/docs/zh-TW/hooks#cwdchanged) 與 [FileChanged](/docs/zh-TW/hooks#filechanged) hook 動態填入 |
| `CLAUDE_JOB_DIR` | 由 Claude Code 在每個[背景工作階段](/docs/zh-TW/agent-view)中設定為該工作階段的 `~/.claude/jobs/` 目錄。工作階段執行的 shell 命令會繼承此變數。請將暫存檔寫入 [`$CLAUDE_JOB_DIR/tmp`](/docs/zh-TW/agent-view#where-state-is-stored)。Claude 在該處的 `Write` 與 `Edit` 呼叫不會要求權限，且該目錄會在工作階段刪除時移除 |
| `CLAUDE_PID` | Claude Code 會在其產生的子程序（Bash 與 PowerShell 工具命令以及 hook 命令）中將此變數設定為自己的程序 ID。在 Linux 上，Bash 工具的 shell 整合會使用它來拒絕會符合 Claude Code 程序本身的 `pkill` 模式；請參閱[錯誤參考](/docs/zh-TW/errors#pkill-pattern-matches-the-claude-code-process)。可從您自己的指令碼中讀取它，以刻意識別上層 Claude Code 程序或向其傳送訊號。需要 Claude Code v2.1.214 或更新版本 |
| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 未提供明確名稱時，自動產生的 [Remote Control](/docs/zh-TW/remote-control) 工作階段名稱的前綴。預設為您電腦的主機名稱，產生如 `myhost-graceful-unicorn` 的名稱。`--remote-control-session-name-prefix` CLI 旗標會針對單次呼叫設定相同的值 |
| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | 在執行[首位元組期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)的連線上，串流請求第一個回應位元組的期限（毫秒）。關於 Claude Code 如何限制此值、為大型請求本文額外增加的時間，以及在您未設定此變數時如何選擇期限，請參閱 [No response from API](/docs/zh-TW/errors#no-response-from-api)。需要 Claude Code v2.1.242 或更新版本 |
| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 事件層級與位元組層級串流閒置監視器關閉停滯連線前的逾時（毫秒）。當您明確設定此變數時，最小值為 `300000`（5 分鐘）；較低的值會被自動調整，以容納延伸思考的暫停與代理伺服器緩衝，而位元組層級監視器會將此值上限設為 30 分鐘。對於位元組層級監視器，`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` 優先於此變數。關於各監視器未設定時的預設值，請參閱[串流閒置監視器](/docs/zh-TW/network-config#streaming-idle-watchdogs) |
| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | 已在 v2.1.260 中移除，現在不再有任何作用。先前用於限制 [subagent](/docs/zh-TW/sub-agents) 啟動的[背景 shell 命令](/docs/zh-TW/interactive-mode#background-bash-commands)可執行的時間（毫秒），預設為 60 分鐘。請參閱[背景命令存續期規則](/docs/zh-TW/tools-reference#background-commands) |
| `DEBUG` | 設定為 `1` 可啟用偵錯模式，等同於以 [`--debug`](/docs/zh-TW/cli-reference#cli-flags) 啟動。偵錯日誌會寫入 `~/.claude/debug/.txt`，或寫入 `CLAUDE_CODE_DEBUG_LOGS_DIR` 所設定的路徑。只有真值 `1`、`true`、`yes` 與 `on` 會啟用偵錯模式，因此為其他工具設定的命名空間模式（例如 `DEBUG=express:*`）不會觸發它 |
| `DISABLE_AUTOUPDATER` | 設定為 `1` 可停用自動背景更新。手動執行 `claude update` 仍可運作。使用 `DISABLE_UPDATES` 可同時封鎖兩者 |
| `DISABLE_AUTO_COMPACT` | 設定為 `1` 可停用接近上下文限制時的自動壓縮，以及[閒置壓縮](/docs/zh-TW/settings-reference#idlecompaction)。手動 `/compact` 命令仍可使用。適合在您想明確控制壓縮時機時使用。覆寫 [`autoCompactEnabled`](/docs/zh-TW/settings-reference#autocompactenabled) 設定 |
| `DISABLE_COMPACT` | 設定為 `1` 可停用所有壓縮：包括自動壓縮與手動 `/compact` 命令 |
| `DISABLE_COST_WARNINGS` | 設定為 `1` 可停用成本警告訊息 |
| `DISABLE_DOCTOR_COMMAND` | 設定為 `1` 可隱藏 [`/doctor`](/docs/zh-TW/commands#all-commands) 設定檢查 skill 及其 `/checkup` 別名。適用於使用者不應在工作階段中執行設定診斷的受管部署。不會影響 `claude doctor` 終端機命令。在 v2.1.205 之前，此變數會隱藏 `/doctor` 診斷畫面命令 |
| `DISABLE_ERROR_REPORTING` | 設定為任何非空值（例如 `1`）可選擇退出錯誤回報。**與大多數開關變數不同，設定為 `0` 或 `false` 仍會選擇退出**；取消設定此變數即可重新開啟錯誤回報 |
| `DISABLE_EXTRA_USAGE_COMMAND` | 設定為 `1` 可隱藏讓使用者購買超出速率限制之額外用量的 `/usage-credits` 命令 |
| `DISABLE_FEEDBACK_COMMAND` | 設定為 `1` 可停用 `/feedback` 命令與 [Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)。也會停用透過相同路徑回報的 `/bug` 與 `/share`；在 v2.1.212 之前，它們是 `/feedback` 的別名，因此該命令的每個名稱都會被停用。也接受較舊的名稱 `DISABLE_BUG_COMMAND` |
| `DISABLE_GROWTHBOOK` | 設定為 `1` 或 `true` 可停用 GrowthBook 功能旗標擷取，並對每個旗標使用程式碼預設值。這會使 [Remote Control](/docs/zh-TW/remote-control#requirements) 及其他[需要功能旗標擷取的功能](#features-that-need-feature-flag-fetching)無法使用。設定為 `0` 或 `false` 會保持擷取開啟。除非同時設定 `DISABLE_TELEMETRY`，否則遙測事件記錄會保持開啟 |
| `DISABLE_INSTALLATION_CHECKS` | 設定為 `1` 可停用安裝警告。僅在手動管理安裝位置時使用，因為這可能會掩蓋標準安裝的問題 |
| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | 設定為 `1` 可隱藏 `/install-github-app` 命令。使用第三方提供者（Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry）時已經隱藏 |
| `DISABLE_INTERLEAVED_THINKING` | 設定為 `1` 可避免傳送 interleaved-thinking beta 標頭。當您的 LLM 閘道或提供者不支援[交錯思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)時很有用 |
| `DISABLE_LOGIN_COMMAND` | 設定為 `1` 可隱藏 `/login` 命令。當身分驗證透過 API 金鑰或 `apiKeyHelper` 在外部處理時很有用 |
| `DISABLE_LOGOUT_COMMAND` | 設定為 `1` 可隱藏 `/logout` 命令 |
| `DISABLE_PROMPT_CACHING` | 設定為 `1` 可為所有模型停用[提示快取](/docs/zh-TW/prompt-caching#disable-prompt-caching)（優先於個別模型的設定） |
| `DISABLE_PROMPT_CACHING_FABLE` | 設定為 `1` 可為 Fable 模型停用提示快取 |
| `DISABLE_PROMPT_CACHING_HAIKU` | 設定為 `1` 可為[預設 Haiku 模型](/docs/zh-TW/prompt-caching#disable-prompt-caching)停用提示快取，無論其在何處執行 |
| `DISABLE_PROMPT_CACHING_OPUS` | 設定為 `1` 可為[預設 Opus 模型](/docs/zh-TW/prompt-caching#disable-prompt-caching)停用提示快取 |
| `DISABLE_PROMPT_CACHING_SONNET` | 設定為 `1` 可為[預設 Sonnet 模型](/docs/zh-TW/prompt-caching#disable-prompt-caching)停用提示快取 |
| `DISABLE_TELEMETRY` | 設定為任何非空值（例如 `1`）可選擇退出遙測。**與大多數開關變數不同，設定為 `0` 或 `false` 仍會選擇退出**；取消設定此變數即可重新開啟遙測。遙測事件不包含程式碼、檔案路徑或 Bash 命令等使用者資料。也會停用[功能旗標擷取](#features-that-need-feature-flag-fetching)。請參閱[為您的組織關閉遙測](/docs/zh-TW/managed-settings#turn-telemetry-off-for-your-organization) |
| `DISABLE_UPDATES` | 設定為 `1` 可封鎖所有更新，包括手動執行的 `claude update` 與 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。當您透過自己的管道發佈 Claude Code 且使用者不應自行更新時使用 |
| `DISABLE_UPGRADE_COMMAND` | 設定為 `1` 可隱藏 `/upgrade` 命令 |
| `DO_NOT_TRACK` | 設定為 `1` 可選擇退出遙測，效果與 `DISABLE_TELEMETRY` 相同，包括對[功能旗標擷取](#features-that-need-feature-flag-fetching)的影響。Claude Code 將此變數讀取為標準布林值，因此 `0` 會保持遙測開啟，並將其視為許多開發者 CLI 所認可的跨工具慣例加以遵循 |
| `ENABLE_BETA_TRACING_DETAILED` | 設定為 `1`，並將 `BETA_TRACING_ENDPOINT` 設定為您的 OTLP/HTTP 收集器端點，即可開啟[詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)，這會新增帶有內容的 span 屬性以及 `claude_code.hook` span。互動式 CLI 工作階段還需要您的組織已列入此 beta 的允許清單。兩個變數在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中都會被忽略 |
| `ENABLE_CLAUDEAI_MCP_SERVERS` | 設定為 `false` 可讓 Claude Code 停止擷取 [claude.ai MCP 伺服器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)。對已登入的使用者預設為啟用。若要針對個別專案或組織停用，請改在設定中設定 [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) |
| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 可請求 1 小時的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)，而非預設的 5 分鐘。適用於 API 金鑰、[Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai)、[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 與 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 使用者。在包含用量範圍內的訂閱使用者會在[主要對話](/docs/zh-TW/prompt-caching#which-ttl-each-request-gets)上自動獲得 1 小時 TTL。使用[用量點數](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)的訂閱使用者可以設定此變數以保留 1 小時 TTL。1 小時快取寫入會以較高的費率計費。若要改為依請求類別選擇 TTL，請使用 `CLAUDE_CODE_PROMPT_CACHE_TTL` 與 `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`，兩者優先於此變數 |
| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 已棄用。請改用 `ENABLE_PROMPT_CACHING_1H` |
| `ENABLE_TOOL_SEARCH` | 控制 [MCP 工具搜尋](/docs/zh-TW/mcp#scale-with-mcp-tool-search)。未設定時，Claude Code 預設會延後載入所有 MCP 工具，而當 `ANTHROPIC_BASE_URL` 指向非第一方主機時則改為預先載入。`true` 會讓它們在這類主機上也保持延後載入。`auto` 會在工具定義可容納於上下文的 10% 以內時預先載入。`auto:N` 可設定自訂閾值，例如 `auto:5` 表示 5%。`false` 會預先載入所有工具。關於無論此值為何都會預先載入所有工具的模型和部署，請參閱[設定工具搜尋](/docs/zh-TW/mcp#configure-tool-search) |
| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 設定為任何非空值（例如 `1`），可在未設定備援模型時，讓 Claude Code 對每個模型在重複發生過載錯誤時停止重試。**與大多數開關變數不同，設定為 `0` 或 `false` 仍會啟用此行為**；取消設定此變數即可恢復預設的重試行為。若未設定，當您使用 API 金鑰或[第三方提供者](/docs/zh-TW/third-party-integrations)而非 Claude 訂閱進行身分驗證時，Claude Code 只會對其識別為 Opus、Fable 或 Mythos 的模型以此方式停止重試。在 Claude Code v2.1.160 或更新版本中，Claude Code 會在任何主要模型重複發生過載錯誤時切換至您設定的[備援模型鏈](/docs/zh-TW/model-config#fallback-model-chains)，因此此變數不會影響切換至備援模型 |
| `FORCE_AUTOUPDATE_PLUGINS` | 設定為 `1` 可強制外掛自動更新，即使主要自動更新程式已透過 `DISABLE_AUTOUPDATER` 停用 |
| `FORCE_HYPERLINK` | 當您的終端機支援可點擊的 OSC 8 超連結但未被自動偵測到時，設定為 `1` 可啟用它們，設定為 `0` 則可停用。未設定時，Claude Code 僅在偵測到終端機支援時啟用超連結。Claude Code 會將此值解析為數字而非布林值，因此 `false`、`no` 或 `off` 等值會啟用超連結而非停用。即使 Claude Code 無法偵測終端機支援（例如透過 SSH），頁尾的 [PR 或合併請求徽章](/docs/zh-TW/interactive-mode#pr-review-status)仍會顯示為超連結。設定 `0` 可將徽章顯示為純文字 |
| `FORCE_PROMPT_CACHING_5M` | 設定為 `1` 可強制使用 5 分鐘提示快取 TTL，即使原本會套用 1 小時 TTL。覆寫 `CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`，以及 `promptCacheTtl` 與 `subagentPromptCacheTtl` 設定 |
| `HTTP_PROXY` | 為網路連線指定 HTTP 代理伺服器 |
| `HTTPS_PROXY` | 為網路連線指定 HTTPS 代理伺服器 |
| `IS_DEMO` | 設定為任何非空值（例如 `1`）可啟用示範模式：在標頭與 `/status` 輸出中隱藏您的電子郵件與組織名稱，並略過入門引導。**與大多數開關變數不同，設定為 `0` 或 `false` 仍會啟用示範模式**；取消設定此變數即可將其關閉。適用於直播或錄製工作階段時 |
| `MAX_MCP_OUTPUT_TOKENS` | MCP 工具回應中允許的最大 token 數（預設：25000）。當輸出超過 10,000 個 token 時，Claude Code 會顯示警告。宣告 [`anthropic/maxResultSizeChars`](/docs/zh-TW/mcp#raise-the-limit-for-a-specific-tool) 的工具會改對文字內容使用該字元限制，但這些工具的圖片內容仍受此變數限制。來自未加上該註解之工具、長度超過 50,000 個字元的成功文字結果，無論此變數為何，都會[儲存至檔案](/docs/zh-TW/mcp#mcp-output-limits-and-warnings) |
| `MAX_STRUCTURED_OUTPUT_RETRIES` | 在使用 `-p` 旗標的非互動模式中，當模型的回應未通過 [`--json-schema`](/docs/zh-TW/cli-reference#cli-flags) 驗證時，Claude Code 允許的嘗試次數；在這麼多次嘗試失敗且沒有有效輸出之後，執行會失敗。當[工作流程](/docs/zh-TW/workflows) subagent 的結構化輸出未通過驗證時，也適用相同上限。預設為 5，即第一次嘗試加上四次重試 |
| `MAX_THINKING_TOKENS` | [延伸思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)的固定 token 預算。Claude Code 會將其上限設為比請求的最大輸出 token 少一個，且絕不低於 1,024。關於該限制如何設定，請參閱 `CLAUDE_CODE_MAX_OUTPUT_TOKENS`。未設定且已啟用思考時，具備[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)的模型會自行選擇思考深度，其他模型則使用上限。設定為 `0` 可在 Anthropic API 上停用思考，但 Opus 5.5、Sonnet 5.5、Haiku 5.5 與 Fable 模型除外，這些模型無法關閉思考。在[第三方提供者](/docs/zh-TW/third-party-integrations)上，`0` 則會改為省略 `thinking` 參數。在 Anthropic API 上關閉思考時，對於 Claude Code 已知[不接受該組合](/docs/zh-TW/errors#effort-isnt-available-with-thinking-turned-off)的模型（例如 Opus 5），Claude Code 會傳送 effort `high` 而非更高的等級。若為正值，Claude Code 會在自適應推理模型上忽略該數字本身，除非 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 關閉了自適應推理 |
| `MCP_CLIENT_SECRET` | 需要[預先設定憑證](/docs/zh-TW/mcp#use-pre-configured-oauth-credentials)之 MCP 伺服器的 OAuth 用戶端密鑰。可在使用 `--client-secret` 新增伺服器時避免互動式提示 |
| `MCP_CONNECTION_NONBLOCKING` | 控制啟動時是否在第一個查詢之前等待 MCP 伺服器連線。MCP 啟動預設為非阻塞：伺服器會在背景連線，其工具會在完成時變為可用。設定為 `0` 可讓 Claude Code 在第一個查詢之前等待伺服器連線。以 [`alwaysLoad: true`](/docs/zh-TW/mcp#exempt-a-server-from-deferral) 設定的伺服器無論如何仍會讓啟動等待，除非是從[探索快取](/docs/zh-TW/mcp#server-status-detail)提供，因為建構第一個提示詞時必須具備其工具。在未使用 `--input-format stream-json` 的非互動模式（`-p`）中，無論此變數為何，Claude Code 也會在第一個回合之前等待仍在擱置中的伺服器。當您明確傳遞 [`--mcp-config`](/docs/zh-TW/cli-reference#cli-flags) 時，等待的期限較長；關於已快取伺服器的例外，請參閱該旗標的說明 |
| `MCP_CONNECT_TIMEOUT_MS` | 阻塞式 MCP 啟動在擷取工具清單快照之前，等待連線批次的時間（毫秒，預設：5000）。適用於 `MCP_CONNECTION_NONBLOCKING=0` 時，或標記為 [`alwaysLoad: true`](/docs/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器。在期限時仍處於擱置狀態的伺服器會繼續在背景連線。與 `MCP_TIMEOUT` 不同，後者限制的是個別伺服器的連線嘗試 |
| `MCP_DISCOVERY_CACHE` | 開啟或關閉 [MCP 探索快取](/docs/zh-TW/mcp#server-status-detail)。快取開啟時，您先前使用過的遠端 HTTP 或 SSE 伺服器可以顯示 [`cached` 狀態](/docs/zh-TW/mcp#server-status-detail)，且 Claude Code 會在其第一次工具呼叫時才連線，而非在啟動時。除非漸進式推出已為您的帳戶啟用，否則快取預設為關閉。設定為 `1` 可將其開啟，設定為 `0` 則即使推出已啟用也會保持關閉。在 v2.1.238 之前，快取預設為開啟。`cached` 狀態需要 Claude Code v2.1.221 或更新版本 |
| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [探索快取](/docs/zh-TW/mcp#server-status-detail)項目的最長存留時間（秒）（預設：14400，即 4 小時）。在項目比這更舊的啟動中，Claude Code 會捨棄該項目並在啟動時連線伺服器，如同快取關閉時的行為。Claude Code 會將此值上限設為 7 天。在 v2.1.238 之前，預設值為 86400，即 24 小時，且 Claude Code 不會限制此值 |
| `MCP_DISCOVERY_CACHE_STRIKES` | 在[探索快取](/docs/zh-TW/mcp#server-status-detail)項目比 `MCP_DISCOVERY_CACHE_TTL_S` 更舊的啟動中，Claude Code 會在背景重新整理該項目。此變數設定在 Claude Code 捨棄該項目並改在下次啟動時連線伺服器之前，可連續失敗的重新整理次數（預設：1）。若您的網路連線偶爾會中斷，請提高此值，讓單次重新整理失敗不會捨棄項目。需要 Claude Code v2.1.238 或更新版本 |
| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code 使用[探索快取](/docs/zh-TW/mcp#server-status-detail)項目而不重新整理的秒數（預設：900）。在項目比這更舊的啟動中，Claude Code 仍會使用該項目，但會在背景重新整理。一旦項目比 `MCP_DISCOVERY_CACHE_MAX_STALE_S` 更舊，Claude Code 則會將其捨棄。Claude Code 會將此值上限設為 `MCP_DISCOVERY_CACHE_MAX_STALE_S`，預設為 4 小時。在 v2.1.238 之前，Claude Code 不會限制此值 |
| `MCP_OAUTH_CALLBACK_PORT` | OAuth 重新導向回呼的固定連接埠，在新增具有[預先設定憑證](/docs/zh-TW/mcp#use-pre-configured-oauth-credentials)的 MCP 伺服器時，可作為 `--callback-port` 的替代方案 |
| `MCP_PROTOCOL_NEGOTIATION` | 僅在 [v2 MCP 用戶端執行環境](/docs/zh-TW/mcp#mcp-client-runtimes)上，決定 Claude Code 是否探測伺服器是否支援 MCP 協定修訂版 2026-07-28。設定 `auto` 可探測 HTTP、claude.ai 連接器與 stdio 伺服器，設定 `legacy` 則不探測任何伺服器。未設定此變數時，Claude Code 會探測 [MCP 用戶端執行環境](/docs/zh-TW/mcp#mcp-client-runtimes)中所述的伺服器。任何其他值都會被忽略，並在偵錯日誌中記下警告。需要 Claude Code v2.1.221 或更新版本 |
| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 啟動期間並行連線的遠端 MCP 伺服器（HTTP/SSE）最大數量（預設：20） |
| `MCP_SDK_GENERATION` | 固定此程序連線至 MCP 伺服器時使用的 [MCP 用戶端執行環境](/docs/zh-TW/mcp#mcp-client-runtimes)：`v1`（建構於 MCP TypeScript SDK 1.x）或 `v2`（建構於 [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/)）。未設定此變數時，Claude Code 會使用 v2，自該節所列的版本起生效。在 Claude Code v2.1.221 或更新版本中，v2 執行環境會檢查 MCP OAuth 伺服器在其授權回應中傳回的簽發者，若不相符，會以開頭為 `Issuer mismatch in authorization response` 的錯誤使登入失敗。v1 執行環境不會執行此檢查。若您設定了無法識別的值，Claude Code 會忽略它並在偵錯日誌中寫入警告。Claude Code 每個程序只讀取一次此值。需要 Claude Code v2.1.218 或更新版本 |
| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 啟動期間並行連線的本機 MCP 伺服器（stdio）最大數量（預設：3） |
| `MCP_TIMEOUT` | MCP 伺服器啟動的逾時（毫秒，預設：30000，即 30 秒） |
| `MCP_TOOL_TIMEOUT` | MCP 工具執行的逾時（毫秒，預設：100000000，約 28 小時）。對於 HTTP、SSE 或 claude.ai 連接器伺服器，每個請求預設也會在 60 秒後逾時；將此變數或個別伺服器的 `timeout` 設定為高於 60000，可提高該每請求限制。較低的值仍會縮短整體工具執行逾時，但每請求限制維持 60 秒。Stdio 與 WebSocket 伺服器沒有每請求計時器。`.mcp.json` 中個別伺服器的 `timeout` 欄位會針對該伺服器覆寫此值。個別伺服器至少為 1000 的 `timeout` 也會設定該伺服器工具呼叫的最小閒置時間窗，因此 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` 絕不會更早中止它們；此下限需要 Claude Code v2.1.203 或更新版本。對於環境變數，低於 1000 的值會被提高至一秒；對於個別伺服器欄位，低於 1000 的值會被忽略 |
| `NO_PROXY` | 請求將直接發送、繞過代理伺服器的網域與 IP 清單 |
| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 標準 OpenTelemetry SDK 的屬性值長度限制。Claude Code 會將帶有內容的遙測屬性上限設為此值與 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 中較小者，使截斷標記保持在 SDK 限制之內。Claude Code 會以相同方式讀取 `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` 與 `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` 變體，且最小的已設定值會套用至所有訊號。需要 Claude Code v2.1.214 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage#common-configuration-variables) |
| `OTEL_LOG_ASSISTANT_RESPONSES` | 設定為 `1` 可在 `assistant_response` OpenTelemetry 日誌事件中包含模型的回應文字。未設定時，Claude Code 會改用 `OTEL_LOG_USER_PROMPTS` 的值。設定為 `0` 可在已設定 `OTEL_LOG_USER_PROMPTS` 的情況下仍保持回應遮蔽。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。需要 Claude Code v2.1.193 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage#assistant-response-event) |
| `OTEL_LOG_MANAGED_SETTINGS` | 設定為 `1` 可將遮蔽後的受管設定，以及遮蔽前設定的 SHA-256 摘要，加入 `managed_settings_resolved` OpenTelemetry 日誌事件。預設為停用。請在您的 shell、使用者設定或受管設定中設定；專案或本機設定中的值不會將其開啟。需要 Claude Code v2.1.274 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage#managed-settings-resolved-event) |
| `OTEL_LOG_RAW_API_BODIES` | 將 Anthropic Messages API 請求與回應 JSON 以 `api_request_body` / `api_response_body` 日誌事件發出。設定為 `1` 可發出在內容限制處截斷的內嵌本文，或設定為 `file:` 可將未截斷的本文寫入磁碟並改為發出 `body_ref` 路徑。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 可設定內容限制，預設為 60 KB。預設為停用；本文包含完整的對話記錄。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。請參閱[監控](/docs/zh-TW/monitoring-usage#api-request-body-event) |
| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 可在 `tool.output` OpenTelemetry span 事件中包含工具內容。Span 屬性會依[各自的開關](/docs/zh-TW/monitoring-usage#new-context-gates)攜帶工具內容。需要[追蹤](/docs/zh-TW/monitoring-usage#traces-beta)。預設為停用以保護敏感資料。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](/docs/zh-TW/monitoring-usage#tool-output-span-event) |
| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 可在 OpenTelemetry 指標、追蹤與日誌中包含工具輸入引數；MCP 伺服器名稱；使用者撰寫的工作流程名稱；工具失敗時的原始錯誤字串；`api_refusal` 事件上的拒絕 `category`；[成本與 token 指標](/docs/zh-TW/monitoring-usage#cost-counter)上真實的 agent、skill、外掛與 MCP 伺服器名稱；以及其他工具詳細資訊。預設為停用以保護 PII。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 可在 OpenTelemetry 追蹤與日誌中包含使用者提示詞文字。預設為停用（提示詞會被遮蔽）。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 設定為 `false` 可從指標屬性中排除帳戶 UUID（預設：包含）。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 設定為 `true` 可在指標屬性中包含工作階段進入點（預設：排除）。於 v2.1.152 新增。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_REPOSITORY` | 設定為 `true` 可為 OpenTelemetry 指標與事件加上識別工作階段儲存庫的 `vcs.*` 屬性（預設：排除）。需要 Claude Code v2.1.269 或更新版本。請參閱[儲存庫屬性](/docs/zh-TW/monitoring-usage#repository-attributes) |
| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | 自 v2.1.161 起，Claude Code 會將 `OTEL_RESOURCE_ATTRIBUTES` 的鍵附加至指標資料點標籤。設定為 `false` 可將其排除（預設：包含）。請參閱[監控](/docs/zh-TW/monitoring-usage#multi-team-organization-support) |
| `OTEL_METRICS_INCLUDE_SESSION_ID` | 設定為 `false` 可從指標屬性中排除工作階段 ID（預設：包含）。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_VERSION` | 設定為 `true` 可在指標屬性中包含 Claude Code 版本（預設：排除）。請參閱[監控](/docs/zh-TW/monitoring-usage) |
| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆寫顯示給 [Skill 工具](/docs/zh-TW/skills#control-who-invokes-a-skill)之 skill 中繼資料的字元預算。此預算會動態調整為上下文視窗的 1%，備援值為 8,000 個字元。保留舊名稱以維持向下相容 |
| `TASK_MAX_OUTPUT_LENGTH` | 已在 v2.1.277 中與其所設定大小的 `TaskOutput` 工具一併移除，現在不再有任何作用。先前用於設定 `TaskOutput` 工具保留的[背景任務](/docs/zh-TW/tools-reference#background-commands)輸出最大字元數。Claude 現在改以 `Read` 讀取背景任務的輸出檔案 |
| `USE_BUILTIN_RIPGREP` | 設定為 `0` 可使用系統安裝的 `rg`，而非 Claude Code 內含的 `rg` |
| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | 使用 Google Cloud's Agent Platform 時覆寫 Claude 3.5 Haiku 的區域 |
| `VERTEX_REGION_CLAUDE_3_5_SONNET` | 使用 Google Cloud's Agent Platform 時覆寫 Claude 3.5 Sonnet 的區域 |
| `VERTEX_REGION_CLAUDE_3_7_SONNET` | 使用 Google Cloud's Agent Platform 時覆寫 Claude 3.7 Sonnet 的區域 |
| `VERTEX_REGION_CLAUDE_4_0_OPUS` | 使用 Google Cloud's Agent Platform 時，覆寫 Claude Opus 4 的區域 |
| `VERTEX_REGION_CLAUDE_4_0_SONNET` | 使用 Google Cloud's Agent Platform 時，覆寫 Claude Sonnet 4 的區域 |
| `VERTEX_REGION_CLAUDE_4_1_OPUS` | 使用 Google Cloud's Agent Platform 時，覆寫 Claude Opus 4.1 的區域 |
| `VERTEX_REGION_CLAUDE_4_5_OPUS` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Opus 4.5 的區域 |
| `VERTEX_REGION_CLAUDE_4_5_SONNET` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Sonnet 4.5 的區域 |
| `VERTEX_REGION_CLAUDE_4_6_OPUS` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Opus 4.6 的區域 |
| `VERTEX_REGION_CLAUDE_4_6_SONNET` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Sonnet 4.6 的區域 |
| `VERTEX_REGION_CLAUDE_4_7_OPUS` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Opus 4.7 的區域 |
| `VERTEX_REGION_CLAUDE_4_8_OPUS` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Opus 4.8 的區域 |
| `VERTEX_REGION_CLAUDE_5_5_OPUS` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Opus 5.5 的區域。於 v2.1.280 新增 |
| `VERTEX_REGION_CLAUDE_5_5_SONNET` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Sonnet 5.5 的區域。於 v2.1.284 新增 |
| `VERTEX_REGION_CLAUDE_5_OPUS` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Opus 5 的區域。於 v2.1.219 新增 |
| `VERTEX_REGION_CLAUDE_5_SONNET` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Sonnet 5 的區域。於 v2.1.197 新增 |
| `VERTEX_REGION_CLAUDE_FABLE_5` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Fable 5 的區域。於 v2.1.170 新增 |
| `VERTEX_REGION_CLAUDE_FABLE_5_1` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Fable 5.1 的區域。於 v2.1.257 新增 |
| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Haiku 4.5 的區域 |
| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | 使用 Google Cloud's Agent Platform 時覆寫 Claude Haiku 5.5 的區域。於 v2.1.293 新增 |
也支援標準 OpenTelemetry 匯出器變數（`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES` 以及特定訊號的變體）。設定詳細資訊請參閱[監控](/docs/zh-TW/monitoring-usage)。
請在您的 shell、使用者設定或受管設定中設定 `CLAUDE_CODE_ENABLE_TELEMETRY`，以及用於開啟匯出、選擇匯出目的地或擷取內容的 OpenTelemetry 變數。Claude Code [會在專案與本機設定中忽略它們](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)，但該節所述的關閉值除外。`OTEL_RESOURCE_ATTRIBUTES` 以及匯出間隔、逾時與壓縮變數（例如 `OTEL_METRIC_EXPORT_INTERVAL`）在專案與本機設定中仍會生效。
子程序環境清除會移除哪些內容
當您將 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) 設為 `1` 時，Claude Code 會從其啟動的子程序環境中移除憑證，例如 Bash 命令、hook 以及 stdio MCP 伺服器。這可減少提示詞注入攻擊所能讀取的內容。Claude Code 程序本身會保留這些憑證，以供其自身的 API 呼叫使用。
清除機制會依據變數名稱或其值的形式來辨識憑證，因此請將其作為一道防護層，搭配範圍狹窄的[權限規則](/docs/zh-TW/permissions)一起使用，而非當作唯一的控制手段。
下表說明清除機制對範例變數的處理方式：
| 範例變數 | 清除機制的處理方式 |
| :- | :- |
| `ANTHROPIC_API_KEY`、`AWS_SECRET_ACCESS_KEY` | 移除 |
| `NPM_TOKEN`、`DB_PASSWORD` | 移除，因為名稱看起來像憑證 |
| 包含密碼的 `DATABASE_URL` | 移除，因為值看起來像憑證 |
| 包含密碼的 `PIP_INDEX_URL` 或 `NPM_CONFIG_REGISTRY` | 保留 URL，但從中去除使用者名稱和密碼 |
| `CLAUDE_CONFIG_DIR` | 移除 |
| `GITHUB_TOKEN`、`GH_TOKEN`、`GH_ENTERPRISE_TOKEN`、`GITHUB_ENTERPRISE_TOKEN` | 保留原狀，讓 `gh` 以及呼叫 GitHub API 的指令碼能繼續運作 |
| `HTTP_PROXY`、`HTTPS_PROXY` | 保留原狀，包括 [URL 中的使用者名稱和密碼](/docs/zh-TW/network-config#basic-authentication)。[沙箱](/docs/zh-TW/sandboxing#network-isolation)可自行為沙箱中的命令設定這些變數 |
| `GIT_CONFIG_COUNT`、`GIT_CONFIG_KEY_`、`GIT_CONFIG_VALUE_` | 無論其內容為何，皆保留原狀 |
| 變數名稱和值看起來都不像憑證的機密 | 保留原狀 |
由於清除機制會保留 `GITHUB_TOKEN`，請僅授予 GitHub Actions 工作所需的最小 `permissions`。若要從沙箱中的 Bash 命令移除 GitHub token，請在 [`sandbox.credentials`](/docs/zh-TW/sandboxing#protect-credentials) 下新增一筆 `deny` 項目。
如果子程序需要其中某個會被移除的變數，請勿設定清除機制。
在 Linux 上，清除機制也會在隔離的 PID 命名空間中執行 Bash 子程序，使其無法透過 `/proc` 讀取主機程序的環境。其副作用是 `ps`、`pgrep` 和 `kill` 無法看到主機程序，也無法向其傳送訊號。
在 v2.1.251 之前，清除機制會移除 `ANTHROPIC_API_KEY` 和 `AWS_SECRET_ACCESS_KEY`，並保留表中其他範例變數不變。
需要擷取功能旗標的功能
Claude Code 會透過從 Anthropic 擷取的功能旗標來啟用部分功能。在下列工作階段中，Claude Code 會略過該擷取：
* 設定了 `DISABLE_GROWTHBOOK`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 的工作階段；[變數表](#variables)中每個變數的列會說明哪些值會關閉擷取
* 使用[第三方供應商](/docs/zh-TW/third-party-integrations)（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry）的工作階段，除非嵌入 Claude Code 的主機平台設定了 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`
* [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)工作階段
關閉擷取時，您無法：
* 執行 [`/auto-mode-setup`](/docs/zh-TW/auto-mode-config#generate-environment-entries) 來草擬 `autoMode.environment` 項目
* 在設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 的情況下使用 [Remote Control](/docs/zh-TW/remote-control)。關於 `DISABLE_TELEMETRY` 和 `DO_NOT_TRACK`，請參閱 [Remote Control 需求](/docs/zh-TW/remote-control#requirements)
* 在 [Remote Control](/docs/zh-TW/remote-control#requirements) 無法使用時，[傳送訊息給此機器以外的工作階段](/docs/zh-TW/cross-session-messaging#message-sessions-on-other-machines)。關閉擷取時，此機器上工作階段之間的訊息傳送仍可運作
* 執行 [`claude import` 或 `/import` 命令](/docs/zh-TW/cli-reference#cli-commands)
* 執行 [`/skill-doctor`](/docs/zh-TW/skills#find-unused-skills)，或在 `/plugin` 的 **Stats** 分頁中開啟其報告
* 將您的 claude.ai 帳戶所啟用的 [skills](/docs/zh-TW/skills#where-synced-skills-load) 和[外掛](/docs/zh-TW/plugins/loading#synced-plugins)同步到您的終端機工作階段
* 啟用 [You should know mod](/docs/zh-TW/interactive-mode#you-should-know-suggestions)
* 查看 [mod](/docs/zh-TW/plugins/mods/overview#where-mods-run) 在 VS Code 擴充功能的聊天面板中繪製的內容；該 mod 的 hook 仍會執行
* 使用 [advisor 工具](/docs/zh-TW/advisor#requirements)
* 閱讀或回覆 [artifact 上的留言](/docs/zh-TW/artifacts#collect-comments-on-an-artifact)
* 讓 Claude 讀取[其他組織的公開 artifact](/docs/zh-TW/artifacts#read-an-artifact-shared-with-you)
* 在已安裝 Git Bash 的 Windows 上，為 claude.ai 和 Console 帳戶預設取得 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)；除非您設定 `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`，否則 Claude Code 會透過 Git Bash 執行 shell 命令。在未安裝 Git Bash 的 Windows 上，該工具會保持啟用
* 取得 [Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)，Claude Code 是透過擷取的旗標來啟用此功能
* 讓 Claude [將大量貼上內容視為貼上的文字，而非輸入的文字](/docs/zh-TW/terminal-config#how-claude-treats-pasted-text)；`[Pasted text #N]` 預留位置背後的內容會未經標記地傳送給 Claude
* 讓 Claude Code [排除 API 會拒絕其輸入 schema 的 MCP 工具](/docs/zh-TW/mcp#tools-with-invalid-input-schemas)；它仍會傳送該 schema，而包含該 schema 的請求會失敗，並出現[依位置指出該工具的 400 錯誤](/docs/zh-TW/errors#tool-input-schema-is-invalid)
* 讓 Claude Code [在您的終端機工作階段閒置時壓縮冗長的對話](/docs/zh-TW/settings-reference#idlecompaction)，時間點在一小時的提示詞快取到期前不久
安裝或升級後的第一個工作階段
在您安裝 Claude Code 後，或升級到新增某項功能的版本後的第一個工作階段中，[受旗標控管的功能](#features-that-need-feature-flag-fetching)可能不存在。該工作階段的起始[權限模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)也可能與您之後的工作階段不同。當 Claude Code 在該工作階段中擷取旗標時，會將其儲存在機器上，因此您在該機器上的下一個工作階段就會具備該功能及一般的起始權限模式。
全新安裝後，在非互動式工作階段（例如 `claude -p`、Agent SDK 或 VS Code 擴充功能）中，Claude Code 可能會在[選擇起始權限模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)之前取得旗標，但不一定會等待旗標。
在如下的設定中，第一個之後的工作階段也會在沒有新擷取旗標的情況下啟動：
* **每次執行都是乾淨的環境**：如果每次執行都在 CI 容器中啟動，或在任何沒有先前工作階段所儲存旗標的環境中啟動，則每次執行都是第一個工作階段
* **沒有 API 金鑰的閘道 token**：如果您使用 `ANTHROPIC_AUTH_TOKEN` 進行身分驗證且沒有 API 金鑰，而 `ANTHROPIC_BASE_URL` 指向 Anthropic 以外的主機（例如 [LLM 閘道](/docs/zh-TW/llm-gateway)），Claude Code 就沒有可用來擷取旗標的憑證
若要選擇這些設定中工作階段的起始權限模式，請參閱[以不同的權限模式啟動](/docs/zh-TW/permission-modes#start-in-a-different-mode)。
另請參閱
* [Settings](/docs/zh-TW/settings)：所有 `settings.json` 配置，包括 `env` 鍵
* [CLI reference](/docs/zh-TW/cli-reference)：啟動時旗標
* [Network configuration](/docs/zh-TW/network-config)：代理和 TLS 設定
* [Monitoring](/docs/zh-TW/monitoring-usage)：OpenTelemetry 配置