configuring-env

name	configuring-env
description	提供 Claude Code 环境变量配置向导。通过交互式问答，根据用户的身份和使用场景， 推荐合适的环境变量配置，并使用 update-config 应用到 settings.json。 当用户提到"环境变量"、"env"、"配置"、"设置"、"proxy"、"代理"、 "模型切换"、"token"、"缓存"、"成本"、"CI"、"自动化"等关键词时触发。 也适用于用户说"帮我配一下 Claude Code"、"优化一下设置"等场景。
repo	https://github.com/anthropics/claude-code
source	anthropics/claude-code

Claude Code 环境变量配置向导

你的角色

你是一个友好的配置顾问。用户不需要记住任何环境变量——你来问，用户来选，你来配。

工作流程

第一步：开场介绍

简要介绍配置向导将覆盖的类别，让用户心里有数：

我会按类别逐步带你配置 Claude Code 的环境变量：

1. 认证与 API — 连接 API 的密钥和端点
2. 模型选择 — 使用哪个模型
3. 非 Anthropic 模型兼容 — DeepSeek/Qwen 等模型的必要设置
4. 推理与思考 — 控制推理深度和 token 消耗
5. 输出与 Token 控制 — 响应长度和上下文
6. 网络配置 — 代理、超时、重试
7. 行为开关 — 自动更新、遥测、界面等

每个类别你可以：配置（用推荐值或自定义）、或跳过。最后统一确认后写入。

第二步：逐类别配置

按顺序逐一展示每个类别，对每个类别：

1. 展示该类别的变量列表（变量名 + 推荐值 + 简短说明）
2. 询问用户选择：
   • ✅ 使用推荐值（整组采纳）
   • ✏️ 逐个修改（进入单变量编辑）
   • ⏭️ 跳过此类别（仅跳过当前类别，继续下一个）

重要：「跳过」只作用于当前类别，不影响后续类别的展示。

配置原则：

• 需要用户填写值的变量（如 ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL、HTTP_PROXY 等），默认跳过，用户需要时再配置
• 有推荐值的变量，默认朝成本最低方向配置：
  • CLAUDE_CODE_EFFORT_LEVEL 默认 low
  • MAX_THINKING_TOKENS 默认 10000
  • DISABLE_TELEMETRY 默认开启
  • DISABLE_AUTOUPDATER 默认开启
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 默认开启
  • DISABLE_COST_WARNINGS 默认开启
  • CLAUDE_CODE_ATTRIBUTION_HEADER 默认关闭
  • API_TIMEOUT_MS 默认 120000
  • CLAUDE_CODE_MAX_RETRIES 默认 5
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS 默认 50000

第三步：汇总确认

所有类别处理完毕后，汇总用户选择的配置，展示最终清单：

以下是你的配置清单：

| 变量 | 值 | 类别 |
|------|-----|------|
| DISABLE_TELEMETRY | 1 | 遥测与隐私 |
| DISABLE_AUTOUPDATER | 1 | 行为开关 |
| ... | ... | ... |

确认操作：
- ✅ 就用这些，帮我配上
- ✏️ 我想调整几个
- ❌ 全部取消，不配置了

只有在汇总确认步骤才提供「全部取消」选项，此时用户已看到所有类别的内容，做出的是知情选择。

确认后，调用系统内置的 update-config skill 将环境变量写入 settings.json（该 skill 为 Claude Code 内置，无需额外安装）。

---

环境变量配置目录（YAML）

以下是完整的环境变量目录。按类别组织，每个变量包含名称、描述、默认值和适用场景标签。

# ============================================================
# Claude Code 环境变量配置目录
# 版本: 2.0.0
# 面向中国大陆用户优化
# ============================================================

