bypassPermissions

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

What it is

Presence across releases

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Changelog entries naming it

1. v2.1.247Preview refuses a Chrome binary the session could have written

   Preview refuses any Chrome binary sitting somewhere the session could have written to.

   named in this entry

2. v2.1.227Auto-mode guidance reminders now also appear in bypassPermissions

   Bypass permissions mode now gets the same guidance reminders auto mode gets.

   named in this entry

3. v2.1.225The bypassPermissions consent flag reaches startup mode resolution

   Setting defaultMode to bypassPermissions now works in VS Code when you have enabled the consent setting.

   named in this entry

4. v2.1.225VS Code-owned sessions get their own settings defaultMode handling

   In VS Code sessions, unsafe default permission modes from settings are refused and fall back to normal.

   named in this entry

5. v2.1.223Circuit breakers carry declared traits instead of hard-coded name checks

   Peer-machine isolation prompts now survive bypass permissions mode and are never auto-approved.

   named in this entry

6. v2.1.223Permission circuit breakers now have a capability table

   Peer-machine isolation prompts now still appear even when you're running in bypass-permissions mode.

   named in this entry

Documentation pages

• Set up Claude Code for your organization mentions it Claude Code CLI
• How the agent loop works mentions it Claude Code CLI
• Connect to external tools with MCP mentions it Claude Code CLI
• Configure permissions mentions it Claude Code CLI
• Agent SDK reference - Python mentions it Claude Code CLI
• Subagents in the SDK mentions it Claude Code CLI
• Agent SDK reference - TypeScript mentions it Claude Code CLI
• Handle approvals and user input mentions it Claude Code CLI
• Manage multiple agents with agent view mentions it Claude Code CLI
• Claude Code changelog mentions it Claude Code CLI
• Push events into a running session with channels mentions it Claude Code CLI
• Claude apps gateway configuration mentions it Claude Code CLI

A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.