CLAUDE_BG_SESSION_PERMISSION_RULES
Updated by Alex Sorokoletov
CLAUDE_BG_SESSION_PERMISSION_RULES is a Claude Code environment variable. Added between v2.1.143 and v2.1.212 and still present in v2.1.295. It is not in the official reference.
| Status | Present in v2.1.295 |
|---|---|
| Added | Added between v2.1.143 and v2.1.212 |
| Category | Permissions and sandbox |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_BG_SESSION_PERMISSION_RULES=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_BG_SESSION_PERMISSION_RULES": "<value>"
}
}Related variables
CLAUDE_CHROME_PERMISSION_MODE: Permission mode for Claude for Chrome.CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKSCLAUDE_CODE_ADOPT_UNDERIVABLE_PARKED_PERMISSIONCLAUDE_CODE_HOLD_UNANSWERED_PARKED_PERMISSIONCLAUDE_CODE_PARKED_PERMISSION_WAIT_MSCLAUDE_CODE_RC_PERMISSION_NUDGECLAUDE_CODE_RETIRE_UNANSWERED_PARKED_PERMISSIONCLAUDE_CODE_AUTO_MODE_CLASSIFY_EDITS: Turns the classification pass on: every edit runs through the classifier before it touches disk.
Frequently asked questions
Which Claude Code version has CLAUDE_BG_SESSION_PERMISSION_RULES?
Added between v2.1.143 and v2.1.212 and still present in v2.1.295.
How do I set CLAUDE_BG_SESSION_PERMISSION_RULES?
Export it before starting Claude Code (export CLAUDE_BG_SESSION_PERMISSION_RULES=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.