SpyBara
Go Premium

env-vars.md 2026-10-01 23:59 UTC to 2026-10-02 04:57 UTC

This page contains 380 additions and 375 deletions.

2026
Thu 1 23:59 Fri 2 04:57

環境變數

控制 Claude Code 行為的環境變數參考。

環境變數可以控制 Claude Code 的行為，例如模型選擇、身份驗證、請求路由和功能切換。許多相同的行為也可以透過設定檔欄位、CLI 旗標或工作階段內命令（如 /model）進行設定。

本頁涵蓋以下內容：

設定環境變數

您在 shell 中設定的變數只在該終端機工作階段期間有效，而設定檔中的變數則在每次執行 claude 時都會套用。

在您的 shell 中

在啟動 claude 之前設定變數：

export API_TIMEOUT_MS="1200000"
claude

若要在每個工作階段都設定它，請將 export 行新增到 ~/.bashrc、~/.zshrc 或您的 shell 設定檔。

指派行在成功時不會列印任何內容。若要確認變數已設定，請在同一個 shell 中將其列印出來：

echo $API_TIMEOUT_MS

在設定檔中

在 settings.json 檔案的 env 鍵下新增變數，如果檔案不存在則建立它。Claude Code 會直接從檔案讀取它們，因此無論如何啟動 claude，它們都會生效。執行中的工作階段會在您儲存檔案時將新的和已變更的值套用到其環境，但在啟動時讀取其變數一次的功能（例如 OpenTelemetry 監控）會保留其啟動值，直到您重新啟動為止。從檔案中移除變數不會在執行中的工作階段中取消設定它；移除會在您下次啟動 claude 時生效。

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

您選擇的檔案控制變數套用的對象：

檔案 套用對象
~/.claude/settings.json 您，在每個專案中
.claude/settings.json 在專案中工作的所有人，簽入原始碼控制
.claude/settings.local.json 您，僅在此專案中，當 Claude Code 將設定儲存到它時會被 gitignore；如果您手動建立它，請將其新增到您的 gitignore
受管理的設定 您組織中的所有人，由管理員部署

請參閱 設定檔 以了解每個檔案的位置，以及 設定優先順序 以了解當多個檔案設定相同變數時它們如何結合。

優先順序

某些行為同時具有環境變數和專用設定鍵，Claude Code 讀取哪一個的順序因鍵而異。對於 ANTHROPIC_MODEL 和 CLAUDE_CODE_AUTO_CONNECT_IDE，Claude Code 會先讀取變數，只有在變數未設定時才使用 model 或 autoConnectIde 設定。對於您要設定的配對，請檢查下方變數的列，以及 設定參考 上的鍵項目。

當相同的變數同時在您的 shell 和設定檔 env 區塊中設定時，設定檔值會在大多數工作階段中套用。Claude Code 會將每個 env 項目寫入程序環境，取代從 shell 繼承的值。env 值如何與您的 shell 互動 涵蓋保留繼承值的工作階段，以及 env 設定 說明何時套用它們。少數變數有特殊處理；env 設定 列出例外。

在設定檔中，您可以設定變數，但無法移除變數。若要覆寫無法取消設定的變數，例如由您無法控制的 shell 設定檔匯出的過時 CLAUDE_CODE_USE_VERTEX，請在 env 區塊中將其設定為空字串："CLAUDE_CODE_USE_VERTEX": ""。Claude Code 將空值視為未設定以進行提供者選擇。子程序仍會繼承空值。

在設定檔之間，env 值遵循 設定優先順序，因此受管設定項目會覆寫使用者或專案設定中的相同變數。專案和本機設定無法設定某些變數，例如 CLAUDE_CONFIG_DIR 和 OpenTelemetry 匯出器變數。Claude Code 在 env 中忽略的變數 列出它們，以及仍然適用的 OpenTelemetry 關閉值。

環境變數如何與 CLI 旗標和工作階段內命令互動因功能而異：--model 和 /model 會覆寫 ANTHROPIC_MODEL，而 CLAUDE_CODE_EFFORT_LEVEL 會覆寫 --effort 和 /effort。當變數與另一個設定來源互動時，變數 列表中的其列會說明優先順序或連結到記錄該項目的頁面。

Claude Code 在啟動時讀取 shell 環境變數，因此對它們的變更會在您下次啟動 claude 時生效。在設定檔中 env 鍵下設定的變數會在檔案變更時重新套用到執行中的工作階段，但 在設定檔中 所述的僅啟動時例外。

變數

逾時、token 預算與重試次數等數值變數，除了純數字之外，也接受科學記號與數字分隔符號的寫法，但變數所在列註明僅接受純數字者除外。例如，Claude Code 會將 2e3 讀取為 2000，將 64_000 讀取為 64000。在 v2.1.211 之前，這些寫法可能會在無任何提示的情況下設定成小得多的值，例如 1e6 會將逾時設定為 1。

