petershk/explain-permission
explain-permission
A Claude Code mod that opens a side pane explaining each permission request in plain English with WHAT, WHY and RISK before you approve.
About this mod
explain-permission 是一個 Claude Code 外掛,當 Claude 在執行某項操作前停下來詢問「這樣可以嗎?」時,它會在對話旁開啟一個面板,用白話說明該請求:WHAT(青色)說明實際會在電腦或網路上做什麼;WHY(洋紅色)根據對話內容說明為何需要這項操作;RISK(綠/黃/紅)標示低、中或高風險,並指出任何會被傳送、刪除、發布或付費的內容。對話框會立即出現,說明則在數秒後補上。
使用方式:以 claude --plugin-dir /path/to/explain-permission 啟動,或輸入 /explain-permission 自行開啟面板。全螢幕模式下它停靠在右側,否則位於提示列上方,並在寬度至少 144 欄的終端機自動開啟。
注意事項:需要支援 mods(function hooks,早期存取功能)的新版 Claude Code;每次說明會在你的帳號上多一次模型呼叫,會帶著目前對話詢問 Claude,失敗時改用 Haiku 且不帶對話;它只負責說明,不會代替你核准或拒絕任何請求。
安裝(GitHub):此資料夾同時是外掛市集,可執行 claude plugin marketplace add petershk/explain-permission 與 claude plugin install explain-permission@hermann-mods,或在 Claude Code 內使用 /plugin。需要 Claude Code 2.1.287 以上版本。
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add petershk/explain-permission claude plugin install explain-permission
Original text / README
explain-permission
A Claude Code mod. When Claude stops to ask "is this ok?" before running something, a pane opens beside the conversation and explains the request in plain English:
- WHAT (cyan): what it will actually do on your computer or online
- WHY (magenta): why it's needed for what you asked, based on the conversation
- RISK (green / yellow / red): low, medium or high, and anything that gets sent, deleted, published or paid for
The dialog appears right away; the explanation fills in a few seconds later. Read the pane before you answer.
Use it
claude --plugin-dir /path/to/explain-permission
Type /explain-permission to open the pane yourself. It docks on the right in fullscreen mode, and otherwise sits
above the prompt. It opens by itself on terminals at least 144 columns wide.
Good to know
- Needs a recent Claude Code with mods (function hooks), an early-access feature.
- Each explanation is one extra model call on your own account. It asks Claude, with the conversation so far, and falls back to Haiku without the conversation if that fails.
- It only explains. It never approves or denies anything for you.
Made by Hermann Peterscheck · https://hermann.fyi
Install from GitHub
This folder is also a plugin marketplace. Once it's in a GitHub repo:
claude plugin marketplace add petershk/explain-permission
claude plugin install explain-permission@hermann-mods
or the same with /plugin inside Claude Code. Needs Claude Code 2.1.287 or later.
