当前位置：首页 > news >正文

HoRain云--Claude Code 环境变量

news 2026/6/2 8:46:13

🎬 HoRain云小助手：个人主页

🔥 个人专栏: 《Linux 系列教程》《c语言教程》

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称	专栏介绍
《C语言》	本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。
《网络协议》	本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！
《docker容器精解篇》	全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。
《linux系列》	本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。
《python 系列》	本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。
《试题库》	本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

场景四：Windows PowerShell 环境

环境变量是控制 Claude Code 行为的重要方式，无需编辑配置文件即可灵活调整各项设置。本章详细介绍 Claude Code 支持的所有环境变量、它们的用途、配置方式以及常见使用场景。

环境变量概述

Claude Code 使用环境变量来控制行为，这些变量可以通过以下方式设置：

直接在 shell 中export
在~/.claude/settings.json的env字段中配置
在项目级.claude/settings.json中配置
通过 IDE 插件的设置界面配置

环境变量优先级从高到低：命令行 > 项目级 settings.json > 用户级 settings.json > shell 环境变量。在 settings.json 中配置的变量会自动传递给 Claude 进程。

认证相关变量

变量名	说明	值
`ANTHROPIC_API_KEY`	Claude API 密钥（从 claude.ai 获取）	API 密钥字符串
`ANTHROPIC_BASE_URL`	API 请求的目标地址（用于代理或自定义端点）	URL 地址
`ANTHROPIC_AUTH_TOKEN`	认证令牌（用于 VS Code 插件等场景）	令牌字符串

配置示例

实例

# 在 shell 中设置
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

实例

// 在 settings.json 中配置
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-xxxxx",
"ANTHROPIC_BASE_URL": "https://custom-proxy.com/v1"
}
}

模型配置变量

变量名	说明	值
`ANTHROPIC_MODEL`	默认使用的模型	`claude-opus-4-5`、`claude-sonnet-4-5`、`claude-haiku-3-5`等
`ANTHROPIC_SMALL_FAST_MODEL`	快速响应模式使用的模型（用于简单任务）	模型名称
`CLAUDE_CODE_SUBAGENT_MODEL`	统一设置所有子代理使用的模型	模型名称
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	使用 Bedrock 或 Vertex 的 Anthropic Messages 格式时禁用实验性功能	`1`

使用场景

子代理默认继承主对话的模型。通过CLAUDE_CODE_SUBAGENT_MODEL可以统一设置，将简单任务交给 Haiku，将复杂分析交给 Sonnet，从而优化成本：

实例

# 主对话用 Opus 做复杂推理，子代理统一用 Sonnet
export ANTHROPIC_MODEL="claude-opus-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5"

工具与命令变量

变量名	说明	值
`CLAUDE_CODE_DISABLE_SLASH_COMMANDS`	禁用所有斜杠命令	`1`
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	禁用内置的 Git 相关系统提示词（优先级高于 settings.json 中的`includeGitInstructions`）	`1`
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	在 Windows 上启用 PowerShell 工具（需要配合`defaultShell: "powershell"`设置）	`1`
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	跳过自动安装 IDE 扩展（替代`autoInstallIdeExtension`设置）	`1`
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	禁用后台任务功能	`1`

权限与安全变量

变量名	说明	值
`CLAUDE_CODE_PERMISSION_MODE`	设置默认权限模式（详见子代理章节）	`default`、`acceptEdits`、`dontAsk`、`bypassPermissions`、`plan`
`CLAUDE_CODE_ALLOWED_TOOLS`	允许 Claude 使用的工具白名单（逗号分隔）	工具列表
`CLAUDE_CODE_DISALLOWED_TOOLS`	禁止 Claude 使用的工具黑名单	工具列表

实例

# 在 CI 环境中使用只读模式
export CLAUDE_CODE_PERMISSION_MODE="plan"
export CLAUDE_CODE_ALLOWED_TOOLS="Read,Grep,Glob,Bash(gh *)"

日志与调试变量

变量名	说明	值
`CLAUDE_CODE_DEBUG`	启用调试输出	`1`
`CLAUDE_CODE_ENABLE_TELEMETRY`	启用遥测数据收集	`1`
`OTEL_METRICS_EXPORTER`	OpenTelemetry 指标导出器	`otlp`等

会话与历史变量

变量名	说明	值
`CLAUDE_CODE_DISABLE_HISTORY`	禁用对话历史保存	`1`
`CLAUDE_CODE_SESSION_TIMEOUT`	会话超时时间（秒）	数字
`CLAUDE_CODE_MAX_SESSIONS`	最大保存的会话数量	数字

MCP 相关变量

当 Claude Code 执行 MCP 工具时，会设置以下环境变量：

变量名	说明	值
`CLAUDE_CODE_MCP_SERVER_NAME`	MCP 服务器名称	字符串
`CLAUDE_CODE_MCP_TOOL_NAME`	正在调用的 MCP 工具名称	字符串
`CLAUDE_CODE_MCP_TOOL_ARGS`	传递给 MCP 工具的参数	JSON 字符串

工作流相关变量

变量名	说明	值
`CLAUDE_CODE_WORKTREE_CLEANUP_PERIOD_DAYS`	孤立 worktree 的自动清理周期	天数
`CLAUDE_CODE_DISABLE_WORKTREE_AUTO_CLEANUP`	禁用 worktree 自动清理	`1`

GitHub Actions 专用变量

变量名	说明	值
`ANTHROPIC_VERTEX_PROJECT_ID`	Vertex AI 项目 ID（使用 Vertex 时由认证步骤设置）	GCP 项目 ID
`CLOUD_ML_REGION`	Vertex AI 区域	区域代码（如`us-east5`）