API调试插件在VSCode中的环境变量设置-VSCode-PHP中文网

vs code插件如rest client、thunder client和claude code不继承系统path或终端环境，必须通过各自专用配置项（如rest-client.environmentvariables、thunder-client.environments、claudecode.environmentvariables）显式声明环境变量，且修改后需彻底重启vs code才生效。

api调试插件在vscode中的环境变量设置

API调试插件（如 Claude Code、REST Client、Thunder Client）在 VSCode 中读取环境变量时，不走系统 PATH 或终端环境，必须显式注入——否则 ANTHROPIC_AUTH_TOKEN、OPENAI_API_KEY 这类关键凭据根本不会被识别。

launch.json 的 env 字段只对调试器生效，不影响插件

很多人误以为在 launch.json 里配了 "env": { "API_KEY": "xxx" }，就能让 REST Client 或 Claude Code 插件读到这个值。事实是：插件运行在 VSCode 主进程里，和调试器子进程完全隔离。它既不继承 launch.json 的 env，也不自动加载 .env 文件。

REST Client 和 Thunder Client 只认自己配置的「环境」（通过 rest-client.environmentVariables 或 thunder-client.environments）
Claude Code 插件只读 claudeCode.environmentVariables 配置项，且要求是数组结构，不是对象
Python/Node.js 调试器的 env 字段对插件无任何作用，纯属“各管各的”

Claude Code 插件必须用 claudeCode.environmentVariables 数组

这是最容易出错的地方：Claude Code 不接受 env 键名，也不支持扁平键值对写法。它的配置项名固定为 claudeCode.environmentVariables，值必须是对象数组，每个对象含 name 和 value 字段。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

✅ 正确写法：

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-ant-api03-xxx" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://api.your-proxy.com/v1" }
]

❌ 错误写法："env": { "ANTHROPIC_AUTH_TOKEN": "..." }（插件直接忽略）
❌ 错误写法："ANTHROPIC_AUTH_TOKEN": "..."（字段名不对，配置无效）
修改后必须彻底重启 VS Code，仅重载窗口（Developer: Reload Window）不生效

REST Client 和 Thunder Client 各自维护环境配置

这两个插件不共享配置，也不读全局环境变量。它们的环境变量必须在各自扩展设置中独立声明，且语法不同：

REST Client 使用 rest-client.environmentVariables，格式为对象：
```
"rest-client.environmentVariables": {
  "dev": { "API_KEY": "dev-key" },
  "prod": { "API_KEY": "prod-key" }
}
```
调用时需在请求头写 {{API_KEY}} 并选中对应环境
Thunder Client 使用 thunder-client.environments，格式为数组，每个环境是一个对象：
```
"thunder-client.environments": [
  { "name": "dev", "variables": { "API_KEY": "dev-key" } }
]
```
两者都不支持插值（如 ${env:HOME}），所有值必须硬编码或手动替换
敏感值不要提交到 Git：把 settings.json 加入 .gitignore，或改用插件内置的「加密环境」功能（如 Thunder Client Pro）

别指望 terminal.integrated.env.xxx 能喂给插件

你在 settings.json 里写的 terminal.integrated.env.linux 只影响集成终端启动的 shell 进程，和插件运行时的 Node.js 上下文无关。即使你在那里设了 ANTHROPIC_AUTH_TOKEN，Claude Code 也看不到。

插件启动时读的是 VSCode 主进程的环境，而主进程的环境由你启动 VSCode 的方式决定（桌面图标 vs 终端执行 code）
想让插件“看到”某个变量，唯一可靠路径就是插件自己定义的配置项（如 claudeCode.environmentVariables）
如果插件文档没提某个环境变量名，那它大概率根本不读——别猜，查源码或官方配置列表

最常被跳过的动作是：改完插件配置后没关死所有 VSCode 进程就点重载窗口。Windows 下残留的 Code.exe、macOS 下 Dock 里还勾着 “Keep in Dock”，都会导致旧环境持续生效。真要验证，打开命令面板执行 Developer: Show Running Extensions，看插件详情页是否显示你刚填的 ANTHROPIC_BASE_URL ——没显示，说明配置压根没加载。