环境变量参考——Claude Code配置大全

Claude Code提供了一系列环境变量来微调其行为。这份参考手册整理了所有可用的环境变量，方便你按需配置。

调试与诊断

核心调试变量

变量名	默认值	说明
`CLAUDE_CODE_DEBUG`	未设置	开启调试模式，输出详细日志
`CLAUDE_CODE_DEBUG_TOOLS`	未设置	开启工具调用调试
`CLAUDE_CODE_DEBUG_HTTP`	未设置	开启HTTP请求调试
`CLAUDE_CODE_DUMP_AUTO_MODE`	未设置	导出YOLO分类器的输入/输出，用于调试权限决策
`DEBUG`	未设置	通用调试开关，影响依赖库

日志相关

变量名	默认值	说明
`CLAUDE_CODE_LOG_LEVEL`	`info`	日志级别：`debug`、`info`、`warn`、`error`
`CLAUDE_CODE_LOG_FILE`	未设置	日志文件路径，默认输出到控制台
`CLAUDE_CODE_LOG_TIMESTAMPS`	`true`	是否在日志中包含时间戳

API与模型

API配置

变量名	默认值	说明
`ANTHROPIC_API_KEY`	未设置	Anthropic API密钥
`CLAUDE_CODE_API_KEY`	未设置	专用API密钥（优先级高于ANTHROPIC_API_KEY）
`CLAUDE_CODE_API_BASE_URL`	`https://api.anthropic.com`	API基础URL
`CLAUDE_CODE_MODEL`	`claude-sonnet-4-6`	默认使用的模型
`CLAUDE_CODE_MAX_TOKENS`	`8192`	最大输出token数

模型特定配置

变量名	默认值	说明
`CLAUDE_CODE_EFFORT_LEVEL`	未设置	推理努力度：`low`、`medium`、`high`、`max`
`CLAUDE_CODE_FAST_MODE`	未设置	是否启用Fast Mode
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	`false`	是否禁用adaptive thinking
`MAX_THINKING_TOKENS`	未设置	thinking模式的最大token数

第三方提供商

变量名	默认值	说明
`AWS_ACCESS_KEY_ID`	未设置	AWS Bedrock访问密钥
`AWS_SECRET_ACCESS_KEY`	未设置	AWS Bedrock密钥
`AWS_REGION`	未设置	AWS区域
`GOOGLE_APPLICATION_CREDENTIALS`	未设置	Google Vertex AI凭证路径
`GOOGLE_CLOUD_PROJECT`	未设置	Google Cloud项目ID

上下文与缓存

缓存控制

变量名	默认值	说明
`CLAUDE_CODE_CACHE_ENABLED`	`true`	是否启用提示词缓存
`CLAUDE_CODE_CACHE_TTL`	`3600`	缓存TTL（秒），默认1小时
`CLAUDE_CODE_DISABLE_PROMPT_CACHE`	`false`	完全禁用提示词缓存
`CLAUDE_CODE_DISABLE_CACHE_EDITING`	`false`	禁用缓存编辑功能

压缩配置

变量名	默认值	说明
`CLAUDE_CODE_DISABLE_AUTO_COMPACT`	`false`	禁用自动压缩
`CLAUDE_CODE_COMPACT_THRESHOLD`	`150000`	自动压缩触发阈值（token）
`CLAUDE_CODE_COMPACT_MIN_MESSAGES`	`10`	触发压缩的最小消息数

Token预算

变量名	默认值	说明
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	`200000`	最大上下文token数
`CLAUDE_CODE_OUTPUT_TOKEN_RESERVE`	`8192`	输出token预留
`CLAUDE_CODE_TOKEN_BUFFER`	`10000`	Token缓冲区

权限与安全

权限模式

变量名	默认值	说明
`CLAUDE_CODE_PERMISSION_MODE`	`default`	权限模式：`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`
`CLAUDE_CODE_DISABLE_PERMISSIONS`	`false`	禁用权限检查（危险）
`CLAUDE_CODE_YOLO_ENABLED`	`true`	是否启用YOLO分类器
`CLAUDE_CODE_YOLO_DISABLED`	`false`	完全禁用YOLO分类器

安全设置

