🧩ClaudeAgentOptions
Also known as Options (TypeScript), Agent SDK options object
The one object that holds all the settings for a session.
Think of it like
It is like the list of house rules you give a sitter.
Example
Leo wants a safe agent that only reads code. He sets allowed_tools to Read and Glob in ClaudeAgentOptions.
Why it matters
It is where you decide what the agent may do, how far it may go and what it costs.
Definition
Example code
python
options = ClaudeAgentOptions(
allowed_tools=["Read", "Glob"],
max_turns=5,
)Common mistake
Key takeaways
- 1All fields optional. Defaults apply.
- 2Options in TypeScript. Same fields, camelCase.
- 3No temperature. Use effort.