智域科技 查看产品

PowerShell 环境变量 · 2026 年 7 月更新

关掉 PowerShell 后
Claude 配置怎么又没了?

如果你用 $env: 写入 DeepSeek 配置,当前窗口可以正常使用, 关闭 PowerShell 或 VS Code 后却重新报认证错误,通常不是 API Key 突然失效, 而是变量只存在于已经结束的终端会话。

本文检查不会上传文件,也不会要求展示完整 API Key。自动配置工具一次性 ¥19.9。

适用系统
Windows 10 / 11
常见症状
重开后认证或模型配置失效
主要原因
$env: 只写入当前会话
预计时间
5–10 分钟

01

$env: 写入当前会话,不等于永久保存

在 PowerShell 中执行下面这种命令时,变量立即出现在当前 PowerShell 进程里, 从该窗口启动的程序也可以继承它:

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

但关闭窗口后,这个进程和它的临时环境一起结束。新打开的 PowerShell 或 VS Code 不会自动恢复该值。需要长期使用时,应保存到当前 Windows 账户的“用户环境变量”, 而不是每次重新粘贴。

$env::当前窗口立即生效

用户环境变量:新打开的程序长期读取

系统环境变量:本文不需要修改

保存后必须重开 VS Code

02

先检查 User 范围,不要把完整 Key 打印出来

查看用户环境变量中的接口地址:

[Environment]::GetEnvironmentVariable(
  "ANTHROPIC_BASE_URL",
  "User"
)

检查 Key 是否存在时,只显示状态和长度:

$token = [Environment]::GetEnvironmentVariable(
  "ANTHROPIC_AUTH_TOKEN",
  "User"
)

if ([string]::IsNullOrWhiteSpace($token)) {
  "未设置"
} else {
  "已设置,长度:$($token.Length)"
}

不要直接运行会完整输出 ANTHROPIC_AUTH_TOKEN 的命令,也不要把 Windows 环境变量窗口中 Key 的完整值截进图片。

03

使用 Windows 用户环境变量持久保存

  1. 01按 Windows 键,搜索“编辑账户的环境变量”。
  2. 02打开“环境变量”,只处理上方的“用户变量”。
  3. 03逐项新建或编辑下文列出的变量名与对应值。
  4. 04变量名不要带 $env:,值两端不要额外加引号或空格。
  5. 05保存后完全关闭 VS Code、PowerShell 和 CMD,再重新打开。

不建议为了省一步而把真实 API Key 直接写进会留下历史记录的公开命令示例。 使用图形界面时也应确认周围没有录屏、远程协助或公开直播。

04

当前 DeepSeek V4 配置需要核对 8 个变量

变量名应与 DeepSeek 当前 Claude Code 接入指南一致。以下只展示名称和非敏感值; ANTHROPIC_AUTH_TOKEN 的值必须使用你自己的 DeepSeek API Key。

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN=你的 DeepSeek API Key
ANTHROPIC_MODEL=deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
CLAUDE_CODE_EFFORT_LEVEL=max

如果之前保存过旧模型名,不要只补新变量而保留互相冲突的旧值。逐项核对后再重开 VS Code。模型名和接入方式可能随上游变化,应以官方当前页面为准。

官方参考: DeepSeek:在 Claude Code 中使用 DeepSeek API

05

保存后重开程序,再按顺序验证

已经打开的 VS Code 不会自动重读刚保存的用户环境变量。彻底关闭全部窗口, 重新打开 VS Code,选择“终端 → 新建终端”,再执行:

claude --version

[Environment]::GetEnvironmentVariable(
  "ANTHROPIC_BASE_URL",
  "User"
)

版本命令能运行、接口地址能显示正确值后,再在项目文件夹中启动 claude。若命令本身找不到,先转到 claude 不是内部或外部命令的排查教程

06

这四种情况最容易造成“保存了但仍失效”

只关闭终端,没有完全退出 VS Code

新终端仍可能由旧的 VS Code 进程创建,并继承旧环境。完全退出所有 VS Code 窗口后再重新打开。

把变量保存到了另一个 Windows 账户

Claude Code 应读取当前登录账户的用户变量。不要在管理员账户中保存后, 期待普通账户自动获得相同值。

变量名带了 $env: 或值带了多余引号

Windows 环境变量窗口中的变量名应为 ANTHROPIC_BASE_URL, 不包含 $env:;值只填写实际内容。

旧模型名与当前 V4 配置混在一起

按官方当前指南逐项核对全部变量。只替换其中一项,可能留下互相矛盾的模型映射。

07

常见问题

关闭 PowerShell 后为什么配置会消失?

$env: 默认写入当前 PowerShell 进程。关闭窗口后进程结束, 新窗口不会继承已经结束的会话。

保存用户变量后需要重启电脑吗?

通常不需要重启整台电脑,但必须完全关闭并重新打开 VS Code 和终端。 若仍读取旧值,再注销 Windows 账户或重启电脑排除残留进程。

怎样确认 Key 已保存而不泄露?

只读取 User 范围并判断是否为空、显示字符长度,不打印完整 Key。 对外求助时不要发送完整环境变量列表。

不想手动逐项保存和检查?

先免费确认 Windows、网络和 DeepSeek Key 条件。符合要求后,再决定是否使用 Claude Code Bridge 检测依赖并写入当前 V4 用户环境变量。

开始 30 秒自检

自检不会要求输入 API Key。需要从安装开始操作时,可阅读 Windows 配置 Claude Code 接入 DeepSeek 综合指南