变量名	默认值	说明
`CLAUDE_CODE_DISABLE_BASH_SANDBOX`	`false`	禁用Bash沙箱（危险）
`CLAUDE_CODE_ALLOW_DANGEROUS_COMMANDS`	`false`	允许危险命令（如rm -rf /）
`CLAUDE_CODE_DISABLE_GIT_SAFETY`	`false`	禁用Git安全协议（危险）

记忆系统

记忆控制

变量名	默认值	说明
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	`false`	禁用自动记忆提取
`CLAUDE_CODE_DISABLE_AUTO_DREAM`	`false`	禁用夜间记忆整合
`CLAUDE_COWORK_MEMORY_PATH_OVERRIDE`	未设置	覆盖记忆目录路径
`CLAUDE_CODE_MEMORY_LOG_LEVEL`	`info`	记忆系统日志级别

Session Memory

变量名	默认值	说明
`CLAUDE_CODE_SESSION_MEMORY_ENABLED`	`true`	是否启用Session Memory
`CLAUDE_CODE_SESSION_MEMORY_THRESHOLD`	`10000`	Session Memory触发阈值（token）

技能系统

变量名	默认值	说明
`CLAUDE_CODE_SKILLS_ENABLED`	`true`	是否启用技能系统
`CLAUDE_CODE_SKILL_PATH`	未设置	自定义技能搜索路径
`CLAUDE_CODE_DISABLE_BUILTIN_SKILLS`	`false`	禁用内置技能
`CLAUDE_CODE_SKILL_BUDGET_PERCENT`	`1`	技能列表占上下文的百分比

Agent系统

变量名	默认值	说明
`CLAUDE_CODE_DISABLE_SUBAGENTS`	`false`	禁用子Agent功能
`CLAUDE_CODE_MAX_CONCURRENT_AGENTS`	`5`	最大并发Agent数
`CLAUDE_CODE_AGENT_TIMEOUT`	`300`	Agent超时时间（秒）

Feature Flags

实验性功能

变量名	默认值	说明
`CLAUDE_CODE_COORDINATOR_MODE`	`false`	启用协调者模式
`CLAUDE_CODE_EXPERIMENTAL_SKILLS`	`false`	启用实验性技能
`CLAUDE_CODE_VOICE_ENABLED`	`false`	启用语音输入
`CLAUDE_CODE_ALWAYS_THINKING`	`false`	始终启用thinking模式

KAIROS模式

变量名	默认值	说明
`CLAUDE_CODE_KAIROS_ENABLED`	`false`	启用KAIROS后台模式
`CLAUDE_CODE_KAIROS_TICK_INTERVAL`	`60000`	Tick间隔（毫秒）
`CLAUDE_CODE_KAIROS_CHANNELS`	未设置	启用频道列表

会话管理

变量名	默认值	说明
`CLAUDE_CODE_SESSION_ID`	自动生成	自定义会话ID
`CLAUDE_CODE_RESUME_SESSION`	`false`	恢复上次会话
`CLAUDE_CODE_DISABLE_TRANSCRIPT`	`false`	禁用会话记录
`CLAUDE_CODE_TRANSCRIPT_PATH`	未设置	自定义会话记录路径

Git与版本控制

变量名	默认值	说明
`CLAUDE_CODE_GIT_ENABLED`	`true`	启用Git集成
`CLAUDE_CODE_AUTO_COMMIT`	`false`	自动提交更改
`CLAUDE_CODE_COMMIT_MESSAGE_STYLE`	`conventional`	提交信息风格
`CLAUDE_CODE_DISABLE_PRE_COMMIT_HOOKS`	`false`	禁用pre-commit hooks

网络与代理

变量名	默认值	说明
`HTTP_PROXY`	未设置	HTTP代理地址
`HTTPS_PROXY`	未设置	HTTPS代理地址
`NO_PROXY`	未设置	代理绕过列表
`CLAUDE_CODE_TIMEOUT`	`120`	请求超时（秒）
`CLAUDE_CODE_RETRY_ATTEMPTS`	`3`	重试次数

用户类型

变量名	默认值	说明
`USER_TYPE`	`external`	用户类型：`ant`（内部）、`external`（外部）
`CLAUDE_CODE_ORG_ID`	未设置	组织ID