變數 用途
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 的工作區 API 金鑰，於 AWS Console 中產生。以 x-api-key 傳送，且優先於 AWS SigV4
ANTHROPIC_AWS_BASE_URL 覆寫 Claude Platform on AWS 端點 URL。用於自訂區域，或透過 LLM 閘道路由時。預設為 https://aws-external-anthropic.{region}.api.aws。Claude Code 會以與 Amazon Bedrock 相同的優先順序解析區域
ANTHROPIC_AWS_WORKSPACE_ID Claude Platform on AWS 的必要項目。會在每個請求中以 anthropic-workspace-id 標頭傳送
ANTHROPIC_BASE_URL 覆寫 API 端點，以透過代理伺服器或閘道路由請求。若設定為非第一方主機，MCP tool search 預設會停用。如果您的代理伺服器會轉送 tool_reference 區塊，請設定 ENABLE_TOOL_SEARCH=true。自 v2.1.196 起，當此變數指向 api.anthropic.com 以外的主機時，Remote Control 會停用，與其在 Amazon Bedrock、Google Cloud's Agent Platform 及 Microsoft Foundry 上的行為一致
ANTHROPIC_BEDROCK_BASE_URL 覆寫 Amazon Bedrock 端點 URL。用於自訂的 Amazon Bedrock 端點，或透過 LLM 閘道路由時。請參閱 Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL 覆寫 Amazon Bedrock Mantle 端點 URL。請參閱 Mantle 端點
ANTHROPIC_BEDROCK_REGION_PREFIX Claude Code 優先嘗試的跨區域推論設定檔前綴（us、eu、apac、jp、au 或 global），取代從 AWS 區域推導出的前綴。在 AWS GovCloud 區域中會被忽略。需要 Claude Code v2.1.224 或更新版本。請參閱 Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Amazon Bedrock 服務層級（default、flex 或 priority）。以 X-Amzn-Bedrock-Service-Tier 標頭傳送。請參閱 Amazon Bedrock
ANTHROPIC_BETAS 要包含在 API 請求中的額外 anthropic-beta 標頭值，以逗號分隔。Claude Code 已會傳送其所需的 beta 標頭；您可使用此變數，在 Claude Code 加入原生支援之前選擇加入某項 Anthropic API beta。與需要 API 金鑰身分驗證的 --betas 旗標不同，此變數適用於所有驗證方式，包括 Claude.ai 訂閱
ANTHROPIC_CUSTOM_HEADERS 要加入請求的自訂標頭（Name: Value 格式，多個標頭以換行分隔）。如果名稱或值包含 HTTP 標頭無法承載的字元，例如彎引號或零寬空格，請求會失敗，並顯示依位置指出該組名稱與值的錯誤。需要 Claude Code v2.1.227 或更新版本。無效的請求標頭值列出了確切的字元集以及檢查執行的位置。若某個值設定的是憑證、組織或租用戶、路由或 API 行為相關的標頭，例如 Authorization 或 Host，當由伺服器管理的設定傳遞時，該值會被視為需要核准的設定。若來自專案或本機設定，此類值會遵循env 值何時套用的規則
ANTHROPIC_CUSTOM_MODEL_OPTION 要在 /model 選擇器中新增為自訂項目的模型 ID。使用此變數可讓非標準或閘道專屬的模型可供選取，而不會取代內建別名。請參閱模型設定
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION /model 選擇器中自訂模型項目的顯示說明。未設定時預設為 Custom model (<model-id>)
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME /model 選擇器中自訂模型項目的顯示名稱。未設定時，如果 Claude Code 能辨識該 ID，項目會顯示模型名稱，否則顯示模型 ID
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES 自訂模型所支援的功能清單，以逗號分隔，例如 effort,thinking。請參閱模型設定
ANTHROPIC_DEFAULT_FABLE_MODEL fable 別名所解析成的模型 ID，也是 Claude Code 在第三方供應商上進行自動模型備援時辨識為 Fable 模型的 ID。請參閱模型設定
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION /model 選擇器中固定 Fable 模型的顯示說明。未設定時，該列會顯示以 Custom Fable model 開頭的預設說明。請參閱模型設定
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME /model 選擇器中固定 Fable 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱模型設定
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES 固定 Fable 模型所支援的功能清單，以逗號分隔，例如 effort,thinking。請參閱模型設定
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku 別名所解析成的模型 ID，也用於背景功能。請參閱模型設定
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION /model 選擇器中固定 Haiku 模型的顯示說明。未設定時，該列會顯示以 Custom Haiku model 開頭的預設說明。請參閱模型設定
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME /model 選擇器中固定 Haiku 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱模型設定
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES 固定 Haiku 模型所支援的功能清單，以逗號分隔，例如 effort,thinking。請參閱模型設定
ANTHROPIC_DEFAULT_MODEL 新工作階段預設啟動時使用的模型。需要 Claude Code v2.1.236 或更新版本。請參閱為新工作階段設定預設模型
ANTHROPIC_DEFAULT_OPUS_MODEL opus 別名所解析成的模型 ID，也是 opusplan 在 Plan Mode 啟用時使用的模型。請參閱模型設定
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION /model 選擇器中固定 Opus 模型的顯示說明。未設定時，該列會顯示以 Custom Opus model 開頭的預設說明。請參閱模型設定
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME /model 選擇器中固定 Opus 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱模型設定
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES 固定 Opus 模型所支援的功能清單，以逗號分隔，例如 effort,thinking。請參閱模型設定
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet 別名所解析成的模型 ID，也是 opusplan 在 Plan Mode 未啟用時使用的模型。請參閱模型設定
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION /model 選擇器中固定 Sonnet 模型的顯示說明。未設定時，該列會顯示以 Custom Sonnet model 開頭的預設說明。請參閱模型設定
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME /model 選擇器中固定 Sonnet 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱模型設定
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES 固定 Sonnet 模型所支援的功能清單，以逗號分隔，例如 effort,thinking。請參閱模型設定
ANTHROPIC_FEDERATION_RULE_ID Workload Identity Federation 的聯合規則 ID。當您將其與 ANTHROPIC_ORGANIZATION_ID 一起設定時，Claude Code 會選用聯合憑證，其優先順序高於您的 /login 憑證。請參閱身分驗證優先順序
ANTHROPIC_FOUNDRY_API_KEY 用於 Microsoft Foundry 身分驗證的 API 金鑰（請參閱 Microsoft Foundry）
ANTHROPIC_FOUNDRY_AUTH_TOKEN 用於 Microsoft Foundry 身分驗證的 Bearer token，例如 Microsoft Entra 存取 token。Claude Code 會將其以 Authorization: Bearer 標頭傳送。優先於 ANTHROPIC_FOUNDRY_API_KEY 及 Azure 預設憑證鏈。請參閱 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）
ANTHROPIC_FOUNDRY_RESOURCE Microsoft Foundry 資源名稱（例如 my-resource）。若未設定 ANTHROPIC_FOUNDRY_BASE_URL 則為必要項目（請參閱 Microsoft Foundry）
ANTHROPIC_MODEL 要使用的模型設定名稱（請參閱模型設定）
ANTHROPIC_ORGANIZATION_ID Workload Identity Federation 的組織 ID。請將其與 ANTHROPIC_FEDERATION_RULE_ID 一起設定。請參閱身分驗證優先順序
ANTHROPIC_PROFILE 用於身分驗證的 Anthropic 設定檔名稱，例如由 ant auth login 建立的設定檔，或不使用 API 金鑰登入 Console 帳戶時建立的設定檔。請參閱身分驗證優先順序
ANTHROPIC_SMALL_FAST_MODEL [已棄用] 用於背景任務的 Haiku 級模型名稱
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 模型或主要模型執行背景任務
ANTHROPIC_VERTEX_BASE_URL 覆寫 Google Cloud's Agent Platform 端點 URL。用於自訂的 Google Cloud's Agent Platform 端點，或透過 LLM 閘道路由時。請參閱 Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID Google Cloud's Agent Platform 請求所指向的 GCP 專案 ID。請參閱設定 GCP 憑證
ANTHROPIC_WORKSPACE_ID Workload Identity Federation 的工作區 ID。當您的聯合規則範圍涵蓋多個工作區時請設定此變數，讓 token 交換得知要以哪個工作區為目標
API_FORCE_IDLE_TIMEOUT 覆寫 5 分鐘的主體閒置逾時；當沒有任何位元組抵達時，此逾時會中止串流模型回應。設定為 0 可關閉此逾時，例如當速度較慢的閘道或本機模型在區塊之間暫停超過 5 分鐘時；設定為 1 則可讓所有供應商都保持開啟。未設定時，此逾時會在直接 Anthropic API、Claude Platform on AWS，以及設定了 CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 的 Amazon Bedrock 以外的供應商上啟用。串流監控程式與其獨立運作，即使您在此設定 0，仍會中止長時間無回應的暫停
API_TIMEOUT_MS API 請求的逾時時間，以毫秒為單位（預設：600000，即 10 分鐘；最大值：2147483647）。當請求在速度較慢的網路上逾時，或透過代理伺服器路由時，請提高此值。超過最大值會導致底層計時器溢位，使請求立即失敗
AWS_BEARER_TOKEN_BEDROCK 用於身分驗證的 Amazon Bedrock API 金鑰（請參閱 Amazon Bedrock API 金鑰）
BASH_DEFAULT_TIMEOUT_MS 前景 Bash 或 PowerShell 工具命令的預設逾時，以毫秒為單位（預設：120000，即 2 分鐘）。超過 30 分鐘的預設值也會成為背景命令時間限制的預設值。背景時間限制需要 Claude Code v2.1.285 或更新版本
BASH_MAX_OUTPUT_LENGTH Claude Code 讀回命令結果中的 bash 輸出最大字元數（預設：30000；最大值：150000）。如果您設定了 bashOutputMaxChars 設定，Claude Code 會忽略此變數。請參閱輸出限制
BASH_MAX_TIMEOUT_MS 模型可為前景 Bash 或 PowerShell 工具命令設定的最大逾時，以毫秒為單位（預設：600000，即 10 分鐘）。有效上限為此值與 BASH_DEFAULT_TIMEOUT_MS 中較大者。超過 2 小時的有效上限也會成為背景命令時間限制的最大值。背景時間限制需要 Claude Code v2.1.285 或更新版本
BETA_TRACING_ENDPOINT 詳細 beta 追蹤的 OTLP 端點：搭配 ENABLE_BETA_TRACING_DETAILED=1 時，日誌與追蹤會傳送至此處，而非已設定的匯出器。請在您的 shell、使用者設定或受管設定中設定。在專案與本機設定中會被忽略
CCR_FORCE_BUNDLE 設定為 1 可強制 claude --cloud 打包並上傳您的本機儲存庫，而非從其遠端複製
CLAUDECODE 在 Claude Code 產生的子程序中設定為 1（Bash 與 PowerShell 工具、tmux 工作階段、hook 命令、狀態列命令、stdio MCP 伺服器子程序）。IDE 擴充功能也會在其整合式終端機中設定此變數。可用來偵測腳本是否在 Claude Code 產生的子程序中執行。若要檢查目前程序是否由工具呼叫或 hook 直接產生，而非在 Claude Code 啟動的 stdio MCP 伺服器內，請改用 CLAUDE_CODE_CHILD_SESSION
CLAUDE_AFK_COUNTDOWN_MS 在未回答的 AskUserQuestion 對話方塊自動繼續之前多少毫秒顯示螢幕上的倒數計時。預設為 20000（20 秒），上限為自動繼續逾時。除非開啟自動繼續，否則不會有任何作用；請參閱 askUserQuestionTimeout 設定與 CLAUDE_AFK_TIMEOUT_MS。需要 Claude Code v2.1.198 或更新版本
CLAUDE_AFK_TIMEOUT_MS 未回答的 AskUserQuestion 對話方塊在閒置多少毫秒後，不等待您而自動繼續。自動繼續預設為關閉；請透過 askUserQuestionTimeout 設定選擇加入。此變數是供示範與自動化測試使用的覆寫：設定後，它會優先於該設定，即使該設定未設定或為 never，也會開啟自動繼續。設定 0 並不會關閉逾時，而是會立即關閉對話方塊。在 v2.1.198 與 v2.1.199 中，自動繼續預設為開啟，逾時為 60000（60 秒）。需要 Claude Code v2.1.198 或更新版本
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS 設定為 1 可停用所有內建的 subagent 類型，例如 Explore 與 Plan。僅適用於非互動模式（-p 旗標）。適合想要從零開始的 SDK 使用者。這也會移除 general-purpose，也就是當 Agent 工具呼叫省略 subagent_type 時 Claude Code 執行的 subagent。此類呼叫接著會以 subagent_type is required 失敗
CLAUDE_AGENT_SDK_MCP_NO_PREFIX 設定為 1 可略過由 SDK 建立的 MCP 伺服器工具名稱上的 mcp__<server>__ 前綴。工具會使用其原始名稱。僅限 SDK 使用
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS subagent 的停滯逾時，以毫秒為單位。預設為 600000（10 分鐘）；如果您在串流監控程式開啟時提高 CLAUDE_STREAM_IDLE_TIMEOUT_MS，預設值會隨之提高，如處理緩慢或停滯的 API 回應所述。計時器會在每個串流進度事件時重設；若在此時間範圍內沒有收到任何進度，Claude Code 會中止該 subagent，並向上層回報停滯
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 設定觸發自動壓縮時所佔自動壓縮視窗的百分比（1-100）。使用較低的值（例如 50）可更早壓縮；此變數無法提高閾值，因此高於預設百分比的值會被忽略。僅適用於在模型上下文限制之前壓縮的工作階段。同時適用於主要對話與 subagent
CLAUDE_AUTO_BACKGROUND_TASKS 設定為 1 可強制啟用長時間執行的 agent 任務自動移至背景的功能。啟用後，subagent 在執行約兩分鐘後會被移至背景。在 Claude Code v2.1.212 或更新版本中，也會在非互動模式中啟用長時間 MCP 工具呼叫的自動背景化
CLAUDE_AX_PREPARK_MS 在螢幕閱讀器模式中，Claude Code 在寫入新的或已變更的行之前等待的毫秒數。預設為 0，因此 Claude Code 不會等待。在 v2.1.287 之前，預設值為 50。Claude Code 將等待時間上限設為 5000。需要 Claude Code v2.1.233 或更新版本
CLAUDE_AX_SCREEN_READER 設定為 1 可輸出對螢幕閱讀器友善的內容：不含裝飾性邊框或動畫的平面文字。設定為 0 可強制關閉螢幕閱讀器模式，即使 axScreenReader 為 true 亦然。--ax-screen-reader 旗標優先。需要 Claude Code v2.1.181 或更新版本
CLAUDE_AX_STARTUP_QUIET_MS 在螢幕閱讀器模式中，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 行動推播通知，讓您在主動使用電腦時不再收到推播。當檔案不存在或無法讀取時，通知會照常傳送。Claude Code 會在每次觸發推播的事件時檢查該檔案一次，而非輪詢。需要 Claude Code v2.1.181 或更新版本
CLAUDE_CODE_ACCESSIBILITY 設定為 1 可保持原生終端機游標可見，並停用反白文字游標指示器。讓 macOS Zoom 等螢幕放大鏡能追蹤游標位置
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 可在全螢幕轉譯中每一幀都重繪整個螢幕，而非傳送增量更新。如果全螢幕模式顯示過時或錯位的文字片段，請使用此設定。Claude Code 會在 Windows 上的背景工作階段與 agent view 中自動啟用此設定
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 設定為 1 可在每個請求中傳送 effort 參數，即使 Claude Code 無法將模型 ID 辨識為支援 effort 的模型亦然。當您透過 LLM 閘道或以自訂識別碼提供模型的第三方供應商路由時，請使用此設定。在 API 端拒絕 effort 參數的模型，包括 Claude 3 模型、Sonnet 4.0 與 4.5、Opus 4.0 與 4.1，以及 Haiku 4.5，仍會被排除，以免請求失敗
CLAUDE_CODE_API_KEY_HELPER_TTL_MS 重新整理憑證的間隔，以毫秒為單位（使用 apiKeyHelper 時）
CLAUDE_CODE_ARTIFACT_AUTO_OPEN 設定為 0 可在發佈新 artifact 時，阻止 Claude Code 自動開啟瀏覽器
CLAUDE_CODE_ARTIFACT_COMMENTS 設定為 0 可阻止 Claude 讀取與回覆 artifact 上的留言。當 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 已關閉 artifact 時不會有任何作用。需要 Claude Code v2.1.221 或更新版本
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT 設定為 0 可阻止 Claude 自行回覆傳送給它的留言。需要 Claude Code v2.1.228 或更新版本
CLAUDE_CODE_ATTRIBUTION_HEADER 設定為 0 可從系統提示詞開頭省略歸屬區塊，該區塊包含用戶端版本與提示詞指紋。無論如何設定，直接連線至 Anthropic API 時的快取都不受影響。在某些直接連線設定中，即使您設定 0，Claude Code 仍會在自動模式分類器請求中保留此區塊。請在系統提示詞歸屬區塊中查看此情況涵蓋哪些連線與憑證。在 v2.1.181 之前，此區塊在自訂基礎 URL 與 Microsoft Foundry 連線上包含每個請求各自的 token，因此在那些版本中，當您的 LLM 閘道依請求主體進行快取或將請求轉送至第三方供應商時，或當您直接連線至 Microsoft Foundry 時，請將其設定為 0
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS 啟用 CLAUDE_AUTO_BACKGROUND_TASKS 時，提醒 Claude 檢查仍在執行的背景 subagent 的間隔秒數。僅接受 1 至 86400 的純整數；任何其他值或寫法都會視為未設定。未設定時不會有檢查提醒。需要 Claude Code v2.1.248 或更新版本
CLAUDE_CODE_AUTO_COMPACT_WINDOW 以 token 為單位設定自動壓縮視窗，範圍為 100000 至 1000000。僅接受純整數，例如 500000：像 500k 這樣的值會被讀取為 500，並被限制至 100K 的最小值。有效視窗也會受限於模型的上下文視窗。優先於 /autocompact 命令、--autocompact 旗標與 autoCompactWindow 設定。狀態列的 used_percentage 一律以模型的完整上下文視窗衡量，因此一旦設定此變數，該百分比便不再能表示何時會執行壓縮
CLAUDE_CODE_AUTO_CONNECT_IDE 覆寫自動 IDE 連線。預設情況下，在受支援 IDE 的整合式終端機中啟動時，Claude Code 會自動連線。設定為 false 可防止此行為。設定為 true 可在自動偵測失敗時強制嘗試連線，例如當 tmux 遮蔽了上層終端機時。優先於 autoConnectIde 全域設定
CLAUDE_CODE_AUTO_MODE_SERVER 控制 Claude Code 是否請伺服器審查自動模式動作。設定為 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 失敗（預設：60000）。當您的憑證鏈中某個步驟確實需要更長時間時，請提高此值，例如透過 aws-vault 等包裝工具進行以瀏覽器為基礎、搭配 MFA 的 SSO 登入。適用於 Claude Code 使用預設憑證鏈簽署的所有情況：Amazon Bedrock、Claude Platform on AWS 與 Mantle 端點。需要 Claude Code v2.1.207 或更新版本
CLAUDE_CODE_BASH_EDIT_DIFF 設定為 0 可關閉Bash 命令執行期間變更之檔案的差異，設定為 1 則可在每種權限模式中記錄它。優先於 bashEditDiffEnabled 設定。需要 Claude Code v2.1.269 或更新版本
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING 設定為 0 可讓非互動工作階段在每個回合結束時向其主機回報閒置狀態，即使背景工作仍在執行亦然。預設情況下，當背景 agent 或工作流程執行等背景工作仍在進行時，工作階段在回合結束後會持續回報執行中狀態。這可避免監看狀態的主機（例如遠端工作階段清單）在工作進行中宣告 Claude 正在等待您的輸入。背景 shell 命令（例如開發伺服器）不會維持執行中狀態。執行中狀態的預設行為與 0 選擇退出需要 Claude Code v2.1.269 或更新版本；在較早版本中，請設定 1 以維持執行中狀態
CLAUDE_CODE_BRIDGE_SESSION_ID 當工作階段有作用中的 Remote Control 連線時，會在 Bash 工具與 hook 命令子程序中自動設定，並在連線結束時移除。其值為 session_ 形式的工作階段 ID，與工作階段的 claude.ai/code URL 中出現的識別碼相同，因此腳本可以連結回執行它的工作階段。需要 Claude Code v2.1.199 或更新版本。在雲端工作階段中，請改為讀取 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。若在 Windows 終端機中 Backspace 會刪除整個單字，請設定 0
CLAUDE_CODE_CERT_STORE TLS 連線的 CA 憑證來源清單，以逗號分隔。bundled 是隨 Claude Code 提供的 Mozilla CA 集。system 是作業系統的信任存放區，僅在具備 tls.getCACertificates 的執行環境中讀取：原生二進位檔，或 npm 安裝時的 Node 22.15 或更新版本。請參閱 CA 憑證存放區。預設為 bundled,system
CLAUDE_CODE_CHILD_SESSION 在 Claude Code 透過 Bash、PowerShell 與 Monitor 工具、hook 命令及狀態列命令產生的子程序中設定為 1。不會為 stdio 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 旗標可同時完成這兩件事。預設為 ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL 寫入偵錯日誌檔案的最低日誌等級。值：verbose、debug（預設）、info、warn、error。設定為 verbose 可包含大量診斷資訊，例如完整的狀態列命令輸出；或提高至 error 以減少雜訊
CLAUDE_CODE_DISABLE_1M_CONTEXT 設定為 1 可停用 1M 上下文視窗支援。設定後，模型選擇器中將無法使用 1M 模型變體，且 Claude Code 會將使用原生 1M 視窗模型（例如 Sonnet 5.5 與 Fable 模型）的工作階段限制在 200K 視窗；關於此限制如何強制執行，請參閱延伸上下文。適用於有合規要求的企業環境。關於其在修正無法辨識之 [1m] 模型 ID 視窗方面的作用，請參閱修正閘道或自訂模型 ID 的視窗
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 設定為 1 可在 Opus 4.6 與 Sonnet 4.6 上停用自適應推理，並改用由 MAX_THINKING_TOKENS 控制的固定思考預算。對 Fable 模型、Sonnet 5 及更新版本，或 Opus 4.7 及更新版本沒有作用，這些模型一律使用自適應推理
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION 設定為 1 可阻止 Claude Code 在各管理來源之間逐鍵合併受管設定的 env 區塊，如此只會套用最高優先順序來源的整個 env 區塊，與 v2.1.223 之前相同。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 env 區塊傳遞的副本。需要 Claude Code v2.1.223 或更新版本
CLAUDE_CODE_DISABLE_ADVISOR_TOOL 設定為 1 可停用 advisor 工具。/advisor 命令將無法使用，任何已設定的 advisorModel 都會被忽略，而 --advisor 旗標仍會被接受但沒有作用，因此傳遞此旗標的現有腳本可以繼續正常運作而不會出錯
CLAUDE_CODE_DISABLE_AGENT_VIEW 設定為 1 可關閉背景 agent 與 agent view：claude agents、--bg、/background 以及隨需監督程式。等同於 disableAgentView 設定
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN 設定為 1 可停用全螢幕轉譯，並使用傳統的主畫面轉譯器。對話會保留在終端機的原生捲動緩衝區中，因此 Cmd+f 與 tmux 複製模式會照常運作。優先於 CLAUDE_CODE_NO_FLICKER 與 tui 設定。您也可以使用 /tui default 切換。不適用於從 agent view 開啟的背景工作階段，這些工作階段一律使用全螢幕轉譯
CLAUDE_CODE_DISABLE_ARTIFACT 設定為 1 可關閉 Artifact 工具，該工具會將工作階段輸出發佈為 claude.ai 上的私人網頁。一旦設定，任何設定檔都無法重新開啟此工具。若要改從設定檔關閉此工具，請將 enableArtifact 設定為 false；已棄用的 disableArtifact 鍵也能將其關閉
CLAUDE_CODE_DISABLE_ATTACHMENTS 設定為 1 可停用附件處理。使用 @ 語法的檔案提及會以純文字傳送，而不會展開為檔案內容
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK 設定為 1 可讓 Claude Code 程序自行執行其 gcpAuthRefresh 或 awsAuthRefresh 命令，而非在另一個程序執行時等待。需要 Claude Code v2.1.286 或更新版本
CLAUDE_CODE_DISABLE_AUTO_MEMORY 設定為 1 可停用自動記憶。設定為 0 可強制開啟自動記憶，即使 --bare 模式或 autoMemoryEnabled: false 原本會停用它亦然。停用後，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 串流回應視為 Amazon Bedrock 的二進位事件串流。預設情況下，Claude Code 會假設是閘道從原本未經修改的回應中移除了該標頭，因此會解碼主體，讓串流持續運作。只有當閘道也將串流重新發送為伺服器推送事件時才設定此變數；此時 Claude Code 會改將無標頭的主體讀取為伺服器推送事件。需要 Claude Code v2.1.239 或更新版本
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD 設定為 1 可略過檢查 Amazon Bedrock 串流回應是否帶有 application/vnd.amazon.eventstream content-type。若未設定此變數，當回應帶有不同的 content-type 時，Claude Code 會讓請求失敗，並顯示指出該類型的錯誤，這表示有閘道或代理伺服器正在轉換回應。請將閘道設定為不經修改地轉送 Content-Type 標頭與主體，而非設定此變數。需要 Claude Code v2.1.208 或更新版本
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF 設定為 1 可在監督程式停止、重新啟動或更新背景工作階段的程序時，停止該工作階段正在執行的背景 shell 命令、動態工作流程，以及自 v2.1.198 起的背景 subagent，而不是將它們移交給該工作階段的下一個程序。僅影響該移交：使用 ← 或 /background 將工作階段移至背景時，仍會帶過進行中的工作，而 CLAUDE_DISABLE_ADOPT 會同時關閉兩者。需要 Claude Code v2.1.196 或更新版本
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 設定為 1 可阻止 Claude Code 在記憶體壓力下終止背景 shell 命令。預設情況下，在 macOS 與 Linux 上，當作業系統回報嚴重記憶體壓力，且工作階段已閒置 30 分鐘、沒有任何回合或 subagent 正在執行時，Claude Code 會終止背景 shell。Windows 沒有記憶體壓力訊號，因此此變數在該平台上沒有作用。需要 Claude Code v2.1.193 或更新版本
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 設定為 1 可停用 Claude Code 隨附的 skill 與工作流程：隨附 skill 與工作流程會被完全移除，而 /init 等內建命令仍可輸入，但會對模型隱藏。/doctor 與內建命令一樣仍可輸入；若要隱藏它，請改用 DISABLE_DOCTOR_COMMAND。來自外掛、.claude/skills/ 與 .claude/commands/ 的 skill 不受影響。等同於 disableBundledSkills 設定
CLAUDE_CODE_DISABLE_CFC_PROMPT 設定為 1 可保留 Claude in Chrome 瀏覽器工具，同時省略系統提示詞中的 Chrome 區段以及 /claude-in-chrome 隨附 skill。適用於內嵌 Claude Code 並提供自己瀏覽器指引的主機。需要 Claude Code v2.1.257 或更新版本
CLAUDE_CODE_DISABLE_CLAUDE_MDS 設定為 1 可防止將任何 CLAUDE.md 記憶檔案載入上下文，包括使用者、專案與自動記憶檔案
CLAUDE_CODE_DISABLE_CRON 設定為 1 可停用排程任務。/loop skill 與 cron 工具將無法使用，任何已排程的任務都會停止觸發，包括已在工作階段中途執行的任務
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT 設定為 1 可關閉關鍵路徑移除提示的時間限制。在 auto 模式中，Claude Code 會改將這些移除操作傳送給分類器；在 bypassPermissions 模式中，提示會等待您的回答。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 env 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 設定為 1 可從 API 請求中移除 Anthropic 專屬的 anthropic-beta 請求標頭與 beta 工具結構描述欄位（例如 defer_loading 與 eager_input_streaming）。當代理伺服器閘道以「Unexpected value(s) for the anthropic-beta header」或「Extra inputs are not permitted」等錯誤拒絕請求時，請使用此設定。標準欄位（name、description、input_schema、cache_control）會保留。MCP tool search 會停用，且所有 MCP 工具都會預先載入，即使您設定了 ENABLE_TOOL_SEARCH 亦然。在 Claude Code v2.1.227 或更新版本中，受管設定可以讓 tool search 保持開啟。停用預先發行功能說明了此覆寫適用的範圍
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS 設定為 1 可停用內建的 Explore 與 Plan subagent。Claude 會改用其搜尋工具或 general-purpose subagent 進行探索，而 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 可停用快速模式
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 設定。請參閱工作階段品質問卷
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING 設定為 1 可停用檔案檢查點功能。/rewind 命令將無法還原程式碼變更。覆寫 fileCheckpointingEnabled 設定
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 設定為 1 可從 Claude 的上下文中移除內建的提交與 PR 工作流程指令，以及 git 狀態快照。適用於使用您自己的 git 工作流程 skill 的情況。設定後，優先於 includeGitInstructions 設定
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP 設定為 1 可防止在 Anthropic API 上將 Opus 4.0 與 4.1 自動重新對應至目前的 Opus 版本。當您刻意想固定使用較舊的模型時使用。此重新對應不會在 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 上執行
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK 設定為 1 可阻止 Amazon Bedrock 與 Google Cloud's Agent Platform 上的 Claude Code 在您的帳戶於工作階段中途失去該工作階段模型的存取權時切換至較舊的模型；被拒絕的請求會改為立即失敗。您設定的備援模型鏈仍會在該拒絕時切換，而啟動時的模型檢查仍會在啟動時改用備援模型。需要 Claude Code v2.1.285 或更新版本
CLAUDE_CODE_DISABLE_MOUSE 設定為 1 可在全螢幕轉譯中停用滑鼠追蹤。使用 PgUp 與 PgDn 的鍵盤捲動仍可運作。使用此設定可保留終端機原生的選取即複製行為
CLAUDE_CODE_DISABLE_MOUSE_CLICKS 設定為 1 可在全螢幕轉譯中停用點擊、拖曳與懸停處理，同時保留滑鼠滾輪捲動。當您希望滾輪捲動在 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 用戶端憑證與金鑰。停用重新載入後，Claude Code 只會在下次套用設定時或下次啟動時載入輪替後的檔案。需要 Claude Code v2.1.232 或更新版本
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 設定為任何非空值（例如 1）可停用非必要的網路流量：自動更新、遙測、錯誤回報、/feedback 命令、Claude 草擬的意見回饋、版本資訊、PR 與 MR 狀態徽章檢查，以及快速模式檢查等可用性檢查。它也會停止外掛 command 來源的背景執行，這些是本機命令而非網路流量，但因為它們可能觸發相依套件安裝而一併停止。將其設定為 0 或 false 仍會停用此流量，這與大多數開關變數不同；請取消設定該變數以重新允許。也會停用功能旗標擷取，這會使 Remote Control 以及其他需要功能旗標擷取的功能無法使用。官方外掛市集的自動安裝不在涵蓋範圍內；請使用 CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL 將其停用。不影響閘道模型探索，該功能有自己的選擇加入機制
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK 設定為 1 可在串流請求於串流中途失敗時停用非串流備援。串流錯誤會改為傳遞至重試層。適用於代理伺服器或閘道導致備援產生重複工具執行的情況
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK 設定為 1 可讓 PushNotification 工具的桌面通知即使在您於終端機中輸入或焦點在終端機上時仍會傳送。預設情況下，當工具偵測到近期的鍵盤活動或終端機焦點時，會同時略過桌面通知與行動推播。此變數僅停用該本機檢查，因此當伺服器偵測到您處於活動狀態時，仍可抑制行動推播。需要 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 設定為 1 可在 Claude Code 將未回應的權限請求傳送至 Agent SDK 的 canUseTool 回呼的工作階段中（這是 Claude Desktop 與 VS Code 擴充功能承載 Claude Code 的方式），阻止 Claude Code 執行您針對未回應權限請求的 Notification hook。在終端機工作階段中沒有作用。需要 Claude Code v2.1.233 或更新版本
CLAUDE_CODE_DISABLE_POLICY_SKILLS 設定為 1 可略過從全系統受管 skill 目錄載入 skill。適用於不應載入由營運人員佈建之 skill 的容器或 CI 工作階段
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY 設定為 1 可關閉 PowerShell 工具的檢查，該檢查會拒絕在系統路徑（例如磁碟機根目錄或您的家目錄）上使用 cmd 內建命令 rd、rmdir、del 與 erase。Claude Code 會忽略設定檔 env 區塊中的此變數。需要 Claude Code v2.1.283 或更新版本
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT 設定為 1 可關閉針對目標完全是命令替換輸出之遞迴 rm（例如 rm -rf "$(pwd)"）的關鍵路徑檢查。其他關鍵路徑檢查會持續執行。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 env 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本
CLAUDE_CODE_DISABLE_TERMINAL_TITLE 設定為 1 可停用根據對話上下文自動更新終端機標題。這也會略過用來產生工作階段標題的背景小型/快速模型請求
CLAUDE_CODE_DISABLE_THINKING 設定為 1 可從 API 請求中完全省略 thinking 參數。這是針對會拒絕此參數之代理伺服器與閘道的相容性選項。在預設會思考的模型上，省略此參數意味著模型仍可能思考。若要在 Anthropic API 上明確停用延伸思考，請改用 MAX_THINKING_TOKENS=0。這兩個變數都無法在 Opus 5.5、Sonnet 5.5 或 Fable 模型上關閉思考，因為這些模型無法關閉思考。在第三方供應商上，MAX_THINKING_TOKENS=0 同樣會省略此參數，因此這兩個變數在那裡的行為相同
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT 設定為 1 可在 Claude Code 無法辨識模型 ID（例如 LLM 閘道別名）時略過主動自動壓縮。若未設定此變數，Claude Code 會在其為該 ID 假設的上下文視窗處進行壓縮。CLAUDE_CODE_MAX_CONTEXT_TOKENS 可以改為修正假設的視窗；關於各變數的適用時機，請參閱修正閘道或自訂模型 ID 的視窗。需要 Claude Code v2.1.223 或更新版本
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL 設定為 1 可在全螢幕轉譯中停用虛擬捲動，並轉譯逐字稿中的每則訊息。如果在全螢幕模式中捲動時，原本應顯示訊息之處出現空白區域，請使用此設定
CLAUDE_CODE_DISABLE_WEB_FETCH 設定為 1 可關閉 WebFetch 工具。WebSearch 工具仍可使用。需要 Claude Code v2.1.285 或更新版本
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER 設定為 1 可在 Windows 上直接啟動 PowerShell 工具命令，而非透過 cmd.exe 啟動器。預設情況下，啟動器可讓在背景執行的 PowerShell 命令延續至工作階段的下一個程序，例如當您將工作階段移至背景時。如果您設定此變數，背景化的 PowerShell 命令會在工作階段的程序結束時停止。Bash 命令不受影響。需要 Claude Code v2.1.269 或更新版本
CLAUDE_CODE_DISABLE_WORKFLOWS 設定為 1 可停用工作流程。等同於 disableWorkflows 設定
CLAUDE_CODE_EFFORT_LEVEL 為支援的模型設定 effort 等級。值：low、medium、high、xhigh、max，或 auto 以使用模型預設值。可用的等級取決於模型。優先於 --effort、/effort 以及 modelSettings 與 effortLevel 設定。maxEffortLevel 上限仍然適用。請參閱調整 effort 等級
CLAUDE_CODE_ENABLE_AUTO_MODE 為了與較舊版本相容而接受，但沒有作用。自動模式預設在所有供應商上都可使用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry，以及已登入的 Claude apps 閘道工作階段。在 v2.1.158 至 v2.1.206 中，必須將此變數設定為 1，才能在這些供應商上使用自動模式
CLAUDE_CODE_ENABLE_AWAY_SUMMARY 覆寫工作階段摘要的可用性。設定為 0 可強制關閉摘要，不論 /config 切換開關為何。設定為 1 可在 awaySummaryEnabled 為 false 時強制開啟摘要。優先於該設定與 /config 切換開關
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH 設定為 1 可在非互動模式中，於背景安裝完成後在回合邊界重新整理外掛狀態。預設為關閉，因為重新整理會在工作階段中途變更系統提示詞，導致該回合的提示快取失效
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL 設定為 1，可在傳送至 Anthropic 的非必要流量遭封鎖時，將「How is Claude doing?」工作階段品質問卷導向您自己的 OpenTelemetry collector。問卷評分僅會以 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 與閘道連線上預設為關閉
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 設定為 1，可在 ANTHROPIC_BASE_URL 指向與 Anthropic 相容的閘道（例如 LiteLLM、Kong 或內部代理伺服器）時，從閘道的 /v1/models 端點填入 /model 選擇器。預設為關閉，因為若閘道以共用 API 金鑰為後盾，否則會向每位使用者顯示該金鑰可存取的所有模型。探索到的模型仍會依工作階段收到的 availableModels 允許清單進行篩選；請透過 MDM 或受管設定檔提供該清單，因為閘道設定不支援伺服器受管的傳遞方式
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE 已於 v2.1.142 移除，當時快速模式的預設模型從 Opus 4.6 改為 Opus 4.7
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 設定為 false 可關閉提示詞建議，也就是出現在提示詞輸入框中的灰色預測。優先於 promptSuggestionEnabled 設定，即 /config 中 Prompt suggestions 切換開關所寫入的設定。Claude Code 也會在您的帳戶接近或已達用量上限時暫停建議。設定為 true 可讓建議持續開啟，直到您達到上限為止。需要 Claude Code v2.1.238 或更新版本。請參閱提示詞建議
CLAUDE_CODE_ENABLE_TASKS 選擇 Claude Code 在具備任務追蹤工具的工作階段中提供哪些任務追蹤工具。預設情況下，Claude Code 提供 Task 工具 TaskCreate、TaskUpdate、TaskGet 與 TaskList。設定為 0 可改為取得舊版 TodoWrite 工具。請參閱任務清單
CLAUDE_CODE_ENABLE_TELEMETRY 設定為 1 以啟用 OpenTelemetry 的指標與日誌資料收集。設定 OTel 匯出器之前必須先設定此變數。請在您的 shell、使用者設定或受管設定中設定。在專案與本機設定中會被忽略。請參閱監控
CLAUDE_CODE_ENABLE_TODO_TOOLS 設定為 1 以在每個模型上取得任務追蹤工具。若未設定，Claude Code 預設只會在 Task 工具可用性下列出的模型上提供這些工具。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 teams。Agent teams 為實驗性功能，預設為停用
CLAUDE_CODE_EXTRA_BODY 要合併至每個 API 請求主體最上層的 JSON 物件。適用於傳遞 Claude Code 未直接公開的供應商特定參數。在 shell 中 export 的值也會套用至您以 claude agents 或 --bg 分派的背景工作階段。在 v2.1.206 之前，背景工作階段會忽略 shell export 的值，並使用背景監督程序所繼承的任何副本
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS 覆寫檔案讀取的預設 token 上限。適用於需要完整讀取較大檔案時
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE 設定為 1，即使此 claude 是從另一個 Claude Code 工作階段內部啟動，也會強制保存逐字稿、提示詞歷史記錄以及 claude agents 註冊。當繼承的 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 同步輸出。適用於 Emacs eat 等實作了 BSU/ESU 但不回應功能探測的模擬器。在 tmux 下沒有效果。與切換至全螢幕呈現的 CLAUDE_CODE_NO_FLICKER 不同，此變數不會變更呈現器
CLAUDE_CODE_FORK_SUBAGENT 控制 fork 模式，此模式讓 Claude 能自行產生 forked subagent，且預設僅在互動式工作階段中開啟。設定為 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 的文字與思考區塊，行為與 --forward-subagent-text 旗標相同。當執行框架叫用 claude 且無法自行傳遞旗標時，請使用此變數。旗標在「搭配 stream-json 輸出的非互動模式」以外使用時會以錯誤結束，而此變數在這些情況下會被忽略，因此在整個程序範圍設定此變數時，巢狀叫用仍可正常運作。需要 Claude Code v2.1.211 或更新版本
CLAUDE_CODE_GATEWAY_HINT_HEADERS 設定為 1，可在自訂代理伺服器或第三方供應商（例如 Amazon Bedrock 或 Claude Platform on AWS）上傳送閘道提示標頭，例如 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 開啟的閘道模型探索請求之逾時時間（毫秒）（預設：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 設定
CLAUDE_CODE_GLOB_HIDDEN 設定為 false，可在 Claude 叫用 Glob 工具時將 dotfile 排除於結果之外。預設會包含。不影響 @ 檔案自動完成、ls、Grep 或 Read
CLAUDE_CODE_GLOB_NO_IGNORE 設定為 false 可讓 Glob 工具遵循 .gitignore 模式。預設情況下，Glob 會傳回所有相符的檔案，包括被 gitignore 的檔案。不影響 @ 檔案自動完成，後者有自己的 respectGitignore 設定
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Glob 工具檔案探索的逾時時間（秒）。在大多數平台上預設為 20 秒，在 WSL 上為 60 秒
CLAUDE_CODE_GOAL_CHECKIN_MINUTES 背景工作可讓作用中的目標等待多少分鐘，超過後 Claude Code 會要求 Claude 檢查其狀態。預設為 30。設定 0 可關閉檢查。請以純數字提供整數分鐘，最多 10080，也就是一週。Claude Code 會將其他任何值視為未設定並使用預設值。需要 Claude Code v2.1.234 或更新版本
CLAUDE_CODE_HIDE_CWD 設定為 1 可在啟動 logo 中隱藏工作目錄。適用於路徑會暴露您作業系統使用者名稱的螢幕分享或錄影情境
CLAUDE_CODE_IDE_HOST_OVERRIDE 覆寫用來連線至 IDE 擴充功能的主機位址。預設情況下，Claude Code 會自動偵測正確的位址，包括 WSL 至 Windows 的路由
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL 設定為 1 以略過 IDE 擴充功能的自動安裝。相當於將 autoInstallIdeExtension 設定為 false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK 設定為 1 以在連線時略過 IDE lockfile 項目的驗證。當 IDE 正在執行但自動連線仍找不到它時使用
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 一個工作階段中可同時執行多少個 subagent，超過後 Agent 工具會拒絕再產生新的 subagent（預設：20）。接受以純數字表示的正整數；其他任何值都會被忽略，因此此變數可以調整上限，但無法停用上限。需要 Claude Code v2.1.217 或更新版本
CLAUDE_CODE_MAX_CONTEXT_TOKENS 覆寫 Claude Code 為作用中模型所假設的上下文視窗大小。自 v2.1.193 起，其套用方式取決於 Claude Code 如何解析模型 ID；請參閱修正閘道或自訂模型 ID 的視窗。當透過 ANTHROPIC_BASE_URL 路由至某個模型，而其上下文視窗與該名稱的內建大小不符時使用
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Claude Code 傳送給模型的每個 MCP 工具描述及每個 MCP 伺服器指令的最大長度（字元數）（預設：2048）。Claude Code 會截斷較長的文字。接受以純數字表示的正整數。其他任何值都會被忽略並套用預設值。需要 Claude Code v2.1.280 或更新版本
CLAUDE_CODE_MAX_OUTPUT_TOKENS 設定大多數請求的最大輸出 token 數。預設值與上限因模型而異；請參閱最大輸出 token。Claude Code 會將超過模型上限的值降為該上限。對於 Claude Code 無法解析為已知模型的模型 ID，預設值為 32000，上限為 128000。增加此值會減少觸發自動壓縮前可用的有效上下文視窗
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 總數（預設：200）；超過上限的產生會以 Subagent spawn limit reached 失敗。並行 subagent 上限與深度上限仍然適用
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 主對話之下允許的 subagent 層數 （預設：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，兩者都設定時該旗標優先。不是正整數的值會在啟動時以錯誤遭到拒絕，而不會被視為無上限
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION 一個工作階段可進行的 WebSearch 呼叫總數上限（預設：200）。當 Claude 達到上限時，後續的 WebSearch 呼叫會傳回一則通知，告知它以已收集的資訊繼續進行。接受任意大小的正整數。其他任何值都會被忽略並套用預設值，因此上限可以提高但無法關閉。需要 Claude Code v2.1.212 或更新版本
CLAUDE_CODE_MCP_ALLOWLIST_ENV 設定為 1，以僅含安全基準環境加上伺服器所設定之 env 的方式產生 stdio MCP 伺服器，而不是繼承您的 shell 環境
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS 仍在執行的 MCP 工具呼叫移至背景任務前所經過的時間（毫秒）（預設：120000，即 2 分鐘）。設定為 0 以關閉自動背景化。需要 Claude Code v2.1.212 或更新版本
CLAUDE_CODE_MCP_STARTUP_WAIT_MS 非互動工作階段的第一個回合等待仍在連線中之 MCP 伺服器的時間長度（毫秒），取代預設的第一回合等待。設定後，等待會涵蓋所有擱置中的伺服器。設定為 0 以略過等待。無論此值為何，--permission-prompt-tool 伺服器都會保留其自己的 MCP_TIMEOUT 等待。需要 Claude Code v2.1.274 或更新版本
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT MCP 工具呼叫的閒置逾時（毫秒）。當 stdio、HTTP、SSE、WebSocket 或 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 的工作階段中，Claude Code 會在綁定 socket 時將該 socket 的路徑匯出給 hook 與 Bash 命令。在啟動時即開啟訊息功能的工作階段中，Claude Code 會在任何 hook 執行前綁定 socket。機器上的其他工作階段會將訊息傳送至此路徑。每個工作階段都會匯出自己的 socket，而不是從父工作階段繼承的 socket，抵達的訊息會經過該工作階段的傳入控制。設定中的 env 區塊無法設定此變數。需要 Claude Code v2.1.224 或更新版本
CLAUDE_CODE_MESSAGING_TOKEN 由 Claude Code 設定，而非由您設定：在綁定收件匣 socket 的工作階段中，Claude Code 會將此工作階段專屬的 token 與 CLAUDE_CODE_MESSAGING_SOCKET 一起匯出給 hook 與 Bash 命令。傳送至 socket 的指令碼可以將 {"type":"auth","token":"<token>"} 作為第一行傳送，以證明它屬於該工作階段。在原生 Windows 上，Claude Code 要求必須有此行，並會關閉任何未以有效的此行開頭的連線。自身子程序規則說明 Claude Code 何時會查驗 token。每個工作階段都會匯出自己的 token，絕不會使用從父工作階段繼承的 token。設定中的 env 區塊無法設定此變數。需要 Claude Code v2.1.228 或更新版本
CLAUDE_CODE_NATIVE_CURSOR 設定為 1，在輸入插入點顯示終端機本身的游標，而非繪製的區塊。游標會遵循終端機的閃爍、形狀與焦點設定
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_NO_FLICKER 設定為 1 以啟用全螢幕呈現，這是一項研究預覽功能，可減少閃爍並在長對話中維持穩定的記憶體用量。覆寫 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 存取 token。在 SDK 與自動化環境中可作為 /login 的替代方案。優先於儲存在鑰匙圈中的憑證。使用 claude setup-token 產生。除非您執行 /login，否則 Claude Code 會在整個工作階段中使用您設定的 token。若要替換已過期的 token，請產生新的 token 並重新啟動
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 已於 v2.1.160 移除，現在不具作用。先前用於將快速模式固定於 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 或更新版本。請參閱監控
CLAUDE_CODE_OTEL_DIAG_STDERR 設定為 1 以將 OpenTelemetry 匯出器的診斷錯誤寫入 stderr。預設情況下，這些錯誤只會在使用 --debug 時出現，因此設定錯誤的匯出器（例如 Prometheus 連接埠衝突）否則會無聲無息地失敗。需要 Claude Code v2.1.179 或更新版本。請參閱監控
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS 排清擱置中 OpenTelemetry span 的逾時時間（毫秒）（預設：5000）。請參閱監控
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS 重新整理動態 OpenTelemetry 標頭的間隔（毫秒）（預設：1740000 / 29 分鐘）。請參閱動態標頭
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS OpenTelemetry 匯出器在關閉時完成作業的逾時時間（毫秒）（預設：2000）。若指標在結束時遭到捨棄，請調高此值。請參閱監控
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 設定為 1，讓 Claude Code 在有新版本時於背景執行您套件管理員的升級命令。適用於 Homebrew 與 WinGet 安裝。其他套件管理員仍會只顯示升級命令而不執行。請參閱自動更新
CLAUDE_CODE_PERFORCE_MODE 設定為 1 以啟用感知 Perforce 的寫入保護。設定後，若目標檔案缺少擁有者寫入位元（Perforce 會在同步的檔案上清除此位元，直到 p4 edit 開啟它們為止），Edit、Write 與 NotebookEdit 會失敗並顯示 p4 edit <file> 提示。這可防止 Claude Code 繞過 Perforce 的變更追蹤
CLAUDE_CODE_PLUGIN_CACHE_DIR 覆寫外掛根目錄。儘管名稱如此，此變數設定的是父目錄，而非快取本身：市集與外掛快取位於此路徑下的子目錄中。預設為 ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS 要為工作階段載入的外掛目錄，每個目錄的載入方式與 --plugin-dir 旗標相同。在 Unix 上以 : 分隔多個路徑，在 Windows 上以 ; 分隔。每個路徑請提供絕對路徑或以 ~ 開頭，因為 Claude Code 會略過相對路徑。需要 Claude Code v2.1.280 或更新版本。請參閱為單一工作階段載入外掛
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS clone 或重新整理外掛市集的逾時時間（毫秒）（預設：120000）。對於大型儲存庫或緩慢的網路連線，請調高此值。請參閱 Git clone 逾時
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 設定為 1，當市集重新整理無法連線至遠端或無法向遠端進行身分驗證時，略過重新 clone 的嘗試，並繼續使用現有的市集 checkout。適用於離線或實體隔離環境，在這些環境中重新 clone 也會以相同方式失敗。請參閱市集更新在離線環境中失敗
CLAUDE_CODE_PLUGIN_PREFER_HTTPS 設定為 1 以透過 HTTPS 而非 SSH clone GitHub owner/repo 簡寫來源。適用於外掛的安裝與更新，以及 /plugin marketplace add 與 update。適用於 CI runner、容器，或任何未針對 github.com 設定 SSH 金鑰的環境
CLAUDE_CODE_PLUGIN_SEED_DIR 一或多個唯讀外掛種子目錄的路徑，在 Unix 上以 : 分隔，在 Windows 上以 ; 分隔。使用此變數可將預先填入的外掛目錄打包進容器映像。Claude Code 會在啟動時從這些目錄註冊市集，並使用預先快取的外掛而無需重新 clone。請參閱為容器預先填入外掛
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 旗標的非互動模式中，最後一個回合結束後，閒置等待背景 subagent 與工作流程的上限時間（毫秒）。每當 Claude 進行一個回合來處理背景結果時，閒置等待都會重新計算。預設：600000，即 10 分鐘。當閒置等待達到上限時，Claude Code 會停止等待剩餘的背景任務並結束。設定為 0 以無限期等待。此上限與適用於一般背景 shell 的五秒寬限期是分開的。需要 Claude Code v2.1.182 或更新版本
CLAUDE_CODE_PROCESS_WRAPPER 透過以 argv 前綴形式提供的企業啟動器（例如 /opt/corp/launcher），啟動 Claude Code 從自身二進位檔啟動的程序，例如承載 agent view 工作階段的背景服務。請在使用者設定或受管設定的 env 區塊中設定，而非以 shell export 設定，讓分離的背景服務能繼承它；專案與本機設定無法設定此變數。相當於 processWrapper 設定，該設定需要 Claude Code v2.1.210 或更新版本；兩者都設定時，此變數優先。VS Code 擴充功能會透過其 claudeProcessWrapper 設定另行設定自己的啟動器。在 Windows 上會被忽略。如需值的格式、啟動器涵蓋的範圍，以及啟動器必須滿足的約定，請參閱在企業啟動器後方執行 Claude Code。需要 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 區塊讀取。請參閱自行命名專案目錄。需要 Claude Code v2.1.234 或更新版本
CLAUDE_CODE_PROMPT_CACHE_TTL 設定 5m 或 1h（Claude Code 僅接受這兩個值），為主對話選擇提示快取 TTL：包括您的互動式、-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）
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 由嵌入 Claude Code 並代為管理模型供應商路由的主機平台設定。設定後，Claude Code 會忽略設定檔中的供應商選擇、端點與身分驗證變數，例如 CLAUDE_CODE_USE_BEDROCK、ANTHROPIC_BASE_URL 與 ANTHROPIC_API_KEY，使使用者設定無法覆寫主機的路由。Claude Code 也會忽略受管設定中的模型選擇鍵，例如 model、fallbackModel 與 modelOverrides，無論由哪個受管來源傳遞，讓主機的模型設定優先於過時的受管模型固定值。Claude Code 也會忽略受管 env 區塊中的模型選擇變數，例如 ANTHROPIC_MODEL 與 ANTHROPIC_DEFAULT_*_MODEL 系列；受管設定中的 availableModels 允許清單仍然適用，除非主機提供自己的允許清單。Claude Code 也會略過它在第三方供應商（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform 與 Microsoft Foundry）上原本會套用的自動遙測選擇退出，讓遙測遵循標準的 DISABLE_TELEMETRY 選擇退出機制。請參閱依 API 供應商區分的預設行為
CLAUDE_CODE_PROXY_RESOLVES_HOSTS 設定為 1 以允許代理伺服器執行 DNS 解析，而非由呼叫端執行。適用於應由代理伺服器處理主機名稱解析之環境的選擇性功能
CLAUDE_CODE_REMOTE 當 Claude Code 以雲端工作階段執行時，會自動設定為 true。可從 hook 或設定指令碼讀取此值，以偵測您是否位於雲端工作階段中
CLAUDE_CODE_REMOTE_SESSION_ID 在雲端工作階段中自動設定為目前工作階段的 ID。讀取此值可建構返回工作階段逐字稿的連結。請參閱將輸出連結回工作階段
CLAUDE_CODE_RESTRICTED 設定為 1 以受限模式啟動工作階段，與傳遞 --restricted 相同。Claude Code 會忽略設定檔 env 區塊中的此變數。需要 Claude Code v2.1.248 或更新版本
CLAUDE_CODE_RESUME_INTERRUPTED_TURN 設定為 1 可在上一個工作階段於回合中途結束時自動繼續。用於 SDK 模式，讓模型無需 SDK 重新傳送提示詞即可繼續。若要關閉此功能，請取消設定此變數或將其設定為 0。有關 VS Code 聊天面板，請參閱 重新載入後繼續對話
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 工作階段時，會自行設定一小時的界限。需要 Claude Code v2.1.211 或更新版本
CLAUDE_CODE_RESUME_PROMPT 覆寫當 CLAUDE_CODE_RESUME_INTERRUPTED_TURN 接續中斷的回合而非重新傳送其提示詞時，或當您以 -p 繼續延後的工具呼叫時，Claude Code 傳送給 Claude 的接續訊息。預設為 Continue from where you left off.。空字串會使用預設值
CLAUDE_CODE_RETRY_WATCHDOG 設定為 1，適用於無人值守的工作階段，例如評估框架、CI 作業或遠端 worker。會無限期重試 429 與 529 容量錯誤，而不會在 CLAUDE_CODE_MAX_RETRIES 次嘗試後失敗。當標準速度請求收到回報消費上限或用量點數耗盡的 429 時，Claude Code 會立即失敗，即使該錯誤來自依排程重設的閘道消費上限也是如此。在 v2.1.239 之前，watchdog 會無限期重試這些錯誤。關於快速模式請求，請參閱處理速率限制。watchdog 在兩次嘗試之間最多退避 5 分鐘，或在回應帶有速率限制重設時間時等到限制重設，因此達到用量上限的工作階段會等待剩餘的時段結束。在 v2.1.199 或更新版本中，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時與連線中斷）的預設重試次數提高至 300，約三小時的退避時間，並在您明確設定 CLAUDE_CODE_MAX_RETRIES 時移除其 15 次的上限。需要 Claude Code v2.1.186 或更新版本
CLAUDE_CODE_SAFE_MODE 設定為 1 以安全模式啟動：CLAUDE.md、skill、外掛、hook、MCP 伺服器、自訂命令與 agent、輸出風格、工作流程、自訂主題、自訂快捷鍵、狀態列與檔案建議命令、LSP 伺服器以及自動記憶都不會載入，用於對損壞的設定進行疑難排解。受管設定原則仍然適用，包括由原則設定的 hook、狀態列與檔案建議命令；受管外掛、受管 skill、受管 CLAUDE.md 以及由原則設定的 MCP 伺服器則不會載入。相當於傳遞 --safe-mode。直接產生的子程序會繼承此變數
CLAUDE_CODE_SCRIPT_CAPS 在設定 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 時，限制特定指令碼在每個工作階段中可被叫用次數的 JSON 物件。鍵是與命令文字比對的子字串；值是整數呼叫上限。例如，{"deploy.sh": 2} 允許 deploy.sh 最多被呼叫兩次。比對以子字串為基礎，因此像 ./scripts/deploy.sh $(evil) 這類 shell 展開技巧仍會計入上限。透過 xargs 或 find -exec 進行的執行期擴散不會被偵測到；這是一項縱深防禦控制
CLAUDE_CODE_SCROLL_SPEED 設定全螢幕呈現中的滑鼠滾輪捲動倍率。接受最高 20 的任何正值，包括低於 1 的小數值（例如 0.5），可在已放大滾輪事件的終端機中減緩加速的觸控板與滾輪捲動。如果您的終端機每一格只傳送一個滾輪事件且未放大，設定為 3 可與 vim 一致。在 JetBrains IDE 終端機中會被忽略，因為 Claude Code 在其中使用自己的捲動處理
CLAUDE_CODE_SEND_FEEDBACK 設定為 0 以關閉工作階段的 Claude 草擬的意見回饋。設定為 1 可在您的帳戶已具存取權的情況下開啟；此變數本身無法授予存取權，而其他關閉意見回饋的開關，例如 DISABLE_FEEDBACK_COMMAND 以及 feedbackDrafts 設定的 off 值，仍然適用
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 覆寫 SessionEnd hook 的時間預算（毫秒）。此值也是每個未自行設定 timeout 之 hook 的逾時時間。適用於工作階段結束、/clear，以及透過互動式 /resume 切換工作階段。預設預算為 1.5 秒，會自動提高至設定檔中所設定的最高個別 hook timeout，最多 60 秒。外掛提供之 hook 上的逾時不會提高預算
CLAUDE_CODE_SESSION_ID 在 Bash 與 PowerShell 工具子程序、hook 命令子程序以及 stdio MCP 伺服器子程序中，自動設定為目前的工作階段 ID。對於 Bash、PowerShell 與 hook，此值與 hook JSON 輸入中的 session_id 欄位相符，並會在 /clear 時更新。MCP 伺服器子程序會保留其產生時的 ID。在使用 --resume <session-id> 時，它會收到繼續的 ID，與 hook 和 Bash 一致。在使用 --continue 或未提供明確 ID 的 --resume 時，它可能會改為收到初始啟動時的 ID。可用於將指令碼與外部工具關聯至啟動它們的 Claude Code 工作階段
CLAUDE_CODE_SHELL 設定 Claude Code 用來執行 Bash 工具命令的 shell。接受 bash 或 zsh 二進位檔的路徑，例如 /opt/homebrew/bin/bash。不支援 fish 等其他 shell。如果該值不是可運作的 bash 或 zsh 路徑，Claude Code 會忽略它並改用自動偵測。自動偵測會在您的 $SHELL 指向 bash 或 zsh 時使用它，否則會從您的 PATH 與標準安裝位置中，先選擇第一個可運作的 zsh，其次是 bash
CLAUDE_CODE_SHELL_PREFIX 包裝 Claude Code 所產生之 shell 命令的命令前綴：Bash 工具呼叫、hook 命令、狀態列命令以及 stdio MCP 伺服器啟動命令。PowerShell hook 與 exec 形式的 hook 會在不加前綴的情況下執行。適用於日誌記錄或稽核。設定像 /path/to/logger.sh 這樣的單純執行檔路徑時，每個命令都會以 /path/to/logger.sh '<command>' 的形式執行。包裝器會在 $1 中以單一 shell 引號包覆的引數接收命令列，因此包裝器必須使用 shell 重新評估 $1，例如 exec bash -c "$1"。將 $1 視為單純的執行檔路徑，會導致傳遞 npx -y <package> 等引數的 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
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT 設定為 1，可在任何模型上使用較短的系統提示詞與精簡的工具描述。設定為 0、false、no 或 off 可選擇退出，即使在實驗或伺服器設定原本會啟用它的模型上也是如此。完整的工具集、hook、MCP 伺服器與 CLAUDE.md 探索仍保持啟用
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH 略過 Claude Platform on AWS 的用戶端身分驗證，適用於自行簽署請求的閘道
CLAUDE_CODE_SKIP_AWS_CRED_CACHE 設定為 1 以關閉從 AWS 預設憑證提供者鏈解析之憑證的程序內快取，讓 Claude Code 在每次 API 請求時都解析該鏈。關閉快取時，以 SSO 為基礎的設定檔會在每次請求時向 IAM Identity Center 請求憑證。請參閱憑證快取與解析逾時。需要 Claude Code v2.1.207 或更新版本
CLAUDE_CODE_SKIP_BEDROCK_AUTH 略過 Amazon Bedrock 的 AWS 身分驗證（例如使用 LLM 閘道時）
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS 設定為 1，將失敗的快速模式可用性檢查視為可用，適用於會封鎖該檢查直接傳送至 api.anthropic.com 之請求的網路。Claude Code 仍會遵循「disabled by your organization」回應
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK 設定為 1 以略過用戶端的快速模式可用性檢查，適用於會攔截而非拒絕該檢查請求的代理伺服器。當您的組織已停用快速模式時，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 與 Google Cloud's Agent Platform 上的啟動模型檢查會在此機器上記住它們發現您的帳戶無法叫用哪些模型，最長保留一天。設定為 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 拒絕啟動原因的結果訊息。需要 Claude Code v2.1.274 或更新版本
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Stop 或 SubagentStop hook 可連續阻止回合結束的最大次數，超過後 Claude Code 會覆寫它並仍然結束回合（預設：8）。設定為 0 以停用此上限。如果您的 hook 確實需要更多次迭代才能解決，請調高此值
CLAUDE_CODE_SUBAGENT_MODEL 未以其他方式指派模型的 subagent、agent team 隊員以及工作流程 agent 的預設模型。接受 haiku 等別名或完整模型名稱。有兩個來源優先於此變數：Claude 產生 agent 時傳遞的模型，以及 agent 定義中的 model 欄位，包括 inherit。若要改變此行為，請設定 CLAUDE_CODE_SUBAGENT_MODEL_FORCE。完整順序請參閱選擇模型。將其設定為 inherit 與不設定相同。在 v2.1.251 之前，此變數會同時覆寫每次叫用的模型與定義中的 model 欄位
CLAUDE_CODE_SUBAGENT_MODEL_FORCE 設定為 1 以將單一模型強制套用至 subagent、隊員與工作流程 agent。在單一模型上執行所有 subagent 說明是哪一個模型。需要 Claude Code v2.1.257 或更新版本
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL 設定 5m 或 1h（Claude Code 僅接受這兩個值），為主對話以外的請求（例如 subagent、工作流程與背景工作）選擇提示快取 TTL。優先於 subagentPromptCacheTtl 設定與 ENABLE_PROMPT_CACHING_1H，而 FORCE_PROMPT_CACHING_5M 會覆寫此變數。API 會以較高費率計費 1 小時的快取寫入。需要 Claude Code v2.1.242 或更新版本
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 設定為 1 以從子程序環境（Bash 工具、hook、MCP stdio 伺服器）中移除憑證：Anthropic 與雲端供應商憑證、Claude Code 識別為憑證的任何其他變數，以及內嵌於套件登錄 URL 中的憑證。父 Claude 程序會保留這些憑證以進行 API 呼叫，但子程序無法讀取它們，從而降低遭受試圖透過 shell 展開竊取機密之提示詞注入攻擊的風險。在 v2.1.251 或更新版本中，清除作業也會移除 Claude Code 自身的設定儲存區指標變數（例如 CLAUDE_CONFIG_DIR），讓子程序無法找到已重新定位的設定目錄。如果子程序需要這些變數，請勿設定此清除作業。在 Linux 上，這也會在隔離的 PID 命名空間中執行 Bash 子程序，使其無法透過 /proc 讀取主機程序環境；副作用是 ps、pgrep 與 kill 無法看見主機程序或向其傳送訊號。設定 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，並在執行第一次查詢前等待這些 skill 的清單，最長等待 CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS。下載本身會在背景完成，而 Claude 在叫用某個 skill 時會等待該 skill 下載完成。需要 claude.ai 身分驗證。使用 claude.ai 帳戶登入的終端機工作階段，即使未設定此變數，也會將這些 skill 下載至 ~/.claude/skills/synced/，並大約每 10 分鐘重新同步一次，因此僅在 -p 執行需要在第一次查詢時取得您目前的 skill 時才設定此變數。在 v2.1.273 之前，終端機工作階段只會在設定了此變數的 -p 執行中下載它們。synced 資料夾名稱保留給此下載使用。在 v2.1.227 之前，skill 會直接下載至 ~/.claude/skills/。Claude Code 會對下載的 skill 套用額外規則，例如不在您的機器上執行其 ! 命令
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS 當以 Agent SDK 建置的應用程式重新載入 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 設定
CLAUDE_CODE_TASK_LIST_ID 跨工作階段共用任務清單。在多個 Claude Code 執行個體中設定相同的 ID，即可在具備 Task 工具的工作階段中協調共用的任務清單。請參閱任務清單
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS 以毫秒為單位，覆寫非互動工作階段在結束時等待其 agent team 完成拆除的時間長度。接受 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 上，當您的覆寫值是很長的路徑時，沙箱化的 Bash 子程序會收到位於系統預設位置下的簡短備援 $TMPDIR，因為某些工具在暫存路徑過長時會失敗。未沙箱化的 Bash 命令會在您的 shell 設定了 $TMPDIR 時繼承該值。在原生 Windows 上，當您的 shell 未設定 $TMPDIR 時，參照 $TMPDIR 的 Bash 命令會收到您的覆寫值，若您未設定覆寫值則會收到 %TEMP%。Claude Code 自身的暫存檔案一律使用您的覆寫值。請在您的 shell、使用者設定或受管設定中設定。在專案與本機設定中會被忽略
CLAUDE_CODE_TMUX_TRUECOLOR 設定為任何非空值（例如 1），以允許在 tmux 內輸出 24 位元 truecolor。將其設定為 0 或 false 仍會允許 truecolor，這與大多數開關變數不同；請取消設定此變數以恢復 256 色限制。預設情況下，當設定了 $TMUX 時，Claude Code 會限制為 256 色，因為除非經過設定，否則 tmux 不會傳遞 truecolor 跳脫序列。請在將 set -ga terminal-overrides ',*:Tc' 加入您的 ~/.tmux.conf 後設定此變數。其他 tmux 設定請參閱終端機設定
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE 在 Linux 與 WSL 上，設定為以逗號分隔的程序類型清單，Claude Code 會將這些程序排除於工具記憶體上限之外，例如 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 工具命令可使用的記憶體，在 v2.1.246 或更新版本中也包括 Monitor 工具命令。請以純數字撰寫大小，單獨使用時表示位元組數，或加上 K、M、G 或 T 後綴。設定 0 或 off 以關閉上限。一旦 Claude Code 啟動的第一個程序已開啟或關閉上限，變更後的值會在您下次啟動 claude 時生效。需要 Claude Code v2.1.233 或更新版本
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Claude Code 取消其轉送至遠端用戶端（例如 Remote Control 或 SDK 主機）的對話框，或保留中的跨工作階段訊息之核准對話框前的期限（毫秒）；權限提示與 AskUserQuestion 問題使用各自的流程，不受此變數控制。在 Claude Code v2.1.236 或更新版本中，它也會限制在可能無人值守執行的工作階段中，於工作階段中途出現的 Fable 用量點數同意提示。控制傳入訊息與非互動工作階段涵蓋完整的保留訊息到期規則，包括期限不適用的情況。覆寫 dialogExpiry 設定。0 或負值會停用期限
CLAUDE_CODE_USE_ANTHROPIC_AWS 使用 Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCK 使用 Amazon Bedrock
CLAUDE_CODE_USE_FOUNDRY 使用 Microsoft Foundry
CLAUDE_CODE_USE_MANTLE 使用 Amazon Bedrock Mantle 端點
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 工具
CLAUDE_CODE_USE_VERTEX 使用 Google Cloud's Agent Platform
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS 設定為 WebFetch 將每個擷取之 URL 的回應保留在快取中的毫秒數。預設為 900000，即 15 分鐘。僅接受純數字；0、小數或其他任何寫法都會保留預設值。Claude Code 每次啟動時只讀取一次此值，因此設定 env 區塊中的變更會在您下次啟動 claude 時套用。需要 Claude Code v2.1.233 或更新版本
CLAUDE_CODE_WEBFETCH_DEADLINE_MS WebFetch 等待頁面下載的時間上限（毫秒），包括其遵循的任何重新導向。在此時間前未完成的下載會以期限錯誤失敗。預設為 300000，即五分鐘。設定為 0 以移除限制。僅接受純數字；小數或其他任何寫法都會保留預設值。需要 Claude Code v2.1.268 或更新版本
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 單一工作流程執行同時執行的 agent 數量，範圍從 1 到 256。預設情況下，一次執行最多同時執行 16 個 agent，當 Claude Code 可用的 CPU 較少時則會更少；排入佇列的 agent() 呼叫會等待空閒的位置。每個執行中 agent 的逐字稿會保留在 Claude Code 的記憶體中，因此較高的值會增加記憶體用量。僅接受純數字；超出範圍的值與其他寫法都會保留預設值。需要 Claude Code v2.1.269 或更新版本
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS 工作流程 agent 在送出自己的第一個請求之前，等待具有相同前綴的同層 agent 開始第一個回應的時間上限，以毫秒為單位。當扇出啟動多個共用提示快取前綴的 agent 時，Claude Code 會讓第一個以外的所有 agent 最多等待這段時間，使其餘 agent 讀取已快取的前綴，而非各自在未快取的情況下處理該前綴。預設為 5000。設定為 0 可停用等待。設定 DISABLE_PROMPT_CACHING 時，agent 永遠不會等待。需要 Claude Code v2.1.229 或更新版本
CLAUDE_CONFIG_DIR 覆寫設定目錄（預設：~/.claude）。所有設定、工作階段歷史記錄和外掛都儲存在此路徑下。關於憑證，請參閱 Claude Code 儲存憑證的位置。適用於同時執行多個帳戶：例如 alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'。請在 shell、使用者設定或受管設定中設定。在專案和本機設定中會被忽略
CLAUDE_DISABLE_ADOPT 設定為 1 時，當您按下 ← 或使用 /background 將工作階段移至背景時，會停止進行中的背景工作，而非將其延續。Claude Code 會在移至背景前請您確認，然後停止原本會延續的任務。需要 Claude Code v2.1.195 或更新版本
CLAUDE_EFFORT 在 Bash 工具子程序和 hook 命令中自動設定為子程序啟動時生效的 effort 等級：low、medium、high、xhigh 或 max。與傳遞給 hook 的 effort.level 欄位相符。僅在目前模型支援 effort 參數時設定
CLAUDE_ENABLE_BYTE_WATCHDOG 設定為 1 可強制啟用位元組層級的串流閒置監視器，設定為 0 可強制停用。0 也會在執行首位元組期限的連線上關閉該期限。未設定時，此監視器預設會在直接 Anthropic API 和 Claude Platform on AWS 連線上啟用，也會在透過 ANTHROPIC_BASE_URL 或 ANTHROPIC_AWS_BASE_URL 連線的閘道連線上，針對串流回應啟用；在 v2.1.222 之前，此監視器不會在這些閘道連線上執行，因此即使 keep-alive ping 持續抵達，事件層級的監視器仍可能在那裡回報停滯。關於逾時以及計時器之間的互動方式，請參閱串流閒置監視器
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK 設定為 1 可在 Amazon Bedrock vnd.amazon.eventstream 回應上啟用位元組層級的串流閒置監視器，這也會在 Bedrock 串流請求上啟用首位元組期限。預設為關閉。請使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 設定逾時
CLAUDE_ENABLE_STREAM_WATCHDOG 設定為 0 可強制停用事件層級的串流閒置監視器，設定為 1 可強制啟用。未設定時，此監視器預設會對所有提供者啟用。在 v2.1.196 之前，未設定時的預設值在直接 Anthropic API 上由伺服器控制，在其他提供者上則為關閉。請使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 設定逾時；關於與此監視器一同執行的其他停滯計時器，請參閱串流閒置監視器
CLAUDE_ENV_FILE shell 指令碼的路徑，Claude Code 會在每個 Bash 命令之前，於同一個 shell 程序中執行該指令碼的內容，因此檔案中的 export 對命令可見。用於在命令之間保留 virtualenv 或 conda 的啟用狀態。也會由 SessionStart、Setup、CwdChanged 和 FileChanged hook 動態填入
CLAUDE_JOB_DIR 由 Claude Code 在每個背景工作階段中設定為該工作階段的 ~/.claude/jobs/<id> 目錄。工作階段執行的 shell 命令會繼承此變數。請將暫存檔案寫入 $CLAUDE_JOB_DIR/tmp。Claude 在該處的 Write 和 Edit 呼叫不會提示權限，且該目錄會在工作階段刪除時一併移除
CLAUDE_PID Claude Code 會在其產生的子程序中將此變數設定為自身的程序 ID：包括 Bash 和 PowerShell 工具命令以及 hook 命令。在 Linux 上，Bash 工具的 shell 整合會使用此變數來拒絕會比對到 Claude Code 程序本身的 pkill 模式；請參閱錯誤參考。您可以在自己的指令碼中讀取此變數，以刻意識別父 Claude Code 程序或向其傳送訊號。需要 Claude Code v2.1.214 或更新版本
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX 未提供明確名稱時，自動產生的 Remote Control 工作階段名稱的前綴。預設為您機器的主機名稱，產生如 myhost-graceful-unicorn 的名稱。--remote-control-session-name-prefix CLI 旗標會為單次呼叫設定相同的值
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS 在執行首位元組期限的連線上，串流請求第一個回應位元組的期限，以毫秒為單位。關於 Claude Code 如何限制此值、為大型請求本文增加的額外時間，以及未設定此變數時如何選擇期限，請參閱API 沒有回應。需要 Claude Code v2.1.242 或更新版本
CLAUDE_STREAM_IDLE_TIMEOUT_MS 事件層級和位元組層級的串流閒置監視器關閉停滯連線前的逾時時間，以毫秒為單位。明確設定此變數時，最小值為 300000（5 分鐘）；較低的值會被靜默調整至最小值，以吸收延伸思考的暫停和代理伺服器緩衝，且位元組層級的監視器會將此值上限設為 30 分鐘。對於位元組層級的監視器，CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS 優先於此變數。關於各監視器未設定時的預設值，請參閱串流閒置監視器
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS 已於 v2.1.260 移除，現在不會產生任何作用。先前用於限制 subagent 啟動的背景 shell 命令可執行的時間，以毫秒為單位，預設為 60 分鐘。請參閱背景命令生命週期規則
DEBUG 設定為 1 可啟用偵錯模式，相當於使用 --debug 啟動。偵錯日誌會寫入 ~/.claude/debug/<session-id>.txt，或寫入 CLAUDE_CODE_DEBUG_LOGS_DIR 設定的路徑。只有真值 1、true、yes 和 on 會啟用偵錯模式，因此為其他工具設定的命名空間模式（如 DEBUG=express:*）不會觸發偵錯模式
DISABLE_AUTOUPDATER 設定為 1 可停用自動背景更新。手動執行 claude update 仍然有效。使用 DISABLE_UPDATES 可同時封鎖兩者
DISABLE_AUTO_COMPACT 設定為 1 可停用接近上下文限制時的自動壓縮。手動 /compact 命令仍可使用。適用於您希望明確控制壓縮發生時機的情況。會覆寫 autoCompactEnabled 設定
DISABLE_COMPACT 設定為 1 可停用所有壓縮：包括自動壓縮和手動 /compact 命令
DISABLE_COST_WARNINGS 設定為 1 可停用費用警告訊息
DISABLE_DOCTOR_COMMAND 設定為 1 可隱藏 /doctor 設定檢查 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 草擬的意見回饋。也會停用透過相同路徑回報的 /bug 和 /share；在 v2.1.212 之前，它們是 /feedback 的別名，因此該命令會在所有名稱下被停用。也接受舊名稱 DISABLE_BUG_COMMAND
DISABLE_GROWTHBOOK 設定為 1 或 true 可停用 GrowthBook 功能旗標擷取，並對每個旗標使用程式碼預設值。這會使 Remote Control 和其他需要擷取功能旗標的功能無法使用。設定為 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 閘道或提供者不支援交錯思考的情況
DISABLE_LOGIN_COMMAND 設定為 1 可隱藏 /login 命令。適用於透過 API 金鑰或 apiKeyHelper 在外部處理身分驗證的情況
DISABLE_LOGOUT_COMMAND 設定為 1 可隱藏 /logout 命令
DISABLE_PROMPT_CACHING 設定為 1 可為所有模型停用提示快取（優先於各模型的設定）
DISABLE_PROMPT_CACHING_FABLE 設定為 1 可為 Fable 模型停用提示快取
DISABLE_PROMPT_CACHING_HAIKU 設定為 1 可為預設 Haiku 模型停用提示快取，無論其在何處執行
DISABLE_PROMPT_CACHING_OPUS 設定為 1 可為預設 Opus 模型停用提示快取
DISABLE_PROMPT_CACHING_SONNET 設定為 1 可為預設 Sonnet 模型停用提示快取
DISABLE_TELEMETRY 設定為任何非空值（例如 1）可選擇退出遙測。設定為 0 或 false 仍會選擇退出，這與大多數開/關變數不同；取消設定此變數即可重新開啟遙測。遙測事件不包含使用者資料，例如程式碼、檔案路徑或 Bash 命令。也會停用功能旗標擷取。請參閱為您的組織關閉遙測
DISABLE_UPDATES 設定為 1 可封鎖所有更新，包括手動執行 claude update 和 claude install。比 DISABLE_AUTOUPDATER 更嚴格。適用於透過您自己的管道發布 Claude Code 且使用者不應自行更新的情況
DISABLE_UPGRADE_COMMAND 設定為 1 可隱藏 /upgrade 命令
DO_NOT_TRACK 設定為 1 可選擇退出遙測，效果與 DISABLE_TELEMETRY 相同，包括對功能旗標擷取的影響。Claude Code 會將此變數讀取為標準布林值，因此 0 會保持遙測開啟，並將其視為許多開發者 CLI 認可的跨工具慣例
ENABLE_BETA_TRACING_DETAILED 設定為 1 並搭配 BETA_TRACING_ENDPOINT，可開啟詳細 beta 追蹤，這會新增承載內容的 span 屬性和 claude_code.hook span。互動式 CLI 工作階段還需要您的組織被列入該 beta 的允許清單。這兩個變數在專案和本機設定中都會被忽略
ENABLE_CLAUDEAI_MCP_SERVERS 設定為 false 可阻止 Claude Code 擷取 claude.ai MCP 伺服器。對已登入的使用者預設為啟用。若要依專案或依組織停用，請改為在設定中設定 disableClaudeAiConnectors
ENABLE_PROMPT_CACHING_1H 設定為 1 可請求 1 小時的提示快取 TTL，而非預設的 5 分鐘。適用於 API 金鑰、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 和 Claude Platform on AWS 使用者。在包含用量範圍內的訂閱使用者會在主要對話上自動獲得 1 小時 TTL。使用用量點數的訂閱使用者可以設定此變數以保留 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 Tool Search。未設定時，Claude Code 預設會延遲載入所有 MCP 工具。但在早於 Claude 4.5 世代的 Google Cloud's Agent Platform 模型、託管於 Azure 的 Microsoft Foundry 部署，以及 ANTHROPIC_BASE_URL 指向非第一方主機時，仍會預先載入這些工具。true 一律延遲載入並傳送 beta 標頭，但上述相同的 Agent Platform 模型和 Microsoft Foundry 部署除外；在不支援 tool_reference 的代理伺服器上，請求會失敗。auto 會在工具定義符合上下文的 10% 以內時預先載入。auto:N 可設定自訂閾值，例如 auto:5 表示 5%。false 會預先載入所有工具。設定 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 時，您自行設定的值會被忽略。在 v2.1.221 之前，除非您將此變數設定為 true，否則 Claude Code 會在 Google Cloud's Agent Platform 上為所有模型停用工具搜尋
FALLBACK_FOR_ALL_PRIMARY_MODELS 設定為任何非空值（例如 1），可讓 Claude Code 在未設定備援模型時，對每個模型在重複發生過載錯誤時停止重試。設定為 0 或 false 仍會啟用此功能，這與大多數開/關變數不同；取消設定此變數即可恢復預設的重試行為。若未設定此變數，當您使用 API 金鑰或第三方提供者而非 Claude 訂閱進行身分驗證時，Claude Code 會在其識別為 Opus、Fable 或 Mythos 的模型上以此方式停止重試。在 Claude Code v2.1.160 或更新版本中，Claude Code 會在任何主要模型重複發生過載錯誤時切換到您設定的備援模型鏈，因此此變數不會影響切換到備援模型
FORCE_AUTOUPDATE_PLUGINS 設定為 1 可在主要自動更新程式透過 DISABLE_AUTOUPDATER 停用時，仍強制外掛自動更新
FORCE_HYPERLINK 設定為 1 可在您的終端機支援但未被自動偵測到時，啟用可點擊的 OSC 8 超連結，設定為 0 則停用超連結。未設定時，Claude Code 僅在偵測到終端機支援時啟用超連結。Claude Code 會將此值解析為數字而非布林值，因此 false、no 或 off 等值會啟用超連結，而非停用。頁尾的 PR 或合併請求徽章即使在 Claude Code 無法偵測終端機支援時（例如透過 SSH）也會呈現為超連結。設定 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 數。當輸出超過 10,000 個 token 時，Claude Code 會顯示警告。宣告 anthropic/maxResultSizeChars 的工具會改為對文字內容使用該字元限制，但這些工具的圖片內容仍受此變數限制（預設：25000）
MAX_STRUCTURED_OUTPUT_RETRIES 在使用 -p 旗標的非互動模式中，當模型的回應未通過 --json-schema 驗證時，Claude Code 允許的嘗試次數；在達到該次數的失敗嘗試且沒有有效輸出後，執行即失敗。當工作流程 subagent 的結構化輸出未通過驗證時，也適用相同的上限。預設為 5，即第一次嘗試加上四次重試
MAX_THINKING_TOKENS 延伸思考的固定 token 預算。Claude Code 會將其上限設為比請求的最大輸出 token 少一個 token，且永遠不低於 1,024。關於該限制的設定方式，請參閱 CLAUDE_CODE_MAX_OUTPUT_TOKENS。未設定且已啟用思考時，具有自適應推理的模型會自行選擇思考深度，其他模型則使用上限。設定為 0 可在 Anthropic API 上停用思考，但 Opus 5.5、Sonnet 5.5 和 Fable 模型除外，這些模型無法關閉思考。在第三方提供者上，0 會改為省略 thinking 參數。在 Anthropic API 上關閉思考時，對於 Claude Code 已知不接受該組合的模型（例如 Opus 5），Claude Code 會傳送 effort high 而非更高的等級。Claude Code 會在自適應推理模型上忽略非零值，但 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 會關閉自適應推理的模型除外
MCP_CLIENT_SECRET 需要預先設定憑證的 MCP 伺服器所使用的 OAuth 用戶端密碼。使用 --client-secret 新增伺服器時可避免互動式提示
MCP_CONNECTION_NONBLOCKING 控制啟動時是否在第一個查詢之前等待 MCP 伺服器連線。MCP 啟動預設為非阻塞：伺服器會在背景連線，其工具會在完成時變為可用。設定為 0 可讓 Claude Code 在第一個查詢之前等待伺服器連線。設定了 alwaysLoad: true 的伺服器無論如何仍會讓啟動等待，除非是從探索快取提供，因為建立第一個提示詞時其工具必須存在。在未使用 --input-format stream-json 的非互動模式（-p）中，無論此變數為何，Claude Code 也會在第一個回合之前等待仍在擱置中的伺服器。當您明確傳遞 --mcp-config 時，等待會有較長的期限；關於已快取伺服器的例外情況，請參閱該旗標的項目
MCP_CONNECT_TIMEOUT_MS 阻塞式 MCP 啟動在擷取工具清單快照之前，等待連線批次的時間，以毫秒為單位（預設：5000）。適用於 MCP_CONNECTION_NONBLOCKING=0 時，或標記為 alwaysLoad: true 的伺服器。在期限時仍在擱置中的伺服器會繼續在背景連線。與 MCP_TIMEOUT 不同，後者限制的是個別伺服器的連線嘗試
MCP_DISCOVERY_CACHE 開啟或關閉 MCP 探索快取。快取開啟時，您先前使用過的遠端 HTTP 或 SSE 伺服器可以顯示 cached 狀態，且 Claude Code 會在其第一次工具呼叫時才連線，而非在啟動時連線。除非逐步推出已為您的帳戶啟用，否則快取預設為關閉。設定為 1 可開啟，設定為 0 則即使推出已啟用也保持關閉。在 v2.1.238 之前，快取預設為開啟。cached 狀態需要 Claude Code v2.1.221 或更新版本
MCP_DISCOVERY_CACHE_MAX_STALE_S 探索快取項目的最長存留時間，以秒為單位（預設：14400，即 4 小時）。在項目超過此時間的啟動中，Claude Code 會捨棄該項目並在啟動時連線伺服器，如同快取關閉時的做法。Claude Code 會將此值上限設為 7 天。在 v2.1.238 之前，預設值為 86400，即 24 小時，且 Claude Code 不會限制此值
MCP_DISCOVERY_CACHE_STRIKES 在探索快取項目超過 MCP_DISCOVERY_CACHE_TTL_S 的啟動中，Claude Code 會在背景重新整理該項目。此變數設定在 Claude Code 捨棄該項目並改為在下次啟動時連線伺服器之前，可以連續失敗多少次重新整理（預設：1）。如果您的網路連線偶爾中斷，請提高此值，以免一次重新整理失敗就捨棄該項目。需要 Claude Code v2.1.238 或更新版本
MCP_DISCOVERY_CACHE_TTL_S Claude Code 在不重新整理的情況下使用探索快取項目的秒數（預設：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 重新導向回呼的固定連接埠，可在新增具有預先設定憑證的 MCP 伺服器時，作為 --callback-port 的替代方案
MCP_PROTOCOL_NEGOTIATION 僅在 v2 MCP 用戶端執行環境上，決定 Claude Code 是否探測伺服器是否支援 MCP 協定修訂版 2026-07-28。設定 auto 可探測 HTTP、claude.ai 連接器和 stdio 伺服器；未回應探測的伺服器會改用較早的協定連線，如同 SSE 和 WebSocket 伺服器一向的做法。設定 legacy 可對所有伺服器略過探測。未設定此變數時，Claude Code 會探測 HTTP 伺服器，並在其擷取功能旗標的工作階段中也探測 claude.ai 連接器伺服器。任何其他值都會被忽略，並在偵錯日誌中記錄警告。需要 Claude Code v2.1.221 或更新版本
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE 啟動期間並行連線的遠端 MCP 伺服器（HTTP/SSE）最大數量（預設：20）
MCP_SDK_GENERATION 固定此程序用於連線 MCP 伺服器的 MCP 用戶端執行環境：v1，建構於 MCP TypeScript SDK 1.x 之上，或 v2，建構於 MCP TypeScript SDK 2.0 之上。未設定此變數時，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 或更新版本。請參閱監控
OTEL_LOG_ASSISTANT_RESPONSES 設定為 1 可在 assistant_response OpenTelemetry 日誌事件中包含模型的回應文字。未設定時，Claude Code 會改用 OTEL_LOG_USER_PROMPTS 的值。設定為 0 可在設定了 OTEL_LOG_USER_PROMPTS 時仍保持回應遮蔽。請在 shell、使用者設定或受管設定中設定。在專案和本機設定中會被忽略。需要 Claude Code v2.1.193 或更新版本。請參閱監控
OTEL_LOG_MANAGED_SETTINGS 設定為 1 可將遮蔽後的受管設定，以及遮蔽前設定的 SHA-256 摘要，新增至 managed_settings_resolved OpenTelemetry 日誌事件。預設為停用。請在 shell、使用者設定或受管設定中設定；專案或本機設定中的值不會將其開啟。需要 Claude Code v2.1.274 或更新版本。請參閱監控
OTEL_LOG_RAW_API_BODIES 將 Anthropic Messages API 請求和回應 JSON 作為 api_request_body / api_response_body 日誌事件發出。設定為 1 可發出在內容限制處截斷的內嵌本文，或設定為 file:<dir> 將未截斷的本文寫入磁碟並改為發出 body_ref 路徑。CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH 可設定內容限制，預設為 60 KB。預設為停用；本文包含完整的對話歷史記錄。請在 shell、使用者設定或受管設定中設定。在專案和本機設定中會被忽略。請參閱監控
OTEL_LOG_TOOL_CONTENT 設定為 1 可在 tool.output OpenTelemetry span 事件中包含工具內容。span 屬性會在其各自的閘門下承載工具內容。需要追蹤。預設為停用以保護敏感資料。請在 shell、使用者設定或受管設定中設定。在專案和本機設定中會被忽略，但該章節所述的關閉值除外。請參閱監控
OTEL_LOG_TOOL_DETAILS 設定為 1 可在 OpenTelemetry 指標、追蹤和日誌中包含工具輸入引數；MCP 伺服器名稱；使用者撰寫的工作流程名稱；工具失敗時的原始錯誤字串；api_refusal 事件上的拒絕 category；費用和 token 指標上的真實 agent、skill、外掛和 MCP 伺服器名稱；以及其他工具詳細資訊。預設為停用以保護 PII。請在 shell、使用者設定或受管設定中設定。在專案和本機設定中會被忽略，但該章節所述的關閉值除外。請參閱監控
OTEL_LOG_USER_PROMPTS 設定為 1 可在 OpenTelemetry 追蹤和日誌中包含使用者提示詞文字。預設為停用（提示詞會被遮蔽）。請在 shell、使用者設定或受管設定中設定。在專案和本機設定中會被忽略，但該章節所述的關閉值除外。請參閱監控
OTEL_METRICS_INCLUDE_ACCOUNT_UUID 設定為 false 可從指標屬性中排除帳戶 UUID（預設：包含）。請參閱監控
OTEL_METRICS_INCLUDE_ENTRYPOINT 設定為 true 可在指標屬性中包含工作階段進入點（預設：排除）。已於 v2.1.152 新增。請參閱監控
OTEL_METRICS_INCLUDE_REPOSITORY 設定為 true 可為 OpenTelemetry 指標和事件加上識別工作階段儲存庫的 vcs.* 屬性（預設：排除）。需要 Claude Code v2.1.269 或更新版本。請參閱儲存庫屬性
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES 自 v2.1.161 起，Claude Code 會將 OTEL_RESOURCE_ATTRIBUTES 鍵附加至指標資料點標籤。設定為 false 可排除它們（預設：包含）。請參閱監控
OTEL_METRICS_INCLUDE_SESSION_ID 設定為 false 可從指標屬性中排除工作階段 ID（預設：包含）。請參閱監控
OTEL_METRICS_INCLUDE_VERSION 設定為 true 可在指標屬性中包含 Claude Code 版本（預設：排除）。請參閱監控
SLASH_COMMAND_TOOL_CHAR_BUDGET 覆寫顯示給 Skill 工具的 skill 中繼資料字元預算。預算會以上下文視窗的 1% 動態調整，備援值為 8,000 個字元。為了向後相容而保留舊名稱
TASK_MAX_OUTPUT_LENGTH 已於 v2.1.277 移除，現在不會產生任何作用，其所調整大小的 TaskOutput 工具也一併移除。先前用於設定 TaskOutput 工具保留的背景任務輸出最大字元數。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 4.0 Opus 的區域
VERTEX_REGION_CLAUDE_4_0_SONNET 使用 Google Cloud's Agent Platform 時覆寫 Claude 4.0 Sonnet 的區域
VERTEX_REGION_CLAUDE_4_1_OPUS 使用 Google Cloud's Agent Platform 時覆寫 Claude 4.1 Opus 的區域
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 的區域

