SpyBara
Go Premium

env-vars.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

186 added, 186 removed.

2026
Wed 5 02:01 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

環境變數

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

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

本頁涵蓋如何：

設定環境變數

您在 shell 中設定的變數會持續該終端工作階段，而 settings 檔案中的變數在每次 claude 執行時都會套用。

在您的 shell 中

在啟動 claude 之前設定變數：

export API_TIMEOUT_MS="1200000"
claude

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

在 settings 檔案中

在 settings.json 檔案的 env 鍵下新增變數。Claude Code 在啟動時直接從檔案讀取它們，因此無論如何啟動 claude，它們都會生效。

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

您選擇的檔案控制變數適用於誰：

檔案 適用於
~/.claude/settings.json 您，在每個專案中
.claude/settings.json 在專案中工作的每個人，簽入原始碼控制
.claude/settings.local.json 您，僅在此專案中（如果您手動建立，請將其新增到您的 gitignore）
受管 settings 您組織中的每個人，由管理員部署

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

優先順序

當相同的行為同時具有環境變數和 settings 欄位時，環境變數優先。例如，ANTHROPIC_MODEL 覆蓋 model 設定，CLAUDE_CODE_AUTO_CONNECT_IDE 覆蓋 autoConnectIde。當環境變數未設定時，settings 欄位適用。

當相同的變數同時在您的 shell 和 settings 檔案 env 區塊中設定時，settings 檔案值適用。Claude Code 在啟動時將每個 env 項目寫入程序環境，取代從 shell 繼承的值。少數變數有特殊處理；env 設定列出例外。

在 settings 檔案之間，env 值遵循 settings 優先順序，因此受管理的 settings 項目覆蓋使用者或專案 settings 中的相同變數。

環境變數與 CLI 旗標和工作階段內命令的互動因功能而異：--model 和 /model 覆蓋 ANTHROPIC_MODEL，而 CLAUDE_CODE_EFFORT_LEVEL 覆蓋 /effort。當變數與另一個配置來源互動時，其在 變數 清單中的列會說明優先順序或連結到記錄它的頁面。

Claude Code 在啟動時讀取環境變數，因此變更會在您下次啟動 claude 時生效。

變數

