From 734ce2eeb8464337524b0a2db8abf610c4a8685b Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Tue, 13 Oct 2026 15:11:14 +0200 Subject: [PATCH] docs: document thinking variants for sandbox models (#26292) Document how to select a model reasoning level with `sbx run --variant`, with an example and the relevant agent limitations. Validation: Markdown and style checks pass. Generated by Codex. --- .../ai/sandboxes/configuration/models.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/content/manuals/ai/sandboxes/configuration/models.md b/content/manuals/ai/sandboxes/configuration/models.md index 7b640bee6f..74c7eecc89 100644 --- a/content/manuals/ai/sandboxes/configuration/models.md +++ b/content/manuals/ai/sandboxes/configuration/models.md @@ -186,6 +186,25 @@ Changing the model recreates the sandbox container. The workspace and kit-owned volumes persist. Omit `--provider` to select a local model managed by `llmman`. +## Choose a reasoning level + +Use `--variant` with `--model` to select a reasoning level supported by your +model. For example, replace `` with an OpenAI model that supports +`high` reasoning effort to start Codex at that level: + +```console +$ sbx run --provider openai --model --variant high codex +``` + +Available values depend on the model and agent. Reasoning levels are `minimal`, +`low`, `medium`, `high`, `xhigh`, and `max`. Some models support `none` to disable +thinking or `thinking` to enable it. Omit `--variant` to use the default. + +Claude Code doesn't support `none` or `minimal`. For Claude Code and Codex, +`--variant` requires an attached session and can't be combined with `--detach`. +In OpenCode, it selects the initial variant, which you can change inside +OpenCode. + ## Use another provider for larger requests Pair a local model with another provider to handle requests that exceed the