也支援標準 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 以及特定訊號的變體）。關於設定詳細資訊，請參閱監控。

請在 shell、使用者設定或受管設定中設定 CLAUDE_CODE_ENABLE_TELEMETRY，以及用於開啟匯出、選擇匯出目的地或擷取內容的 OpenTelemetry 變數。Claude Code 會在專案和本機設定中忽略這些變數，但該章節所述的關閉值除外。OTEL_RESOURCE_ATTRIBUTES 以及匯出間隔、逾時和壓縮變數（例如 OTEL_METRIC_EXPORT_INTERVAL）在專案和本機設定中仍然適用。

需要功能旗標擷取的功能

Claude Code 透過從 Anthropic 擷取的功能旗標來啟用某些功能。Claude Code 在以下工作階段中會跳過該擷取：

  • 設定 DISABLE_GROWTHBOOK、DISABLE_TELEMETRY、DO_NOT_TRACK 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 的工作階段；變數表中每個變數的列會說明哪些值會關閉擷取
  • 第三方提供者上的工作階段，例如 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform 或 Microsoft Foundry，除非嵌入 Claude Code 的主機平台設定 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • Claude 應用程式閘道工作階段

擷取關閉時，您無法：

安裝或升級後的第一個工作階段

在您安裝 Claude Code 或升級到新增功能的版本後的第一個工作階段中，旗標閘道功能可能會遺失。該工作階段也可能以不同的權限模式啟動，而不是您稍後的工作階段。Claude Code 在該工作階段期間擷取旗標，因此您的下一個工作階段具有該功能和通常的起始權限模式。

在全新安裝後，在非互動式工作階段（例如 claude -p、Agent SDK 或 VS Code 擴充功能）中，Claude Code 仍可在選擇起始權限模式之前擷取旗標。

另請參閱