# ClaudeAgentOptions

> The one object that holds all the settings for a session.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** Options (TypeScript), Agent SDK options object

## Think of it like

It is like the list of house rules you give a sitter.

## Definition

ClaudeAgentOptions is the Python type that holds the settings for a session. In TypeScript it is called Options. Each field is optional. They cover the model, the tools, the permission mode, the system prompt, the limits, MCP servers and hooks. With no options, the session runs on the defaults.

## Example

Leo wants a safe agent that only reads code. He sets allowed_tools to Read and Glob in ClaudeAgentOptions.

## Example code

```python
options = ClaudeAgentOptions(
    allowed_tools=["Read", "Glob"],
    max_turns=5,
)
```

A read-only agent that stops after five turns.

## Why it matters

It is where you decide what the agent may do, how far it may go and what it costs.

## Common mistake

Looking for temperature or max tokens here. They are not options. Set the effort or a budget.

## Three principles

- **All fields optional.** Defaults apply.
- **Options in TypeScript.** Same fields, camelCase.
- **No temperature.** Use effort.

## Related terms

- [query() Function](https://learn.benibix.com/term/ai/query-function)
- [allowedTools Option](https://learn.benibix.com/term/ai/allowed-tools-option)
- [permissionMode Option](https://learn.benibix.com/term/ai/permission-mode-option)
- [maxTurns Option](https://learn.benibix.com/term/ai/max-turns-option)
- [model Option](https://learn.benibix.com/term/ai/model-option)
- [cwd Option](https://learn.benibix.com/term/ai/cwd-option)

---

Source: https://learn.benibix.com/term/ai/claude-agent-options
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.