快速配置示例

调试模式

# 开启完整调试
export CLAUDE_CODE_DEBUG=1
export CLAUDE_CODE_LOG_LEVEL=debug
export CLAUDE_CODE_DUMP_AUTO_MODE=1

claude

高性能模式

# 最大化性能
export CLAUDE_CODE_EFFORT_LEVEL=low
export CLAUDE_CODE_FAST_MODE=1
export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=true

claude

安全模式

# 最保守的安全设置
export CLAUDE_CODE_PERMISSION_MODE=default
export CLAUDE_CODE_YOLO_DISABLED=1
export CLAUDE_CODE_DISABLE_BASH_SANDBOX=false

claude

开发调试模式

# 开发时使用
export CLAUDE_CODE_DEBUG=1
export CLAUDE_CODE_DISABLE_AUTO_COMPACT=true  # 方便查看完整上下文
export CLAUDE_CODE_DUMP_AUTO_MODE=1            # 调试权限决策
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=true    # 避免记忆干扰

claude

CI/CD模式

# 自动化脚本使用
export CLAUDE_CODE_PERMISSION_MODE=auto
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=true
export CLAUDE_CODE_NON_INTERACTIVE=1
export CLAUDE_CODE_LOG_LEVEL=error

claude --command "..."

配置文件优先级

环境变量 > 本地设置 > 用户设置 > 默认值

环境变量 (最高优先级)
    ↓
.claude/settings.local.json (项目级)
    ↓
~/.claude/settings.json (用户级)
    ↓
内置默认值 (最低优先级)

注意事项

敏感信息

以下变量包含敏感信息，避免提交到版本控制：

ANTHROPIC_API_KEY
AWS_SECRET_ACCESS_KEY
GOOGLE_APPLICATION_CREDENTIALS

建议：

使用.env文件并在.gitignore中排除
或使用系统的环境变量管理工具

危险设置

以下设置会绕过安全机制，仅在充分了解风险时使用：

CLAUDE_CODE_DISABLE_PERMISSIONS=true
CLAUDE_CODE_ALLOW_DANGEROUS_COMMANDS=true
CLAUDE_CODE_DISABLE_GIT_SAFETY=true

性能权衡

某些设置是性能与质量的权衡：

EFFORT_LEVEL=low：更快但更浅层
FAST_MODE=1：使用更强模型但成本更高
DISABLE_AUTO_COMPACT=true：完整上下文但更快达到上限

故障排查

问题：权限频繁询问

# 检查当前权限模式
export CLAUDE_CODE_PERMISSION_MODE=auto

# 或查看YOLO分类器日志
export CLAUDE_CODE_DUMP_AUTO_MODE=1

问题：缓存不生效

# 检查缓存状态
export CLAUDE_CODE_DEBUG=1

# 确认缓存未禁用
unset CLAUDE_CODE_DISABLE_PROMPT_CACHE

问题：记忆不工作

# 检查记忆目录
ls ~/.claude/projects/$(basename $(git rev-parse --show-toplevel))/memory/

# 开启记忆调试
export CLAUDE_CODE_MEMORY_LOG_LEVEL=debug

这份环境变量参考涵盖了Claude Code的主要配置选项。大多数用户不需要修改这些设置，但在特定场景下（调试、CI/CD、性能调优），这些变量能让你更好地控制Claude Code的行为。

调试与诊断#

核心调试变量#

日志相关#

API与模型#

API配置#

模型特定配置#

第三方提供商#

上下文与缓存#

缓存控制#

压缩配置#

Token预算#

权限与安全#

权限模式#

安全设置#

记忆系统#

记忆控制#

Session Memory#

技能系统#

Agent系统#

Feature Flags#

实验性功能#

KAIROS模式#

会话管理#

Git与版本控制#

网络与代理#

用户类型#

快速配置示例#

调试模式#

高性能模式#

安全模式#

开发调试模式#

CI/CD模式#

配置文件优先级#

注意事项#

敏感信息#

危险设置#

性能权衡#

故障排查#

问题：权限频繁询问#

问题：缓存不生效#

问题：记忆不工作#