结论先说
- 先用
permissions.deny硬性封锁真实密钥文件:在.claude/settings.json中拒绝Read(./.env)和各环境变体文件,官方规定deny优先级最高,命中后模型无法读取真实密钥。 - 用
.env.example承担「变量名契约」角色:只保留键名、格式注释与占位符,在CLAUDE.md中约定新增或修改环境变量一律写进模板文件,再由开发者同步到本机.env。 - 同时堵住命令行旁路读取:仅拦
Read工具不够,建议在deny中一并加入Bash(cat .env)、Bash(printenv)与Bash(env),防止排查报错时通过终端命令打印密钥。 - 本地运行测试无需模型看见密钥明文:让测试框架(如 Vitest、Pytest 或 Docker Compose)在系统层自动加载
.env,Claude Code 只需观察退出码与报错堆栈即可改好代码。 - 高频多轮联调注意订阅配额准备:长链路调试对 5 小时窗口消耗较快,国内开发者若缺少外币卡,可通过本站 Claude Code 订阅专区 或 Claude Pro 自助充值 免密开通。

图:本站根据 Claude Code 官方文档:Configure permissions 整理的示意图
本文根据 Claude Code 官方文档《Configure permissions》《Claude Code settings》《How Claude remembers your project》《Security》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 本地开发联调时需要核对环境变量名,但不希望 Claude Code 把真实
.env密钥读进上下文的开发者; - 团队共用代码仓库,想通过提交
.claude/settings.json统一拦截敏感配置文件的项目负责人; - 配了拒绝规则后,Claude Code 因读不到配置而卡住联调,想用
.env.example顺畅替代的人。
一、为什么单靠口头叮嘱拦不住读取 .env
很多开发者习惯在对话里叮嘱「不要读 .env」,或只在 CLAUDE.md 写提示约束。按官方权限与记忆文档的设计,CLAUDE.md 属于给模型的上下文引导,不是强制访问控制;一旦本地服务报缺少环境变量或数据库连接失败,模型为了定位问题,仍可能调用读取工具去查看 .env。
要把防线变成硬规则,必须使用 settings.json 里的 permissions 配置。官方写明评估顺序固定为先查 deny、再查 ask、最后查 allow。只要路径命中 deny,无论处于常规模式还是自动编辑模式,读取请求都会被直接拦截。拦截后的规则来源核查见 Claude Code 命令被拦不知道哪条规则生效怎么办。
二、目录结构与 settings.json 规则写法
注意通配符细节:Read(./.env.*) 会同时命中 .env.local、.env.production 与 .env.example,而 deny 永远压过 allow。想放行 .env.example,最稳妥的做法是在 deny 中按环境列出敏感文件名(或把模板改名为 env.example)。在 .claude/settings.json 中可这样配置:
json
{
"permissions": {
"allow": ["Read(./.env.example)", "Edit(./.env.example)"],
"deny": [
"Read(./.env)",
"Read(./.env.local)",
"Read(./.env.development)",
"Read(./.env.production)",
"Edit(./.env)",
"Edit(./.env.local)",
"Bash(cat .env*)",
"Bash(grep * .env*)",
"Bash(printenv*)",
"Bash(env)"
]
}
}
保存后输入 /permissions 即可确认生效条目。更多配置层级优先级见 Claude Code settings.json 配置详解。
三、写好 .env.example 与 CLAUDE.md 映射约定
拦住 .env 后,需在 .env.example 里写清键名和格式占位符,清空真实凭据:
ini
DATABASE_URL="postgresql://dev_user:CHANGE_ME@localhost:5432/app_dev"
STRIPE_SECRET_KEY="sk_test_placeholder"
JWT_SIGNING_SECRET="32_bytes_hex_placeholder"
接着在根目录 CLAUDE.md 中补上协作规则:
markdown
## 环境变量与本地联调约定
- 真实 `.env` 与 `.env.local` 已被权限锁定禁止访问,请勿尝试读取或打印环境变量。
- 核对变量名或格式时只读 `.env.example`;新增配置项先写入 `.env.example`,再提醒我同步本机 `.env`。
- 执行测试命令时运行时会自动加载 `.env`,请根据报错堆栈直接排查业务代码。
这样接口报配置错误时,Claude Code 会比对 .env.example 与代码键名拼写,不会触发权限拦截。数据库只读账号搭配做法见 Claude Code 写后端接口、连数据库。
订阅与账号准备提示:后端安全联调往往伴随密集检索与多轮测试重试。若基础配额频繁触发窗口限制、国内又不便绑定境外卡,可在本站选购 Claude Pro iOS 免上号自助卡密(无需交出密码),重度全栈开发可升级 Claude Max 订阅服务。
四、联调排错决策与旁路防漏自查

图:本站根据 Claude Code 官方文档:Security 与权限规则整理的示意图
实际联调时,建议对照下表排查常见旁路风险(本站根据终端运行机制补充):
| 风险场景 | 泄露原因 | 对应加固做法 |
|---|---|---|
启动 claude 前执行了 source .env | 父 Shell 已载入密钥,测试若打印 process.env 会回显到上下文 | 不在父 Shell 导出线上密钥,改由框架在子进程内按需加载 |
| ORM 异常把连接串原样打到控制台 | 超时报错消息里拼入了含密码的 DATABASE_URL | 本地 .env 只填本机容器弱口令或沙盒测试号,不放生产库密码 |
| 普通测试命令每次都弹窗确认 | 配好拒绝规则后常规测试命令未放行 | 在 allow 放行 Bash(npm test*),详见 别让 Claude Code 一直问你能不能执行 |
常见问题
问:.gitignore 里写了 .env,还需要配 permissions.deny 吗?
答:需要。.gitignore 只控制 Git 跟踪和默认搜索,模型看到代码里的 dotenv 调用后若点名执行 Read(./.env),没有 deny 规则仍可能请求读取。
问:封锁 Read(./.env) 后,Claude Code 跑 npm run dev 还能读到配置吗?
答:可以。Read 限制的是 Claude Code 内置工具,不阻止 Node.js 或 Python 进程在操作系统层读取本地 .env。只要程序不把密钥明文打印出来,联调完全正常。
问:本地 settings.local.json 写 allow 能覆盖项目里的 deny 吗?
答:不能。按官方文档,任何层级的 deny 规则都优先于 allow,本地放行无法解除共享设置里已声明的拒绝项。
问:国内没有外币卡,或公司采购 Claude Code 需要开增值税发票怎么办理?
答:可通过本站 AI 会员充值总览 或 Claude Code 订阅页 办理,支持支付宝、微信支付及 AlipayHK,提供免密自助卡密兑换与团队方案,并可按需开具国内报销用的增值税发票。实时价格以页面展示为准;订阅期内若掉订阅按剩余天数折退,因违反官方条款导致的封号不在质保范围内。
相关教程
- Claude Code settings.json 配置详解:文件位置、优先级与常用示例
- Claude Code 命令被拦不知道哪条规则生效怎么办:/permissions 查看规则来源与沙箱网络白名单排错
- 别让 Claude Code 一直问你能不能执行:选 don't ask again、写 allow 规则、切 acceptEdits 或 auto 模式
- Claude Code 写后端接口、连数据库:只读账号加 MCP 查表结构,用拒绝规则和钩子保护 .env 与迁移目录
参考资料
- Claude Code 官方文档:Configure permissions — https://code.claude.com/docs/en/permissions
- Claude Code 官方文档:Claude Code settings — https://code.claude.com/docs/en/settings
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
- Claude Code 官方文档:Security — https://code.claude.com/docs/en/security
0 条评论
还没有评论,来抢沙发~