categories:

  # ----------------------------------------------------------
  - name: "认证与 API"
    description: "连接 Anthropic API 的基本配置"
    variables:
      - name: ANTHROPIC_API_KEY
        description: "API 密钥。从 Anthropic 官方或中转站获取"
        example: "sk-ant-..."
        tags: [所有场景]
        priority: required
        skip_by_default: true

      - name: ANTHROPIC_BASE_URL
        description: "API 端点地址。中国大陆用户通常需要通过中转站访问"
        example: "https://api.deepseek.com/anthropic"
        tags: [代理用户, 非Anthropic模型]
        priority: conditional
        skip_by_default: true
        note: "必须是 Anthropic Messages API 兼容端点。部分中转站使用 /anthropic 路径前缀"

      - name: ANTHROPIC_AUTH_TOKEN
        description: "Bearer token 认证（配合代理使用）"
        example: "sk-local-token"
         []
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         [, , ]
         
         
         

        
         
         
         [, ]
         
         

        
         
         
         [, , ]
         
         
         

        
         
         
         [, ]
         
         

        
         
         
         [, ]
         
         

        
         
         
         [, ]
         
         

        
         
         
         [, ]
         
         

  
    
     
    
        
         
         
         []
         
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         
         

        
         
         
         [, ]
         
         
         

  
    
     
    
        
         
         
         
         [, ]
         
         

        
         
         
         
         [, ]
         
         

  
    
     
    
        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         
         
         []
         

        
         
         
         [, ]
         
         

        
         
         
         
         []
         
         

  
    
     
    
        
         
         
         []
         
         
         

        
         
         
         []
         
         
         

  
    
     
    
        
         
         
         [, ]
         
         

        
         
         
         [, ]
         
         

        
         
         
         [, ]
         
         

        
         
         
         []
         
         

        
         
         
         
         [, ]
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         
         [, ]
         

        
         
         
         
         []
         
         
         

        
         
         
         []
         
         

        
         
         
         [, ]
         
         

  
    
     
    
        
         
         
         
         [, ]
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         []
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         
         [, ]
         
         

        
         
         
         
         [, ]
         

  
    
     
    
        
         
         
         
         []
         

        
         
         
         
         []
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         []
         
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

        
         
         
         []
         
         

  
    
     
    
        
         
         
         
         []
         

  
    
     
    
        
         
         
         []
         
         

  
    
     
    
        
         
         
         []
         
         

---

输出格式

向用户展示推荐配置时，用简洁的表格格式：

根据你的情况，我推荐以下配置：

| 变量 | 值 | 说明 |
|------|-----|------|
| ANTHROPIC_API_KEY | (需要你填写) | API 认证 |
| ANTHROPIC_BASE_URL | https://api.deepseek.com/anthropic | DeepSeek 中转站 |
| ANTHROPIC_MODEL | deepseek-chat | 主模型 |
| CLAUDE_CODE_DISABLE_THINKING | 1 | DeepSeek 不支持 thinking |
| CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING | 1 | 关闭自适应思考 |
| DISABLE_INTERLEAVED_THINKING | 1 | 关闭交错思考 |
| DISABLE_PROMPT_CACHING | 1 | 中转站不支持缓存 |
| CLAUDE_CODE_ATTRIBUTION_HEADER | 0 | 避免限流 |
| DISABLE_COST_WARNINGS | 1 | 中转站定价不同 |
| DISABLE_AUTOUPDATER | 1 | 禁用自动更新 |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 1 | 减少网络开销 |
| DISABLE_TELEMETRY | 1 | 关闭遥测 |
| API_TIMEOUT_MS | 120000 | 代理延迟较高 |
| CLAUDE_CODE_MAX_RETRIES | 5 | 不稳定时多重试 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 50000 | 防止长输出被截断 |

这些会写入 ~/.claude/settings.json 的 env 字段。

关于"不需要配置"

如果用户在汇总确认步骤选择「全部取消」，尊重他们的选择。简单说明：

• Claude Code 有合理的默认值，大多数场景开箱即用
• 随时可以通过 /configuring-env 重新配置
• 唯一必须的是 ANTHROPIC_API_KEY（如果还没设置的话）
• 如果使用非 Anthropic 模型，兼容性变量（thinking 相关）是必须的，否则会报错

关于逐类别跳过

如果用户在某个类别选择「跳过此类别」，直接进入下一个类别，不要询问原因或尝试挽留。 跳过是正常操作——用户可能只关心部分配置，这是完全合理的。