結論先說
- 先用
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 條評論
還沒有評論,來搶沙發~