[DOCS] Python SDK Reference missing `allow_dangerously_skip_permissions` field in ClaudeAgentOptions

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://platform.claude.com/docs/en/agent-sdk/python

Section/Topic

ClaudeAgentOptions dataclass definition and property table

Current Documentation

The ClaudeAgentOptions dataclass lists permission_mode but omits the safety flag:

@dataclass
class ClaudeAgentOptions:
    tools: list[str] | ToolsPreset | None = None
    allowed_tools: list[str] = field(default_factory=list)
    system_prompt: str | SystemPromptPreset | None = None
    mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)
    permission_mode: PermissionMode | None = None
    # ... (no allow_dangerously_skip_permissions field)

What's Wrong or Missing?

The TypeScript SDK documents allowDangerouslySkipPermissions as required when using permissionMode: 'bypassPermissions':

| `allowDangerouslySkipPermissions` | `boolean` | `false` | Enable bypassing permissions. Required when using `permissionMode: 'bypassPermissions'` |

The Python SDK documentation does not include the equivalent allow_dangerously_skip_permissions field. This creates a parity gap between the SDKs for a security-sensitive feature. Users following the Python SDK documentation cannot safely enable bypassPermissions mode because the required safety flag is not documented.

Suggested Improvement

Add allow_dangerously_skip_permissions to the ClaudeAgentOptions dataclass definition:

@dataclass
class ClaudeAgentOptions:
    # ... existing fields ...
    permission_mode: PermissionMode | None = None
    allow_dangerously_skip_permissions: bool = False
    # ... remaining fields ...

Add to the property table:

| Property | Type | Default | Description |
| :------- | :--- | :------ | :---------- |
| allow_dangerously_skip_permissions | bool | False | Enable bypassing permissions. Required when using permission_mode='bypassPermissions' |

Impact

High - Prevents users from using a feature

Additional Context

• TypeScript SDK reference (documents the field): https://platform.claude.com/docs/en/agent-sdk/typescript
• CLI reference (has corresponding --allow-dangerously-skip-permissions flag): https://code.claude.com/docs/en/cli-reference