一、问题背景

Claude Code 作为一款强大的AI编程助手，其原生设计仅支持 Anthropic 官方接口。对于希望使用 DeepSeek 模型的开发者来说，需要通过兼容接口地址配合环境变量密钥的方式完成对接。
如果不小心删除了API秘钥或是不想用这个API秘钥了，也就是旧秘钥失效，可以参考下文解决。

本次核心故障：旧密钥失效，持续出现 401 鉴权失败错误。通过更新系统环境变量成功解决了连通问题。

二、核心环境变量说明

配置 Claude Code 使用 DeepSeek 接口需要两组关键环境变量，全部配置在用户级环境变量中：

1. ANTHROPIC_BASE_URL

• 值：兼容接口地址
• 作用：将 Claude Code 的请求转发至 DeepSeek 服务，实现模型兼容调用

2. ANTHROPIC_AUTH_TOKEN

• 值：接口访问密钥（文字替代：个人API密钥）
• 作用：身份鉴权，密钥错误或过期会直接抛出 401 报错

额外可选变量：ANTHROPIC_MODEL，用于指定默认调用的模型名称。

三、踩坑重点知识点

1. 修改环境变量后，已打开终端不会自动刷新

Windows PowerShell、CMD 等终端进程在启动时一次性读取环境变量。修改变量后，必须完全关闭所有终端窗口，重新打开新的终端，新配置才能加载。在旧窗口内直接测试，依旧会读取旧密钥。

2. 区分两种环境变量作用域

• User（用户级别）：仅对当前 Windows 账户生效，推荐使用，命令末尾参数为 "User"
• Machine（系统级别）：对本机所有账户生效，需要管理员权限

3. 更新密钥最简操作（无需重写全部变量）

不需要重复配置接口地址、模型名称，只需单独更新鉴权密钥即可。

PowerShell 命令流程：

# 1. 清除旧密钥
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")

# 2. 写入新密钥
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "个人API密钥", "User")

执行完成后 → 关闭全部终端 → 新开终端校验。

4. 校验命令

echo $env:ANTHROPIC_AUTH_TOKEN

输出内容和新密钥一致，代表配置成功。

四、启动验证流程

1. 终端输入 claude 启动客户端
2. 正常现象：成功展示欢迎界面、识别配置的模型名称，可正常对话、生成代码
3. 异常现象：出现 401 Unauthorized 错误 → 优先排查密钥是否复制完整、有无多余空格

五、补充使用小技巧

1. 工作目录设置：建议先使用 cd 命令切换到项目文件夹，再执行 claude 命令，工具会自动读取当前目录代码
2. 操作模式：界面默认处于 manual mode 手动模式，输入 ? 可以查看全部快捷键
3. 安全注意事项：密钥属于敏感信息，不要直接截图完整密钥，对外文档建议使用文字替代

六、最终结论

本次故障的根源在于：系统环境变量内保存的鉴权密钥仍是旧值。遵循「清除旧变量 → 写入新密钥 → 重启终端加载配置 → 校验 → 启动客户端」的标准流程，即可完成鉴权修复，实现 Claude Code 顺利调用 DeepSeek 系列模型。

通过这次实操，我们不仅解决了具体的连接问题，更重要的是掌握了在 Windows 环境下正确配置和管理环境变量的方法，为后续的开发和调试工作打下了坚实基础。