# permissionMode Option

> The option that sets the mode for what needs a yes.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** permissionMode, permission_mode, Agent SDK permission mode, Claude Agent SDK permissionMode

## Think of it like

It is like how much a new helper may do on their own.

## Definition

permissionMode is the Agent SDK option that sets how much the agent may do with no approval. In Python it is permission_mode. In default mode, calls that need approval go to your canUseTool callback, and with no callback they are denied. acceptEdits lets file edits through. The other modes work as they do in Claude Code. You can change it mid-session.

## Example

Leo's agent runs in a test box in CI that is thrown away after. He uses bypass mode there, and default mode on his laptop.

## Why it matters

The same agent needs a tight leash on a laptop and a loose one in a sandbox.

## Common mistake

Using default with no callback and wondering why calls are denied. With no callback, default denies.

## Three principles

- **Picks the mode.** Six choices.
- **default needs a callback.** Or it denies.
- **Change it mid-session.** setPermissionMode.

## Related terms

- [Permission Mode](https://learn.benibix.com/term/ai/permission-mode)
- [canUseTool Callback](https://learn.benibix.com/term/ai/can-use-tool-callback)
- [allowDangerouslySkipPermissions Option](https://learn.benibix.com/term/ai/allow-dangerously-skip-permissions-option)
- [Bypass Permissions Mode](https://learn.benibix.com/term/ai/bypass-permissions-mode)

---

Source: https://learn.benibix.com/term/ai/permission-mode-option
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
