学了个寂寞

Appearance

环境变量参考 ​

Claude Code 通过环境变量控制各种行为。在启动 claude 前在 Shell 中设置，或者在 settings.json 的 env 字段中配置，以便应用到每次会话或在团队中统一下发。

快速设置方法 ​

临时生效（当前会话）：

bash
export ANTHROPIC_API_KEY="your-key"
claude

永久生效（写入 ~/.zshrc 或 ~/.bashrc）：

bash
echo 'export ANTHROPIC_API_KEY="your-key"' >> ~/.zshrc
source ~/.zshrc

通过 settings.json 配置：

json
{
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "BASH_DEFAULT_TIMEOUT_MS": "60000"
  }
}

API 认证 ​

变量说明
ANTHROPIC_API_KEYAPI 密钥，作为 X-Api-Key 请求头发送。设置后优先于 Pro/Max/Team/Enterprise 订阅，即使已登录也会使用此 Key。交互模式下首次使用会提示确认。恢复使用订阅请运行 unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN自定义 Authorization 请求头值（自动添加 Bearer 前缀）
ANTHROPIC_BASE_URL覆盖 API 端点，用于通过代理或网关路由请求。指向非 Anthropic 主机时默认禁用 MCP 工具搜索
ANTHROPIC_CUSTOM_HEADERS添加到请求的自定义请求头（Name: Value 格式，多个请求头用换行分隔）

模型配置 ​

变量说明
ANTHROPIC_MODEL使用的模型名称
ANTHROPIC_DEFAULT_HAIKU_MODEL自定义 Haiku 类模型
ANTHROPIC_DEFAULT_SONNET_MODEL自定义 Sonnet 类模型
ANTHROPIC_DEFAULT_OPUS_MODEL自定义 Opus 类模型
ANTHROPIC_CUSTOM_MODEL_OPTION在 /model 选择器中添加自定义模型条目（不替换内置别名）
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME自定义模型条目的显示名称
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION自定义模型条目的描述（默认为 Custom model (<model-id>)）
CLAUDE_CODE_SUBAGENT_MODEL子代理使用的模型
CLAUDE_CODE_EFFORT_LEVEL模型思考深度：low/medium/high/max（仅 Opus 4.6）/auto。优先于 /effort 和 effortLevel 设置
MAX_THINKING_TOKENS覆盖扩展思考的 Token 预算。设为 0 完全禁用思考

Bash 执行控制 ​

变量说明
BASH_DEFAULT_TIMEOUT_MS长时间运行的 Bash 命令的默认超时时间（毫秒）
BASH_MAX_TIMEOUT_MS模型可以为 Bash 命令设置的最大超时时间（毫秒）
BASH_MAX_OUTPUT_LENGTHBash 输出在被中间截断前的最大字符数
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR每次 Bash 命令后返回原始工作目录
CLAUDE_CODE_SHELL覆盖自动 Shell 检测（如 bash vs zsh）
CLAUDE_CODE_SHELL_PREFIX包装所有 Bash 命令的前缀命令（用于日志记录或审计）。示例：/path/to/logger.sh 会执行 /path/to/logger.sh <命令>
CLAUDE_ENV_FILEClaude Code 在每次 Bash 命令前 source 的 Shell 脚本路径。用于跨命令持久化 virtualenv 或 conda 激活

上下文和记忆 ​

变量说明
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE触发自动压缩的上下文容量百分比（1-100）。默认约 95%，设低值（如 50）更早压缩
CLAUDE_CODE_AUTO_COMPACT_WINDOW用于自动压缩计算的上下文容量 Token 数。标准模型默认 200K，扩展上下文模型默认 1M
CLAUDE_CODE_DISABLE_AUTO_MEMORY设为 1 禁用自动记忆功能
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS覆盖文件读取的默认 Token 限制
CLAUDE_CODE_MAX_OUTPUT_TOKENS设置大多数请求的最大输出 Token 数
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD设为 1 从 --add-dir 指定的目录加载 CLAUDE.md 文件

会话和任务 ​

变量说明
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS设为 1 禁用所有后台任务功能（包括 Ctrl+B 快捷键）
CLAUDE_CODE_DISABLE_CRON设为 1 禁用定时任务（/loop 命令和 cron 工具不可用）
CLAUDE_CODE_ENABLE_TASKS设为 true 在非交互模式（-p）启用任务追踪系统
CLAUDE_CODE_TASK_LIST_ID跨会话共享任务列表的 ID
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY查询循环空闲后自动退出前等待的毫秒数
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION设为 false 禁用提示词建议（灰色预测）
CLAUDE_CODE_NEW_INIT设为 true 让 /init 运行交互式设置流程

检测和调试 ​

变量说明
CLAUDECODEClaude Code 在其衍生的 Shell 环境中设为 1。用于检测脚本是否在 Claude Code 衍生的 Shell 中运行
CLAUDE_CODE_REMOTE云端远程会话中设为 true。可用于区分本地和云端环境
CLAUDE_CODE_DISABLE_TERMINAL_TITLE设为 1 禁用基于对话上下文的终端标题自动更新

企业级提供商 ​

AWS Bedrock ​

变量说明
CLAUDE_CODE_USE_BEDROCK使用 Amazon Bedrock
AWS_BEARER_TOKEN_BEDROCKBedrock API 密钥
CLAUDE_CODE_SKIP_BEDROCK_AUTH跳过 AWS 认证（用于 LLM 网关）
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION使用 Bedrock 时 Haiku 类模型的 AWS 区域

Google Vertex AI ​

