2. 配置Claude Code环境变量

任务目标

本案例将完成Claude Code运行所需的核心环境变量配置，包括认证、默认模型选择、请求超时与代理设置。配置完成后，通过CLI命令验证Claude Code能够正确读取环境变量并正常启动。

环境变量清单

以下为Claude Code运行所需的关键环境变量，按功能分组：

• 认证与模型：ANTHROPIC_（必填，）、ANTHROPIC_MODEL（默认模型，如claude-sonnet-4-20250514）、ANTHROPIC_SMALL_FAST_MODEL（轻量任务模型）
• 网络与超时：ANTHROPIC_API_URL（API端点，默认https://api.anthropic.com）、ANTHROPIC_TIMEOUT_MS（请求超时毫秒数）、HTTP_PROXY/HTTPS_PROXY（企业代理场景）
• 行为配置：CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC（设为1可禁用非必要遥测）、CLAUDE_CODE_MAX_OUTPUT_TOKENS（单次响应最大数）

实现步骤

在项目根目录创建.env文件，Claude Code启动时会自动加载该文件中的变量。若需全局生效，可将变量写入用户主目录下的.claude/.env文件。

完整配置代码

# .env — Claude Code 环境变量配置
# 认证（必填）
ANTHROPIC_=sk-ant-your-actual--here

# 模型参数
ANTHROPIC_MODEL=claude-sonnet-4-20250514
ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-20250514
CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192

# 网络设置（按需取消注释）
# ANTHROPIC_API_URL=https://api.anthropic.com
# ANTHROPIC_TIMEOUT_MS=300000
# HTTPS_PROXY=http://proxy.company.com:8080

# 行为开关
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

验证方法

完成配置后，在终端执行以下命令验证环境变量是否生效：

# 1. 确认变量已加载
claude --version

# 2. 启动交互式会话，观察是否进入正常对话界面
claude

# 3. 在Claude Code会话中输入 /status 命令，检查显示的模型名称
#    是否为 ANTHROPIC_MODEL 中设置的值

通过条件：claude --version正常输出版本号；claude命令能进入交互式提示符且无认证错误；/status中显示的模型与配置一致。

常见问题

• 认证失败（401错误）：检查ANTHROPIC_是否包含正确前缀sk-ant-，且密钥未过期。
• 变量未生效：确认.env文件位于当前工作目录，或已通过export $(grep -v '^#' .env | xargs)手动加载到当前shell。
• 代理导致连接失败：若设置了HTTPS_PROXY但代理不可用，请注释该行后重试。