📊 页面导航

    适用角色与上手难度

    角色推荐度上手难度
    🛠️ 开发★★★★★★★★☆☆
    🧪 测试★★★☆☆★★★☆☆
    📦 产品★★☆☆☆★★★★☆

    🎯 学习产出： 掌握环境变量配置，能独立通过环境变量定制 Claude Code 的行为、认证方式和性能参数

    🚀 AI 能力提升： 上下文管理、技能扩展

    环境变量

    预计阅读时间: 5 分钟

    Claude Code 支持通过环境变量控制行为、配置认证和调整性能。在 shell 配置文件中设置，或在启动时内联传递。

    认证与 API

    变量说明
    ANTHROPIC_API_KEYAnthropic API 密钥。设置后覆盖 Pro/Max/Team/Enterprise 订阅认证
    ANTHROPIC_AUTH_TOKEN自定义 Authorization 头的值（自动添加 Bearer 前缀）
    ANTHROPIC_BASE_URL覆盖 API 端点 URL（用于代理/网关路由）
    CLAUDE_CODE_OAUTH_TOKENOAuth 访问令牌，用于 Claude.ai 认证（替代 /login）
    CLAUDE_CODE_OAUTH_REFRESH_TOKENOAuth 刷新令牌（用于自动化环境）
    CLAUDE_CODE_OAUTH_SCOPES刷新令牌的 OAuth 作用域（与 CLAUDE_CODE_OAUTH_REFRESH_TOKEN 配合使用）

    模型配置

    变量说明
    ANTHROPIC_MODEL默认使用的模型名称，覆盖 model 设置
    CLAUDE_MODEL等同于 ANTHROPIC_MODEL
    ANTHROPIC_DEFAULT_SONNET_MODEL覆盖默认 Sonnet 模型
    ANTHROPIC_DEFAULT_OPUS_MODEL覆盖默认 Opus 模型
    ANTHROPIC_DEFAULT_HAIKU_MODEL覆盖默认 Haiku 模型
    CLAUDE_CODE_EFFORT_LEVEL设置推理强度：low、medium、high、xhigh、max、auto
    CLAUDE_CODE_MAX_OUTPUT_TOKENS最大输出 token 数。增大时会减少自动压缩前的可用上下文窗口

    行为控制

    变量说明
    CLAUDE_CODE_MAX_TURNS无显式限制时的代理轮次上限，等同于 --max-turns
    CLAUDE_CODE_MAX_RETRIESAPI 请求失败的重试次数（默认：10）
    CLAUDE_CODE_MAX_CONTEXT_TOKENS覆盖假定的上下文窗口大小（需同时设置 DISABLE_COMPACT）
    CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY最大并行只读工具和子代理数（默认：10）
    CLAUDE_CODE_DISABLE_THINKING设为 1 强制禁用扩展思考
    CLAUDE_CODE_DISABLE_FAST_MODE设为 1 禁用快速模式
    CLAUDE_CODE_DISABLE_CRON设为 1 禁用定时任务
    CLAUDE_CODE_DISABLE_WORKFLOWS设为 1 禁用工作流

    上下文与记忆

    变量说明
    CLAUDE_CODE_DISABLE_CLAUDE_MDS设为 1 禁止加载任何 CLAUDE.md 记忆文件
    CLAUDE_CODE_DISABLE_AUTO_MEMORY设为 1 禁用自动记忆。设为 0 强制启用
    CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD设为 1 从 --add-dir 目录加载记忆文件
    CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS设为 1 从系统提示中移除内置 git 工作流指令
    CLAUDE_AUTOCOMPACT_PCT_OVERRIDE自动压缩触发的上下文容量百分比（默认约 95%）

    工具与功能

    变量说明
    CLAUDE_CODE_DISABLE_BACKGROUND_TASKS设为 1 禁用所有后台任务功能
    CLAUDE_CODE_DISABLE_AGENT_VIEW设为 1 关闭后台代理和代理视图
    CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING设为 1 禁用文件检查点，/rewind 将无法恢复代码变更
    CLAUDE_CODE_DISABLE_ATTACHMENTS设为 1 禁用附件处理，@ 文件提及作为纯文本发送
    CLAUDE_CODE_NEW_INIT设为 1 使 /init 运行交互式设置流程
    BASH_DEFAULT_TIMEOUT_MSBash 命令的默认超时时间（默认：120000 / 2 分钟）
    BASH_MAX_TIMEOUT_MS模型可设置的最大 Bash 超时时间（默认：600000 / 10 分钟）
    BASH_MAX_OUTPUT_LENGTHBash 输出的最大字符数，超出部分保存到文件

    界面与渲染

    变量说明
    CLAUDE_CODE_NO_FLICKER设为 1 启用全屏渲染
    CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN设为 1 禁用全屏渲染，使用经典渲染器
    CLAUDE_CODE_HIDE_CWD设为 1 在启动 logo 中隐藏工作目录
    CLAUDE_CODE_ACCESSIBILITY设为 1 保持终端原生光标可见

    云平台

    变量说明
    CLAUDE_CODE_USE_BEDROCK设为 1 启用 Amazon Bedrock 支持
    CLAUDE_CODE_USE_VERTEX设为 1 启用 Google Vertex AI 支持
    ANTHROPIC_BEDROCK_BASE_URL覆盖 Bedrock 端点 URL
    ANTHROPIC_VERTEX_BASE_URL覆盖 Vertex AI 端点 URL
    ANTHROPIC_VERTEX_PROJECT_IDGCP 项目 ID（用于 Vertex AI 请求）

    诊断

    变量说明
    CLAUDE_CODE_DEBUG_LOGS_DIR调试日志文件路径（需单独启用调试模式）
    CLAUDE_CODE_DEBUG_LOG_LEVEL最低日志级别：verbose、debug（默认）、info、warn、error
    DISABLE_TELEMETRY禁用遥测数据收集
    DISABLE_AUTOUPDATER禁用自动更新
    DISABLE_ERROR_REPORTING禁用错误报告
    DO_NOT_TRACK禁用跟踪（遵循标准隐私约定）
    CLAUDECODEClaude Code 生成的子进程中自动设为 1，用于检测是否在 Claude Code 子进程中运行

    下一步