變數 用途
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 主控台中產生。作為 x-api-key 發送，優先於 AWS SigV4
ANTHROPIC_AWS_BASE_URL 覆蓋 Claude Platform on AWS 端點 URL。用於自訂區域或透過 LLM gateway 路由。預設為 https://aws-external-anthropic.{AWS_REGION}.api.aws
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 gateway 路由。請參閱 Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL 覆蓋 Amazon Bedrock Mantle 端點 URL。請參閱 Mantle endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER Amazon Bedrock service tier（default、flex 或 priority）。作為 X-Amzn-Bedrock-Service-Tier 標頭發送。請參閱 Amazon Bedrock
ANTHROPIC_BETAS 逗號分隔的其他 anthropic-beta 標頭值清單，以包含在 API 請求中。Claude Code 已發送其需要的 beta 標頭；使用此選項可在 Claude Code 新增原生支援之前選擇加入 Anthropic API beta。與 --betas 旗標（需要 API 金鑰驗證）不同，此變數適用於所有驗證方法，包括 Claude.ai 訂閱
ANTHROPIC_CUSTOM_HEADERS 要新增至請求的自訂標頭（Name: Value 格式，多個標頭以換行符分隔）
ANTHROPIC_CUSTOM_MODEL_OPTION 要在 /model 選擇器中新增為自訂項目的模型 ID。使用此選項可使非標準或閘道特定的模型可選擇，而無需替換內建別名。請參閱 Model configuration
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION /model 選擇器中自訂模型項目的顯示描述。未設定時預設為 Custom model (<model-id>)
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME /model 選擇器中自訂模型項目的顯示名稱。未設定時預設為模型 ID
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES 請參閱 Model configuration
ANTHROPIC_DEFAULT_FABLE_MODEL 請參閱 Model configuration
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION 請參閱 Model configuration
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME 請參閱 Model configuration
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES 請參閱 Model configuration
ANTHROPIC_DEFAULT_HAIKU_MODEL 請參閱 Model configuration
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION 請參閱 Model configuration
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME 請參閱 Model configuration
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES 請參閱 Model configuration
ANTHROPIC_DEFAULT_OPUS_MODEL 請參閱 Model configuration
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION 請參閱 Model configuration
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME 請參閱 Model configuration
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES 請參閱 Model configuration
ANTHROPIC_DEFAULT_SONNET_MODEL 請參閱 Model configuration
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION 請參閱 Model configuration
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME 請參閱 Model configuration
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES 請參閱 Model configuration
ANTHROPIC_FOUNDRY_API_KEY Microsoft Foundry 驗證的 API 金鑰（請參閱 Microsoft Foundry）
ANTHROPIC_FOUNDRY_AUTH_TOKEN Microsoft Foundry 驗證的 Bearer 權杖，例如 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 要使用的模型設定名稱（請參閱 Model Configuration）
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 否則會為背景任務使用 default Sonnet model or the primary model
ANTHROPIC_VERTEX_BASE_URL 覆蓋 Google Cloud's Agent Platform 端點 URL。用於自訂 Google Cloud's Agent Platform 端點或透過 LLM gateway 路由。請參閱 Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID Google Cloud's Agent Platform 的 GCP 專案 ID。被 GCLOUD_PROJECT、GOOGLE_CLOUD_PROJECT 或您的 GOOGLE_APPLICATION_CREDENTIALS 認證檔案中的專案覆蓋。請參閱 Google Cloud's Agent Platform
ANTHROPIC_WORKSPACE_ID workload identity federation 的工作區 ID。當您的聯盟規則的範圍涵蓋多個工作區時設定此項，以便權杖交換知道要針對哪個工作區
API_FORCE_IDLE_TIMEOUT 覆蓋 5 分鐘的閒置逾時，該逾時會在沒有位元組到達時中止串流模型回應。設定為 0 以停用逾時，例如當緩慢的 gateway 或本機模型在區塊之間暫停超過 5 分鐘時。設定為 1 以在每個提供者上保持逾時。未設定時，逾時在直接 Anthropic API 和 Claude Platform on AWS 連線上無效，其中 Claude Code 自己的位元組級串流監視程式執行，在每個其他提供者上有效，包括 Google Cloud's Agent Platform、Microsoft Foundry、Mantle、Amazon Bedrock 和閘道連線，因此停滯的串流會中止而不是掛起。自 v2.1.169 起
API_TIMEOUT_MS API 請求的逾時（以毫秒為單位）（預設值：600000，或 10 分鐘；最大值：2147483647）。在緩慢網路上請求逾時或透過代理路由時增加此值。超過最大值的值會導致基礎計時器溢位，並導致請求立即失敗
AWS_BEARER_TOKEN_BEDROCK Amazon Bedrock API 金鑰用於驗證（請參閱 Amazon Bedrock API keys）
BASH_DEFAULT_TIMEOUT_MS 長時間執行的 bash 命令的預設逾時（預設值：120000，或 2 分鐘）
BASH_MAX_OUTPUT_LENGTH bash 輸出中的最大字元數，超過此數量後完整輸出會儲存到檔案，Claude 會收到路徑加上簡短預覽。請參閱 Bash tool behavior
BASH_MAX_TIMEOUT_MS 模型可以為長時間執行的 bash 命令設定的最大逾時（預設值：600000，或 10 分鐘）
CCR_FORCE_BUNDLE 設定為 1 以強制 claude --cloud 在 GitHub 存取可用時也要捆綁並上傳您的本機儲存庫
CLAUDECODE 在 Claude Code 生成的子程序中設定為 1（Bash 和 PowerShell 工具、tmux 工作階段、hook 命令、status line 命令、stdio MCP server 子程序）。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 使用者很有用
CLAUDE_AGENT_SDK_MCP_NO_PREFIX 設定為 1 以跳過來自 SDK 建立的 MCP 伺服器的工具名稱上的 mcp__<server>__ 前綴。工具使用其原始名稱。僅限 SDK 使用
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS 背景 subagents 的停滯逾時（以毫秒為單位）。預設 600000（10 分鐘）。計時器在每個串流進度事件時重設；如果在視窗內沒有進度到達，subagent 會被中止，任務會標記為失敗，將任何部分結果呈現給父級
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 設定自動壓縮觸發的上下文容量百分比 (1-100)。使用較低的值（如 50）以更早進行壓縮。此變數僅在 Claude Code 主動進行壓縮時導致更早壓縮：當設定 CLAUDE_CODE_AUTO_COMPACT_WINDOW 時、在 cloud sessions 中、在沒有 extended context 的 Sonnet 4.6 和 Opus 4.6 上，預設在 200K 邊界進行壓縮。在 Sonnet 5 上，proactive compaction 在模型的 default threshold 處應用。在其他情況下，例如本機工作階段上的 Opus 4.8，當對話達到模型的上下文限制時，自動壓縮觸發。覆蓋只能降低閾值，因此高於預設值的值無效。適用於主要對話和 subagents
CLAUDE_AUTO_BACKGROUND_TASKS 設定為 1 以強制啟用長時間執行的代理任務的自動背景執行。啟用時，subagents 在執行約兩分鐘後會移至背景
CLAUDE_AX_SCREEN_READER 設定為 1 以呈現螢幕閱讀器友善的輸出：沒有裝飾邊框或動畫的平面文字。設定為 0 以強制關閉螢幕閱讀器模式，即使 axScreenReader 為 true。--ax-screen-reader 旗標優先。需要 Claude Code v2.1.181 或更新版本
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR 在主工作階段中每個 Bash 或 PowerShell 命令後返回原始工作目錄
CLAUDE_CLIENT_PRESENCE_FILE 外部工具（例如螢幕鎖定監聽器）在您解鎖螢幕時建立並在您鎖定螢幕時刪除的檔案路徑。檔案存在時，Claude Code 會跳過 Remote Control mobile push notifications，因此當您主動使用電腦時，您會停止收到推送。檔案不存在或無法讀取時，通知會正常發送。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 以在 fullscreen rendering 中的每一幀上重新繪製整個螢幕，而不是發送增量更新。如果全螢幕模式顯示過時或錯位的文字片段，請使用此選項。Claude Code 在 Windows 上的背景工作階段和 agent view 中自動啟用此功能
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 設定為 1 以在每個請求中發送 effort 參數，即使 Claude Code 不將模型 ID 識別為支援努力的模型。在透過 LLM gateway 或第三方提供者路由時使用，該提供者在自訂識別碼下提供模型。在 API 中拒絕努力參數的模型，包括 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 在發佈新 artifact 時自動開啟瀏覽器。重新發佈現有 artifact 無論此設定如何都不會開啟瀏覽器
CLAUDE_CODE_ATTRIBUTION_HEADER 設定為 0 以省略系統提示開始處的歸屬區塊（用戶端版本和提示指紋）。停用它會改善透過 LLM gateway 路由時的提示快取命中率。Anthropic API 快取不受影響
CLAUDE_CODE_AUTO_COMPACT_WINDOW 設定用於自動壓縮計算的上下文容量（以 token 為單位）。預設為模型的上下文視窗：標準模型為 200K 或 extended context 模型為 1M，除了 Sonnet 5，其具有自己的 default threshold。在 1M 模型上使用較低的值（如 500000）以將視窗視為 500K 用於壓縮目的。該值上限為模型的實際上下文視窗。CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 作為此值的百分比應用。設定此變數會將壓縮閾值與狀態行的 used_percentage 解耦，後者始終使用模型的完整上下文視窗
CLAUDE_CODE_AUTO_CONNECT_IDE 覆蓋自動 IDE connection。預設情況下，在支援的 IDE 的整合終端內啟動時，Claude Code 會自動連線。設定為 false 以防止此情況。設定為 true 以在自動偵測失敗時強制連線嘗試，例如當 tmux 遮蔽父終端時。優先於 autoConnectIde 全域配置設定
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 endpoint。需要 Claude Code v2.1.207 或更新版本
CLAUDE_CODE_BRIDGE_SESSION_ID 在工作階段具有作用中 Remote Control 連線時在 Bash 工具和 hook command 子程序中自動設定，並在連線結束時移除。該值是工作階段的 ID，格式為 session_，與出現在工作階段 claude.ai/code URL 中的識別碼相同，因此指令碼可以連結回執行它的工作階段。需要 Claude Code v2.1.199 或更新版本。在 cloud sessions 中，改為讀取 CLAUDE_CODE_REMOTE_SESSION_ID
CLAUDE_CODE_CERT_STORE TLS 連線的 CA 憑證來源逗號分隔清單。bundled 是隨 Claude Code 提供的 Mozilla CA 集。system 是作業系統信任存放區，在具有 tls.getCACertificates 的執行時上唯讀：原生二進位檔或 npm 安裝的 Node 22.15 或更新版本。請參閱 CA certificate store。預設為 bundled,system
CLAUDE_CODE_CHILD_SESSION 在 Claude Code 透過 Bash、PowerShell 和 Monitor 工具、hook 命令和 status line 命令生成的子程序中設定為 1。不為 stdio MCP server 子程序設定，這些是長期存在的，並且超過啟動它們的工作階段。與 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_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 context window 支援。設定時，1M 模型變體在模型選擇器中不可用，Sonnet 5 工作階段被視為具有 200K 視窗。對於具有合規性要求的企業環境很有用
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 設定為 1 以停用 Opus 4.6 和 Sonnet 4.6 的 adaptive reasoning，並回退到由 MAX_THINKING_TOKENS 控制的固定思考預算。從 v2.1.111 起，對 Fable 5、Sonnet 5 或 Opus 4.7 及更新版本無效，其始終使用自適應推理
CLAUDE_CODE_DISABLE_ADVISOR_TOOL 設定為 1 以停用 advisor tool。/advisor 命令變為不可用，任何配置的 advisorModel 都會被忽略，--advisor 旗標被接受但無效，因此傳遞它的現有指令碼繼續工作而不出現錯誤
CLAUDE_CODE_DISABLE_AGENT_VIEW 設定為 1 以關閉 background agents and agent view：claude agents、--bg、/background 和隨選主管。相當於 disableAgentView 設定
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN 設定為 1 以停用 fullscreen rendering 並使用經典主螢幕渲染器。對話保留在您終端的原生捲動回溯中，因此 Cmd+f 和 tmux 複製模式可以正常工作。優先於 CLAUDE_CODE_NO_FLICKER 和 tui 設定。您也可以使用 /tui default 切換。不適用於從 agent view 開啟的背景工作階段，其始終使用全螢幕渲染
CLAUDE_CODE_DISABLE_ARTIFACT 設定為 1 以停用 Artifact 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。相當於 disableArtifact 設定
CLAUDE_CODE_DISABLE_ATTACHMENTS 設定為 1 以停用附件處理。使用 @ 語法的檔案提及會作為純文字發送，而不是擴展為檔案內容
CLAUDE_CODE_DISABLE_AUTO_MEMORY 設定為 1 以停用 auto memory。設定為 0 以在 --bare 模式或 autoMemoryEnabled: false 會以其他方式停用時強制啟用自動記憶體。停用時，Claude 不會建立或載入自動記憶體檔案
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 設定為 1 以停用所有背景任務功能，包括 Bash 和 subagent 工具上的 run_in_background 參數、自動背景執行和 Ctrl+B 快捷鍵
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD 設定為 1 以跳過檢查 Amazon Bedrock 串流回應是否帶有 application/vnd.amazon.eventstream 內容類型。沒有此變數，具有不同內容類型的回應會失敗並出現命名該內容類型的錯誤，這意味著 gateway or proxy is transforming the response。僅當閘道重寫 Content-Type 標頭但未修改的二進位事件串流主體通過時設定它；如果主體本身被轉換，請求會改為失敗並出現 Truncated event message received。需要 Claude Code v2.1.208 或更新版本
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF 設定為 1 以停止 background session 的執行中背景 shell 命令、動態工作流程，以及自 v2.1.198 起的背景 subagents，當 supervisor 停止、重新啟動或更新該工作階段的程序時，而不是將它們交給工作階段的下一個程序。僅影響該交接：使用 ← 或 /background 將工作階段背景化仍會帶入進行中的工作，CLAUDE_DISABLE_ADOPT 會關閉兩者。需要 Claude Code v2.1.196 或更新版本
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 設定為 1 以停止 Claude Code 在作業系統報告記憶體壓力時終止 background shell commands。預設情況下，在 macOS 和 Linux 上，Claude Code 在主工作階段中啟動的背景 shell 在記憶體壓力信號上終止，一旦工作階段已閒置 30 分鐘且沒有回合或 subagent 執行。Windows 沒有記憶體壓力信號，因此此變數對其無效。需要 Claude Code v2.1.193 或更新版本
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 設定為 1 以停用隨 Claude Code 提供的 skills 和工作流程：捆綁的 skills 和工作流程會完全移除，而內建的斜線命令（如 /init）保持可輸入但對模型隱藏。來自外掛程式、.claude/skills/ 和 .claude/commands/ 的 skills 不受影響。相當於 disableBundledSkills 設定；0 不會覆蓋它
CLAUDE_CODE_DISABLE_CLAUDE_MDS 設定為 1 以防止將任何 CLAUDE.md 記憶體檔案載入上下文，包括使用者、專案和自動記憶體檔案
CLAUDE_CODE_DISABLE_CRON 設定為 1 以停用 scheduled tasks。/loop skill 和 cron 工具變為不可用，任何已排程的任務停止觸發，包括已在工作階段中執行的任務
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_DISABLE_EXPLORE_PLAN_AGENTS 設定為 1 以停用內建的 Explore and Plan subagents。Claude 改為使用其搜尋工具或通用 subagent 進行探索，plan mode 直接讀取檔案而不是啟動 Explore 和 Plan agents。名為 Explore 或 Plan 的自訂 subagents 不受影響。若要在 Agent SDK 或非互動式模式中移除每個內建 subagent 類型，請改用 CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS。需要 Claude Code v2.1.198 或更新版本
CLAUDE_CODE_DISABLE_FAST_MODE 設定為 1 以停用 fast mode
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 設定。請參閱 Session quality surveys
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING 設定為 1 以停用檔案 checkpointing。/rewind 命令將無法還原程式碼變更
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 設定為 1 以從 Claude 的系統提示中移除內建的提交和 PR 工作流程指令以及 git 狀態快照。在使用您自己的 git 工作流程 skills 時很有用。設定時優先於 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_MOUSE 設定為 1 以停用 fullscreen rendering 中的滑鼠追蹤。使用 PgUp 和 PgDn 的鍵盤捲動仍然有效。使用此選項可保留您終端的原生選擇複製行為
CLAUDE_CODE_DISABLE_MOUSE_CLICKS 設定為 1 以停用 fullscreen rendering 中的點擊、拖曳和懸停處理，同時保留滑鼠滾輪捲動。當您想要滾輪捲動在 Claude Code 內工作但不想要點擊來定位游標、展開工具輸出或開啟連結時使用。當兩者都設定時，CLAUDE_CODE_DISABLE_MOUSE 優先。需要 Claude Code v2.1.195 或更新版本
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 相當於設定 DISABLE_AUTOUPDATER、DISABLE_FEEDBACK_COMMAND、DISABLE_ERROR_REPORTING 和 DISABLE_TELEMETRY
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK 設定為 1 以停用串流請求在中途失敗時的非串流回退。串流錯誤會傳播到重試層。當代理或閘道導致回退產生重複的工具執行時很有用
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK 設定為 1 以在您在終端中輸入或聚焦時發送 PushNotification 工具的桌面通知。預設情況下，當工具偵測到最近的鍵盤活動或終端焦點時，工具會跳過桌面通知和 mobile push。此變數僅停用該本機檢查，因此伺服器仍可在偵測到您活躍時抑制行動推送。需要 Claude Code v2.1.193 或更新版本
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL 設定為 1 以跳過首次執行時官方外掛程式市場的自動新增
CLAUDE_CODE_DISABLE_POLICY_SKILLS 設定為 1 以跳過從系統範圍的受管 skills 目錄載入 skills。對於不應載入操作員佈建的 skills 的容器或 CI 工作階段很有用
CLAUDE_CODE_DISABLE_TERMINAL_TITLE 設定為 1 以停用基於對話上下文的自動終端標題更新。在 Agent SDK 和 claude -p 工作階段中，這也會跳過產生工作階段標題的背景 Haiku 請求
CLAUDE_CODE_DISABLE_THINKING 設定為 1 以完全省略 API 請求中的 thinking 參數。這是代理和閘道拒絕該參數的相容性選項。該變數的行為與早期版本相同；在預設思考的模型上，省略該參數意味著模型仍可能思考。若要在 Anthropic API 上明確停用 extended thinking，請改用 MAX_THINKING_TOKENS=0，這在 Fable 5 上也無效，因為它無法關閉思考。在 third-party providers 上，0 同樣省略該參數，因此兩個變數在那裡的行為相同
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL 設定為 1 以停用 fullscreen rendering 中的虛擬捲動，並呈現文字記錄中的每條訊息。如果全螢幕模式中的捲動顯示應該出現訊息的空白區域，請使用此選項
CLAUDE_CODE_DISABLE_WORKFLOWS 設定為 1 以停用 workflows。相當於 disableWorkflows 設定
CLAUDE_CODE_EFFORT_LEVEL 為支援的模型設定努力級別。值：low、medium、high、xhigh、max 或 auto 以使用模型預設值。可用級別取決於模型。優先於 /effort 和 effortLevel 設定。請參閱 Adjust effort level
CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT 設定為 1 以啟用將額外文字附加到每個 subagent 系統提示的末尾。--append-subagent-system-prompt 旗標提供附加的文字並自動設定此變數，因此您不需要自己設定它。需要 Claude Code v2.1.205 或更新版本
CLAUDE_CODE_ENABLE_AUTO_MODE 為相容性接受，無效。Auto mode 在每個提供者上預設可用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 和已登入的 Claude apps gateway 工作階段。在 v2.1.158 到 v2.1.206 中，設定此項為 1 是在這些提供者上提供 auto mode 所需的
CLAUDE_CODE_ENABLE_AWAY_SUMMARY 覆蓋 session recap 可用性。設定為 0 以強制關閉摘要，無論 /config 切換如何。設定為 1 以在 awaySummaryEnabled 為 false 時強制啟用摘要。優先於設定和 /config 切換
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH 設定為 1 以在 non-interactive mode 中背景安裝完成後在回合邊界處刷新外掛程式狀態。預設關閉，因為刷新會在工作階段中途更改系統提示，這會使該回合的 prompt caching 失效
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL 設定為 1 以在 Anthropic 綁定的非必要流量被阻止時將「Claude 表現如何？」工作階段品質調查路由到您自己的 OpenTelemetry collector。調查評分僅作為 OTEL 事件發出到您配置的收集器。在此模式下，沒有調查資料發送到 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 以選擇退出。設定為 1 以在透過 ANTHROPIC_BASE_URL、ANTHROPIC_VERTEX_BASE_URL 或 ANTHROPIC_BEDROCK_BASE_URL 路由時強制啟用。在 Microsoft Foundry 和 gateway 連線上預設關閉
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 設定為 1 以在 ANTHROPIC_BASE_URL 指向 Anthropic 相容閘道（例如 LiteLLM、Kong 或內部代理）時從您的閘道的 /v1/models 端點填充 /model 選擇器。預設關閉，因為由共享 API 金鑰支援的閘道會以其他方式向每個使用者顯示該金鑰可以存取的每個模型。探索的模型仍由 availableModels 允許清單篩選，工作階段接收；由於 server-managed delivery is not available on gateway configurations，透過 MDM 或受管設定檔案傳遞清單
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE {{/* max-version: 2.1.141 */}}在 v2.1.142 中移除，當 fast mode 預設從 Opus 4.6 移至 Opus 4.7 時
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 設定為 false 以停用提示建議（/config 中的「提示建議」切換）。這些是在 Claude 回應後出現在您的提示輸入中的灰顯預測。請參閱 Prompt suggestions
CLAUDE_CODE_ENABLE_TASKS 控制工作階段是否使用結構化 Task 工具（TaskCreate、TaskUpdate、TaskGet、TaskList）或舊版 TodoWrite 工具。{{/* min-version: 2.1.142 */}}自 Claude Code v2.1.142 起，Task 工具是所有模式中的預設值。設定為 0 以還原為 TodoWrite。請參閱 Task list 和 Migrate to Task tools
CLAUDE_CODE_ENABLE_TELEMETRY 設定為 1 以啟用 OpenTelemetry 資料收集以進行指標和日誌記錄。在配置 OTel 匯出器之前需要。請參閱 Monitoring
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY 查詢迴圈變為閒置後自動退出前等待的時間（以毫秒為單位）。對於使用 SDK 模式的自動化工作流程和指令碼很有用
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 設定為 1 以啟用 agent teams。Agent teams 是實驗性的，預設停用
CLAUDE_CODE_EXTRA_BODY JSON 物件以合併到每個 API 請求主體的頂層。對於傳遞 Claude Code 不直接公開的提供者特定參數很有用。在您的 shell 中匯出的值也適用於您使用 claude agents 或 --bg 分派的 background sessions。在 v2.1.206 之前，背景工作階段忽略了 shell 匯出的值，並使用背景主管程序繼承的任何副本
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS 覆蓋檔案讀取的預設 token 限制。當您需要完整讀取較大的檔案時很有用
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE {{/* min-version: 2.1.172 /}}設定為 1 以強制文字記錄持久化、提示歷史記錄和 claude agents 註冊，即使此 claude 是從另一個 Claude Code 工作階段內啟動的。在繼承的 CLAUDE_CODE_CHILD_SESSION 值（例如來自 Claude Code 的 Bash 工具首次啟動的 screen 工作階段）導致真正的頂層工作階段被誤分類為嵌套時使用。{{/ min-version: 2.1.178 */}}自 v2.1.178 起，Claude Code 會自動偵測 tmux 情況並忽略繼承的標記，因此 tmux 不再需要此變數。也在 v2.1.169 及更早版本上受尊重；對 v2.1.170 和 v2.1.171 無效，其中它覆蓋的嵌套工作階段偵測被移除
CLAUDE_CODE_FORCE_STRIKETHROUGH {{/* min-version: 2.1.186 */}}設定為 1 以在您的終端支援但未自動偵測時強制刪除線呈現 ~~text~~，例如透過 SSH 而未轉發 TERM_PROGRAM。沒有此選項，未偵測的終端會顯示文字刪除線標記而不是呈現為刪除線。需要 Claude Code v2.1.186 或更新版本
CLAUDE_CODE_FORCE_SYNC_OUTPUT 設定為 1 以強制啟用 DEC 私有模式 2026 synchronized output（當您的終端支援但未自動偵測時）。對於實現 BSU/ESU 但不回覆功能探測的模擬器（例如 Emacs eat）很有用。在 tmux 下無效。與 CLAUDE_CODE_NO_FLICKER 不同，後者會切換到 fullscreen rendering，這不會改變渲染器
CLAUDE_CODE_FORK_SUBAGENT 設定為 1 以啟用 Claude 生成 forked subagents，或 0 以停用它們，覆蓋任何伺服器端推出。啟用時，Claude 可以要求 fork subagent 類型以生成分叉，一個繼承完整對話上下文而不是從頭開始的 subagent。沒有 subagent 類型的生成仍使用通用 subagent，所有 subagent 生成都在背景中執行。明確的 /fork 命令無需此變數即可工作。在互動式模式和透過 SDK 或 claude -p 中工作
CLAUDE_CODE_GIT_BASH_PATH 僅限 Windows：Git Bash 可執行檔（bash.exe）的路徑。在 Git Bash 已安裝但不在您的 PATH 中時使用。請參閱 Windows setup
CLAUDE_CODE_GLOB_HIDDEN 設定為 false 以在 Claude 呼叫 Glob tool 時從結果中排除隱藏檔案。預設包含。不影響 @ 檔案自動完成、ls、Grep 或 Read
CLAUDE_CODE_GLOB_NO_IGNORE 設定為 false 以使 Glob tool 尊重 .gitignore 模式。預設情況下，Glob 返回所有符合的檔案，包括 gitignored 的檔案。不影響 @ 檔案自動完成，其具有自己的 respectGitignore 設定
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Glob 工具檔案探索的逾時（以秒為單位）。在大多數平台上預設為 20 秒，在 WSL 上預設為 60 秒
CLAUDE_CODE_HIDE_CWD 設定為 1 以在啟動標誌中隱藏工作目錄。對於螢幕共享或錄製很有用，其中路徑會暴露您的作業系統使用者名稱
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_CONTEXT_TOKENS 覆蓋 Claude Code 假設用於作用中模型的上下文視窗大小。{{/* min-version: 2.1.193 */}}自 v2.1.193 起，直接應用於 Claude Code 不識別為 Claude 模型的模型名稱；對於識別的 Claude 模型，僅當同時設定 DISABLE_COMPACT 時才生效。當透過 ANTHROPIC_BASE_URL 路由到模型時使用，其上下文視窗與其名稱的內建大小不符
CLAUDE_CODE_MAX_OUTPUT_TOKENS 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異；請參閱 max output tokens。增加此值會減少在 auto-compaction 觸發之前可用的有效上下文視窗
CLAUDE_CODE_MAX_RETRIES 覆蓋重試失敗 API 請求的次數（預設值：10）。{{/* min-version: 2.1.186 /}}自 v2.1.186 起上限為 15；{{/ min-version: 2.1.199 */}}自 v2.1.199 起，CLAUDE_CODE_RETRY_WATCHDOG 會提高預設值並移除上限。對於需要等待較長中斷的無人值守工作階段，請改為設定 CLAUDE_CODE_RETRY_WATCHDOG
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY 可以並行執行的唯讀工具和 subagents 的最大數量（預設值：10）。較高的值會增加並行性，但消耗更多資源
CLAUDE_CODE_MAX_TURNS 當未傳遞明確限制時，限制代理回合的數量。相當於傳遞 --max-turns，當兩者都設定時優先。不是正整數的值在啟動時會被拒絕並出現錯誤，而不是被視為無限制
CLAUDE_CODE_MCP_ALLOWLIST_ENV 設定為 1 以使用僅安全基線環境加上伺服器配置的 env 而不是繼承您的 shell 環境來生成 stdio MCP 伺服器
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT {{/* min-version: 2.1.187 /}}MCP 工具呼叫的閒置逾時（以毫秒為單位）。當 stdio、HTTP、SSE、WebSocket 或 claude.ai connector MCP 伺服器在此期間內沒有發送回應和進度通知時，工具呼叫會中止並出現錯誤，而不是等待整體 MCP_TOOL_TIMEOUT。覆蓋網路伺服器的每個傳輸預設值 300000（5 分鐘）和 stdio 伺服器的 1800000（30 分鐘）。設定為 0 以停用閒置檢查。低於 1000 的值會提高到 1 秒，該值上限為有效的 MCP_TOOL_TIMEOUT。.mcp.json 中的每個伺服器 timeout 至少 1000 會將該伺服器的閒置視窗提高到至少 timeout 值。不適用於 IDE 伺服器或 SDK 進程內伺服器。需要 Claude Code v2.1.187 或更新版本。{{/ min-version: 2.1.203 */}}在 v2.1.203 之前，stdio 伺服器不受閒置逾時限制
CLAUDE_CODE_NATIVE_CURSOR 設定為 1 以在輸入插入符號處顯示終端自己的游標，而不是繪製的區塊。游標尊重終端的閃爍、形狀和焦點設定
CLAUDE_CODE_NEW_INIT 設定為 1 以使 /init 執行互動式設定流程。流程會詢問要產生哪些檔案，包括 CLAUDE.md、skills 和 hooks，然後再探索程式碼庫並寫入它們。沒有此變數，/init 會自動產生 CLAUDE.md 而不提示
CLAUDE_CODE_NO_FLICKER 設定為 1 以啟用 fullscreen rendering，一項研究預覽，可減少閃爍並在長對話中保持記憶體平坦。相當於 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 產生一個
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE {{/* max-version: 2.1.159 */}}在 v2.1.160 中移除，現在是無操作。先前將 fast mode 固定到 Claude Opus 4.6，而不是目前的預設值。Opus 4.6 不再支援快速模式
CLAUDE_CODE_OTEL_DIAG_STDERR {{/* min-version: 2.1.179 */}}設定為 1 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下，這些錯誤僅在 --debug 時出現，因此配置不當的匯出器（例如 Prometheus 連接埠衝突）會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 Monitoring
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS 刷新待處理 OpenTelemetry spans 的逾時（以毫秒為單位）（預設值：5000）。請參閱 Monitoring
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS 刷新動態 OpenTelemetry 標頭的間隔（以毫秒為單位）（預設值：1740000 / 29 分鐘）。請參閱 Dynamic headers
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS OpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：2000）。如果指標在退出時被丟棄，請增加此值。請參閱 Monitoring
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 設定為 1 以讓 Claude Code 在新版本可用時在背景中執行您的套件管理員的升級命令。適用於 Homebrew 和 WinGet 安裝。其他套件管理員繼續顯示升級命令而不執行它。請參閱 Auto updates
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_GIT_TIMEOUT_MS 安裝或更新外掛程式時 git 操作的逾時（以毫秒為單位）（預設值：120000）。對於大型儲存庫或網路連線緩慢，請增加此值。請參閱 Git operations time out
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 設定為 1 以在 git pull 失敗時保留現有的市場快取，而不是擦除並重新複製。在離線或隔離環境中很有用，其中重新複製會以相同方式失敗。請參閱 Marketplace updates fail in offline environments
CLAUDE_CODE_PLUGIN_PREFER_HTTPS 設定為 1 以透過 HTTPS 而不是 SSH 複製 GitHub owner/repo 外掛程式來源。在 CI 執行器、容器或任何沒有為 github.com 配置 SSH 金鑰的環境中很有用
CLAUDE_CODE_PLUGIN_SEED_DIR 一個或多個唯讀外掛程式種子目錄的路徑，在 Unix 上以 : 分隔，在 Windows 上以 ; 分隔。使用此選項可將預先填充的外掛程式目錄捆綁到容器映像中。Claude Code 在啟動時從這些目錄註冊市場，並使用預先快取的外掛程式而無需重新複製。請參閱 Pre-populate plugins for containers
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY 設定為 1 以停止 Claude Code 在生成 PowerShell 以進行工具呼叫、hooks 和狀態行命令時傳遞 -ExecutionPolicy Bypass，並改為尊重機器的有效執行政策。預設情況下，Claude Code 在程序範圍內繞過執行政策，以便 .ps1 指令碼和模組匯入在預設受限的 Windows 安裝上工作。無論此設定如何，程序範圍繞過永遠不會覆蓋群組原則 MachinePolicy 或 UserPolicy
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS {{/* min-version: 2.1.182 */}}非互動式模式使用 -p 旗標在最終回合後等待的最大時間（以毫秒為單位），用於背景 subagents 和工作流程，其結果是輸出的一部分。預設值：600000，或 10 分鐘。超過上限時，剩餘背景任務會被終止，程序會退出。設定為 0 以無限期等待。此上限與適用於純背景 shells 的 5 秒寬限期分開
CLAUDE_CODE_PROCESS_WRAPPER 透過包裝器可執行檔啟動 Claude Code 從其自己的二進位檔啟動的程序，指定為 argv 前綴，例如 /opt/corp/launcher。涵蓋託管 agent view 工作階段的背景服務、它生成的每個工作階段以及 Claude Code 執行自身以完成安裝更新的重新啟動。第一個權杖必須是以 exec "$@" 結尾的可執行檔的絕對路徑，大多數啟動器都是該單一路徑。該值是引數清單，而不是 shell 命令：空格分隔權杖，雙引號將包含空格的路徑分組，以 [ 開頭的值會讀取為 JSON 字串陣列。在使用者或 managed settings 的 env 區塊中設定它，而不是作為 shell 匯出，以便分離的背景服務繼承它；專案和本機設定無法設定它。VS Code 擴充功能透過其 claudeProcessWrapper 設定單獨配置其自己的啟動器。在 Windows 上被忽略。CLAUDE_CODE_SHELL_PREFIX 是一個單獨的控制：它將 Claude Code 執行的 shell 命令包裝為單個引用的字串，而此變數將 Claude Code 自己的程序包裝為 argv 前綴。請參閱 Run Claude Code behind a corporate launcher
CLAUDE_CODE_PROPAGATE_TRACEPARENT {{/* min-version: 2.1.152 */}}設定為 1 以在 ANTHROPIC_BASE_URL 指向自訂代理時傳播 W3C 追蹤上下文。傳播涵蓋模型和 HTTP MCP 請求上的 traceparent 標頭以及 Bash、PowerShell 和 hook 子程序的 TRACEPARENT 環境變數。預設情況下，傳播僅在直接連線到 Anthropic API 時啟用。在 v2.1.152 中新增。請參閱 Traces (beta)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 由嵌入 Claude Code 並代表其管理模型提供者路由的主機平台設定。設定時，提供者選擇、端點和驗證變數（例如 CLAUDE_CODE_USE_BEDROCK、ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY）在設定檔案中被忽略，以便使用者設定無法覆蓋主機的路由。Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 的自動遙測選擇退出也會被跳過，因此遙測遵循標準 DISABLE_TELEMETRY 選擇退出。請參閱 Default behaviors by API provider
CLAUDE_CODE_PROXY_RESOLVES_HOSTS 設定為 1 以允許代理執行 DNS 解析而不是呼叫者。對於代理應處理主機名稱解析的環境選擇加入
CLAUDE_CODE_REMOTE 當 Claude Code 作為 cloud session 執行時自動設定為 true。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中
CLAUDE_CODE_REMOTE_SESSION_ID 在 cloud sessions 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 Link output back to the session
CLAUDE_CODE_RESUME_INTERRUPTED_TURN 設定為 1 以在上一個工作階段在中途結束時自動繼續。在 SDK 模式中使用，以便模型繼續而無需 SDK 重新發送提示
CLAUDE_CODE_RESUME_PROMPT 覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 Continue from where you left off.。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值
CLAUDE_CODE_RETRY_WATCHDOG {{/* min-version: 2.1.186 /}}設定為 1 用於無人值守工作階段，例如評估工具、CI 工作或遠端工作者。無限期重試 429 和 529 容量錯誤，而不是在 CLAUDE_CODE_MAX_RETRIES 嘗試後失敗。監視程式在嘗試之間退避最多 5 分鐘，或直到限制在回應帶有速率限制重設時間時重設，因此達到使用限制的工作階段會等待剩餘視窗。{{/ min-version: 2.1.199 */}}自 v2.1.199 起，它也會提高其他暫時性錯誤（例如伺服器錯誤、逾時和丟棄的連線）的預設重試計數至 300，大約三小時的退避，並在您明確設定該變數時移除 CLAUDE_CODE_MAX_RETRIES 的上限 15。需要 Claude Code v2.1.186 或更新版本
CLAUDE_CODE_SAFE_MODE 設定為 1 以在安全模式下啟動：CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態行和檔案建議命令、LSP 伺服器和自動記憶體不載入，用於對損壞的配置進行故障排除。受管設定政策仍然適用，包括政策配置的 hooks、狀態行和檔案建議命令；受管外掛程式、受管 skills、受管 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 在 fullscreen rendering 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值，以及低於 1 的分數值（例如 0.5）以減慢終端上原生捲動路徑中加速的觸控板和滾輪捲動。設定為 3 以符合 vim（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件）。在 JetBrains IDE 終端中被忽略，Claude Code 使用其自己的捲動處理
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 覆蓋 SessionEnd hooks 的時間預算（以毫秒為單位）。適用於工作階段退出、/clear 和透過互動式 /resume 切換工作階段。預設情況下，預算為 1.5 秒，自動提高到設定檔案中配置的最高每個 hook timeout，最高 60 秒。外掛程式提供的 hooks 上的逾時不會提高預算
CLAUDE_CODE_SESSION_ID 在 Bash 和 PowerShell 工具子程序、hook command 子程序和 stdio MCP server 子程序中自動設定為目前工作階段 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 等其他 shells。如果該值不是有效的 bash 或 zsh 路徑，Claude Code 會忽略它並回退到自動偵測。自動偵測在您的 $SHELL 指向 bash 或 zsh 時使用它，否則它會在您的 PATH 和標準安裝位置上選擇第一個有效的 zsh 然後 bash
CLAUDE_CODE_SHELL_PREFIX 命令前綴以包裝 Claude Code 生成的 shell 命令：Bash 工具呼叫、hook 命令、status line 命令和 stdio MCP server 啟動命令。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、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索。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 跳過 Claude Platform on AWS 的用戶端驗證，用於自行簽署請求的閘道
CLAUDE_CODE_SKIP_AWS_CRED_CACHE 設定為 1 以關閉 AWS 預設認證提供者鏈解析的認證進程內快取，以便 Claude Code 在每個 API 請求上解析鏈。關閉快取時，由 SSO 支援的設定檔會在每個請求時從 IAM Identity Center 要求認證。請參閱 credential caching and resolution timeout。需要 Claude Code v2.1.207 或更新版本
CLAUDE_CODE_SKIP_BEDROCK_AUTH 跳過 Amazon Bedrock 的 AWS 驗證（例如，使用 LLM 閘道時）
CLAUDE_CODE_SKIP_FOUNDRY_AUTH 跳過 Microsoft Foundry 的 Azure 驗證，用於代理或閘道，該代理或閘道注入其自己的 Authorization 標頭。Claude Code 發送沒有 Azure 認證的請求，並保留您提供的 Authorization 標頭，例如透過 ANTHROPIC_CUSTOM_HEADERS。當設定 ANTHROPIC_FOUNDRY_API_KEY 或 ANTHROPIC_FOUNDRY_AUTH_TOKEN 時被忽略。{{/* min-version: 2.1.203 */}}在 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's Agent Platform 的 Google 驗證（例如，使用 LLM 閘道時）
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Stop 或 SubagentStop hook 可能連續阻止回合結束的最大次數，然後 Claude Code 覆蓋它並無論如何結束回合（預設值：8）。設定為 0 以停用上限。如果您的 hook 合法需要更多迭代來解決，請提高此值
CLAUDE_CODE_SUBAGENT_MODEL 請參閱 Model configuration。{{/* min-version: 2.1.196 */}}自 v2.1.196 起，將其設定為 inherit 與不設定相同；較早版本將 inherit 視為覆蓋，強制每個 subagent 進入主對話的模型
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 設定為 1 以從子程序環境中移除 Anthropic 和雲端提供者認證（Bash 工具、hooks、MCP stdio 伺服器）。父 Claude 程序保留這些認證以進行 API 呼叫，但子程序無法讀取它們，減少了嘗試透過 shell 擴展來竊取機密的提示注入攻擊的暴露。在 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 設定為 1 以在第一個查詢之前將您啟用的 claude.ai skills 下載到 ~/.claude/skills/，並每 10 分鐘重新同步一次。僅適用於非互動式模式，使用 -p 旗標。需要 claude.ai 驗證。Claude Code on the web 工作階段會自動接收您啟用的 claude.ai skills；您不需要在那裡設定此項
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS 當設定 CLAUDE_CODE_SYNC_SKILLS 時，中途工作階段 skills 重新同步的逾時（以毫秒為單位）（預設值：30000）。限制在主機要求 skill 重新載入期間觸發的下載。超過時，重新同步停止，其餘下載在背景中繼續
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS 當設定 CLAUDE_CODE_SYNC_SKILLS 時，第一個查詢等待初始 skills 同步的逾時（以毫秒為單位）（預設值：5000）。超過時，查詢會繼續進行，其餘 skill 下載會在背景中繼續
CLAUDE_CODE_SYNTAX_HIGHLIGHT 設定為 false 以停用 diff 輸出中的語法醒目提示。當顏色干擾您的終端設定時很有用。若要也停用程式碼區塊和檔案預覽中的醒目提示，請使用 syntaxHighlightingDisabled 設定
CLAUDE_CODE_TASK_LIST_ID 跨工作階段共享任務清單。在多個 Claude Code 實例中設定相同的 ID 以協調共享任務清單。請參閱 Task list
CLAUDE_CODE_TEAM_NAME 此隊友所屬的 agent team 名稱。在 agent team 成員上自動設定
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS 覆蓋，以毫秒為單位，非互動式工作階段在退出時等待其 agent team 完成拆卸的時間。接受 1000 到 60000；超出範圍的值被忽略，預設值 10000 適用。需要 Claude Code v2.1.206 或更新版本
CLAUDE_CODE_TMPDIR 覆蓋用於內部臨時檔案的臨時目錄。Claude Code 將 /claude-{uid}/（Unix）或 /claude/（Windows）附加到此路徑。預設值：macOS 上的 /tmp、Linux/Windows 上的 os.tmpdir()。{{/* min-version: 2.1.161 */}}自 v2.1.161 起，在 macOS 和 Linux 上，當您的覆蓋是長路徑時，sandboxed Bash 子程序會在系統預設下收到簡短的回退 $TMPDIR，因為某些工具在臨時路徑變得太長時會失敗。未沙箱化的 Bash 命令繼承您的 shell 的 $TMPDIR 不變。Claude Code 自己的臨時檔案始終使用您的覆蓋
CLAUDE_CODE_TMUX_TRUECOLOR 設定為 1 以允許 tmux 內的 24 位真彩色輸出。預設情況下，當設定 $TMUX 時，Claude Code 會限制為 256 色，因為 tmux 不會通過真彩色逃逸序列，除非配置為這樣做。在將 set -ga terminal-overrides ',*:Tc' 新增到您的 ~/.tmux.conf 後設定此項。請參閱 Terminal configuration 以取得其他 tmux 設定
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 endpoint
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH 設定為 1 以使用 Node.js 檔案 API 而不是 ripgrep 來探索自訂命令、subagents 和輸出樣式。如果捆綁的 ripgrep 二進位檔案在您的環境中不可用或被阻止，請設定此項。不影響 Grep 或檔案搜尋工具
CLAUDE_CODE_USE_POWERSHELL_TOOL 控制 PowerShell 工具。在沒有 Git Bash 的 Windows 上，工具會自動啟用；設定為 0 以停用它。在安裝了 Git Bash 的 Windows 上，工具正在逐步推出：設定為 1 以選擇加入或 0 以選擇退出。在 Linux、macOS 和 WSL 上，設定為 1 以啟用它，這需要您的 PATH 上有 pwsh。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不是透過 Git Bash 路由。請參閱 PowerShell tool
CLAUDE_CODE_USE_VERTEX 使用 Google Cloud's Agent Platform
CLAUDE_CONFIG_DIR 覆蓋配置目錄（預設值：~/.claude）。所有設定、認證、工作階段歷史記錄和外掛程式都儲存在此路徑下。對於並排執行多個帳戶很有用：例如，alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
CLAUDE_DISABLE_ADOPT {{/* min-version: 2.1.195 */}}設定為 1 以停止進行中的背景工作，而不是在您按 ← 或使用 /background 將工作階段背景化時帶入它。Claude Code 會要求您在背景化前確認，然後停止會以其他方式帶入的任務。需要 Claude Code v2.1.195 或更新版本
CLAUDE_EFFORT 在 Bash 工具子程序和 hook 命令中自動設定為該回合的作用中 effort level：low、medium、high、xhigh 或 max。Ultracode 不是一個不同的級別，報告為 xhigh。符合傳遞給 hooks 的 effort.level 欄位。僅在目前模型支援努力參數時設定
CLAUDE_ENABLE_BYTE_WATCHDOG 設定為 1 以強制啟用位元級串流閒置監視程式，或設定為 0 以強制停用它。未設定時，監視程式預設對 Anthropic API 和 Claude Platform on AWS 連線啟用。位元監視程式會在 180 秒內沒有位元組到達線路時中止連線（直接 Anthropic API 連線上預設為 180 秒，Claude Platform on AWS 和其他提供者上為 300 秒），或在設定 CLAUDE_STREAM_IDLE_TIMEOUT_MS 時為該值，該值被限制為最少 5 分鐘，獨立於事件級監視程式
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK 設定為 1 以在 Amazon Bedrock vnd.amazon.eventstream 回應上啟用位元級串流閒置監視程式。預設關閉。使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 配置逾時
CLAUDE_ENABLE_STREAM_WATCHDOG 設定為 1 以強制啟用事件級串流閒置監視程式，或設定為 0 以強制停用它。{{/* min-version: 2.1.196 /}}未設定時，監視程式預設對所有提供者啟用。在 v2.1.196 之前，未設定的預設值由伺服器在直接 Anthropic API 上控制，在其他提供者上關閉。{{/ min-version: 2.1.169 */}}自 v2.1.169 起，直接 Anthropic API 和 Claude Platform on AWS 以外的提供者也有預設開啟的 5 分鐘主體閒置逾時，獨立於此變數；請參閱 API_FORCE_IDLE_TIMEOUT。在 Amazon Bedrock 上，您也可以使用 CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK 啟用獨立的位元級監視程式；當兩者都設定時，它們一起執行。使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 配置逾時
CLAUDE_ENV_FILE Claude Code 在每個 Bash 命令之前在同一 shell 程序中執行的 shell 指令碼的路徑，因此檔案中的匯出對命令可見。用於在命令之間保持 virtualenv 或 conda 啟用。也由 SessionStart、Setup、CwdChanged 和 FileChanged hooks 動態填充
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX 當未提供明確名稱時，自動產生的 Remote Control 工作階段名稱的前綴。預設為您的機器主機名稱，產生名稱如 myhost-graceful-unicorn。--remote-control-session-name-prefix CLI 旗標為單一呼叫設定相同的值
CLAUDE_STREAM_IDLE_TIMEOUT_MS 串流閒置監視程式在關閉停滯連線之前的逾時（以毫秒為單位）。當您明確設定此變數時，最小值為 300000（5 分鐘）；較低的值會無聲地限制以吸收延伸思考暫停和代理緩衝。未設定時，事件級監視程式預設為 300 秒，位元級監視程式在直接 Anthropic API 連線上預設為 180 秒（Claude Platform on AWS 和其他提供者上為 300 秒）。未設定的 180 秒位元監視程式預設是一個單獨的值，不受 5 分鐘限制。API_FORCE_IDLE_TIMEOUT 下描述的主體閒置逾時獨立適用。在 Amazon Bedrock 上，也適用於 CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1
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 命令仍然可用。在您想要明確控制何時進行壓縮時使用
DISABLE_COMPACT 設定為 1 以停用所有壓縮：自動壓縮和手動 /compact 命令
DISABLE_COST_WARNINGS 設定為 1 以停用成本警告訊息
DISABLE_DOCTOR_COMMAND 設定為 1 以隱藏 /doctor 設定檢查 skill 及其 /checkup 別名。對於使用者不應執行安裝診斷的受管部署很有用。不影響 claude doctor 終端命令。{{/* min-version: 2.1.205 */}}在 v2.1.205 之前，此變數隱藏了 /doctor 診斷螢幕命令
DISABLE_ERROR_REPORTING 設定為 1 以選擇退出錯誤報告
DISABLE_EXTRA_USAGE_COMMAND 設定為 1 以隱藏 /usage-credits 命令，讓使用者購買超過速率限制的額外使用量
DISABLE_FEEDBACK_COMMAND 設定為 1 以停用 /feedback 命令。較舊的名稱 DISABLE_BUG_COMMAND 也被接受
DISABLE_GROWTHBOOK 設定為 1 以停用 GrowthBook 功能旗標擷取並為每個旗標使用程式碼預設值。遙測事件日誌記錄保持開啟，除非也設定 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 以防止發送交錯思考 beta 標頭。當您的 LLM 閘道或提供者不支援 interleaved thinking 時很有用
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 以選擇退出遙測。遙測事件不包括使用者資料，如程式碼、檔案路徑或 bash 命令。也停用功能旗標擷取，效果與 DISABLE_GROWTHBOOK 相同，因此某些標記的功能可能無法使用
DISABLE_UPDATES 設定為 1 以阻止所有更新，包括手動 claude update 和 claude install。比 DISABLE_AUTOUPDATER 更嚴格。在透過您自己的管道分發 Claude Code 且使用者不應自行更新時使用
DISABLE_UPGRADE_COMMAND 設定為 1 以隱藏 /upgrade 命令
DO_NOT_TRACK 設定為 1 以選擇退出遙測。相當於設定 DISABLE_TELEMETRY。Claude Code 尊重此作為許多開發者 CLI 認可的跨工具慣例
ENABLE_CLAUDEAI_MCP_SERVERS 設定為 false 以停用 Claude Code 中的 claude.ai MCP servers。對於已登入的使用者預設啟用。若要按專案或按組織停用，請改為在設定中設定 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 小時快取寫入以更高的速率計費
ENABLE_PROMPT_CACHING_1H_BEDROCK 已棄用。改用 ENABLE_PROMPT_CACHING_1H
ENABLE_TOOL_SEARCH 控制 MCP tool search。未設定：預設所有 MCP 工具延遲，但在 Google Cloud's Agent Platform 上或當 ANTHROPIC_BASE_URL 指向非第一方主機時提前載入。值：true（始終延遲並發送 beta 標頭，在 Google Cloud's Agent Platform 或不支援 tool_reference 的代理上請求失敗）、auto（閾值模式：如果工具符合上下文的 10% 內則提前載入）、auto:N（自訂閾值，例如 auto:5 表示 5%）、false（提前載入全部）。當設定 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 時被忽略，這會強制所有工具提前載入
FALLBACK_FOR_ALL_PRIMARY_MODELS 設定為任何非空值以在任何主要模型上重複過載錯誤後觸發回退。{{/* min-version: 2.1.160 */}}自 v2.1.160 起，配置的 fallback model chain 會在任何主要模型的重複過載錯誤時觸發，因此此變數不影響切換到回退模型
FORCE_AUTOUPDATE_PLUGINS 設定為 1 以強制外掛程式自動更新，即使主自動更新器通過 DISABLE_AUTOUPDATER 停用
FORCE_HYPERLINK 設定為 1 以在您的終端支援但未自動偵測時啟用可點擊的 OSC 8 超連結，或 0 以停用它們
FORCE_PROMPT_CACHING_5M 設定為 1 以強制 5 分鐘的提示快取 TTL，即使 1 小時 TTL 會以其他方式適用。覆蓋 ENABLE_PROMPT_CACHING_1H
HTTP_PROXY 為網路連線指定 HTTP 代理伺服器
HTTPS_PROXY 為網路連線指定 HTTPS 代理伺服器
IS_DEMO 設定為 1 以啟用演示模式：隱藏標頭和 /status 輸出中的電子郵件和組織名稱，並跳過上線。對於串流或錄製工作階段很有用
MAX_MCP_OUTPUT_TOKENS MCP 工具回應中允許的最大 token 數。Claude Code 在輸出超過 10,000 token 時顯示警告。宣告 anthropic/maxResultSizeChars 的工具對文字內容使用該字元限制，但來自這些工具的影像內容仍受此變數限制（預設值：25000）
MAX_STRUCTURED_OUTPUT_RETRIES 當模型的回應無法驗證非互動式模式（-p 旗標）中的 --json-schema 時重試的次數。預設為 5
MAX_THINKING_TOKENS 覆蓋 extended thinking token 預算。上限是模型的 max output tokens 減一。設定為 0 以在 Anthropic API 上停用思考，除了 Fable 5，它無法關閉思考。在 third-party providers 上，0 同樣省略該參數，具有 adaptive reasoning 的模型仍可能思考。對於自適應推理模型上的非零值，預算會被忽略，除非透過 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 停用自適應推理
MCP_CLIENT_SECRET 需要 pre-configured credentials 的 MCP 伺服器的 OAuth 用戶端密碼。在使用 --client-secret 新增伺服器時避免互動式提示
MCP_CONNECTION_NONBLOCKING 控制啟動是否在第一個查詢之前等待 MCP 伺服器連線。{{/* min-version: 2.1.142 */}}自 Claude Code v2.1.142 起，MCP 啟動預設為非阻止：伺服器在背景中連線，其工具在完成時變為可用。設定為 0 以還原阻止 5 秒連線等待。配置 alwaysLoad: true 的伺服器仍會阻止啟動，無論如何，因為其工具必須在建立第一個提示時存在
MCP_CONNECT_TIMEOUT_MS 阻止 MCP 啟動等待連線批次的時間（以毫秒為單位），然後拍攝工具清單快照（預設值：5000）。適用於 MCP_CONNECTION_NONBLOCKING=0 或標記為 alwaysLoad: true 的伺服器。在截止時間時仍待處理的伺服器會在背景中繼續連線，但在下一個查詢之前不會出現。與 MCP_TIMEOUT 不同，後者限制個別伺服器的連線嘗試
MCP_OAUTH_CALLBACK_PORT OAuth 重新導向回呼的固定連接埠，作為在使用 pre-configured credentials 新增 MCP 伺服器時 --callback-port 的替代方案
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE 啟動期間並行連線的遠端 MCP 伺服器（HTTP/SSE）的最大數量（預設值：20）
MCP_SERVER_CONNECTION_BATCH_SIZE 啟動期間並行連線的本機 MCP 伺服器（stdio）的最大數量（預設值：3）
MCP_TIMEOUT MCP 伺服器啟動的逾時（以毫秒為單位）（預設值：30000，或 30 秒）
MCP_TOOL_TIMEOUT MCP 工具執行的逾時（以毫秒為單位）（預設值：100000000，約 28 小時）。對於 HTTP、SSE 或 claude.ai connector 伺服器，每個請求也預設在 60 秒後逾時；設定此變數或每個伺服器 timeout 超過 60000 以提高該每個請求限制。較低的值仍會縮短整體工具執行逾時，但將每個請求限制保留在 60 秒。Stdio 和 WebSocket 伺服器沒有每個請求計時器。.mcp.json 中的每個伺服器 timeout 欄位會覆蓋該伺服器的此值。每個伺服器 timeout 至少 1000 也會設定該伺服器的工具呼叫的最小閒置視窗，因此 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 永遠不會更早中止它們；此下限需要 Claude Code v2.1.203 或更新版本。對於環境變數，低於 1000 的值會下限為 1 秒；對於每個伺服器欄位，低於 1000 的值會被忽略
NO_PROXY 要直接發出請求的網域和 IP 清單，繞過代理
OTEL_LOG_ASSISTANT_RESPONSES {{/* min-version: 2.1.193 */}}設定為 1 以在 assistant_response OpenTelemetry 日誌事件上包含模型的回應文字。未設定時，使用 OTEL_LOG_USER_PROMPTS 的值。設定為 0 以保持回應編輯，即使設定 OTEL_LOG_USER_PROMPTS。需要 Claude Code v2.1.193 或更新版本。請參閱 Monitoring
OTEL_LOG_RAW_API_BODIES 設定為 1 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 api_request_body / api_response_body 日誌事件發出（在 60 KB 處截斷），或 file:<dir> 以將未截斷的主體寫入磁碟並發出 body_ref 路徑。預設停用；主體包括整個對話歷史記錄。請參閱 Monitoring
OTEL_LOG_TOOL_CONTENT 設定為 1 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 Monitoring
OTEL_LOG_TOOL_DETAILS 設定為 1 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串、api_refusal 事件上的拒絕 category 和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 Monitoring
OTEL_LOG_USER_PROMPTS 設定為 1 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用（提示被編輯）。請參閱 Monitoring
OTEL_METRICS_INCLUDE_ACCOUNT_UUID 設定為 false 以從指標屬性中排除帳戶 UUID（預設值：包含）。請參閱 Monitoring
OTEL_METRICS_INCLUDE_ENTRYPOINT {{/* min-version: 2.1.152 */}}設定為 true 以在指標屬性中包含工作階段進入點（預設值：排除）。在 v2.1.152 中新增。請參閱 Monitoring
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES {{/* min-version: 2.1.161 */}}自 v2.1.161 起，Claude Code 將 OTEL_RESOURCE_ATTRIBUTES 金鑰附加到指標資料點標籤。設定為 false 以排除它們（預設值：包含）。請參閱 Monitoring
OTEL_METRICS_INCLUDE_SESSION_ID 設定為 false 以從指標屬性中排除工作階段 ID（預設值：包含）。請參閱 Monitoring
OTEL_METRICS_INCLUDE_VERSION 設定為 true 以在指標屬性中包含 Claude Code 版本（預設值：排除）。請參閱 Monitoring
SLASH_COMMAND_TOOL_CHAR_BUDGET 覆蓋顯示給 Skill tool 的 skill 中繼資料的字元預算。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 個字元。為了向後相容性保留舊名稱
TASK_MAX_OUTPUT_LENGTH subagent 輸出在截斷前的最大字元數（預設值：32000，最大值：160000）。截斷時，完整輸出會儲存到磁碟，路徑會包含在截斷的回應中
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 {{/* min-version: 2.1.111 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Opus 4.7 的區域。在 v2.1.111 中新增
VERTEX_REGION_CLAUDE_4_8_OPUS {{/* min-version: 2.1.154 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Opus 4.8 的區域。在 v2.1.154 中新增
VERTEX_REGION_CLAUDE_5_SONNET {{/* min-version: 2.1.197 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Sonnet 5 的區域。在 v2.1.197 中新增
VERTEX_REGION_CLAUDE_FABLE_5 {{/* min-version: 2.1.170 */}}使用 Google Cloud's Agent Platform 時覆蓋 Claude Fable 5 的區域。在 v2.1.170 中新增
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 和信號特定變體）也受支援。請參閱 Monitoring 以取得配置詳細資訊。

另請參閱