[DOCS] Inconsistency: Missing `allow_dangerously_skip_permissions` in Python SDK `ClaudeAgentOptions` reference

Documentation Type

Unclear/confusing documentation

Documentation Location

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

Section/Topic

The ClaudeAgentOptions configuration dataclass in the Python SDK reference vs. the Options type in the TypeScript SDK reference.

Current Documentation

TypeScript Reference (typescript.md):
Lists the property:

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

Python Reference (python.md):
The ClaudeAgentOptions dataclass and the subsequent parameters table do not include allow_dangerously_skip_permissions. However, the PermissionMode type for Python still includes "bypassPermissions".

What's Wrong or Missing?

There is a "Safety Gate" inconsistency between the two SDKs.

In the TypeScript SDK, documentation explicitly states that allowDangerouslySkipPermissions is required to use the bypassPermissions mode. In the Python documentation, this safety boolean is missing entirely from the ClaudeAgentOptions definition.

If the Python SDK requires this field for feature parity and security compliance (as a "double confirmation" for high-risk actions), its absence in the documentation will lead to runtime errors for developers attempting to implement bypass modes.

Suggested Improvement

Update the ClaudeAgentOptions class definition and the parameter table in docs/en/agent-sdk/python.md to include the missing field.

Suggested text for Python dataclass snippet:

@dataclass
class ClaudeAgentOptions:
    # ... existing fields
    allow_dangerously_skip_permissions: bool = False
    # ... existing fields

Suggested row for the Python parameters 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

This inconsistency is particularly high-severity because it involves security permissions. Developers looking at the TypeScript documentation might assume the logic carries over to Python (which is standard for Anthropic's SDKs), but the current Python reference provides no way to discover the correct snake_case parameter name or its requirement.

Related Documentation Links:

• TypeScript Options Reference
• Python ClaudeAgentOptions Reference