跳轉到主要內容

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 之前在您的 shell 中設定它們，或在 settings.json 中的 env 鍵下配置它們，以將其應用於每個工作階段或在您的團隊中推出。
變數用途
ANTHROPIC_API_KEYAPI 金鑰作為 X-Api-Key 標頭發送。設定時，即使您已登入，此金鑰也會用於代替您的 Claude Pro、Max、Team 或 Enterprise 訂閱。在非互動式模式（-p）中，金鑰存在時始終使用。在互動式模式中，系統會提示您在金鑰覆蓋您的訂閱之前批准一次。若要改用您的訂閱，請執行 unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKENAuthorization 標頭的自訂值（您在此設定的值將以 Bearer 為前綴）
ANTHROPIC_AWS_API_KEYClaude 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_IDClaude Platform on AWS 所需。在每個請求上作為 anthropic-workspace-id 標頭發送
ANTHROPIC_BASE_URL覆蓋 API 端點以透過代理或閘道路由請求。設定為非第一方主機時，MCP tool search 預設停用。如果您的代理轉發 tool_reference 區塊，請設定 ENABLE_TOOL_SEARCH=true
ANTHROPIC_BEDROCK_BASE_URL覆蓋 Bedrock 端點 URL。用於自訂 Bedrock 端點或透過 LLM gateway 路由。請參閱 Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL覆蓋 Bedrock Mantle 端點 URL。請參閱 Mantle endpoint
ANTHROPIC_BEDROCK_SERVICE_TIERBedrock 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_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_KEYMicrosoft Foundry 驗證的 API 金鑰（請參閱 Microsoft Foundry）
ANTHROPIC_FOUNDRY_BASE_URLFoundry 資源的完整基礎 URL（例如，https://my-resource.services.ai.azure.com/anthropic）。ANTHROPIC_FOUNDRY_RESOURCE 的替代方案（請參閱 Microsoft Foundry）
ANTHROPIC_FOUNDRY_RESOURCEFoundry 資源名稱（例如，my-resource）。如果未設定 ANTHROPIC_FOUNDRY_BASE_URL，則為必需（請參閱 Microsoft Foundry）
ANTHROPIC_MODEL要使用的模型設定名稱（請參閱 Model Configuration）
ANTHROPIC_SMALL_FAST_MODEL[已棄用] Haiku 級別模型用於背景任務的名稱
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 路由。請參閱 Google Vertex AI
ANTHROPIC_VERTEX_PROJECT_IDVertex AI 的 GCP 專案 ID。被 GCLOUD_PROJECT、GOOGLE_CLOUD_PROJECT 或您的 GOOGLE_APPLICATION_CREDENTIALS 認證檔案中的專案覆蓋。請參閱 Google Vertex AI
ANTHROPIC_WORKSPACE_IDworkload identity federation 的工作區 ID。當您的聯盟規則的範圍涵蓋多個工作區時設定此項，以便權杖交換知道要針對哪個工作區
API_TIMEOUT_MSAPI 請求的逾時（以毫秒為單位）（預設值：600000，或 10 分鐘；最大值：2147483647）。在緩慢網路上請求逾時或透過代理路由時增加此值。超過最大值的值會導致基礎計時器溢位，並導致請求立即失敗
AWS_BEARER_TOKEN_BEDROCKBedrock API 金鑰用於驗證（請參閱 Bedrock API keys）
BASH_DEFAULT_TIMEOUT_MS長時間執行的 bash 命令的預設逾時（預設值：120000，或 2 分鐘）
BASH_MAX_OUTPUT_LENGTHbash 輸出中的最大字元數，超過此數量後完整輸出會儲存到檔案，Claude 會收到路徑加上簡短預覽。請參閱 Bash tool behavior
BASH_MAX_TIMEOUT_MS模型可以為長時間執行的 bash 命令設定的最大逾時（預設值：600000，或 10 分鐘）
CCR_FORCE_BUNDLE設定為 1 以強制 claude --remote 在 GitHub 存取可用時也要捆綁並上傳您的本機儲存庫
CLAUDECODE在 Claude Code 生成的 shell 環境中設定為 1（Bash 工具、tmux 工作階段）。未在 hooks 或 status line 命令中設定。用於偵測指令碼何時在 Claude Code 生成的 shell 內執行
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)。預設情況下，自動壓縮在約 95% 容量時觸發。使用較低的值（如 50）以更早進行壓縮。高於預設閾值的值無效。適用於主要對話和 subagents。此百分比與 status line 中可用的 context_window.used_percentage 欄位一致
CLAUDE_AUTO_BACKGROUND_TASKS設定為 1 以強制啟用長時間執行的代理任務的自動背景執行。啟用時，subagents 在執行約兩分鐘後會移至背景
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR在主工作階段中每個 Bash 或 PowerShell 命令後返回原始工作目錄
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_API_KEY_HELPER_TTL_MS應刷新認證的間隔（以毫秒為單位）（使用 apiKeyHelper 時）
CLAUDE_CODE_ATTRIBUTION_HEADER設定為 0 以省略系統提示開始處的歸屬區塊（用戶端版本和提示指紋）。停用它會改善透過 LLM gateway 路由時的提示快取命中率。Anthropic API 快取不受影響
CLAUDE_CODE_AUTO_COMPACT_WINDOW設定用於自動壓縮計算的上下文容量（以 token 為單位）。預設為模型的上下文視窗：標準模型為 200K 或 extended context 模型為 1M。在 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_CERT_STORETLS 連線的 CA 憑證來源逗號分隔清單。bundled 是隨 Claude Code 提供的 Mozilla CA 集。system 是作業系統信任存放區。預設為 bundled,system
CLAUDE_CODE_CLIENT_CERT用於 mTLS 驗證的用戶端憑證檔案的路徑
CLAUDE_CODE_CLIENT_KEY用於 mTLS 驗證的用戶端私密金鑰檔案的路徑
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE加密 CLAUDE_CODE_CLIENT_KEY 的密碼（可選）
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 模型變體在模型選擇器中不可用。對於具有合規性要求的企業環境很有用
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING設定為 1 以停用 Opus 4.6 和 Sonnet 4.6 的 adaptive reasoning，並回退到由 MAX_THINKING_TOKENS 控制的固定思考預算。對 Opus 4.7 無效，其始終使用自適應推理
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 切換
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_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）會保留。
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 版本。在您想要刻意固定較舊模型時使用。重新對應不在 Bedrock、Vertex 或 Foundry 上執行
CLAUDE_CODE_DISABLE_MOUSE設定為 1 以停用 fullscreen rendering 中的滑鼠追蹤。使用 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 以停用基於對話上下文的自動終端標題更新
CLAUDE_CODE_DISABLE_THINKING設定為 1 以強制停用 extended thinking，無論模型支援或其他設定如何。比 MAX_THINKING_TOKENS=0 更直接
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL設定為 1 以停用 fullscreen rendering 中的虛擬捲動，並呈現文字記錄中的每條訊息。如果全螢幕模式中的捲動顯示應該出現訊息的空白區域，請使用此選項
CLAUDE_CODE_EFFORT_LEVEL為支援的模型設定努力級別。值：low、medium、high、xhigh、max 或 auto 以使用模型預設值。可用級別取決於模型。優先於 /effort 和 effortLevel 設定。請參閱 Adjust effort level
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 上預設啟用。在 Bedrock 和 Vertex 上，按模型啟用，其中已部署的容器支援它。設定為 0 以選擇退出。設定為 1 以在透過 ANTHROPIC_BASE_URL、ANTHROPIC_VERTEX_BASE_URL 或 ANTHROPIC_BEDROCK_BASE_URL 路由時強制啟用。在 Foundry 和 gateway 連線上預設關閉
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY設定為 1 以在 ANTHROPIC_BASE_URL 指向 Anthropic 相容閘道（例如 LiteLLM、Kong 或內部代理）時從您的閘道的 /v1/models 端點填充 /model 選擇器。預設關閉，因為由共享 API 金鑰支援的閘道會以其他方式向每個使用者顯示該金鑰可以存取的每個模型。探索的模型仍由 availableModels 允許清單篩選
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE設定為 1 以在 Claude Opus 4.7 上執行 fast mode 而不是 Opus 4.6。設定此變數時，/fast 會切換到 Opus 4.7；沒有它，/fast 會繼續使用 Opus 4.6
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION設定為 false 以停用提示建議（/config 中的「提示建議」切換）。這些是在 Claude 回應後出現在您的提示輸入中的灰顯預測。請參閱 Prompt suggestions
CLAUDE_CODE_ENABLE_TASKS設定為 1 以在非互動式模式（-p 旗標）中啟用任務追蹤系統。任務在互動式模式中預設為開啟。請參閱 Task list
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_BODYJSON 物件以合併到每個 API 請求主體的頂層。對於傳遞 Claude Code 不直接公開的提供者特定參數很有用
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS覆蓋檔案讀取的預設 token 限制。當您需要完整讀取較大的檔案時很有用
CLAUDE_CODE_FORCE_SYNC_OUTPUT設定為 1 以強制啟用 DEC 私有模式 2026 synchronized output（當您的終端支援但未自動偵測時）。對於實現 BSU/ESU 但不回覆功能探測的模擬器（例如 Emacs eat）很有用。在 tmux 下無效
CLAUDE_CODE_FORK_SUBAGENT設定為 1 以啟用 forked subagents。分叉的 subagent 從主工作階段繼承完整的對話上下文，而不是從頭開始。啟用時，/fork 會生成分叉的 subagent，而不是充當 /branch 的別名，所有 subagent 生成都在背景中執行。在互動式模式和透過 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_SECONDSGlob 工具檔案探索的逾時（以秒為單位）。在大多數平台上預設為 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 設定為 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。增加此值會減少在 auto-compaction 觸發之前可用的有效上下文視窗。
CLAUDE_CODE_MAX_RETRIES覆蓋重試失敗 API 請求的次數（預設值：10）
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_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_TOKENClaude.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_TOKENClaude.ai 驗證的 OAuth 存取權杖。/login 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 claude setup-token 產生一個
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE設定為 1 以保持 fast mode 在 Claude Opus 4.6 上。優先於 CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE，因此如果您需要固定 Opus 4.6，無論預設如何變化，請設定此項
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_MSOpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：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_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
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 artifacts back to the session
CLAUDE_CODE_RESUME_INTERRUPTED_TURN設定為 1 以在上一個工作階段在中途結束時自動繼續。在 SDK 模式中使用，以便模型繼續而無需 SDK 重新發送提示
CLAUDE_CODE_RESUME_PROMPT覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 Continue from where you left off.。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值
CLAUDE_CODE_SCRIPT_CAPSJSON 物件，當設定 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 的值。設定為 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 工具子程序中自動設定為目前工作階段 ID。符合傳遞給 hooks 的 session_id 欄位。在 /clear 時更新。用於將指令碼和外部工具與啟動它們的 Claude Code 工作階段相關聯
CLAUDE_CODE_SHELL覆蓋自動 shell 偵測。當您的登入 shell 與您偏好的工作 shell 不同時很有用（例如，bash 與 zsh）
CLAUDE_CODE_SHELL_PREFIX命令前綴以包裝 Claude Code 生成的 shell 命令：Bash 工具呼叫、hook 命令和 stdio MCP server 啟動命令。對於日誌記錄或稽核很有用。範例：設定 /path/to/logger.sh 會將每個命令執行為 /path/to/logger.sh <command>
CLAUDE_CODE_SIMPLE設定為 1 以使用最小系統提示和僅 Bash、檔案讀取和檔案編輯工具執行。來自 --mcp-config 的 MCP 工具仍然可用。停用 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索。--bare CLI 旗標設定此項
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_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_SUBAGENT_MODEL請參閱 Model configuration
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_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_TMPDIR覆蓋用於內部臨時檔案的臨時目錄。Claude Code 將 /claude-{uid}/（Unix）或 /claude/（Windows）附加到此路徑。預設值：macOS 上的 /tmp、Linux/Windows 上的 os.tmpdir()
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使用 Bedrock
CLAUDE_CODE_USE_FOUNDRY使用 Microsoft Foundry
CLAUDE_CODE_USE_MANTLE使用 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使用 Vertex
CLAUDE_CONFIG_DIR覆蓋配置目錄（預設值：~/.claude）。所有設定、認證、工作階段歷史記錄和外掛程式都儲存在此路徑下。對於並排執行多個帳戶很有用：例如，alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
CLAUDE_EFFORT在 Bash 工具子程序和 hook 命令中自動設定為該回合的作用中 effort level：low、medium、high、xhigh 或 max。符合傳遞給 hooks 的 effort.level 欄位。僅在目前模型支援努力參數時設定
CLAUDE_ENABLE_BYTE_WATCHDOG設定為 1 以強制啟用位元級串流閒置監視程式，或設定為 0 以強制停用它。未設定時，監視程式預設對 Anthropic API 連線啟用。位元監視程式會在 CLAUDE_STREAM_IDLE_TIMEOUT_MS 設定的持續時間內沒有位元到達線路時中止連線，最少 5 分鐘，獨立於事件級監視程式
CLAUDE_ENABLE_STREAM_WATCHDOG設定為 1 以啟用事件級串流閒置監視程式。預設關閉。對於 Bedrock、Vertex 和 Foundry，這是唯一可用的閒置監視程式。使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 配置逾時
CLAUDE_ENV_FILEClaude 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 分鐘）用於位元級和事件級監視程式；較低的值會無聲地限制以吸收延伸思考暫停和代理緩衝。對於第三方提供者，需要 CLAUDE_ENABLE_STREAM_WATCHDOG=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 命令。對於使用者不應執行安裝診斷的受管部署很有用
DISABLE_ERROR_REPORTING設定為 1 以選擇退出 Sentry 錯誤報告
DISABLE_EXTRA_USAGE_COMMAND設定為 1 以隱藏 /extra-usage 命令，讓使用者購買超過速率限制的額外使用量
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 時很有用
DISABLE_LOGIN_COMMAND設定為 1 以隱藏 /login 命令。當驗證透過 API 金鑰或 apiKeyHelper 外部處理時很有用
DISABLE_LOGOUT_COMMAND設定為 1 以隱藏 /logout 命令
DISABLE_PROMPT_CACHING設定為 1 以停用所有模型的提示快取（優先於每個模型的設定）
DISABLE_PROMPT_CACHING_HAIKU設定為 1 以停用 Haiku 模型的提示快取
DISABLE_PROMPT_CACHING_OPUS設定為 1 以停用 Opus 模型的提示快取
DISABLE_PROMPT_CACHING_SONNET設定為 1 以停用 Sonnet 模型的提示快取
DISABLE_TELEMETRY設定為 1 以選擇退出遙測。遙測事件不包括使用者資料，如程式碼、檔案路徑或 bash 命令。也停用功能旗標，因此仍在推出的某些功能可能無法使用
DISABLE_UPDATES設定為 1 以阻止所有更新，包括手動 claude update 和 claude install。比 DISABLE_AUTOUPDATER 更嚴格。在透過您自己的管道分發 Claude Code 且使用者不應自行更新時使用
DISABLE_UPGRADE_COMMAND設定為 1 以隱藏 /upgrade 命令
DO_NOT_TRACK設定為 1 以選擇退出遙測。相當於設定 DISABLE_TELEMETRY。尊重 standard cross-tool convention
ENABLE_CLAUDEAI_MCP_SERVERS設定為 false 以停用 Claude Code 中的 claude.ai MCP servers。對於已登入的使用者預設啟用
ENABLE_PROMPT_CACHING_1H設定為 1 以要求 1 小時的提示快取 TTL，而不是預設的 5 分鐘。適用於 API 金鑰、Bedrock、Vertex、Foundry 和 Claude Platform on AWS 使用者。訂閱使用者自動接收 1 小時 TTL。1 小時快取寫入以更高的速率計費
ENABLE_PROMPT_CACHING_1H_BEDROCK已棄用。改用 ENABLE_PROMPT_CACHING_1H
ENABLE_TOOL_SEARCH控制 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設定為任何非空值以在任何主要模型上重複過載錯誤後觸發回退至 --fallback-model。預設情況下，僅 Opus 模型觸發回退
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_TOKENSMCP 工具回應中允許的最大 token 數。當輸出超過 10,000 token 時，Claude Code 會顯示警告。宣告 anthropic/maxResultSizeChars 的工具對文字內容使用該字元限制，但來自這些工具的影像內容仍受此變數限制（預設值：25000）
MAX_STRUCTURED_OUTPUT_RETRIES當模型的回應無法驗證非互動式模式（-p 旗標）中的 --json-schema 時重試的次數。預設為 5
MAX_THINKING_TOKENS覆蓋 extended thinking token 預算。上限是模型的 max output tokens 減一。設定為 0 以完全停用思考。在具有 adaptive reasoning 的模型上，預算會被忽略，除非透過 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 停用自適應推理
MCP_CLIENT_SECRET需要 pre-configured credentials 的 MCP 伺服器的 OAuth 用戶端密碼。在使用 --client-secret 新增伺服器時避免互動式提示
MCP_CONNECTION_NONBLOCKING在非互動式模式（-p）中設定為 true 以完全跳過 MCP 連線等待。對於不需要 MCP 工具的指令碼化管道很有用。沒有此變數，第一個查詢會等待最多 5 秒以進行 --mcp-config 伺服器連線。配置 alwaysLoad: true 的伺服器始終會阻止啟動，無論此變數如何，因為其工具必須在建立第一個提示時存在
MCP_CONNECT_TIMEOUT_MS第一個查詢在拍攝工具清單快照之前等待 MCP 連線批次的時間（以毫秒為單位）（預設值：5000）。在截止時間時仍待處理的伺服器會在背景中繼續連線，但在下一個查詢之前不會出現。與 MCP_TIMEOUT 不同，後者限制個別伺服器的連線嘗試。最相關於發出單一查詢且需要緩慢連線伺服器可見的非互動式工作階段
MCP_OAUTH_CALLBACK_PORTOAuth 重新導向回呼的固定連接埠，作為在使用 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_TIMEOUTMCP 伺服器啟動的逾時（以毫秒為單位）（預設值：30000，或 30 秒）
MCP_TOOL_TIMEOUTMCP 工具執行的逾時（以毫秒為單位）（預設值：100000000，約 28 小時）
NO_PROXY要直接發出請求的網域和 IP 清單，繞過代理
OTEL_LOG_RAW_API_BODIES設定為 1 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 api_request_body / api_response_body 日誌事件發出，或 file:<dir> 以將未截斷的主體寫入磁碟並發出 body_ref 路徑。預設停用；主體包括整個對話歷史記錄。請參閱 Monitoring
OTEL_LOG_TOOL_CONTENT設定為 1 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 Monitoring
OTEL_LOG_TOOL_DETAILS設定為 1 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 Monitoring
OTEL_LOG_USER_PROMPTS設定為 1 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用（提示被編輯）。請參閱 Monitoring
OTEL_METRICS_INCLUDE_ACCOUNT_UUID設定為 false 以從指標屬性中排除帳戶 UUID（預設值：包含）。請參閱 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_LENGTHsubagent 輸出在截斷前的最大字元數（預設值：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使用 Vertex AI 時覆蓋 Claude Opus 4.7 的區域
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 以取得配置詳細資訊。

​
另請參閱