ANTHROPIC_API_KEY | API 金鑰作為 X-Api-Key 標頭發送。設定時，即使您已登入，此金鑰也會用於代替您的 Claude Pro、Max、Team 或 Enterprise 訂閱。在非互動式模式（-p）中，金鑰存在時始終使用。在互動式模式中，系統會提示您在金鑰覆蓋您的訂閱之前批准一次。若要改用您的訂閱，請執行 unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN | Authorization 標頭的自訂值（您在此設定的值將以 Bearer 為前綴） |
ANTHROPIC_BASE_URL | 覆蓋 API 端點以透過代理或閘道路由請求。設定為非第一方主機時，MCP tool search 預設停用。如果您的代理轉發 tool_reference 區塊，請設定 ENABLE_TOOL_SEARCH=true |
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_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_BASE_URL | Foundry 資源的完整基礎 URL（例如，https://my-resource.services.ai.azure.com/anthropic）。ANTHROPIC_FOUNDRY_RESOURCE 的替代方案（請參閱 Microsoft Foundry） |
ANTHROPIC_FOUNDRY_RESOURCE | Foundry 資源名稱（例如，my-resource）。如果未設定 ANTHROPIC_FOUNDRY_BASE_URL，則為必需（請參閱 Microsoft Foundry） |
ANTHROPIC_MODEL | 要使用的模型設定名稱（請參閱 Model Configuration） |
ANTHROPIC_SMALL_FAST_MODEL | [已棄用] Haiku 級別模型用於背景任務的名稱 |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION | 使用 Bedrock 時覆蓋 Haiku 級別模型的 AWS 區域 |
AWS_BEARER_TOKEN_BEDROCK | Bedrock API 金鑰用於驗證（請參閱 Bedrock API keys） |
BASH_DEFAULT_TIMEOUT_MS | 長時間執行的 bash 命令的預設逾時 |
BASH_MAX_OUTPUT_LENGTH | bash 輸出中的最大字元數，超過此數量後將進行中間截斷 |
BASH_MAX_TIMEOUT_MS | 模型可以為長時間執行的 bash 命令設定的最大逾時 |
CLAUDECODE | 在 Claude Code 生成的 shell 環境中設定為 1（Bash 工具、tmux 工作階段）。未在 hooks 或 status line 命令中設定。用於偵測指令碼何時在 Claude Code 生成的 shell 內執行 |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | 設定自動壓縮觸發的上下文容量百分比 (1-100)。預設情況下，自動壓縮在約 95% 容量時觸發。使用較低的值（如 50）以更早進行壓縮。高於預設閾值的值無效。適用於主要對話和 subagents。此百分比與 status line 中可用的 context_window.used_percentage 欄位一致 |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | 在每個 Bash 命令後返回原始工作目錄 |
CLAUDE_CODE_ACCOUNT_UUID | 已驗證使用者的帳戶 UUID。由 SDK 呼叫者使用以同步提供帳戶資訊，避免早期遙測事件缺少帳戶中繼資料的競爭條件。需要同時設定 CLAUDE_CODE_USER_EMAIL 和 CLAUDE_CODE_ORGANIZATION_UUID |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD | 設定為 1 以從使用 --add-dir 指定的目錄載入 CLAUDE.md 檔案。預設情況下，其他目錄不載入記憶體檔案 |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | 設定用於自動壓縮計算的上下文容量（以 token 為單位）。預設為模型的上下文視窗：標準模型為 200K 或 extended context 模型為 1M。在 1M 模型上使用較低的值（如 500000）以將視窗視為 500K 用於壓縮目的。該值上限為模型的實際上下文視窗。CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 作為此值的百分比應用。設定此變數會將壓縮閾值與狀態行的 used_percentage 解耦，後者始終使用模型的完整上下文視窗 |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | 應刷新認證的間隔（以毫秒為單位）（使用 apiKeyHelper 時） |
CLAUDE_CODE_CLIENT_CERT | 用於 mTLS 驗證的用戶端憑證檔案的路徑 |
CLAUDE_CODE_CLIENT_KEY | 用於 mTLS 驗證的用戶端私密金鑰檔案的路徑 |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE | 加密 CLAUDE_CODE_CLIENT_KEY 的密碼（可選） |
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 控制的固定思考預算 |
CLAUDE_CODE_DISABLE_AUTO_MEMORY | 設定為 1 以停用 auto memory。設定為 0 以在逐步推出期間強制啟用自動記憶體。停用時，Claude 不會建立或載入自動記憶體檔案 |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS | 設定為 1 以從 Claude 的系統提示中移除內建的提交和 PR 工作流程指令以及 git 狀態快照。在使用您自己的 git 工作流程 skills 時很有用。設定時優先於 includeGitInstructions 設定 |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS | 設定為 1 以停用所有背景任務功能，包括 Bash 和 subagent 工具上的 run_in_background 參數、自動背景執行和 Ctrl+B 快捷鍵 |
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 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 時也會停用調查。請參閱 Session quality surveys |
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_TERMINAL_TITLE | 設定為 1 以停用基於對話上下文的自動終端標題更新 |
CLAUDE_CODE_EFFORT_LEVEL | 為支援的模型設定努力級別。值：low、medium、high、max（僅限 Opus 4.6）或 auto 以使用模型預設值。優先於 /effort 和 effortLevel 設定。請參閱調整努力級別 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION | 設定為 false 以停用提示建議（/config 中的「提示建議」切換）。這些是在 Claude 回應後出現在您的提示輸入中的灰顯預測。請參閱 Prompt suggestions |
CLAUDE_CODE_ENABLE_TASKS | 設定為 true 以在非互動式模式（-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_FILE_READ_MAX_OUTPUT_TOKENS | 覆蓋檔案讀取的預設 token 限制。當您需要完整讀取較大的檔案時很有用 |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | 跳過 IDE 擴充功能的自動安裝。相當於將 autoInstallIdeExtension 設定為 false |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異；請參閱 max output tokens。增加此值會減少在 auto-compaction 觸發之前可用的有效上下文視窗。 |
CLAUDE_CODE_NEW_INIT | 設定為 true 以使 /init 執行互動式設定流程。流程會詢問要產生哪些檔案，包括 CLAUDE.md、skills 和 hooks，然後再探索程式碼庫並寫入它們。沒有此變數，/init 會自動產生 CLAUDE.md 而不提示。 |
CLAUDE_CODE_NO_FLICKER | 設定為 1 以啟用 fullscreen rendering，一項研究預覽，可減少閃爍並在長對話中保持記憶體平坦 |
CLAUDE_CODE_ORGANIZATION_UUID | 已驗證使用者的組織 UUID。由 SDK 呼叫者使用以同步提供帳戶資訊。需要同時設定 CLAUDE_CODE_ACCOUNT_UUID 和 CLAUDE_CODE_USER_EMAIL |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS | 刷新動態 OpenTelemetry 標頭的間隔（以毫秒為單位）（預設值：1740000 / 29 分鐘）。請參閱 Dynamic headers |
CLAUDE_CODE_PLAN_MODE_REQUIRED | 在需要計畫批准的 agent team 隊友上自動設定為 true。唯讀：在生成隊友時由 Claude Code 設定。請參閱 require plan approval |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS | 安裝或更新外掛程式時 git 操作的逾時（以毫秒為單位）（預設值：120000）。對於大型儲存庫或網路連線緩慢，請增加此值。請參閱 Git operations time out |
CLAUDE_CODE_PLUGIN_SEED_DIR | 一個或多個唯讀外掛程式種子目錄的路徑，在 Unix 上以 : 分隔，在 Windows 上以 ; 分隔。使用此選項可將預先填充的外掛程式目錄捆綁到容器映像中。Claude Code 在啟動時從這些目錄註冊市場，並使用預先快取的外掛程式而無需重新複製。請參閱 Pre-populate plugins for containers |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS | 設定為 true 以允許代理執行 DNS 解析而不是呼叫者。對於代理應處理主機名稱解析的環境選擇加入 |
CLAUDE_CODE_SCROLL_SPEED | 在 fullscreen rendering 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值。設定為 3 以符合 vim（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件） |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS | SessionEnd hooks 完成的最大時間（以毫秒為單位）（預設值：1500）。適用於工作階段退出、/clear 和透過互動式 /resume 切換工作階段。每個 hook 的 timeout 值也受此預算上限 |
CLAUDE_CODE_SHELL | 覆蓋自動 shell 偵測。當您的登入 shell 與您偏好的工作 shell 不同時很有用（例如，bash 與 zsh） |
CLAUDE_CODE_SHELL_PREFIX | 命令前綴以包裝所有 bash 命令（例如，用於日誌記錄或稽核）。範例：/path/to/logger.sh 將執行 /path/to/logger.sh <command> |
CLAUDE_CODE_SIMPLE | 設定為 1 以使用最小系統提示和僅 Bash、檔案讀取和檔案編輯工具執行。停用 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索。--bare CLI 旗標設定此項 |
CLAUDE_CODE_SKIP_BEDROCK_AUTH | 跳過 Bedrock 的 AWS 驗證（例如，使用 LLM 閘道時） |
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS | 設定為 1，當組織狀態檢查因網路錯誤失敗時允許 fast mode。當企業代理封鎖狀態端點時很有用。API 仍然單獨強制執行組織層級的停用 |
CLAUDE_CODE_SKIP_FOUNDRY_AUTH | 跳過 Microsoft Foundry 的 Azure 驗證（例如，使用 LLM 閘道時） |
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 擴展來竊取機密的提示注入攻擊的暴露。配置 allowed_non_write_users 時，claude-code-action 會自動設定此項 |
CLAUDE_CODE_TASK_LIST_ID | 跨工作階段共享任務清單。在多個 Claude Code 實例中設定相同的 ID 以協調共享任務清單。請參閱 Task list |
CLAUDE_CODE_TEAM_NAME | 此隊友所屬的 agent team 名稱。在 agent team 成員上自動設定 |
CLAUDE_CODE_TMPDIR | 覆蓋用於內部臨時檔案的臨時目錄。Claude Code 將 /claude/ 附加到此路徑。預設值：Unix/macOS 上的 /tmp，Windows 上的 os.tmpdir() |
CLAUDE_CODE_USER_EMAIL | 已驗證使用者的電子郵件地址。由 SDK 呼叫者使用以同步提供帳戶資訊。需要同時設定 CLAUDE_CODE_ACCOUNT_UUID 和 CLAUDE_CODE_ORGANIZATION_UUID |
CLAUDE_CODE_USE_BEDROCK | 使用 Bedrock |
CLAUDE_CODE_USE_FOUNDRY | 使用 Microsoft Foundry |
CLAUDE_CODE_USE_POWERSHELL_TOOL | 設定為 1 以在 Windows 上啟用 PowerShell 工具（選擇加入預覽）。啟用時，Claude 可以原生執行 PowerShell 命令，而不是透過 Git Bash 路由。僅在原生 Windows 上支援，不支援 WSL。請參閱 PowerShell tool |
CLAUDE_CODE_USE_VERTEX | 使用 Vertex |
CLAUDE_CONFIG_DIR | 自訂 Claude Code 儲存其配置和資料檔案的位置 |
CLAUDE_ENV_FILE | Claude Code 在每個 Bash 命令之前來源的 shell 指令碼的路徑。用於在命令之間保持 virtualenv 或 conda 啟用。也由 SessionStart、CwdChanged 和 FileChanged hooks 動態填充 |
CLAUDE_STREAM_IDLE_TIMEOUT_MS | 串流閒置監視程式在關閉停滯連線之前的逾時（以毫秒為單位）。預設值：90000（90 秒）。如果長時間執行的工具或緩慢的網路導致過早逾時錯誤，請增加此值 |
DISABLE_AUTOUPDATER | 設定為 1 以停用自動更新。 |
DISABLE_COST_WARNINGS | 設定為 1 以停用成本警告訊息 |
DISABLE_ERROR_REPORTING | 設定為 1 以選擇退出 Sentry 錯誤報告 |
DISABLE_FEEDBACK_COMMAND | 設定為 1 以停用 /feedback 命令。也接受較舊的名稱 DISABLE_BUG_COMMAND |
DISABLE_INSTALLATION_CHECKS | 設定為 1 以停用安裝警告。僅在手動管理安裝位置時使用，因為這可能會掩蓋標準安裝的問題 |
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 以選擇退出 Statsig 遙測（請注意，Statsig 事件不包括使用者資料，如程式碼、檔案路徑或 bash 命令） |
ENABLE_CLAUDEAI_MCP_SERVERS | 設定為 false 以停用 Claude Code 中的 claude.ai MCP servers。對於已登入的使用者預設啟用 |
ENABLE_TOOL_SEARCH | 控制 MCP tool search。未設定：預設啟用所有 MCP 工具，但當 ANTHROPIC_BASE_URL 指向非第一方主機時停用。值：true（始終延遲，包括代理）、auto（閾值模式：如果工具符合上下文的 10% 內則提前載入）、auto:N（自訂閾值，例如 auto:5 表示 5%）、false（提前載入全部） |
FORCE_AUTOUPDATE_PLUGINS | 設定為 true 以強制外掛程式自動更新，即使主自動更新器通過 DISABLE_AUTOUPDATER 停用 |
HTTP_PROXY | 為網路連線指定 HTTP 代理伺服器 |
HTTPS_PROXY | 為網路連線指定 HTTPS 代理伺服器 |
IS_DEMO | 設定為 true 以啟用演示模式：隱藏 UI 中的電子郵件和組織、跳過上線和隱藏內部命令。對於串流或錄製工作階段很有用 |
MAX_MCP_OUTPUT_TOKENS | MCP 工具回應中允許的最大 token 數。當輸出超過 10,000 token 時，Claude Code 會顯示警告（預設值：25000） |
MAX_THINKING_TOKENS | 覆蓋 extended thinking token 預算。上限是模型的 max output tokens 減一。設定為 0 以完全停用思考。在具有自適應推理的模型（Opus 4.6、Sonnet 4.6）上，除非透過 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 停用自適應推理，否則預算會被忽略 |
MCP_CLIENT_SECRET | 需要 pre-configured credentials 的 MCP 伺服器的 OAuth 用戶端密碼。在使用 --client-secret 新增伺服器時避免互動式提示 |
MCP_OAUTH_CALLBACK_PORT | OAuth 重新導向回呼的固定連接埠，作為在使用 pre-configured credentials 新增 MCP 伺服器時 --callback-port 的替代方案 |
MCP_TIMEOUT | MCP 伺服器啟動的逾時（以毫秒為單位） |
MCP_TOOL_TIMEOUT | MCP 工具執行的逾時（以毫秒為單位） |
NO_PROXY | 要直接發出請求的網域和 IP 清單，繞過代理 |
SLASH_COMMAND_TOOL_CHAR_BUDGET | 覆蓋顯示給 Skill tool 的 skill 中繼資料的字元預算。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 個字元。為了向後相容性保留舊名稱 |
USE_BUILTIN_RIPGREP | 設定為 0 以使用系統安裝的 rg 而不是 Claude Code 隨附的 rg |
VERTEX_REGION_CLAUDE_3_5_HAIKU | 使用 Vertex AI 時覆蓋 Claude 3.5 Haiku 的區域 |
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 的區域 |
