SpyBara
Go Premium

env-vars.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

This page contains 284 additions and 282 deletions.

2026
Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Sat 19 23:57 Tue 22 23:59 Wed 23 23:57 Thu 24 22:57 Fri 25 23:58

環境變數

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

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

本頁涵蓋以下內容：

設定環境變數

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

在您的 shell 中

在啟動 claude 之前設定變數：

export API_TIMEOUT_MS="1200000"
claude

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

指派行在成功時不會列印任何內容，因此請在執行 claude 之前在同一個 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 設定 說明何時套用它們。少數變數有特殊處理；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 鍵下設定的變數會在檔案變更時重新套用到執行中的工作階段，但 在設定檔中 所述的僅啟動時例外。

變數

數值變數（例如逾時、權杖預算和重試次數）除了接受純數字外，還接受科學記號和數字分隔符拼寫，除非變數的列註明只接受純數字。例如，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 AWS 上的 Claude Platform 的工作區 API 金鑰，在 AWS 主控台中產生。作為 x-api-key 傳送，優先於 AWS SigV4
ANTHROPIC_AWS_BASE_URL 覆蓋 AWS 上的 Claude Platform 端點 URL。用於自訂區域或透過 LLM 閘道 路由時。預設為 https://aws-external-anthropic.{region}.api.aws。Claude Code 使用 Amazon Bedrock 上相同的優先順序 解析區域
ANTHROPIC_AWS_WORKSPACE_ID AWS 上的 Claude Platform 所需。在每個請求上作為 anthropic-workspace-id 標頭傳送
ANTHROPIC_BASE_URL 覆蓋 API 端點以透過代理或閘道路由請求。設定為非第一方主機時，MCP 工具搜尋 預設停用。如果您的代理轉發 tool_reference 區塊，請設定 ENABLE_TOOL_SEARCH=true。從 v2.1.196 開始，當此指向 api.anthropic.com 以外的主機時，Remote Control 停用，與其在 Amazon Bedrock、Google Cloud 的 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 跨區域推論設定檔前綴（us、eu、apac、jp、au 或 global）Claude Code 首先嘗試，而不是從 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 已傳送其需要的測試版標頭；在 Claude Code 新增原生支援之前，使用此變數選擇加入 Anthropic API 測試版。與需要 API 金鑰驗證的 --betas 旗標 不同，此變數適用於所有驗證方法，包括 Claude.ai 訂閱
ANTHROPIC_CUSTOM_HEADERS 要新增至請求的自訂標頭（Name: Value 格式，多個標頭以換行符分隔）。如果名稱或值包含 HTTP 標頭無法攜帶的字元（例如彎引號或零寬空格），請求會失敗並出現錯誤，該錯誤按位置識別該對。需要 Claude Code v2.1.227 或更新版本。無效的請求標頭值 列出確切的字元集以及檢查執行的位置。設定認證、組織或租戶、路由或 API 行為標頭（例如 Authorization 或 Host）的值在伺服器管理的設定傳遞時計為 需要批准的設定。從專案或本機設定，此類值遵循 何時 env 值適用的規則
ANTHROPIC_CUSTOM_MODEL_OPTION 模型 ID，作為自訂項目新增至 /model 選擇器。使用此選項可使非標準或閘道特定的模型可選，而無需替換內建別名。請參閱 模型設定
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，以及 Plan Mode 啟用時 opusplan 使用的模型 ID。請參閱 模型設定
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，以及 Plan Mode 未啟用時 opusplan 使用的模型 ID。請參閱 模型設定
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 工作負載身份聯盟 的聯盟規則 ID。當您將其與 ANTHROPIC_ORGANIZATION_ID 一起設定時，Claude Code 選擇聯盟認證，其優先於您的 /login 認證。請參閱 驗證優先順序
ANTHROPIC_FOUNDRY_API_KEY Microsoft Foundry 驗證的 API 金鑰（請參閱 Microsoft Foundry）
ANTHROPIC_FOUNDRY_AUTH_TOKEN Microsoft Foundry 驗證的持有人權杖，例如 Microsoft Entra 存取權杖。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 工作負載身份聯盟 的組織 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 的 Agent Platform 端點 URL。用於自訂 Google Cloud 的 Agent Platform 端點或透過 LLM 閘道 路由時。請參閱 Google Cloud 的 Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID Google Cloud 的 Agent Platform 請求所定址的 GCP 專案 ID。請參閱 設定 GCP 認證
ANTHROPIC_WORKSPACE_ID 工作負載身份聯盟 的工作區 ID。當您的聯盟規則範圍涵蓋多個工作區時設定此項，以便權杖交換知道要定位哪個工作區
API_FORCE_IDLE_TIMEOUT 覆蓋 5 分鐘的主體閒置逾時，當沒有位元組到達時中止串流模型回應。設定為 0 以關閉逾時，例如當緩慢的 閘道 或本機模型在區塊之間暫停超過 5 分鐘時，或設定為 1 以為每個提供者保持開啟。未設定時，逾時在直接 Anthropic API 和 AWS 上的 Claude Platform 以外的提供者上啟用。串流監視狗 獨立執行，即使您在此設定 0，也會中止長時間的無聲暫停
API_TIMEOUT_MS API 請求的逾時（毫秒）（預設：600000 或 10 分鐘；最大：2147483647）。在緩慢網路上或透過代理路由時請求逾時時增加此值。超過最大值的值會溢出基礎計時器，導致請求立即失敗
AWS_BEARER_TOKEN_BEDROCK Amazon Bedrock API 金鑰用於驗證（請參閱 Amazon Bedrock API 金鑰）
BASH_DEFAULT_TIMEOUT_MS 長時間執行 bash 命令的預設逾時（預設：120000 或 2 分鐘）
BASH_MAX_OUTPUT_LENGTH Claude Code 讀回命令結果的 bash 輸出的最大字元數（預設：30000；最大：150000）。如果您設定 bashOutputMaxChars 設定，Claude Code 會忽略此變數。請參閱 輸出限制
BASH_MAX_TIMEOUT_MS 模型可為長時間執行的 bash 命令設定的最大逾時（預設：600000 或 10 分鐘）。有效的上限是此值和 BASH_DEFAULT_TIMEOUT_MS 中的較大值
BETA_TRACING_ENDPOINT 詳細測試版追蹤 的 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 以停用所有內建 子代理 類型，例如 Explore 和 Plan。僅適用於非互動模式（-p 旗標）。對於想要空白狀態的 SDK 使用者很有用。這也會移除 general-purpose，即當 Agent 工具呼叫省略 subagent_type 時 Claude Code 執行的子代理。此類呼叫隨後會失敗，並出現 subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIX 設定為 1 以跳過來自 SDK 建立的 MCP 伺服器的工具名稱上的 mcp__<server>__ 前綴。工具使用其原始名稱。僅限 SDK 使用
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS 子代理的停滯逾時（毫秒）。預設 600000（10 分鐘）；如果您在串流監視狗開啟時提高 CLAUDE_STREAM_IDLE_TIMEOUT_MS，預設會隨之上升，如 處理緩慢或停滯的 API 回應 所述。計時器在每個串流進度事件上重設；如果在視窗內沒有進度到達，Claude Code 會中止子代理並向父代理報告停滯
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 設定自動壓縮視窗的百分比（1-100），自動壓縮在該百分比觸發。使用較低的值（如 50）以更早壓縮；變數無法提高閾值，因此高於預設百分比的值會被忽略。它僅適用於在模型的上下文限制之前 壓縮的工作階段。適用於主要對話和子代理
CLAUDE_AUTO_BACKGROUND_TASKS 設定為 1 以強制啟用長時間執行代理工作的自動背景化。啟用時，子代理在執行約兩分鐘後會移至背景。也在 Claude Code v2.1.212 或更新版本的非互動模式中啟用 長 MCP 工具呼叫的自動背景化
CLAUDE_AX_PREPARK_MS 在 螢幕閱讀器模式 中，Claude Code 在游標位於行首時等待多少毫秒，然後才寫入新的或變更的行。預設 50。設定 0 以立即寫入。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 上的背景工作階段和 代理檢視 上自動啟用此功能
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 以停止 Claude Code 在發佈新 成品 時自動開啟瀏覽器
CLAUDE_CODE_ARTIFACT_COMMENTS 設定為 0 以停止 Claude 讀取和回覆 成品上的評論。當 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 關閉成品 時無效。需要 Claude Code v2.1.221 或更新版本
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT 設定為 0 以停止 Claude 自行回覆傳送給它的評論。需要 Claude Code v2.1.228 或更新版本
CLAUDE_CODE_ATTRIBUTION_HEADER 設定為 0 以從系統提示的開頭省略 歸屬區塊，該區塊攜帶用戶端版本和提示指紋。直接連線到 Anthropic API 的快取無論如何都不受影響。在某些直接連線設定中，Claude Code 在 自動模式 分類器請求上保持區塊，即使您設定 0。在 系統提示歸屬區塊 中，檢查此涵蓋哪些連線和認證。在 v2.1.181 之前，該區塊在自訂基礎 URL 和 Microsoft Foundry 連線上包含每個請求的權杖，因此在這些版本上，當您的 LLM 閘道在請求主體上快取或將請求轉發給第三方提供者，或當您直接連線到 Microsoft Foundry 時，將其設定為 0
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS 啟用 CLAUDE_AUTO_BACKGROUND_TASKS 時，提醒 Claude 檢查仍在執行的 背景子代理 之間的秒數。僅接受 1 到 86400 的純整數；任何其他值或拼寫讀作未設定。未設定時，沒有檢查提醒。需要 Claude Code v2.1.248 或更新版本
CLAUDE_CODE_AUTO_COMPACT_WINDOW 設定 自動壓縮視窗（權杖），從 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、AWS 上的 Claude Platform 和 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 以使非互動工作階段在每個轉向結束時向其主機報告閒置狀態，即使背景工作仍在執行。預設情況下，工作階段在背景工作（例如背景代理或 工作流 執行）仍在進行時，會在轉向結束後繼續報告執行狀態。這可防止監視狀態的主機（例如遠端工作階段列表）在工作中途宣佈 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 終端中設定 0，其中 Backspace 刪除整個單詞
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 啟動子程序時由 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 視窗的模型上的工作階段保持在 200K 視窗，例如 Sonnet 5 和 Fable 模型；請參閱 擴充上下文 以了解如何強制執行保持。對於具有合規要求的企業環境很有用。對於其在為無法識別的 [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 命令變為不可用，任何配置的 advisorModel 都會被忽略，--advisor 旗標被接受但無效，因此傳遞它的現有指令碼繼續工作而不會出錯
CLAUDE_CODE_DISABLE_AGENT_VIEW 設定為 1 以關閉 背景代理和代理檢視：claude agents、--bg、/background 和隨選主管。等同於 disableAgentView 設定
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN 設定為 1 以停用 全螢幕呈現 並使用經典主螢幕呈現器。對話保留在您終端的原生捲軸中，因此 Cmd+f 和 tmux 複製模式可以正常工作。優先於 CLAUDE_CODE_NO_FLICKER 和 tui 設定。您也可以使用 /tui default 切換。不適用於從 代理檢視 開啟的背景工作階段，它們始終使用全螢幕呈現
CLAUDE_CODE_DISABLE_ARTIFACT 設定為 1 以關閉 成品 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。一旦設定，沒有設定檔會開啟工具。若要改從設定檔關閉工具，請將 enableArtifact 設定為 false；已棄用的 disableArtifact 金鑰也會關閉它
CLAUDE_CODE_DISABLE_ATTACHMENTS 設定為 1 以停用附件處理。使用 @ 語法的檔案提及會作為純文字傳送，而不是擴充為檔案內容
CLAUDE_CODE_DISABLE_AUTO_MEMORY 設定為 1 以停用 自動記憶。設定為 0 以強制啟用自動記憶，即使 --bare 模式或 autoMemoryEnabled: false 會否則停用它。停用時，Claude 不會建立或載入自動記憶檔案
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 設定為 1 以停用所有背景工作功能，包括 Bash 和子代理工具上的 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 內容類型。沒有此變數，當回應攜帶不同的內容類型時，Claude Code 會失敗請求，並出現命名該類型的錯誤，這意味著 閘道或代理正在轉換回應。設定閘道以未修改地轉發 Content-Type 標頭和主體，而不是設定此變數。需要 Claude Code v2.1.208 或更新版本
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF 設定為 1 以停止 背景工作階段 的執行背景 shell 命令、動態工作流，以及從 v2.1.198 開始的背景子代理，當 主管 停止、重新啟動或更新該工作階段的程序時，而不是將它們交給工作階段的下一個程序。僅影響該交付：使用 ← 或 /background 背景化工作階段仍會進行中的工作，CLAUDE_DISABLE_ADOPT 會關閉兩者。需要 Claude Code v2.1.196 或更新版本
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 設定為 1 以停止 Claude Code 在記憶體壓力下終止 背景 shell 命令。預設情況下，在 macOS 和 Linux 上，當作業系統報告關鍵記憶體壓力且工作階段已閒置 30 分鐘且沒有轉向或子代理執行時，Claude Code 會終止背景 shell。Windows 沒有記憶體壓力信號，因此此變數在那裡無效。需要 Claude Code v2.1.193 或更新版本
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 設定為 1 以停用 Claude Code 包含的 技能 和工作流：捆綁的技能和工作流會完全移除，而內建命令（如 /init）保持可輸入但對模型隱藏。/doctor 保持可輸入，如內建命令；使用 DISABLE_DOCTOR_COMMAND 隱藏它。來自外掛程式、.claude/skills/ 和 .claude/commands/ 的技能不受影響。等同於 disableBundledSkills 設定
CLAUDE_CODE_DISABLE_CFC_PROMPT 設定為 1 以保持 Chrome 中的 Claude 瀏覽器工具可用，同時省略系統提示的 Chrome 部分和 /claude-in-chrome 捆綁技能。適用於嵌入 Claude Code 並提供自己的瀏覽器指導的主機。需要 Claude Code v2.1.257 或更新版本
CLAUDE_CODE_DISABLE_CLAUDE_MDS 設定為 1 以防止將任何 CLAUDE.md 記憶體檔案載入上下文，包括使用者、專案和自動記憶檔案
CLAUDE_CODE_DISABLE_CRON 設定為 1 以停用 排程工作。/loop 技能和 cron 工具變為不可用，任何已排程的工作停止觸發，包括已在工作階段中執行的工作
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 設定為 1 以從 API 請求中移除 Anthropic 特定的 anthropic-beta 請求標頭和測試版工具架構欄位（例如 defer_loading 和 eager_input_streaming）。當代理閘道拒絕請求並出現錯誤（例如「anthropic-beta 標頭的意外值」或「不允許額外輸入」）時使用此選項。標準欄位（name、description、input_schema、cache_control）會保留。MCP 工具搜尋 停用，所有 MCP 工具會預先載入，即使您設定 ENABLE_TOOL_SEARCH。在 Claude Code v2.1.227 或更新版本上，受管設定 可以保持工具搜尋開啟。停用預發行功能 涵蓋覆蓋適用的位置
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS 設定為 1 以停用內建 Explore 和 Plan 子代理。Claude 改用其搜尋工具或通用子代理進行探索，計畫模式 直接讀取檔案，而不是啟動 Explore 和 Plan 代理。名為 Explore 或 Plan 的自訂子代理不受影響。若要在 Agent SDK 或非互動模式中移除每個內建子代理類型，請改用 CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS。需要 Claude Code v2.1.198 或更新版本
CLAUDE_CODE_DISABLE_FAST_MODE 設定為 1 以停用 快速模式
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY 設定為 1 以停用「Claude 表現如何？」工作階段品質調查。當設定 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 以移除內建提交和 PR 工作流指示以及 Claude 上下文中的 git 狀態快照。在使用您自己的 git 工作流技能時很有用。設定時優先於 includeGitInstructions 設定
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP 設定為 1 以防止在 Anthropic API 上自動重新對應 Opus 4.0 和 4.1 到目前的 Opus 版本。在您想要有意釘選較舊模型時使用。重新對應不在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上執行
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 在 Claude Code 將它們傳送到 Agent SDK 的 canUseTool 回呼的工作階段中執行 未回答權限請求的 Notification hooks，這是 Claude Desktop 和 VS Code 擴充功能主機 Claude Code 的方式。在終端工作階段中無效。需要 Claude Code v2.1.233 或更新版本
CLAUDE_CODE_DISABLE_POLICY_SKILLS 設定為 1 以跳過從系統範圍受管技能目錄載入技能。對於不應載入操作員佈建技能的容器或 CI 工作階段很有用
CLAUDE_CODE_DISABLE_TERMINAL_TITLE 設定為 1 以停用基於對話上下文的自動終端標題更新。這也會跳過 產生工作階段標題 的背景小型/快速模型請求
CLAUDE_CODE_DISABLE_THINKING 設定為 1 以從 API 請求中完全省略 thinking 參數。這是代理和閘道拒絕參數的相容性選項。在預設思考的模型上，省略參數意味著模型可能仍然思考。若要在 Anthropic API 上明確停用 擴充思考，請改用 MAX_THINKING_TOKENS=0。兩個變數都不會在 Opus 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_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 的 Agent Platform、Microsoft Foundry 和已登入的 Claude 應用程式閘道 工作階段。在 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 繫結的非必要流量被阻止時將「Claude 表現如何？」工作階段品質調查路由到您自己的 OpenTelemetry 收集器。調查評分僅作為 OTEL 事件發出到您配置的收集器。在此模式中，沒有調查資料傳送到 Anthropic。當設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY 或 DO_NOT_TRACK 時適用，否則無效。CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY 和組織產品回饋政策優先
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING 控制工具呼叫輸入是否在 API 產生時從 API 串流。關閉此選項時，大型工具輸入（例如長檔案寫入）僅在 Claude 完成產生後到達，這可能看起來像它掛起。在 Anthropic API 上預設啟用。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 上，在部署的容器支援的每個模型上啟用。設定為 0 以選擇退出。設定為 1 以在透過 ANTHROPIC_BASE_URL、ANTHROPIC_VERTEX_BASE_URL 或 ANTHROPIC_BEDROCK_BASE_URL 透過代理路由時強制開啟。在 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 中的提示建議切換寫入的。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 預設僅在 工作工具可用性 下列出的模型上提供它們。CLAUDE_CODE_ENABLE_TASKS 仍選擇 Task 工具或 TodoWrite。需要 Claude Code v2.1.233 或更新版本
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY 查詢迴圈變為閒置後自動退出前等待的時間（毫秒）。對於使用 SDK 模式的自動化工作流和指令碼很有用
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 設定為 1 以啟用 代理團隊。代理團隊是實驗性的，預設停用
CLAUDE_CODE_EXTRA_BODY JSON 物件以合併到每個 API 請求主體的頂層。對於傳遞 Claude Code 不直接公開的提供者特定參數很有用。在 shell 中匯出的值也適用於您使用 claude agents 或 --bg 分派的 背景工作階段。在 v2.1.206 之前，背景工作階段忽略 shell 匯出的值，並使用背景主管程序繼承的任何副本
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS 覆蓋檔案讀取的預設權杖限制。當您需要完整讀取較大的檔案時很有用
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 以在您的終端支援但未自動偵測時強制 ~~text~~ 的刪除線呈現，例如透過 SSH 而不轉發 TERM_PROGRAM。沒有此項，未偵測的終端會顯示文字刪除線標記而不是呈現為刪除線。需要 Claude Code v2.1.186 或更新版本
CLAUDE_CODE_FORCE_SYNC_OUTPUT 設定為 1 以在您的終端支援但未自動偵測時強制啟用 DEC 私人模式 2026 同步輸出。對於實現 BSU/ESU 但不回覆功能探測的模擬器（例如 Emacs eat）很有用。在 tmux 下無效。與 全螢幕呈現 的 CLAUDE_CODE_NO_FLICKER 不同，這不會變更呈現器
CLAUDE_CODE_FORK_SUBAGENT 控制 fork 模式，它讓 Claude 產生 forked 子代理 本身，在互動工作階段中預設開啟。設定為 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 輸出中發出 子代理 文字和思考區塊，與 --forward-subagent-text 旗標相同的行為。當工具呼叫 claude 的工具無法自己傳遞旗標時使用變數。與旗標不同，旗標在非互動模式下使用 stream-json 輸出時以錯誤退出，變數在那裡被忽略，以便嵌套呼叫在全程設定時繼續工作。需要 Claude Code v2.1.211 或更新版本
CLAUDE_CODE_GATEWAY_HINT_HEADERS 設定為 1 以在自訂代理或第三方提供者（例如 Amazon Bedrock 或 AWS 上的 Claude Platform）上傳送 閘道提示標頭（例如 x-claude-code-request-class 和 x-claude-code-compaction）。設定為 0 以停止在每個連線上傳送它們，包括 Claude Code 預設傳送的直接 Anthropic API 連線。需要 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 工具 時從結果中排除隱藏檔案。預設包含。不影響 @ 檔案自動完成、ls、Grep 或 Read
CLAUDE_CODE_GLOB_NO_IGNORE 設定為 false 以使 Glob 工具 尊重 .gitignore 模式。預設情況下，Glob 傳回所有符合的檔案，包括 gitignored 的檔案。不影響 @ 檔案自動完成，它有自己的 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 以在啟動標誌中隱藏工作目錄。對於螢幕共享或錄製很有用，其中路徑會公開您的 OS 使用者名稱
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 鎖定檔案項目的驗證。當自動連線無法找到您的 IDE 儘管它執行時使用
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 在 Agent 工具拒絕產生另一個之前，一個工作階段中可以執行多少 子代理（預設：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 為大多數請求設定最大輸出權杖數。預設值和上限因模型而異；請參閱 最大輸出權杖。Claude Code 為不識別的模型 ID（例如閘道特定名稱）預設為 32000，並將高於模型上限的值降低到上限。增加此值會減少 自動壓縮 觸發前可用的有效上下文視窗
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 工具產生的 子代理 總數（預設：200）；超過上限的產生失敗，並出現 Subagent spawn limit reached。並行子代理限制 和 深度限制 仍然適用
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 主要對話下方允許的 子代理層 數（預設：3）。在預設值，子代理可以產生自己的子代理，第三層的子代理無法進一步產生；設定 1 以關閉嵌套。在 v2.1.217 到 v2.1.218 中，預設為 1，因此子代理無法產生自己的，除非您提高限制；v2.1.219 將預設提高到 3。接受純數字的正整數；任何其他值都被忽略，因此限制可以調整但無法移除。需要 Claude Code v2.1.217 或更新版本
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY 可以並行執行的唯讀工具和子代理的最大數量（預設：10）。較高的值會增加並行性，但消耗更多資源
CLAUDE_CODE_MAX_TURNS 當未傳遞明確限制時，上限代理轉向數。等同於傳遞 --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 中的每個伺服器 timeout 至少 1000 會將該伺服器的閒置視窗提高到至少 timeout 值。不適用於 IDE 伺服器或 SDK 進程內伺服器。需要 Claude Code v2.1.187 或更新版本。在 v2.1.203 之前，stdio 伺服器免除閒置逾時
CLAUDE_CODE_MESSAGING_SOCKET 由 Claude Code 設定，不由您設定：在繫結 收件匣通訊端 的工作階段中，Claude Code 在繫結通訊端時將該通訊端的路徑匯出到 hooks 和 Bash 命令。在以啟用傳訊開始的工作階段中，Claude Code 在任何 hook 執行之前繫結通訊端。機器上的其他工作階段將訊息傳遞到此路徑。每個工作階段匯出自己的通訊端，而不是從父工作階段繼承的通訊端，到達它的訊息會透過工作階段的 入站控制 進行。設定 env 區塊無法設定它。需要 Claude Code v2.1.224 或更新版本
CLAUDE_CODE_MESSAGING_TOKEN 由 Claude Code 設定，不由您設定：在繫結 收件匣通訊端 的工作階段中，Claude Code 將此每個工作階段權杖匯出到 hooks 和 Bash 命令，與 CLAUDE_CODE_MESSAGING_SOCKET 一起。發佈到通訊端的指令碼可以傳送 {"type":"auth","token":"<token>"} 作為其第一行以證明它屬於工作階段。在原生 Windows 上，Claude Code 需要此行並關閉任何未使用有效行開啟的連線。自有子規則 說明 Claude Code 何時查詢權杖。每個工作階段匯出自己的權杖，絕不是從父工作階段繼承的。設定 env 區塊無法設定它。需要 Claude Code v2.1.228 或更新版本
CLAUDE_CODE_NATIVE_CURSOR 設定為 1 以在輸入插入符號處顯示終端自己的游標，而不是繪製的區塊。游標尊重終端的閃爍、形狀和焦點設定
CLAUDE_CODE_NEW_INIT 設定為 1 以使 /init 執行互動設定流程。流程會詢問要產生哪些檔案，包括 CLAUDE.md、技能和 hooks，然後再探索程式碼庫並寫入它們。沒有此變數，/init 會自動產生 CLAUDE.md，而不提示
CLAUDE_CODE_NONBLOCKING_STDOUT 設定為 1 以透過第二個非阻塞檔案描述符寫入終端輸出，因此停止讀取的終端（例如暫停的 tmux 控制模式窗格或停滯的 SSH 連線）無法在工作階段中途凍結 Claude Code。在 macOS、Linux 和 WSL 上當 stdout 是終端時適用。需要 Claude Code v2.1.261 或更新版本
CLAUDE_CODE_NO_FLICKER 設定為 1 以啟用 全螢幕呈現，一項減少閃爍並在長對話中保持記憶體平坦的研究預覽。覆蓋 tui 設定；您也可以使用 /tui fullscreen 切換
CLAUDE_CODE_OAUTH_REFRESH_TOKEN Claude.ai 驗證的 OAuth 重新整理權杖。設定時，claude auth login 直接交換此權杖，而不是開啟瀏覽器。需要 CLAUDE_CODE_OAUTH_SCOPES。對於在自動化環境中佈建驗證很有用
CLAUDE_CODE_OAUTH_SCOPES 重新整理權杖發出時使用的空格分隔 OAuth 範圍，例如 "user:profile user:inference user:sessions:claude_code"。設定 CLAUDE_CODE_OAUTH_REFRESH_TOKEN 時為必需
CLAUDE_CODE_OAUTH_TOKEN claude.ai 驗證的 OAuth 存取權杖。/login 對 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 claude setup-token 產生一個。除非您執行 /login，Claude Code 會在整個工作階段中使用您設定的權杖。若要替換過期的權杖，產生新的並重新啟動
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 跨度的逾時（毫秒）（預設：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 複製或重新整理外掛程式市場的逾時（毫秒）（預設：120000）。對於大型儲存庫或緩慢網路連線，增加此值。請參閱 Git 複製逾時
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 設定為 1 以在市場重新整理無法到達或驗證遠端時跳過重新複製嘗試，並繼續使用現有市場簽出。在無法重新複製會以相同方式失敗的離線或隔離環境中很有用。請參閱 市場更新在離線環境中持續失敗
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 在啟動時從這些目錄註冊市場，並使用預先快取的外掛程式而不重新複製。請參閱 為容器預先填充外掛程式
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY 設定為 1 以停止 Claude Code 在為工具呼叫、hooks 和狀態列命令產生 PowerShell 時傳遞 -ExecutionPolicy Bypass，並改為尊重機器的有效執行政策。預設情況下，Claude Code 在程序範圍內繞過執行政策，以便 .ps1 指令碼和模組匯入在預設限制的 Windows 安裝上工作。程序範圍繞過無論此設定如何都絕不會覆蓋 Group Policy MachinePolicy 或 UserPolicy
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS 在 非互動模式 中使用 -p 旗標在最終轉向後等待背景子代理和工作流的閒置等待上限（毫秒）。每次 Claude 採取轉向來處理背景結果時，閒置等待重新開始。預設：600000 或 10 分鐘。當閒置等待達到上限時，Claude Code 停止等待剩餘的背景工作並退出。設定為 0 以無限期等待。此上限與適用於純背景 shell 的五秒寬限期分開。需要 Claude Code v2.1.182 或更新版本
CLAUDE_CODE_PROCESS_WRAPPER 透過公司啟動器啟動 Claude Code 從其自己的二進位檔啟動的程序，例如主機 代理檢視 工作階段的背景服務，給定為 argv 前綴，如 /opt/corp/launcher。在使用者或 受管設定 的 env 區塊中設定它，而不是作為 shell 匯出，以便分離的背景服務繼承它；專案和本機設定無法設定它。等同於 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 一起設定以選擇 projects/ 目錄名稱，Claude Code 在其下儲存該工作階段的文字記錄和自動記憶，代替從工作目錄路徑衍生的名稱。例如，使用 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 追蹤上下文。傳播涵蓋模型和 HTTP MCP 請求上的 traceparent 標頭以及 Bash、PowerShell 和 hook 子程序的 TRACEPARENT 環境變數。預設情況下，傳播僅在直接連線到 Anthropic API 時啟用。在 v2.1.152 中新增。請參閱 追蹤（測試版）
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、AWS 上的 Claude Platform、Google Cloud 的 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。在 v2.1.221 之前，Claude Code 忽略 0 和其他虛假值，因此在非互動模式中設定 0 仍會觸發繼續，取消設定變數是關閉它的唯一方法
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS 最後文字記錄訊息的最大年齡（毫秒），以便在中途結束的工作階段在繼續時自動繼續。當最後訊息比此界限更舊時，Claude Code 會跳過 CLAUDE_CODE_RESUME_INTERRUPTED_TURN 自動繼續及其 CLAUDE_CODE_RESUME_PROMPT 繼續訊息，工作階段啟動閒置，以便您明確繼續。未設定或 0 表示無界限，除了最後請求因 API 錯誤失敗的轉向僅在該錯誤少於六小時時繼續。正值界限每個轉向，包括那些；負值或非數值值應用一小時界限。長時間執行代理的產生指令碼可以設定此項，以便針對舊文字記錄的重新啟動不會重新執行過時的提示。Claude Code 在重新啟動從互動工作階段繼承其對話的崩潰 代理檢視 工作階段時自己設定一小時界限。需要 Claude Code v2.1.211 或更新版本
CLAUDE_CODE_RESUME_PROMPT 覆蓋 Claude Code 在 CLAUDE_CODE_RESUME_INTERRUPTED_TURN 繼續中途轉向而不是重新傳送其提示時傳送給 Claude 的繼續訊息，或當您使用 -p 繼續 延遲工具呼叫 時。預設為 Continue from where you left off.。空字串使用預設值
CLAUDE_CODE_RETRY_WATCHDOG 設定為 1 用於無人值守工作階段，例如評估工具、CI 工作或遠端工作者。無限期重試 429 和 529 容量錯誤，而不是在 CLAUDE_CODE_MAX_RETRIES 嘗試後失敗。當標準速度請求取得報告支出限制或耗盡使用額度的 429（即使來自重設時間表的 閘道支出上限）時，Claude Code 立即失敗。在 v2.1.239 之前，監視狗無限期重試這些。對於快速模式請求，請參閱 處理速率限制。監視狗在嘗試之間備份最多 5 分鐘，或直到限制重設（當回應攜帶速率限制重設時間時），因此達到使用限制的工作階段會等待剩餘視窗。在 v2.1.199 或更新版本上，它也為其他暫時性錯誤（例如伺服器錯誤、逾時和丟棄的連線）提高預設重試計數為 300，大約三小時的備份，如果您明確設定該變數，則移除 CLAUDE_CODE_MAX_RETRIES 的 15 上限。需要 Claude Code v2.1.186 或更新版本
CLAUDE_CODE_SAFE_MODE 設定為 1 以在安全模式中啟動：CLAUDE.md、技能、外掛程式、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流、自訂主題、自訂快捷鍵、狀態列和檔案建議命令、LSP 伺服器和自動記憶不載入，用於疑難排解損壞的設定。受管設定政策仍然適用，包括政策配置的 hooks、狀態列和檔案建議命令；受管外掛程式、受管技能、受管 CLAUDE.md 和政策配置的 MCP 伺服器不適用。等同於傳遞 --safe-mode。直接產生的子程序繼承變數
CLAUDE_CODE_SCRIPT_CAPS JSON 物件，限制當設定 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 時特定指令碼在每個工作階段中可能被呼叫的次數。金鑰是針對命令文字進行的子字串比對；值是整數呼叫限制。例如，{"deploy.sh": 2} 允許 deploy.sh 最多被呼叫兩次。比對是基於子字串的，因此 shell 擴充技巧（如 ./scripts/deploy.sh $(evil)）仍然計入上限。透過 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 hooks 的時間預算（毫秒）。值也是未設定自己 timeout 的每個 hook 的逾時。適用於工作階段退出、/clear 和透過互動 /resume 切換工作階段。預設情況下，預算為 1.5 秒，自動提高到設定檔中配置的最高每個 hook timeout，最多 60 秒。外掛程式提供的 hooks 上的逾時不會提高預算
CLAUDE_CODE_SESSION_ID 在 Bash 和 PowerShell 工具子程序、hook 命令 子程序和 stdio MCP 伺服器 子程序中自動設定為目前工作階段 ID。對於 Bash、PowerShell 和 hooks，這符合 hook JSON 輸入中的 session_id 欄位，並在 /clear 上更新。MCP 伺服器子程序保留它產生時的 ID。在 --resume <session-id> 上，它接收繼續的 ID，符合 hooks 和 Bash。在 --continue 或 --resume 沒有明確 ID 上，它可能改為接收初始啟動 ID。用於將指令碼和外部工具與啟動它們的 Claude Code 工作階段相關聯
CLAUDE_CODE_SHELL 設定 Claude Code 用於執行 Bash 工具命令的 shell。接受 bash 或 zsh 二進位檔的路徑，例如 /opt/homebrew/bin/bash。不支援 fish 等其他 shell。如果值不是工作的 bash 或 zsh 路徑，Claude Code 會忽略它並回退到自動偵測。自動偵測在指向 bash 或 zsh 時使用您的 $SHELL，否則它選擇在您的 PATH 和標準安裝位置上找到的第一個工作 zsh，然後 bash
CLAUDE_CODE_SHELL_PREFIX 包裝 Claude Code 產生的 shell 命令的命令前綴：Bash 工具呼叫、hook 命令、狀態列 命令和 stdio MCP 伺服器 啟動命令。PowerShell hooks 和 exec 形式 hooks 執行時不帶前綴。對於日誌記錄或稽核很有用。設定裸可執行檔路徑（例如 /path/to/logger.sh）將每個命令執行為 /path/to/logger.sh '<command>'。包裝器在 $1 中接收命令列作為單一 shell 引用的引數，因此包裝器必須使用 shell 重新評估 $1，例如 exec bash -c "$1"。將 $1 視為裸可執行檔路徑會破壞傳遞引數的 stdio MCP 伺服器，例如 npx -y <package>。對於 Bash 工具呼叫，$1 包含 Claude Code 組合的完整 shell 呼叫，包括環境設定，而不僅僅是 Claude 執行的命令
CLAUDE_CODE_SIMPLE 設定為 1 以使用最小系統提示和僅 Bash、檔案讀取和檔案編輯工具執行。來自 --mcp-config 的 MCP 工具仍然可用。停用 hooks、技能、自訂命令、子代理、已安裝外掛程式、MCP 伺服器、自動記憶和 CLAUDE.md 的自動探索。您使用 --add-dir 傳遞的目錄中的技能仍然載入。OAuth 權杖和鑰匙圈認證不被讀取，因此 Anthropic 驗證必須來自 ANTHROPIC_API_KEY 或 --settings 中的 apiKeyHelper。等同於傳遞 --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT 設定為 1 以在任何模型上使用較短的系統提示和縮寫工具說明。設定為 0、false、no 或 off 以選擇退出，即使實驗或伺服器設定會否則啟用它。完整工具集、hooks、MCP 伺服器和 CLAUDE.md 探索保持啟用
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH 跳過 AWS 上的 Claude Platform 的用戶端驗證，用於自己簽署請求的閘道
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 仍然尊重「您的組織停用了快速模式」回應
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 之前，此變數使 Microsoft Foundry 用戶端無法傳送請求，除非同時設定了 API 金鑰
CLAUDE_CODE_SKIP_MANTLE_AUTH 跳過 Amazon Bedrock Mantle 的 AWS 驗證（例如，使用 LLM 閘道時）
CLAUDE_CODE_SKIP_PROMPT_HISTORY 設定為 1 以跳過將提示歷史記錄和工作階段文字記錄寫入磁碟。使用此變數啟動的工作階段不會出現在 --resume、--continue 或向上箭頭歷史記錄中。對於暫時指令碼工作階段很有用
CLAUDE_CODE_SKIP_VERTEX_AUTH 跳過 Google Cloud 的 Agent Platform 的 Google 驗證（例如，使用 LLM 閘道時）
CLAUDE_CODE_STARTUP_FAILURE_RESULTS 設定為 1 以讓以 --output-format stream-json 啟動的工作階段為啟動失敗寫入 結果訊息，命名 Claude Code 拒絕啟動的原因，否則以 stderr 結尾。需要 Claude Code v2.1.274 或更新版本
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Stop 或 SubagentStop hook 可能在 Claude Code 覆蓋它並結束轉向之前連續阻止轉向結束的最大次數（預設：8）。設定為 0 以停用上限。如果您的 hook 合法需要更多迭代來解決，請提高此值
CLAUDE_CODE_SUBAGENT_MODEL 子代理、代理團隊 隊友和 工作流 代理的預設模型，這些代理未以其他方式指派模型。接受別名（例如 haiku）或完整模型名稱。兩個來源優先於它：Claude 產生代理時傳遞的模型，以及代理定義中的 model 欄位，包括 inherit。若要變更該項，請設定 CLAUDE_CODE_SUBAGENT_MODEL_FORCE。請參閱 選擇模型 以了解完整順序。將其設定為 inherit 與保持未設定相同。在 v2.1.251 之前，此變數覆蓋了每個呼叫模型和定義的 model 欄位
CLAUDE_CODE_SUBAGENT_MODEL_FORCE 設定為 1 以強制一個模型到子代理、隊友和工作流代理。在一個模型上執行每個子代理 說明那是哪個模型。需要 Claude Code v2.1.257 或更新版本
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL 設定 5m 或 1h，Claude Code 接受的唯一值，以選擇主要對話外請求的 提示快取 TTL，例如 子代理、工作流和背景工作。優先於 subagentPromptCacheTtl 設定和 ENABLE_PROMPT_CACHING_1H，FORCE_PROMPT_CACHING_5M 覆蓋它。API 以更高的速率計費 1 小時快取寫入。需要 Claude Code v2.1.242 或更新版本
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 設定為 1 以從子程序環境中移除認證（Bash 工具、hooks、MCP stdio 伺服器）：Anthropic 和雲提供者認證、Claude Code 識別為認證的任何其他變數，以及嵌入在套件登錄 URL 中的認證。父 Claude 程序保留這些認證用於 API 呼叫，但子程序無法讀取它們，減少試圖透過 shell 擴充洩露機密的提示注入攻擊的曝光。在 v2.1.251 或更新版本上，擦除也移除 Claude Code 自己的設定存放區指標變數（例如 CLAUDE_CONFIG_DIR），因此子程序無法找到重新定位的設定目錄。如果子程序需要這些變數，請保持擦除未設定。在 Linux 上，這也在隔離的 PID 命名空間中執行 Bash 子程序，以便它們無法透過 /proc 讀取主機程序環境；作為副作用，ps、pgrep 和 kill 無法看到或發信號給主機程序。claude-code-action 在設定 allowed_non_write_users 時自動設定此項
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 在非互動模式中設定為 1，使用 -p 旗標，以使 Claude Code 下載為您的 claude.ai 帳戶啟用的技能在該執行中，並等待它們的清單，最多 CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS，然後才執行第一個查詢。下載本身在背景完成，Claude 在呼叫該技能時等待技能的下載。需要 claude.ai 驗證。您登入 claude.ai 帳戶的終端工作階段 下載這些技能 到 ~/.claude/skills/synced/ 並大約每 10 分鐘重新同步，而不需要此變數，因此僅在 -p 執行需要您目前技能在其第一個查詢上時設定它。在 v2.1.273 之前，終端工作階段僅在帶有此變數集的 -p 執行中下載它們。synced 資料夾名稱 保留用於此下載。在 v2.1.227 之前，技能直接下載到 ~/.claude/skills/。Claude Code 對下載的技能應用 額外規則，例如不在您的機器上執行其 ! 命令
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS 當在 Agent SDK 上建立的應用程式重新載入技能時執行的技能重新同步的逾時（毫秒）（預設：30000）。超過時，重新載入繼續進行，無論已到達哪些技能，剩餘下載在背景完成
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS 當設定 CLAUDE_CODE_SYNC_SKILLS 時，第一個查詢等待初始技能清單的逾時（毫秒）（預設：5000）。超過時，第一個查詢執行，無論已到達哪些技能。下載無論如何都在背景完成，Claude 在呼叫該技能時等待技能的下載
CLAUDE_CODE_SYNTAX_HIGHLIGHT 設定為 false 以停用差異輸出中的語法醒目提示。當顏色干擾您的終端設定時很有用。若要也停用程式碼區塊和檔案預覽中的醒目提示，請使用 syntaxHighlightingDisabled 設定
CLAUDE_CODE_TASK_LIST_ID 跨工作階段共享工作清單。在多個 Claude Code 執行個體中設定相同的 ID 以在 具有 Task 工具的工作階段 中協調共享工作清單。請參閱 工作清單
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS 覆蓋非互動工作階段在退出時等待其 代理團隊 完成拆卸的時間（毫秒）。接受 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。Claude Code 自己的暫時檔案始終使用您的覆蓋。在您的 shell、使用者設定或受管設定中設定它。在 專案和本機設定 中忽略
CLAUDE_CODE_TMUX_TRUECOLOR 設定為任何非空值（例如 1）以允許 tmux 內的 24 位真彩色輸出。將其設定為 0 或 false 仍允許真彩色，與大多數開啟/關閉變數不同；取消設定變數以恢復 256 色限制。預設情況下，當設定 $TMUX 時，Claude Code 限制為 256 色，因為 tmux 不會透過真彩色逃逸序列，除非設定。在將 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 使用 AWS 上的 Claude Platform
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 探索自訂命令、子代理和輸出樣式。如果捆綁的 ripgrep 二進位檔在您的環境中不可用或被阻止，請設定此項。不影響 Grep 或檔案搜尋工具
CLAUDE_CODE_USE_POWERSHELL_TOOL 控制 PowerShell 工具。在沒有 Git Bash 的 Windows 上，工具自動啟用；設定為 0 以停用它。在安裝了 Git Bash 的 Windows 上，工具預設為 claude.ai 和 Console 帳戶開啟；設定為 1 以在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 工作階段中啟用它，或設定為 0 以關閉它。在 Linux、macOS 和 WSL 上，設定為 1 以啟用它，這需要您的 PATH 上的 pwsh。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不是透過 Git Bash 路由。請參閱 PowerShell 工具
CLAUDE_CODE_USE_VERTEX 使用 Google Cloud 的 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 單個 工作流 執行一次執行的代理數，從 1 到 256。預設情況下，執行一次執行最多 16 個代理，當 Claude Code 有更少 CPU 可用時更少；排隊的 agent() 呼叫等待空閒插槽。每個執行中代理的文字記錄保留在 Claude Code 的記憶體中，因此較高的值會提高記憶體使用。僅接受純數字；超出範圍的值和其他拼寫保持預設。需要 Claude Code v2.1.269 或更新版本
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS 工作流 代理等待相同前綴同級的第一個回應開始的上限（毫秒），然後才傳送自己的第一個請求。當扇出啟動共享 提示快取前綴 的多個代理時，Claude Code 將除第一個外的所有代理保持最多此長時間，以便其餘代理讀取快取的前綴，而不是每個未快取地處理它。預設 5000。設定為 0 以停用等待。當設定 DISABLE_PROMPT_CACHING 時，代理絕不會等待。需要 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。Ultracode 不是不同的級別，報告為 xhigh。符合傳遞給 hooks 的 effort.level 欄位。僅在目前模型支援 effort 參數時設定
CLAUDE_ENABLE_BYTE_WATCHDOG 設定為 1 以強制啟用位元組級串流閒置監視狗，或設定為 0 以強制停用它。0 也會在執行該期限的連線上關閉 第一位元組期限。未設定時，監視狗預設在直接 Anthropic API 和 AWS 上的 Claude Platform 連線上啟用，以及透過 ANTHROPIC_BASE_URL 或 ANTHROPIC_AWS_BASE_URL 到達的 閘道 連線上的串流回應；在 v2.1.222 之前，它不在這些閘道連線上執行，因此事件級監視狗可能在那裡報告停滯，即使保活 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 在同一 shell 程序中的每個 Bash 命令之前執行，因此檔案中的匯出對命令可見。用於在命令之間保持 virtualenv 或 conda 啟用。也由 SessionStart、Setup、CwdChanged 和 FileChanged hooks 動態填充
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 中移除，現在是無操作。先前上限了 背景 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 設定檢查技能及其 /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 的 Agent Platform 或 Microsoft Foundry）時已隱藏
DISABLE_INTERLEAVED_THINKING 設定為 1 以防止傳送交錯思考測試版標頭。當您的 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_GROWTHBOOK 相同，使 Remote Control 和其他 需要功能旗標擷取的功能 不可用。請參閱 為您的組織關閉遙測
DISABLE_UPDATES 設定為 1 以阻止所有更新，包括手動 claude update 和 claude install。比 DISABLE_AUTOUPDATER 更嚴格。在透過您自己的通道分發 Claude Code 且使用者不應自行更新時使用
DISABLE_UPGRADE_COMMAND 設定為 1 以隱藏 /upgrade 命令
DO_NOT_TRACK 設定為 1 以選擇退出遙測，效果與 DISABLE_TELEMETRY 相同，包括使 Remote Control 和其他 需要功能旗標擷取的功能 不可用。Claude Code 將此變數讀作標準布林值，因此 0 保持遙測開啟，並尊重許多開發人員 CLI 識別的跨工具慣例
ENABLE_BETA_TRACING_DETAILED 設定為 1，與 BETA_TRACING_ENDPOINT 一起，以開啟 詳細測試版追蹤，這會新增內容承載跨度屬性和 claude_code.hook 跨度。互動 CLI 工作階段也需要您的組織被允許列出測試版。兩個變數在 專案和本機設定 中被忽略
ENABLE_CLAUDEAI_MCP_SERVERS 設定為 false 以停止 Claude Code 擷取 claude.ai MCP 伺服器。對於已登入的使用者預設啟用。若要按專案或按組織停用，請改設定設定中的 disableClaudeAiConnectors
ENABLE_PROMPT_CACHING_1H 設定為 1 以要求 1 小時 提示快取 TTL，而不是預設 5 分鐘。適用於 API 金鑰、Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 和 AWS 上的 Claude Platform 使用者。訂閱使用者在包含的使用量內會自動在 主要對話 上接收 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 工具搜尋。未設定時，Claude Code 預設延遲所有 MCP 工具。它仍在早於 Claude 4.5 代的 Google Cloud 的 Agent Platform 模型上預先載入它們，在 Azure 上託管的 Microsoft Foundry 部署上，以及當 ANTHROPIC_BASE_URL 指向非第一方主機時。true 始終延遲並傳送測試版標頭，除了在這些相同的 Agent Platform 模型和 Microsoft Foundry 部署上；請求在不支援 tool_reference 的代理上失敗。auto 在工具定義符合上下文的 10% 時預先載入。auto:N 設定自訂閾值，例如 5% 的 auto:5。false 預先載入所有工具。您自己設定的值在設定 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 時被忽略。在 v2.1.221 之前，Claude Code 停用了 Google Cloud 的 Agent Platform 上所有模型的工具搜尋，除非您將此變數設定為 true
FALLBACK_FOR_ALL_PRIMARY_MODELS 設定為任何非空值（例如 1），以使 Claude Code 在未設定回退模型時停止在重複過載錯誤上重試每個模型。將其設定為 0 或 false 仍會啟用此項，與大多數開啟/關閉變數不同；取消設定變數以恢復預設重試行為。沒有它，Claude Code 在您使用 API 金鑰或 第三方提供者 而不是 Claude 訂閱進行驗證時，停止以此方式重試它識別為 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 工具回應中允許的最大權杖數。Claude Code 在輸出超過 10,000 權杖時顯示警告。宣告 anthropic/maxResultSizeChars 的工具改為使用該字元限制用於文字內容，但來自這些工具的影像內容仍受此變數限制（預設：25000）
MAX_STRUCTURED_OUTPUT_RETRIES 當模型的回應無法針對非互動模式中的 -p 旗標的 --json-schema 驗證時，Claude Code 允許的嘗試次數；在那麼多次失敗的嘗試後沒有有效輸出，執行失敗。當 工作流 子代理的結構化輸出無法驗證時，相同的上限適用。預設為 5，第一次嘗試加四次重試
MAX_THINKING_TOKENS 擴充思考 的固定權杖預算。Claude Code 將其上限設為請求最大輸出權杖下方一個權杖，絕不低於 1,024。請參閱 CLAUDE_CODE_MAX_OUTPUT_TOKENS 以了解該限制如何設定。未設定時，具有 自適應推理 的模型選擇自己的思考深度，其他模型使用上限。設定為 0 以在 Anthropic API 上停用思考，除了 Opus 5.5 和 Fable 模型，它們無法關閉思考。在 第三方提供者 上，0 改為省略 thinking 參數。在 Anthropic API 上關閉思考時，Claude Code 改為傳送 effort high 到它知道 不接受該組合 的模型，例如 Opus 5。Claude Code 在自適應推理模型上忽略非零值，除了 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 關閉自適應推理的模型
MCP_CLIENT_SECRET 需要 預先配置認證 的 MCP 伺服器的 OAuth 用戶端機密。在使用 --client-secret 新增伺服器時避免互動提示
MCP_CONNECTION_NONBLOCKING 控制啟動是否在第一個查詢前等待 MCP 伺服器連線。MCP 啟動預設非阻塞：伺服器在背景連線，其工具在完成時變為可用。設定為 0 以使 Claude Code 在第一個查詢前等待伺服器連線。配置 alwaysLoad: true 的伺服器仍會使啟動等待，除非從 探索快取 提供，因為它們的工具必須在建立第一個提示時存在。在非互動模式 (-p) 中沒有 --input-format stream-json，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 或更新版本。對於 env 變數，低於 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 跨度事件上包含工具內容。跨度屬性在 自己的門 下攜帶工具內容。需要 追蹤。預設停用以保護敏感資料。在您的 shell、使用者設定或受管設定中設定。在 專案和本機設定 中忽略，除了該部分描述的關閉值。請參閱 監視
OTEL_LOG_TOOL_DETAILS 設定為 1 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、使用者撰寫的工作流名稱、工具失敗上的原始錯誤字串、api_refusal 事件上的拒絕 category 和其他工具詳細資訊。預設停用以保護 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 以使用識別工作階段儲存庫的 vcs.* 屬性標記 OpenTelemetry 指標和事件（預設：排除）。需要 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 工具 顯示的技能中繼資料的字元預算。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 字元。為了向後相容性保留舊名稱
TASK_MAX_OUTPUT_LENGTH 在 v2.1.277 中移除，現在是無操作，與它調整大小的 TaskOutput 工具一起。先前設定 背景工作 輸出的最大字元數，TaskOutput 工具保留。Claude 改為使用 Read 讀取背景工作的輸出檔案
USE_BUILTIN_RIPGREP 設定為 0 以使用系統安裝的 rg 而不是 rg 包含在 Claude Code 中
VERTEX_REGION_CLAUDE_3_5_HAIKU 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude 3.5 Haiku 的區域
VERTEX_REGION_CLAUDE_3_5_SONNET 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude 3.5 Sonnet 的區域
VERTEX_REGION_CLAUDE_3_7_SONNET 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude 3.7 Sonnet 的區域
VERTEX_REGION_CLAUDE_4_0_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude 4.0 Opus 的區域
VERTEX_REGION_CLAUDE_4_0_SONNET 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude 4.0 Sonnet 的區域
VERTEX_REGION_CLAUDE_4_1_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude 4.1 Opus 的區域
VERTEX_REGION_CLAUDE_4_5_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Opus 4.5 的區域
VERTEX_REGION_CLAUDE_4_5_SONNET 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Sonnet 4.5 的區域
VERTEX_REGION_CLAUDE_4_6_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Opus 4.6 的區域
VERTEX_REGION_CLAUDE_4_6_SONNET 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Sonnet 4.6 的區域
VERTEX_REGION_CLAUDE_4_7_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Opus 4.7 的區域
VERTEX_REGION_CLAUDE_4_8_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Opus 4.8 的區域
VERTEX_REGION_CLAUDE_5_5_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Opus 5.5 的區域。在 v2.1.280 中新增
VERTEX_REGION_CLAUDE_5_OPUS 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Opus 5 的區域。在 v2.1.219 中新增
VERTEX_REGION_CLAUDE_5_SONNET 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Sonnet 5 的區域。在 v2.1.197 中新增
VERTEX_REGION_CLAUDE_FABLE_5 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Fable 5 的區域。在 v2.1.170 中新增
VERTEX_REGION_CLAUDE_FABLE_5_1 使用 Google Cloud 的 Agent Platform 時覆蓋 Claude Fable 5.1 的區域。在 v2.1.257 中新增
VERTEX_REGION_CLAUDE_HAIKU_4_5 使用 Google Cloud 的 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 仍可在選擇起始權限模式之前擷取旗標。

另請參閱