1Password插件可避免明文密钥硬编码进settings.json，通过高亮密钥并运行“1Password: Save in 1Password”命令，自动生成op://格式的秘密引用（如op://MyVault/ClaudeAPI/api_key）替换原值，该引用可安全提交至Git；需预先安装1Password CLI并完成op signin登录。
用 1Password 插件避免明文密钥写进 settings.json
硬编码 API 密钥到 VSCode 配置里是高频泄露源头，settings.json 一旦被误提交到 Git，密钥就彻底暴露。1Password 插件能直接在编辑器内生成、存储并插入「秘密引用」，不落地真实值。
操作要点：
- 高亮待替换的密钥字符串（如
"sk-ant-api03-..."），运行命令1Password: Save in 1Password，填入保险库、项名和字段名（如api_key） - 插件自动替换成形如
op://MyVault/ClaudeAPI/api_key的引用，该 URL 不含敏感内容，可安全提交 - 在
settings.json中直接使用该引用：{"claudecode.apiKey": "op://MyVault/ClaudeAPI/api_key"} - 确保已安装 1Password CLI 并完成
op signin登录，否则插件无法解析引用
通过 ${env:VAR} 引用系统级环境变量，绕过配置文件
VSCode 原生支持 ${env:VAR} 语法读取环境变量，这是比硬编码更轻量、更通用的安全方案，尤其适合 CI/CD 或多环境切换场景。
常见踩坑点：
- Windows 用户在 PowerShell 中设置变量需用
$env:ANTHROPIC_API_KEY="..."，而 CMD 是set ANTHROPIC_API_KEY=...；两者互不兼容，推荐统一用 PowerShell 或终端启动脚本 - macOS/Linux 下，若在
~/.zshrc中 export 变量，需重启 VSCode（而非仅重启终端），否则新变量不会注入到 GUI 进程 - 在
settings.json中必须严格匹配大小写："claudecode.apiKey": "${env:ANTHROPIC_API_KEY}"，错一个字母就 fallback 为空字符串 - 不要在
.env文件里写ANTHROPIC_API_KEY=xxx后指望 VSCode 自动加载——它不会读取项目级.env，除非配合其他扩展（如 dotenv）
用 vscode-env-loader 动态注入 Vault 密钥到启动环境
企业级场景中，密钥往往由 HashiCorp Vault 或 Azure Key Vault 统一托管。直接靠用户手动 export 不现实，也难审计。vscode-env-loader 扩展可在 VSCode 启动时调用 Vault CLI 获取密钥，并注入进程环境，后续所有插件（包括 ClaudeCode）都能通过 ${env:...} 读取。
关键步骤：
- 先配置好 Vault CLI 认证（如 token 或 OIDC），确保
vault kv get -field=api_key secret/claudelab能返回有效值 - 在 VSCode 的
settings.json中启用加载器："envLoader.enabled": true，并指定脚本路径："envLoader.scriptPath": "./.vscode/load-vault-env.sh" -
load-vault-env.sh内容只需一行：echo "ANTHROPIC_API_KEY=$(vault kv get -field=api_key secret/claudelab)" - 该脚本输出必须为
KEY=VALUE格式，且不能有空格或注释，否则解析失败
为什么 cloack 插件不适合 API 密钥管理
cloack 插件主打「视觉隐藏」——把代码里已存在的密钥字符串渲染成占位符（如 [REDACTED]），但它不改变实际值，也不阻止复制粘贴或误提交。对 settings.json 或 .env 这类纯文本配置文件完全无效。
它只解决一个表层问题：防止你在写代码时不小心看到同事屏幕上的密钥。但以下情况它无能为力：
- Git 提交前未检查，
settings.json里的"apiKey": "sk-..."依然会被推送到远端 - 导出工作区设置、同步 VSCode 配置时，原始密钥随 JSON 一起流出
- 插件本身不拦截网络请求，密钥仍会以明文形式发往 Anthropic API（除非服务端强制要求 bearer token 加密）
- 无法与 1Password 或 Vault 集成，纯客户端侧掩码，无后端联动能力
真正需要的是「密钥不出现」，而不是「出现了但你看不见」——这点容易被忽略，但恰恰是安全边界的分水岭。
