Set common options in settings.json

configuration

// what it does

settings.json groups options under top-level keys: model (name, turn limits), ui (theme, footer), tools (sandbox, shell allowlists), context (filename, directories), and mcpServers. Set model.name to auto/pro/flash or a full model id, ui.theme to change appearance, and tools.sandbox to a sandbox backend. Open the editor with /settings or edit the file directly.

// shell

$ /settings

// gotcha

Keys are nested by category, not flat — sandbox lives at tools.sandbox and the model at model.name, so a top-level "sandbox": true is ignored. Unknown keys are dropped silently at load, so a misspelled path never errors, it just does nothing.

// resources