> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 環境變數 > 控制 Claude Code 行為的環境變數完整參考。 環境變數可以控制 Claude Code 的行為，例如模型選擇、驗證、請求路由和功能切換。許多相同的行為也可以透過 [settings 檔案](/zh-TW/settings) 欄位、[CLI 旗標](/zh-TW/cli-reference) 或工作階段內命令（如 `/model`）進行配置。 本頁涵蓋如何： * [在您的 shell 或 settings 檔案中設定環境變數](#set-environment-variables) * [當行為可以透過多種方式設定時，檢查哪個值適用](#precedence) * [查詢 Claude Code 讀取的變數](#variables)

設定環境變數

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

在您的 shell 中

在啟動 `claude` 之前設定變數： ```bash theme={null} export API_TIMEOUT_MS="1200000" claude ``` 若要為每個工作階段設定，請將 `export` 行新增到 `~/.bashrc`、`~/.zshrc` 或您的 shell 設定檔。 ```powershell theme={null} $env:API_TIMEOUT_MS = "1200000" claude ``` 若要為每個工作階段設定，請執行 `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")` 並開啟新的終端。 ```batch theme={null} set API_TIMEOUT_MS=1200000 claude ``` 若要為每個工作階段設定，請執行 `setx API_TIMEOUT_MS "1200000"` 並開啟新的終端。

在 settings 檔案中

在 `settings.json` 檔案的 `env` 鍵下新增變數。Claude Code 在啟動時直接從檔案讀取它們，因此無論如何啟動 `claude`，它們都會生效。 ```json ~/.claude/settings.json theme={null} { "env": { "API_TIMEOUT_MS": "1200000", "BASH_DEFAULT_TIMEOUT_MS": "300000" } } ``` 您選擇的檔案控制變數適用於誰： | 檔案 | 適用於 | | :---------------------------- | :----------------------------------- | | `~/.claude/settings.json` | 您，在每個專案中 | | `.claude/settings.json` | 在專案中工作的每個人，簽入原始碼控制 | | `.claude/settings.local.json` | 您，僅在此專案中（如果您手動建立，請將其新增到您的 gitignore） | | 受管 settings | 您組織中的每個人，由管理員部署 | 請參閱 [Settings 檔案](/zh-TW/settings#settings-files) 以了解每個檔案的位置，以及 [Settings 優先順序](/zh-TW/settings#settings-precedence) 以了解當多個檔案設定相同變數時它們如何結合。

優先順序

當相同的行為同時具有環境變數和 settings 欄位時，環境變數優先。例如，`ANTHROPIC_MODEL` 覆蓋 `model` 設定，`CLAUDE_CODE_AUTO_CONNECT_IDE` 覆蓋 `autoConnectIde`。當環境變數未設定時，settings 欄位適用。 環境變數與 CLI 旗標和工作階段內命令的互動因功能而異：`--model` 和 `/model` 覆蓋 `ANTHROPIC_MODEL`，而 `CLAUDE_CODE_EFFORT_LEVEL` 覆蓋 `/effort`。當變數與另一個配置來源互動時，其在 [變數](#variables) 清單中的列會說明優先順序或連結到記錄它的頁面。 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](/zh-TW/claude-platform-on-aws) 的工作區 API 金鑰，在 AWS 主控台中產生。作為 `x-api-key` 發送，優先於 AWS SigV4 | | `ANTHROPIC_AWS_BASE_URL` | 覆蓋 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 端點 URL。用於自訂區域或透過 [LLM gateway](/zh-TW/llm-gateway) 路由。預設為 `https://aws-external-anthropic.{AWS_REGION}.api.aws` | | `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 所需。在每個請求上作為 `anthropic-workspace-id` 標頭發送 | | `ANTHROPIC_BASE_URL` | 覆蓋 API 端點以透過代理或閘道路由請求。設定為非第一方主機時，[MCP tool search](/zh-TW/mcp#scale-with-mcp-tool-search) 預設停用。如果您的代理轉發 `tool_reference` 區塊，請設定 `ENABLE_TOOL_SEARCH=true` | | `ANTHROPIC_BEDROCK_BASE_URL` | 覆蓋 Bedrock 端點 URL。用於自訂 Bedrock 端點或透過 [LLM gateway](/zh-TW/llm-gateway) 路由。請參閱 [Amazon Bedrock](/zh-TW/amazon-bedrock) | | `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | 覆蓋 Bedrock Mantle 端點 URL。請參閱 [Mantle endpoint](/zh-TW/amazon-bedrock#use-the-mantle-endpoint) | | `ANTHROPIC_BEDROCK_SERVICE_TIER` | Bedrock [service tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex` 或 `priority`）。作為 `X-Amzn-Bedrock-Service-Tier` 標頭發送。請參閱 [Amazon Bedrock](/zh-TW/amazon-bedrock#service-tiers) | | `ANTHROPIC_BETAS` | 逗號分隔的其他 `anthropic-beta` 標頭值清單，以包含在 API 請求中。Claude Code 已發送其需要的 beta 標頭；使用此選項可在 Claude Code 新增原生支援之前選擇加入 [Anthropic API beta](https://platform.claude.com/docs/en/api/beta-headers)。與 [`--betas` 旗標](/zh-TW/cli-reference#cli-flags)（需要 API 金鑰驗證）不同，此變數適用於所有驗證方法，包括 Claude.ai 訂閱 | | `ANTHROPIC_CUSTOM_HEADERS` | 要新增至請求的自訂標頭（`Name: Value` 格式，多個標頭以換行符分隔） | | `ANTHROPIC_CUSTOM_MODEL_OPTION` | 要在 `/model` 選擇器中新增為自訂項目的模型 ID。使用此選項可使非標準或閘道特定的模型可選擇，而無需替換內建別名。請參閱 [Model configuration](/zh-TW/model-config#add-a-custom-model-option) | | `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 選擇器中自訂模型項目的顯示描述。未設定時預設為 `Custom model ()` | | `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 選擇器中自訂模型項目的顯示名稱。未設定時預設為模型 ID | | `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_FABLE_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_OPUS_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_SONNET_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 請參閱 [Model configuration](/zh-TW/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 驗證的 API 金鑰（請參閱 [Microsoft Foundry](/zh-TW/microsoft-foundry)） | | `ANTHROPIC_FOUNDRY_BASE_URL` | Foundry 資源的完整基礎 URL（例如，`https://my-resource.services.ai.azure.com/anthropic`）。`ANTHROPIC_FOUNDRY_RESOURCE` 的替代方案（請參閱 [Microsoft Foundry](/zh-TW/microsoft-foundry)） | | `ANTHROPIC_FOUNDRY_RESOURCE` | Foundry 資源名稱（例如，`my-resource`）。如果未設定 `ANTHROPIC_FOUNDRY_BASE_URL`，則為必需（請參閱 [Microsoft Foundry](/zh-TW/microsoft-foundry)） | | `ANTHROPIC_MODEL` | 要使用的模型設定名稱（請參閱 [Model Configuration](/zh-TW/model-config#environment-variables)） | | `ANTHROPIC_SMALL_FAST_MODEL` | \[已棄用] [Haiku 級別模型用於背景任務](/zh-TW/costs)的名稱 | | `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | 使用 Bedrock 或 Bedrock Mantle 時覆蓋 Haiku 級別模型的 AWS 區域。在 Bedrock 上，僅當同時設定 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 或已棄用的 `ANTHROPIC_SMALL_FAST_MODEL` 時才生效，因為 Bedrock 否則會為背景任務使用主要模型 | | `ANTHROPIC_VERTEX_BASE_URL` | 覆蓋 Vertex AI 端點 URL。用於自訂 Vertex 端點或透過 [LLM gateway](/zh-TW/llm-gateway) 路由。請參閱 [Google Vertex AI](/zh-TW/google-vertex-ai) | | `ANTHROPIC_VERTEX_PROJECT_ID` | Vertex AI 的 GCP 專案 ID。被 `GCLOUD_PROJECT`、`GOOGLE_CLOUD_PROJECT` 或您的 `GOOGLE_APPLICATION_CREDENTIALS` 認證檔案中的專案覆蓋。請參閱 [Google Vertex AI](/zh-TW/google-vertex-ai) | | `ANTHROPIC_WORKSPACE_ID` | [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的工作區 ID。當您的聯盟規則的範圍涵蓋多個工作區時設定此項，以便權杖交換知道要針對哪個工作區 | | `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}覆蓋 5 分鐘的閒置逾時，該逾時會在沒有位元組到達時中止串流模型回應。設定為 `0` 以停用逾時，例如當緩慢的 [gateway](/zh-TW/llm-gateway) 或本機模型在區塊之間暫停超過 5 分鐘時。設定為 `1` 以在每個提供者上保持逾時。未設定時，逾時在直接 Anthropic API 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 連線上無效，其中 Claude Code 自己的位元組級串流監視程式執行，在每個其他提供者上有效，包括 [Vertex AI](/zh-TW/google-vertex-ai)、[Foundry](/zh-TW/microsoft-foundry)、[Mantle](/zh-TW/amazon-bedrock#use-the-mantle-endpoint)、[Bedrock](/zh-TW/amazon-bedrock) 和閘道連線，因此停滯的串流會中止而不是掛起。自 v2.1.169 起 | | `API_TIMEOUT_MS` | API 請求的逾時（以毫秒為單位）（預設值：600000，或 10 分鐘；最大值：2147483647）。在緩慢網路上請求逾時或透過代理路由時增加此值。超過最大值的值會導致基礎計時器溢位，並導致請求立即失敗 | | `AWS_BEARER_TOKEN_BEDROCK` | Bedrock API 金鑰用於驗證（請參閱 [Bedrock API keys](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)） | | `BASH_DEFAULT_TIMEOUT_MS` | 長時間執行的 bash 命令的預設逾時（預設值：120000，或 2 分鐘） | | `BASH_MAX_OUTPUT_LENGTH` | bash 輸出中的最大字元數，超過此數量後完整輸出會儲存到檔案，Claude 會收到路徑加上簡短預覽。請參閱 [Bash tool behavior](/zh-TW/tools-reference#bash-tool-behavior) | | `BASH_MAX_TIMEOUT_MS` | 模型可以為長時間執行的 bash 命令設定的最大逾時（預設值：600000，或 10 分鐘） | | `CCR_FORCE_BUNDLE` | 設定為 `1` 以強制 [`claude --remote`](/zh-TW/claude-code-on-the-web#send-local-repositories-without-github) 在 GitHub 存取可用時也要捆綁並上傳您的本機儲存庫 | | `CLAUDECODE` | 在 Claude Code 生成的子程序中設定為 `1`（Bash 和 PowerShell 工具、tmux 工作階段、[hook](/zh-TW/hooks) 命令、[status line](/zh-TW/statusline) 命令、stdio [MCP server](/zh-TW/mcp) 子程序）。IDE 擴充功能也在其整合終端中設定此項。用於偵測指令碼何時在 Claude Code 生成的子程序內執行。若要檢查目前程序是否由工具呼叫或 hook 直接生成，而不是在 Claude Code 啟動的 stdio MCP 伺服器內，請改用 `CLAUDE_CODE_CHILD_SESSION` | | `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 設定為 `1` 以停用所有內建 [subagent](/zh-TW/sub-agents) 類型，例如 Explore 和 Plan。僅適用於非互動式模式（`-p` 旗標）。對於想要空白狀態的 SDK 使用者很有用 | | `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 設定為 `1` 以跳過來自 SDK 建立的 MCP 伺服器的工具名稱上的 `mcp____` 前綴。工具使用其原始名稱。僅限 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](/zh-TW/claude-code-on-the-web) 中、在沒有 [extended context](/zh-TW/model-config#extended-context) 的 Sonnet 4.6 和 Opus 4.6 上，預設在 200K 邊界進行壓縮。在其他情況下，例如本機工作階段，當對話達到模型的上下文限制時，自動壓縮觸發。覆蓋只能降低閾值，因此高於預設值的值無效。適用於主要對話和 subagents | | `CLAUDE_AUTO_BACKGROUND_TASKS` | 設定為 `1` 以強制啟用長時間執行的代理任務的自動背景執行。啟用時，subagents 在執行約兩分鐘後會移至背景 | | `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}設定為 `1` 以呈現螢幕閱讀器友善的輸出：沒有裝飾邊框或動畫的平面文字。設定為 `0` 以強制關閉螢幕閱讀器模式，即使 [`axScreenReader`](/zh-TW/settings#available-settings) 為 `true`。[`--ax-screen-reader`](/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 | | `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主工作階段中每個 Bash 或 PowerShell 命令後返回原始工作目錄 | | `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}外部工具（例如螢幕鎖定監聽器）在您解鎖螢幕時建立並在您鎖定螢幕時刪除的檔案路徑。檔案存在時，Claude Code 會跳過 [Remote Control mobile push notifications](/zh-TW/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](/zh-TW/fullscreen) 中的每一幀上重新繪製整個螢幕，而不是發送增量更新。如果全螢幕模式顯示過時或錯位的文字片段，請使用此選項。Claude Code 在 Windows 上的背景工作階段和 [agent view](/zh-TW/agent-view) 中自動啟用此功能 | | `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 設定為 `1` 以在每個請求中發送 [effort](/zh-TW/model-config#adjust-effort-level) 參數，即使 Claude Code 不將模型 ID 識別為支援努力的模型。在透過 [LLM gateway](/zh-TW/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`](/zh-TW/settings#available-settings) 時） | | `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設定為 `0` 以停止 Claude Code 在發佈新 [artifact](/zh-TW/artifacts) 時自動開啟瀏覽器。重新發佈現有 artifact 無論此設定如何都不會開啟瀏覽器 | | `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 以省略系統提示開始處的歸屬區塊（用戶端版本和提示指紋）。停用它會改善透過 [LLM gateway](/zh-TW/llm-gateway) 路由時的提示快取命中率。Anthropic API 快取不受影響 | | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定用於自動壓縮計算的上下文容量（以 token 為單位）。預設為模型的上下文視窗：標準模型為 200K 或 [extended context](/zh-TW/model-config#extended-context) 模型為 1M。在 1M 模型上使用較低的值（如 `500000`）以將視窗視為 500K 用於壓縮目的。該值上限為模型的實際上下文視窗。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 作為此值的百分比應用。設定此變數會將壓縮閾值與狀態行的 `used_percentage` 解耦，後者始終使用模型的完整上下文視窗 | | `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆蓋自動 [IDE connection](/zh-TW/vs-code)。預設情況下，在支援的 IDE 的整合終端內啟動時，Claude Code 會自動連線。設定為 `false` 以防止此情況。設定為 `true` 以在自動偵測失敗時強制連線嘗試，例如當 tmux 遮蔽父終端時。優先於 [`autoConnectIde`](/zh-TW/settings#global-config-settings) 全域配置設定 | | `CLAUDE_CODE_CERT_STORE` | TLS 連線的 CA 憑證來源逗號分隔清單。`bundled` 是隨 Claude Code 提供的 Mozilla CA 集。`system` 是作業系統信任存放區。預設為 `bundled,system` | | `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}在 Claude Code 透過 Bash、PowerShell 和 Monitor 工具、[hook](/zh-TW/hooks) 命令和 [status line](/zh-TW/statusline) 命令生成的子程序中設定為 `1`。不為 stdio [MCP server](/zh-TW/mcp) 子程序設定，這些是長期存在的，並且超過啟動它們的工作階段。與 `CLAUDECODE` 不同，這僅由 Claude Code 自己的生成路徑設定，而不是由 IDE 擴充功能設定，因此它可靠地區分嵌套工作階段與在 IDE 整合終端中啟動的頂層 `claude`。以這種方式啟動的嵌套互動式 `claude` TUI 會自動從 `--resume`、`--continue`、向上箭頭歷史記錄和 `claude agents` 清單中排除。非互動式 `claude -p` 工作階段仍然保留。設定 `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` 以覆蓋此排除。需要 Claude Code v2.1.172 或更新版本 | | `CLAUDE_CODE_CLIENT_CERT` | 用於 mTLS 驗證的用戶端憑證檔案的路徑 | | `CLAUDE_CODE_CLIENT_KEY` | 用於 mTLS 驗證的用戶端私密金鑰檔案的路徑 | | `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 加密 CLAUDE\_CODE\_CLIENT\_KEY 的密碼（可選） | | `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}在 v2.1.186 中移除，現在是無操作。先前設定串流 API 請求的連線、TLS 和回應標頭階段的逾時。使用 `API_TIMEOUT_MS` 進行每個請求的逾時 | | `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆蓋偵錯日誌檔案路徑。儘管名稱如此，這是檔案路徑，而不是目錄。需要透過 `--debug`、`/debug` 或 `DEBUG` 環境變數單獨啟用偵錯模式：僅設定此變數不會啟用日誌記錄。[`--debug-file`](/zh-TW/cli-reference#cli-flags) 旗標同時執行兩者。預設為 `~/.claude/debug/.txt` | | `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最小日誌級別。值：`verbose`、`debug`（預設）、`info`、`warn`、`error`。設定為 `verbose` 以包含高容量診斷，例如完整狀態行命令輸出，或提高到 `error` 以減少雜訊 | | `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 以停用 [1M context window](/zh-TW/model-config#extended-context) 支援。設定時，1M 模型變體在模型選擇器中不可用。對於具有合規性要求的企業環境很有用 | | `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 設定為 `1` 以停用 Opus 4.6 和 Sonnet 4.6 的 [adaptive reasoning](/zh-TW/model-config#adjust-effort-level)，並回退到由 `MAX_THINKING_TOKENS` 控制的固定思考預算。{/* min-version: 2.1.111 */}從 v2.1.111 起，對 Fable 5 無效，或對 Opus 4.7 及更新版本無效，其始終使用自適應推理 | | `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}設定為 `1` 以停用 [advisor tool](/zh-TW/advisor)。`/advisor` 命令和 `--advisor` 旗標變為不可用，任何配置的 `advisorModel` 都會被忽略。需要 Claude Code v2.1.98 或更新版本 | | `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 以關閉 [background agents and agent view](/zh-TW/agent-view)：`claude agents`、`--bg`、`/background` 和隨選主管。相當於 [`disableAgentView`](/zh-TW/settings#available-settings) 設定 | | `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 並使用經典主螢幕渲染器。對話保留在您終端的原生捲動回溯中，因此 `Cmd+f` 和 tmux 複製模式可以正常工作。優先於 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-TW/settings#available-settings) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/zh-TW/agent-view) 開啟的背景工作階段，其始終使用全螢幕渲染 | | `CLAUDE_CODE_DISABLE_ARTIFACT` | 設定為 `1` 以停用 [Artifact](/zh-TW/artifacts) 工具，該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。相當於 [`disableArtifact`](/zh-TW/settings#available-settings) 設定 | | `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 設定為 `1` 以停用附件處理。使用 `@` 語法的檔案提及會作為純文字發送，而不是擴展為檔案內容 | | `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 設定為 `1` 以停用 [auto memory](/zh-TW/memory#auto-memory)。設定為 `0` 以在 `--bare` 模式或 [`autoMemoryEnabled: false`](/zh-TW/settings#available-settings) 會以其他方式停用時強制啟用自動記憶體。停用時，Claude 不會建立或載入自動記憶體檔案 | | `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 以停用所有背景任務功能，包括 Bash 和 subagent 工具上的 `run_in_background` 參數、自動背景執行和 Ctrl+B 快捷鍵 | | `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設定為 `1` 以停用隨 Claude Code 提供的 [skills](/zh-TW/skills) 和工作流程：捆綁的 skills 和工作流程會完全移除，而內建的斜線命令（如 `/init`）保持可輸入但對模型隱藏。來自外掛程式、`.claude/skills/` 和 `.claude/commands/` 的 skills 不受影響。相當於 [`disableBundledSkills`](/zh-TW/settings#available-settings) 設定；`0` 不會覆蓋它 | | `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 設定為 `1` 以防止將任何 CLAUDE.md 記憶體檔案載入上下文，包括使用者、專案和自動記憶體檔案 | | `CLAUDE_CODE_DISABLE_CRON` | 設定為 `1` 以停用 [scheduled tasks](/zh-TW/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`）會保留。 | | `CLAUDE_CODE_DISABLE_FAST_MODE` | 設定為 `1` 以停用 [fast mode](/zh-TW/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`](/zh-TW/settings#available-settings) 設定。請參閱 [Session quality surveys](/zh-TW/data-usage#session-quality-surveys) | | `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 設定為 `1` 以停用檔案 [checkpointing](/zh-TW/checkpointing)。`/rewind` 命令將無法還原程式碼變更 | | `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 設定為 `1` 以從 Claude 的系統提示中移除內建的提交和 PR 工作流程指令以及 git 狀態快照。在使用您自己的 git 工作流程 skills 時很有用。設定時優先於 [`includeGitInstructions`](/zh-TW/settings#available-settings) 設定 | | `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | 設定為 `1` 以防止在 Anthropic API 上自動重新對應 Opus 4.0 和 4.1 至目前的 Opus 版本。在您想要刻意固定較舊模型時使用。重新對應不在 Bedrock、Vertex 或 Foundry 上執行 | | `CLAUDE_CODE_DISABLE_MOUSE` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 中的滑鼠追蹤。使用 `PgUp` 和 `PgDn` 的鍵盤捲動仍然有效。使用此選項可保留您終端的原生選擇複製行為 | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 相當於設定 `DISABLE_AUTOUPDATER`、`DISABLE_FEEDBACK_COMMAND`、`DISABLE_ERROR_REPORTING` 和 `DISABLE_TELEMETRY` | | `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 設定為 `1` 以停用串流請求在中途失敗時的非串流回退。串流錯誤會傳播到重試層。當代理或閘道導致回退產生重複的工具執行時很有用 | | `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](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)，請改用 `MAX_THINKING_TOKENS=0`，這在 Fable 5 上也無效，因為它無法關閉思考。在 [third-party providers](/zh-TW/third-party-integrations) 上，`0` 同樣省略該參數，因此兩個變數在那裡的行為相同 | | `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 中的虛擬捲動，並呈現文字記錄中的每條訊息。如果全螢幕模式中的捲動顯示應該出現訊息的空白區域，請使用此選項 | | `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設定為 `1` 以停用 [workflows](/zh-TW/workflows#turn-workflows-off)。相當於 [`disableWorkflows`](/zh-TW/settings#available-settings) 設定 | | `CLAUDE_CODE_EFFORT_LEVEL` | 為支援的模型設定努力級別。值：`low`、`medium`、`high`、`xhigh`、`max` 或 `auto` 以使用模型預設值。可用級別取決於模型。優先於 `/effort` 和 `effortLevel` 設定。請參閱 [Adjust effort level](/zh-TW/model-config#adjust-effort-level) | | `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}設定為 `1` 以在 Amazon Bedrock、Google Cloud Vertex AI 和 Microsoft Foundry 上啟用 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)。需要 Claude Code v2.1.158 或更新版本。對 Anthropic API 無效，其中 auto mode 預設可用。請參閱 [在 Bedrock、Vertex AI 或 Foundry 上啟用自動模式](/zh-TW/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) | | `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆蓋 [session recap](/zh-TW/interactive-mode#session-recap) 可用性。設定為 `0` 以強制關閉摘要，無論 `/config` 切換如何。設定為 `1` 以在 [`awaySummaryEnabled`](/zh-TW/settings#available-settings) 為 `false` 時強制啟用摘要。優先於設定和 `/config` 切換 | | `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設定為 `1` 以在 [non-interactive mode](/zh-TW/headless) 中背景安裝完成後在回合邊界處刷新外掛程式狀態。預設關閉，因為刷新會在工作階段中途更改系統提示，這會使該回合的 [prompt caching](/zh-TW/prompt-caching) 失效 | | `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 設定為 `1` 以在 Anthropic 綁定的非必要流量被阻止時將「Claude 表現如何？」工作階段品質調查路由到您自己的 [OpenTelemetry collector](/zh-TW/monitoring-usage)。調查評分僅作為 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 上預設啟用。在 Bedrock 和 Vertex 上，按模型啟用，其中已部署的容器支援它。設定為 `0` 以選擇退出。設定為 `1` 以在透過 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 路由時強制啟用。在 Foundry 和 [gateway](/zh-TW/llm-gateway) 連線上預設關閉 | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向 Anthropic 相容閘道（例如 LiteLLM、Kong 或內部代理）時從您的閘道的 `/v1/models` 端點填充 `/model` 選擇器。預設關閉，因為由共享 API 金鑰支援的閘道會以其他方式向每個使用者顯示該金鑰可以存取的每個模型。探索的模型仍由 [`availableModels`](/zh-TW/settings#available-settings) 允許清單篩選 | | `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}在 v2.1.142 中移除，當 [fast mode](/zh-TW/fast-mode) 預設從 Opus 4.6 移至 Opus 4.7 時 | | `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 設定為 `false` 以停用提示建議（`/config` 中的「提示建議」切換）。這些是在 Claude 回應後出現在您的提示輸入中的灰顯預測。請參閱 [Prompt suggestions](/zh-TW/interactive-mode#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](/zh-TW/interactive-mode#task-list) 和 [Migrate to Task tools](/zh-TW/agent-sdk/todo-tracking#migrate-to-task-tools) | | `CLAUDE_CODE_ENABLE_TELEMETRY` | 設定為 `1` 以啟用 OpenTelemetry 資料收集以進行指標和日誌記錄。在配置 OTel 匯出器之前需要。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 查詢迴圈變為閒置後自動退出前等待的時間（以毫秒為單位）。對於使用 SDK 模式的自動化工作流程和指令碼很有用 | | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 設定為 `1` 以啟用 [agent teams](/zh-TW/agent-teams)。Agent teams 是實驗性的，預設停用 | | `CLAUDE_CODE_EXTRA_BODY` | JSON 物件以合併到每個 API 請求主體的頂層。對於傳遞 Claude Code 不直接公開的提供者特定參數很有用 | | `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 工具首次啟動的 tmux 伺服器）導致真正的頂層工作階段被誤分類為嵌套時使用。{/* 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](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)（當您的終端支援但未自動偵測時）。對於實現 BSU/ESU 但不回覆功能探測的模擬器（例如 Emacs `eat`）很有用。在 tmux 下無效 | | `CLAUDE_CODE_FORK_SUBAGENT` | 設定為 `1` 以啟用 Claude 生成 [forked subagents](/zh-TW/sub-agents#fork-the-current-conversation)，或 `0` 以停用它們，覆蓋任何伺服器端推出。啟用時，Claude 可以要求 `fork` subagent 類型以生成分叉，一個繼承完整對話上下文而不是從頭開始的 subagent。沒有 subagent 類型的生成仍使用通用 subagent，所有 subagent 生成都在背景中執行。明確的 [`/fork`](/zh-TW/commands) 命令無需此變數即可工作。在互動式模式和透過 SDK 或 `claude -p` 中工作 | | `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows：Git Bash 可執行檔（`bash.exe`）的路徑。在 Git Bash 已安裝但不在您的 PATH 中時使用。請參閱 [Windows setup](/zh-TW/setup#set-up-on-windows) | | `CLAUDE_CODE_GLOB_HIDDEN` | 設定為 `false` 以在 Claude 呼叫 [Glob tool](/zh-TW/tools-reference#glob-tool-behavior) 時從結果中排除隱藏檔案。預設包含。不影響 `@` 檔案自動完成、`ls`、Grep 或 Read | | `CLAUDE_CODE_GLOB_NO_IGNORE` | 設定為 `false` 以使 [Glob tool](/zh-TW/tools-reference#glob-tool-behavior) 尊重 `.gitignore` 模式。預設情況下，Glob 返回所有符合的檔案，包括 gitignored 的檔案。不影響 `@` 檔案自動完成，其具有自己的 [`respectGitignore` 設定](/zh-TW/settings#available-settings) | | `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` | 跳過 IDE 擴充功能的自動安裝。相當於將 [`autoInstallIdeExtension`](/zh-TW/settings#global-config-settings) 設定為 `false` | | `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 設定為 `1` 以跳過連線期間 IDE 鎖定檔案項目的驗證。當自動連線無法找到您的 IDE（儘管它正在執行）時使用 | | `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆蓋 Claude Code 假設用於作用中模型的上下文視窗大小。僅在同時設定 `DISABLE_COMPACT` 時生效。當透過 `ANTHROPIC_BASE_URL` 路由到模型時使用，其上下文視窗與其名稱的內建大小不符 | | `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異；請參閱 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值會減少在 [auto-compaction](/zh-TW/costs#reduce-token-usage) 觸發之前可用的有效上下文視窗。 | | `CLAUDE_CODE_MAX_RETRIES` | 覆蓋重試失敗 API 請求的次數（預設值：10）。{/* min-version: 2.1.186 */}自 v2.1.186 起上限為 15。對於需要等待較長中斷的無人值守工作階段，請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` | | `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可以並行執行的唯讀工具和 subagents 的最大數量（預設值：10）。較高的值會增加並行性，但消耗更多資源 | | `CLAUDE_CODE_MAX_TURNS` | 當未傳遞明確限制時，限制代理回合的數量。相當於傳遞 [`--max-turns`](/zh-TW/cli-reference#cli-flags)，當兩者都設定時優先。不是正整數的值在啟動時會被拒絕並出現錯誤，而不是被視為無限制 | | `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設定為 `1` 以使用僅安全基線環境加上伺服器配置的 `env` 而不是繼承您的 shell 環境來生成 stdio MCP 伺服器 | | `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}遠端 MCP 工具呼叫的閒置逾時（以毫秒為單位）（預設值：300000，或 5 分鐘）。當 HTTP、SSE、WebSocket 或 [claude.ai connector](/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在此期間內沒有發送回應和進度通知時，工具呼叫會中止並出現錯誤，而不是等待牆上時鐘 `MCP_TOOL_TIMEOUT`。設定為 `0` 以停用閒置檢查。低於 1000 的值會提高到 1 秒，該值上限為有效的 `MCP_TOOL_TIMEOUT`。不適用於 stdio 或 IDE 伺服器。需要 Claude Code v2.1.187 或更新版本 | | `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](/zh-TW/fullscreen)，一項研究預覽，可減少閃爍並在長對話中保持記憶體平坦。相當於 [`tui`](/zh-TW/settings#available-settings) 設定；您也可以使用 `/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`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 | | `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}在 v2.1.160 中移除，現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6，而不是目前的預設值 | | `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}設定為 `1` 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下，這些錯誤僅在 `--debug` 時出現，因此配置不當的匯出器（例如 Prometheus 連接埠衝突）會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時（以毫秒為單位）（預設值：5000）。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔（以毫秒為單位）（預設值：1740000 / 29 分鐘）。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) | | `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：2000）。如果指標在退出時被丟棄，請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 設定為 `1` 以讓 Claude Code 在新版本可用時在背景中執行您的套件管理員的升級命令。適用於 Homebrew 和 WinGet 安裝。其他套件管理員繼續顯示升級命令而不執行它。請參閱 [Auto updates](/zh-TW/setup#auto-updates) | | `CLAUDE_CODE_PERFORCE_MODE` | 設定為 `1` 以啟用 Perforce 感知寫入保護。設定時，如果目標檔案缺少擁有者寫入位元（Perforce 在同步的檔案上清除，直到 `p4 edit` 開啟它們），Edit、Write 和 NotebookEdit 會失敗並提示 `p4 edit `。這可防止 Claude Code 繞過 Perforce 變更追蹤 | | `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 覆蓋外掛程式根目錄。儘管名稱如此，這會設定父目錄，而不是快取本身：市場和外掛程式快取位於此路徑下的子目錄中。預設為 `~/.claude/plugins` | | `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 安裝或更新外掛程式時 git 操作的逾時（以毫秒為單位）（預設值：120000）。對於大型儲存庫或網路連線緩慢，請增加此值。請參閱 [Git operations time out](/zh-TW/plugin-marketplaces#git-operations-time-out) | | `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 設定為 `1` 以在 `git pull` 失敗時保留現有的市場快取，而不是擦除並重新複製。在離線或隔離環境中很有用，其中重新複製會以相同方式失敗。請參閱 [Marketplace updates fail in offline environments](/zh-TW/plugin-marketplaces#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](/zh-TW/plugin-marketplaces#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 */}[非互動式模式](/zh-TW/headless#background-tasks-at-exit)使用 `-p` 旗標在最終回合後等待的最大時間（以毫秒為單位），用於背景 subagents 和工作流程，其結果是輸出的一部分。預設值：`600000`，或 10 分鐘。超過上限時，剩餘背景任務會被終止，程序會退出。設定為 `0` 以無限期等待。此上限與適用於純背景 shells 的 5 秒寬限期分開 | | `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)](/zh-TW/monitoring-usage#traces-beta) | | `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 並代表其管理模型提供者路由的主機平台設定。設定時，提供者選擇、端點和驗證變數（例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`）在設定檔案中被忽略，以便使用者設定無法覆蓋主機的路由。Bedrock、Vertex 和 Foundry 的自動遙測選擇退出也會被跳過，因此遙測遵循標準 `DISABLE_TELEMETRY` 選擇退出。請參閱 [Default behaviors by API provider](/zh-TW/data-usage#default-behaviors-by-api-provider) | | `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 設定為 `1` 以允許代理執行 DNS 解析而不是呼叫者。對於代理應處理主機名稱解析的環境選擇加入 | | `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 | | `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link output back to the session](/zh-TW/claude-code-on-the-web#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 分鐘，或直到限制在回應帶有速率限制重設時間時重設，因此達到使用限制的工作階段會等待剩餘視窗。需要 Claude Code v2.1.186 或更新版本 | | `CLAUDE_CODE_SAFE_MODE` | 設定為 `1` 以在安全模式下啟動：CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態行和檔案建議命令、LSP 伺服器和自動記憶體不載入，用於對損壞的配置進行故障排除。受管設定政策仍然適用，包括政策配置的 hooks、狀態行和檔案建議命令；受管外掛程式、受管 skills、受管 CLAUDE.md 和政策配置的 MCP 伺服器不適用。相當於傳遞 [`--safe-mode`](/zh-TW/cli-reference#cli-flags)。直接生成的子程序繼承該變數 | | `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](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值，以及低於 1 的分數值（例如 `0.5`）以減慢終端上原生捲動路徑中加速的觸控板和滾輪捲動。設定為 `3` 以符合 `vim`（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件）。在 JetBrains IDE 終端中被忽略，Claude Code 使用其自己的捲動處理 | | `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆蓋 [SessionEnd](/zh-TW/hooks#sessionend) hooks 的時間預算（以毫秒為單位）。適用於工作階段退出、`/clear` 和透過互動式 `/resume` 切換工作階段。預設情況下，預算為 1.5 秒，自動提高到設定檔案中配置的最高每個 hook `timeout`，最高 60 秒。外掛程式提供的 hooks 上的逾時不會提高預算 | | `CLAUDE_CODE_SESSION_ID` | 在 Bash 和 PowerShell 工具子程序、[hook command](/zh-TW/hooks) 子程序和 stdio [MCP server](/zh-TW/mcp) 子程序中自動設定為目前工作階段 ID。對於 Bash、PowerShell 和 hooks，這符合傳遞給 hook JSON 輸入的 `session_id` 欄位，並在 `/clear` 時更新。MCP 伺服器子程序保留它生成時的 ID。在 `--resume ` 上，它接收繼續的 ID，符合 hooks 和 Bash。在 `--continue` 或 `--resume` 沒有明確 ID 時，它可能接收初始啟動 ID。用於將指令碼和外部工具與啟動它們的 Claude Code 工作階段相關聯 | | `CLAUDE_CODE_SHELL` | 覆蓋自動 shell 偵測。當您的登入 shell 與您偏好的工作 shell 不同時很有用（例如，`bash` 與 `zsh`） | | `CLAUDE_CODE_SHELL_PREFIX` | 命令前綴以包裝 Claude Code 生成的 shell 命令：Bash 工具呼叫、[hook](/zh-TW/hooks) 命令、[status line](/zh-TW/statusline) 命令和 stdio [MCP server](/zh-TW/mcp) 啟動命令。PowerShell hooks 和 exec 形式的 hooks 無需前綴執行。對於日誌記錄或稽核很有用。設定裸可執行檔路徑（例如 `/path/to/logger.sh`）會將每個命令執行為 `/path/to/logger.sh ''`。包裝器在 `$1` 中接收命令行作為單個 shell 引用的引數，因此包裝器必須使用 shell 重新評估 `$1`，例如 `exec bash -c "$1"`。將 `$1` 視為裸可執行檔路徑會破壞傳遞引數的 stdio MCP 伺服器，例如 `npx -y `。對於 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`](/zh-TW/headless#start-faster-with-bare-mode) | | `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 設定為 `1` 以在任何模型上使用較短的系統提示和縮寫工具描述。設定為 `0`、`false`、`no` 或 `off` 以選擇退出，即使實驗或伺服器配置會以其他方式啟用它。完整工具集、hooks、MCP 伺服器和 CLAUDE.md 探索保持啟用 | | `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 跳過 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 的用戶端驗證，用於自行簽署請求的閘道 | | `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | 跳過 Bedrock 的 AWS 驗證（例如，使用 LLM 閘道時） | | `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 跳過 Microsoft Foundry 的 Azure 驗證（例如，使用 LLM 閘道時） | | `CLAUDE_CODE_SKIP_MANTLE_AUTH` | 跳過 Bedrock Mantle 的 AWS 驗證（例如，使用 LLM 閘道時） | | `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 設定為 `1` 以跳過將提示歷史記錄和工作階段文字記錄寫入磁碟。使用此變數啟動的工作階段不會出現在 `--resume`、`--continue` 或向上箭頭歷史記錄中。對於臨時指令碼化工作階段很有用 | | `CLAUDE_CODE_SKIP_VERTEX_AUTH` | 跳過 Vertex 的 Google 驗證（例如，使用 LLM 閘道時） | | `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/zh-TW/hooks#stop) 或 [SubagentStop](/zh-TW/hooks#subagentstop) hook 可能連續阻止回合結束的最大次數，然後 Claude Code 覆蓋它並無論如何結束回合（預設值：8）。設定為 `0` 以停用上限。如果您的 hook 合法需要更多迭代來解決，請提高此值 | | `CLAUDE_CODE_SUBAGENT_MODEL` | 請參閱 [Model configuration](/zh-TW/model-config) | | `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](/zh-TW/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`](/zh-TW/settings) 設定 | | `CLAUDE_CODE_TASK_LIST_ID` | 跨工作階段共享任務清單。在多個 Claude Code 實例中設定相同的 ID 以協調共享任務清單。請參閱 [Task list](/zh-TW/interactive-mode#task-list) | | `CLAUDE_CODE_TEAM_NAME` | 此隊友所屬的 agent team 名稱。在 [agent team](/zh-TW/agent-teams) 成員上自動設定 | | `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](/zh-TW/sandboxing) 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](/zh-TW/terminal-config) 以取得其他 tmux 設定 | | `CLAUDE_CODE_USE_ANTHROPIC_AWS` | 使用 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) | | `CLAUDE_CODE_USE_BEDROCK` | 使用 [Bedrock](/zh-TW/amazon-bedrock) | | `CLAUDE_CODE_USE_FOUNDRY` | 使用 [Microsoft Foundry](/zh-TW/microsoft-foundry) | | `CLAUDE_CODE_USE_MANTLE` | 使用 Bedrock [Mantle endpoint](/zh-TW/amazon-bedrock#use-the-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](/zh-TW/tools-reference#powershell-tool) | | `CLAUDE_CODE_USE_VERTEX` | 使用 [Vertex](/zh-TW/google-vertex-ai) | | `CLAUDE_CONFIG_DIR` | 覆蓋配置目錄（預設值：`~/.claude`）。所有設定、認證、工作階段歷史記錄和外掛程式都儲存在此路徑下。對於並排執行多個帳戶很有用：例如，`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` | | `CLAUDE_EFFORT` | 在 Bash 工具子程序和 hook 命令中自動設定為該回合的作用中 [effort level](/zh-TW/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。Ultracode 不是一個不同的級別，報告為 `xhigh`。符合傳遞給 [hooks](/zh-TW/hooks) 的 `effort.level` 欄位。僅在目前模型支援努力參數時設定 | | `CLAUDE_ENABLE_BYTE_WATCHDOG` | 設定為 `1` 以強制啟用位元級串流閒置監視程式，或設定為 `0` 以強制停用它。未設定時，監視程式預設對 Anthropic API 和 [Claude Platform on AWS](/zh-TW/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` 以強制停用它。未設定時，預設值由伺服器在直接 Anthropic API 上控制，在其他提供者上關閉。{/* min-version: 2.1.169 */}自 v2.1.169 起，直接 Anthropic API 和 Claude Platform on AWS 以外的提供者也有預設開啟的 5 分鐘主體閒置逾時，獨立於此變數；請參閱 `API_FORCE_IDLE_TIMEOUT`。在 Bedrock 上，您也可以使用 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` 啟用獨立的位元級監視程式；當兩者都設定時，它們一起執行。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置逾時 | | `CLAUDE_ENV_FILE` | Claude Code 在每個 Bash 命令之前在同一 shell 程序中執行的 shell 指令碼的路徑，因此檔案中的匯出對命令可見。用於在命令之間保持 virtualenv 或 conda 啟用。也由 [SessionStart](/zh-TW/hooks#persist-environment-variables)、[Setup](/zh-TW/hooks#setup)、[CwdChanged](/zh-TW/hooks#cwdchanged) 和 [FileChanged](/zh-TW/hooks#filechanged) hooks 動態填充 | | `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 當未提供明確名稱時，自動產生的 [Remote Control](/zh-TW/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 分鐘限制。對於第三方提供者上的事件級監視程式，需要 `CLAUDE_ENABLE_STREAM_WATCHDOG=1`；`API_FORCE_IDLE_TIMEOUT` 下描述的主體閒置逾時獨立適用。在 Bedrock 上，也適用於 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` | | `DEBUG` | 設定為 `1` 以啟用偵錯模式，相當於使用 [`--debug`](/zh-TW/cli-reference#cli-flags) 啟動。偵錯日誌會寫入 `~/.claude/debug/.txt`，或寫入 `CLAUDE_CODE_DEBUG_LOGS_DIR` 設定的路徑。僅真值 `1`、`true`、`yes` 和 `on` 啟用偵錯模式，因此為其他工具設定的命名空間模式（如 `DEBUG=express:*`）不會觸發它 | | `DISABLE_AUTOUPDATER` | 設定為 `1` 以停用自動背景更新。手動 `claude update` 仍然有效。使用 `DISABLE_UPDATES` 以阻止兩者 | | `DISABLE_AUTO_COMPACT` | 設定為 `1` 以停用接近上下文限制時的自動壓縮。手動 `/compact` 命令仍然可用。在您想要明確控制何時進行壓縮時使用 | | `DISABLE_COMPACT` | 設定為 `1` 以停用所有壓縮：自動壓縮和手動 `/compact` 命令 | | `DISABLE_COST_WARNINGS` | 設定為 `1` 以停用成本警告訊息 | | `DISABLE_DOCTOR_COMMAND` | 設定為 `1` 以隱藏 `/doctor` 命令。對於使用者不應執行安裝診斷的受管部署很有用 | | `DISABLE_ERROR_REPORTING` | 設定為 `1` 以選擇退出 Sentry 錯誤報告 | | `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` 命令。使用第三方提供者（Bedrock、Vertex 或 Foundry）時已隱藏 | | `DISABLE_INTERLEAVED_THINKING` | 設定為 `1` 以防止發送交錯思考 beta 標頭。當您的 LLM 閘道或提供者不支援 [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) 時很有用 | | `DISABLE_LOGIN_COMMAND` | 設定為 `1` 以隱藏 `/login` 命令。當驗證透過 API 金鑰或 `apiKeyHelper` 外部處理時很有用 | | `DISABLE_LOGOUT_COMMAND` | 設定為 `1` 以隱藏 `/logout` 命令 | | `DISABLE_PROMPT_CACHING` | 設定為 `1` 以停用所有模型的提示快取（優先於每個模型的設定） | | `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](/zh-TW/mcp#use-mcp-servers-from-claude-ai)。對於已登入的使用者預設啟用。若要按專案或按組織停用，請改為在設定中設定 [`disableClaudeAiConnectors`](/zh-TW/settings#available-settings) | | `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 以要求 1 小時的提示快取 TTL，而不是預設的 5 分鐘。適用於 API 金鑰、[Bedrock](/zh-TW/amazon-bedrock)、[Vertex](/zh-TW/google-vertex-ai)、[Foundry](/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 使用者。訂閱使用者自動接收 1 小時 TTL。1 小時快取寫入以更高的速率計費 | | `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 已棄用。改用 `ENABLE_PROMPT_CACHING_1H` | | `ENABLE_TOOL_SEARCH` | 控制 [MCP tool search](/zh-TW/mcp#scale-with-mcp-tool-search)。未設定：預設所有 MCP 工具延遲，但在 Vertex AI 上或當 `ANTHROPIC_BASE_URL` 指向非第一方主機時提前載入。值：`true`（始終延遲並發送 beta 標頭，在 Vertex AI 或不支援 `tool_reference` 的代理上請求失敗）、`auto`（閾值模式：如果工具符合上下文的 10% 內則提前載入）、`auto:N`（自訂閾值，例如 `auto:5` 表示 5%）、`false`（提前載入全部） | | `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 設定為任何非空值以在任何主要模型上重複過載錯誤後觸發回退。{/* min-version: 2.1.160 */}自 v2.1.160 起，配置的 [fallback model chain](/zh-TW/model-config#fallback-model-chains) 會在任何主要模型的重複過載錯誤時觸發，因此此變數不影響切換到回退模型 | | `FORCE_AUTOUPDATE_PLUGINS` | 設定為 `1` 以強制外掛程式自動更新，即使主自動更新器通過 `DISABLE_AUTOUPDATER` 停用 | | `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`](/zh-TW/mcp#raise-the-limit-for-a-specific-tool) 的工具對文字內容使用該字元限制，但來自這些工具的影像內容仍受此變數限制（預設值：25000） | | `MAX_STRUCTURED_OUTPUT_RETRIES` | 當模型的回應無法驗證非互動式模式（`-p` 旗標）中的 [`--json-schema`](/zh-TW/cli-reference#cli-flags) 時重試的次數。預設為 5 | | `MAX_THINKING_TOKENS` | 覆蓋 [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) token 預算。上限是模型的 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 減一。設定為 `0` 以在 Anthropic API 上停用思考，除了 Fable 5，它無法關閉思考。在 [third-party providers](/zh-TW/third-party-integrations) 上，`0` 同樣省略該參數，具有 [adaptive reasoning](/zh-TW/model-config#adjust-effort-level) 的模型仍可能思考。對於自適應推理模型上的非零值，預算會被忽略，除非透過 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 停用自適應推理 | | `MCP_CLIENT_SECRET` | 需要 [pre-configured credentials](/zh-TW/mcp#use-pre-configured-oauth-credentials) 的 MCP 伺服器的 OAuth 用戶端密碼。在使用 `--client-secret` 新增伺服器時避免互動式提示 | | `MCP_CONNECTION_NONBLOCKING` | 控制啟動是否在第一個查詢之前等待 MCP 伺服器連線。{/* min-version: 2.1.142 */}自 Claude Code v2.1.142 起，MCP 啟動預設為非阻止：伺服器在背景中連線，其工具在完成時變為可用。設定為 `0` 以還原阻止 5 秒連線等待。配置 [`alwaysLoad: true`](/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器仍會阻止啟動，無論如何，因為其工具必須在建立第一個提示時存在 | | `MCP_CONNECT_TIMEOUT_MS` | 阻止 MCP 啟動等待連線批次的時間（以毫秒為單位），然後拍攝工具清單快照（預設值：5000）。適用於 `MCP_CONNECTION_NONBLOCKING=0` 或標記為 [`alwaysLoad: true`](/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器。在截止時間時仍待處理的伺服器會在背景中繼續連線，但在下一個查詢之前不會出現。與 `MCP_TIMEOUT` 不同，後者限制個別伺服器的連線嘗試 | | `MCP_OAUTH_CALLBACK_PORT` | OAuth 重新導向回呼的固定連接埠，作為在使用 [pre-configured credentials](/zh-TW/mcp#use-pre-configured-oauth-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 小時）。`.mcp.json` 中的每個伺服器 `timeout` 欄位會覆蓋該伺服器的此值。對於環境變數，低於 1000 的值會下限為 1 秒；對於每個伺服器欄位，低於 1000 的值會被忽略 | | `NO_PROXY` | 要直接發出請求的網域和 IP 清單，繞過代理 | | `OTEL_LOG_RAW_API_BODIES` | 設定為 `1` 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 `api_request_body` / `api_response_body` 日誌事件發出（在 60 KB 處截斷），或 `file:` 以將未截斷的主體寫入磁碟並發出 `body_ref` 路徑。預設停用；主體包括整個對話歷史記錄。請參閱 [Monitoring](/zh-TW/monitoring-usage#api-request-body-event) | | `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串、`api_refusal` 事件上的拒絕 `category` 和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用（提示被編輯）。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 設定為 `false` 以從指標屬性中排除帳戶 UUID（預設值：包含）。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}設定為 `true` 以在指標屬性中包含工作階段進入點（預設值：排除）。在 v2.1.152 中新增。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}自 v2.1.161 起，Claude Code 將 `OTEL_RESOURCE_ATTRIBUTES` 金鑰附加到指標資料點標籤。設定為 `false` 以排除它們（預設值：包含）。請參閱 [Monitoring](/zh-TW/monitoring-usage#multi-team-organization-support) | | `OTEL_METRICS_INCLUDE_SESSION_ID` | 設定為 `false` 以從指標屬性中排除工作階段 ID（預設值：包含）。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `OTEL_METRICS_INCLUDE_VERSION` | 設定為 `true` 以在指標屬性中包含 Claude Code 版本（預設值：排除）。請參閱 [Monitoring](/zh-TW/monitoring-usage) | | `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆蓋顯示給 [Skill tool](/zh-TW/skills#control-who-invokes-a-skill) 的 skill 中繼資料的字元預算。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 個字元。為了向後相容性保留舊名稱 | | `TASK_MAX_OUTPUT_LENGTH` | [subagent](/zh-TW/sub-agents) 輸出在截斷前的最大字元數（預設值：32000，最大值：160000）。截斷時，完整輸出會儲存到磁碟，路徑會包含在截斷的回應中 | | `USE_BUILTIN_RIPGREP` | 設定為 `0` 以使用系統安裝的 `rg` 而不是 Claude Code 隨附的 `rg` | | `VERTEX_REGION_CLAUDE_3_5_HAIKU` | 使用 Vertex AI 時覆蓋 Claude 3.5 Haiku 的區域 | | `VERTEX_REGION_CLAUDE_3_5_SONNET` | 使用 Vertex AI 時覆蓋 Claude 3.5 Sonnet 的區域 | | `VERTEX_REGION_CLAUDE_3_7_SONNET` | 使用 Vertex AI 時覆蓋 Claude 3.7 Sonnet 的區域 | | `VERTEX_REGION_CLAUDE_4_0_OPUS` | 使用 Vertex AI 時覆蓋 Claude 4.0 Opus 的區域 | | `VERTEX_REGION_CLAUDE_4_0_SONNET` | 使用 Vertex AI 時覆蓋 Claude 4.0 Sonnet 的區域 | | `VERTEX_REGION_CLAUDE_4_1_OPUS` | 使用 Vertex AI 時覆蓋 Claude 4.1 Opus 的區域 | | `VERTEX_REGION_CLAUDE_4_5_OPUS` | 使用 Vertex AI 時覆蓋 Claude Opus 4.5 的區域 | | `VERTEX_REGION_CLAUDE_4_5_SONNET` | 使用 Vertex AI 時覆蓋 Claude Sonnet 4.5 的區域 | | `VERTEX_REGION_CLAUDE_4_6_OPUS` | 使用 Vertex AI 時覆蓋 Claude Opus 4.6 的區域 | | `VERTEX_REGION_CLAUDE_4_6_SONNET` | 使用 Vertex AI 時覆蓋 Claude Sonnet 4.6 的區域 | | `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}使用 Vertex AI 時覆蓋 Claude Opus 4.7 的區域。在 v2.1.111 中新增 | | `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}使用 Vertex AI 時覆蓋 Claude Opus 4.8 的區域。在 v2.1.154 中新增 | | `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}使用 Vertex AI 時覆蓋 Claude Fable 5 的區域。在 v2.1.170 中新增 | | `VERTEX_REGION_CLAUDE_HAIKU_4_5` | 使用 Vertex AI 時覆蓋 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](/zh-TW/monitoring-usage) 以取得配置詳細資訊。

另請參閱

* [Settings](/zh-TW/settings)：所有 `settings.json` 配置，包括 `env` 鍵 * [CLI reference](/zh-TW/cli-reference)：啟動時旗標 * [Network configuration](/zh-TW/network-config)：代理和 TLS 設定 * [Monitoring](/zh-TW/monitoring-usage)：OpenTelemetry 配置