VS Code插件如REST Client、Thunder Client和Claude Code不继承系统PATH或终端环境，必须通过各自专用配置项（如rest-client.environmentVariables、thunder-client.environments、claudeCode.environmentVariables）显式声明环境变量，且修改后需彻底重启VS Code才生效。
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 字段。
- ✅ 正确写法：
"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 ——没显示，说明配置压根没加载。