变量说明
CLAUDE_CODE_USE_VERTEX使用 Google Vertex AI
CLAUDE_CODE_SKIP_VERTEX_AUTH跳过 Google 认证（用于 LLM 网关）
VERTEX_REGION_CLAUDE_4_0_SONNETSonnet 4.6 在 Vertex AI 上的区域
VERTEX_REGION_CLAUDE_4_0_OPUSOpus 4.6 在 Vertex AI 上的区域
VERTEX_REGION_CLAUDE_3_5_HAIKUHaiku 4.5 在 Vertex AI 上的区域
VERTEX_REGION_CLAUDE_3_7_SONNETSonnet 3.7 在 Vertex AI 上的区域

Microsoft Foundry ​

变量说明
CLAUDE_CODE_USE_FOUNDRY使用 Microsoft Foundry
ANTHROPIC_FOUNDRY_API_KEYFoundry 认证 API 密钥
ANTHROPIC_FOUNDRY_RESOURCEFoundry 资源名称（如 my-resource）
ANTHROPIC_FOUNDRY_BASE_URLFoundry 资源的完整 Base URL
CLAUDE_CODE_SKIP_FOUNDRY_AUTH跳过 Azure 认证（用于 LLM 网关）

网络和代理 ​

变量说明
HTTP_PROXYHTTP 代理服务器
HTTPS_PROXYHTTPS 代理服务器
NO_PROXY绕过代理直接请求的域名和 IP 列表
CLAUDE_CODE_PROXY_RESOLVES_HOSTS设为 true 允许代理执行 DNS 解析
CLAUDE_CODE_CLIENT_CERTmTLS 认证的客户端证书文件路径
CLAUDE_CODE_CLIENT_KEYmTLS 认证的客户端私钥文件路径
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE加密客户端密钥的密码（可选）

MCP 配置 ​

变量说明
MCP_TIMEOUTMCP 服务器启动超时时间（毫秒）
MCP_TOOL_TIMEOUTMCP 工具执行超时时间（毫秒）
MAX_MCP_OUTPUT_TOKENSMCP 工具响应的最大 Token 数（默认 25000）
MCP_CLIENT_SECRET需要预配置凭证的 MCP 服务器的 OAuth 客户端密钥
MCP_OAUTH_CALLBACK_PORTOAuth 重定向回调的固定端口
ENABLE_CLAUDEAI_MCP_SERVERS设为 false 禁用 claude.ai MCP 服务器（登录用户默认启用）
ENABLE_TOOL_SEARCH控制 MCP 工具搜索：true/auto/auto:N/false

遥测和隐私 ​

变量说明
DISABLE_TELEMETRY设为 1 退出 Statsig 遥测
DISABLE_ERROR_REPORTING设为 1 退出 Sentry 错误报告
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY设为 1 禁用会话质量调查
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC相当于同时设置 DISABLE_AUTOUPDATER、DISABLE_FEEDBACK_COMMAND、DISABLE_ERROR_REPORTING 和 DISABLE_TELEMETRY
DISABLE_PROMPT_CACHING设为 1 禁用所有模型的提示词缓存
DISABLE_PROMPT_CACHING_HAIKU设为 1 禁用 Haiku 模型的提示词缓存
DISABLE_PROMPT_CACHING_SONNET设为 1 禁用 Sonnet 模型的提示词缓存
DISABLE_PROMPT_CACHING_OPUS设为 1 禁用 Opus 模型的提示词缓存
CLAUDE_CODE_ENABLE_TELEMETRY设为 1 启用 OpenTelemetry 数据收集

自动更新和安装 ​

变量说明
DISABLE_AUTOUPDATER设为 1 禁用自动更新
DISABLE_COST_WARNINGS设为 1 禁用费用警告消息
DISABLE_FEEDBACK_COMMAND设为 1 禁用 /feedback 命令
DISABLE_INSTALLATION_CHECKS设为 1 禁用安装警告（仅在手动管理安装位置时使用）
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL跳过 IDE 扩展自动安装

实验性功能 ​

变量说明
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS设为 1 启用 Agent Teams（实验性，默认关闭）
CLAUDE_CODE_DISABLE_1M_CONTEXT设为 1 禁用 1M 上下文窗口支持
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING设为 1 禁用 Opus 4.6 和 Sonnet 4.6 的自适应推理
CLAUDE_CODE_DISABLE_FAST_MODE设为 1 禁用 Fast 模式
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS设为 1 删除系统提示中内置的 commit 和 PR 工作流指令
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS设为 1 移除请求中的 anthropic-beta 头（解决某些代理的兼容问题）

目录和路径 ​

变量说明
CLAUDE_CONFIG_DIR自定义 Claude Code 配置和数据文件的存储位置
CLAUDE_CODE_TMPDIR覆盖内部临时文件使用的临时目录（Claude Code 会在此路径后追加 /claude/）
CLAUDE_CODE_PLUGIN_SEED_DIR只读插件种子目录路径（多个路径用 : 分隔，Windows 用 ;）

SDK 集成 ​

变量说明
CLAUDE_CODE_ACCOUNT_UUID已认证用户的账号 UUID（SDK 调用方使用，同步提供账号信息）
CLAUDE_CODE_USER_EMAIL已认证用户的邮箱地址
CLAUDE_CODE_ORGANIZATION_UUID已认证用户的组织 UUID

演示模式 ​

变量说明
IS_DEMO设为 true 启用演示模式：隐藏邮箱和组织、跳过引导、隐藏内部命令（适用于直播或录制）

相关资源 ​

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 地豆 蜀ICP备2021007188号 | 关于本站 | 隐私政策