Varlock Skill（不读密钥的 .env 安全技能）

它是什么

Varlock Skill 是 William Smith 做的单文件技能，教 Claude Code 在不读取密钥的情况下处理它们。它包装的是 Varlock，这是 DMNO 的一个工具，会读取放在 .env 旁边的 .env.schema 文件，并把标为敏感的每个值遮住。开启这个技能后，Claude 通过运行 varlock load 来确认某个密钥已经设置。它读的是 schema 文件，而不是 .env。

1. 你安装 Varlock 工具和技能文件
2. 你写好 .env.schema，里面不放任何密钥的值
3. 你向 Claude 询问某个密钥，或某个登录问题
4. Claude 运行 varlock load，从不打开 .env
5. Varlock 把每个密钥遮住后再显示

适合谁

在 Claude Code 里做项目、项目的 .env 文件里有 API 密钥、令牌或数据库地址，又不想让这些值出现在聊天里的开发者。小团队也适用，因为 schema 文件不含任何密钥的值，可以提交进仓库。

用在哪里

Claude Code 是它的主场。README 的标题就是为它写的，没有提到别的智能体。

• Claude Code，所有项目：技能文件放在 ~/.claude/skills/varlock/SKILL.md
• 任何有 .env 的项目：Varlock 工具在你的 PATH 上，项目里有一个 .env.schema
• GitHub Actions：一个运行 varlock load --quiet 的步骤
• Docker：在镜像里装好 Varlock，用 varlock run 作为容器的启动命令

如何设置

你要装两样东西。Varlock 工具负责遮住密钥，技能文件告诉 Claude 什么时候用它。点“获取”会把一个 zip 压缩包存进你的下载文件夹，里面是 Mindket 写的安装说明。

1. 安装 Varlock 工具。运行 README 里的安装命令，再把它的文件夹加进 PATH。
2. 加入技能文件。一行命令建好 ~/.claude/skills/varlock，并把 SKILL.md 存进去。
3. 为项目写一个 schema。运行 varlock init，根据你的 .env 生成 .env.schema，或者手写。
4. 检查安装。先运行 varlock --version，再运行 varlock load。在 Claude Code 里，/skills 应该会列出 varlock。

curl -sSfL https://varlock.dev/install.sh | sh -s -- --force-no-brew
export PATH="$HOME/.varlock/bin:$PATH"

第一行在 Varlock 的安装脚本下载完的那一刻就会运行它，所以粘贴之前先读一下 Good to know。技能文件说，要把 export 这一行加进 ~/.zshrc 或 ~/.bashrc。

mkdir -p ~/.claude/skills/varlock && curl -sSL https://raw.githubusercontent.com/wrsmith108/varlock-claude-skill/main/skills/varlock/SKILL.md -o ~/.claude/skills/varlock/SKILL.md

README 的第二种方式是把仓库克隆到 /tmp，把 skills/varlock 复制进 ~/.claude/skills/，再删掉克隆。先用 mkdir -p 建好 ~/.claude/skills。在还没有这个文件夹的电脑上，cp -r 会把新文件夹命名为 skills，SKILL.md 就会高出一层。

如何使用

用平常的话问 Claude 你的密钥。技能加载后，Claude 会用 varlock，而不是 echo、cat 或 printenv。

示例

你的应用付款失败，你怀疑 .env 里少了 Stripe 密钥。

Is my Stripe key set? Do not show me the value.

Claude 运行 varlock load，看到 STRIPE_SECRET_KEY 标为敏感、值已遮住，然后告诉你它已经设置。

如果那一行显示这个变量缺失，Claude 会直说，并请你自己把值加进 .env。它不会替你写这个值。

新手与专家

新手：.env 文件用明文存着你的密钥。Claude 一旦读了它，每个密钥都会进到聊天里。Varlock 把这件事拆成两半。schema 文件写明每个变量、它的类型，以及它是不是密钥。它不含任何密钥的值。varlock load 命令检查真正的 .env，给出遮住后的结果。先在一个小项目里试，运行 varlock init。

专家：schema 开头是一行全局设置，之后每个变量上方有一行注解。技能文件列了七种类型：string、string(startsWith=X)、string(contains=X)、url、port、boolean 和 enum(a,b,c)。值可以来自一条命令，在 schema 里写成 exec(...)。下面是技能文件里用于 1Password、AWS，以及按环境取值的几行：

# @type=string @sensitive
API_KEY=exec('op read "op://vault/item/field"')

# @type=string @sensitive
DB_PASSWORD=exec('aws secretsmanager get-secret-value --secret-id prod/db')

# @type=url
API_URL=env('API_URL_${NODE_ENV}', 'http://localhost:3000')

技能文件的 GitHub Actions 示例把密钥作为 env 传进去，再运行 varlock load --quiet。它的 Docker 示例在镜像里装好 Varlock，用 varlock run 启动应用。它的 npm scripts 示例把 varlock load 接进 prestart 脚本。

注意事项

这个技能是请 Claude 守规矩，它不是一把锁。

• 约束力：仓库里只有一个 SKILL.md 和一个插件清单，没有任何钩子或脚本会阻止读取 .env。只有 Claude 照着做，技能才起作用
• 安装命令：README 里安装 Varlock 的那一行会取回 https://varlock.dev/install.sh，直接交给 sh 执行。脚本会立刻以你的用户身份运行，你还没来得及读它。想先读，就先在浏览器里打开这个地址
• Windows：README 的命令是按 bash 写的，没有给 Windows 步骤
• 密钥归你管：Claude 会拒绝修改密钥，并请你去 .env 或密钥管理工具里改
• 没收尾的地方：技能文件的密钥轮换示例调用了一个 update-github-secrets.sh 脚本，最后一节还指向一个 Clerk 技能和一个 Docker 技能。仓库里这些都没有
• 作者：William Smith，MIT 许可证，版本 1.0.0，按文件自己的注明，最后更新于 2025 年 12 月 22 日。Varlock 本身属于 DMNO。这是社区项目，并非 Anthropic 制作或背书