Qwen Code settings.json settings

The preferred editor to open files in.

string; default undefined

Name of the output style (built-in Concise, Proactive, Explanatory, Learning, or a custom style).

string; default undefined

Enable Vim keybindings.

boolean; default false

Enable automatic update checks and installations on startup.

boolean; default true

Auto-show a one-line "where you left off" recap when returning to the terminal.

boolean; default false

Add a Co-authored-by trailer and a per-file AI-attribution git note to commits made through Qwen Code.

boolean; default true

Append a Qwen Code attribution line to pull request descriptions when running gh pr create.

boolean; default true

Language for the user interface; "auto" detects from system settings. Requires restart.

enum; default "auto"

Language for model output; "auto" detects from system settings. Requires restart.

string; default "auto"

Save chat history to disk. Disabling this also prevents --continue and --resume from working.

boolean; default true

The format of the CLI output.

string; values "text", "json", "stream-json"; default "text"

Default effort for /review when neither --effort nor a remembered level applies.

enum: low, medium, high, auto; default "auto"

The color theme for the UI.

string; default "Qwen Dark"

Custom theme definitions.

object; default {}

Custom status line configuration (supports command, refreshInterval, respectUserColors, hideContextIndicator).

object; default undefined

Hide the window title bar.

boolean; default false

Hide all tips (startup and post-response) in the UI.

boolean; default false

Hide the startup ASCII logo and info panel.

boolean; default false

Show line numbers in code blocks in the CLI output.

boolean; default true

Default Markdown display mode: "render" for rich previews or "raw" for source-oriented Markdown.

string; default "render"

Show welcome back dialog when returning to a project with conversation history.

boolean; default true

Enables screen reader mode, which adjusts the TUI for better compatibility with screen readers.

boolean; default false

Enable followup suggestions that predict what you want to type next after the model responds.

boolean; default true

Render conversation history in an in-app scrollable viewport instead of the terminal scrollback buffer.

boolean; default true

Enable in-app SGR mouse tracking.

boolean; default true

Enable IDE integration mode.

boolean; default false

Enable collection of usage statistics.

boolean; default true

The Qwen model to use for conversations.

string; default undefined

How hard reasoning-capable models think, applied across all providers; set with /effort.

enum: low, medium, high, xhigh, max; default undefined

Maximum recorded prompt token count allowed before sending the next message; -1 means unlimited.

number; default -1

Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.

integer; default -1

Wall-clock budget for headless / unattended runs, in seconds; overridable via --max-wall-time.

number; default -1

Cumulative tool-call budget for a run; -1 unlimited, 0 no tool calls. Aborts with exit code 55.

number; default -1

Maximum sub-agent nesting depth (1-based levels); values clamp to 1-100.

number; default 5

Advanced overrides passed to the underlying content generator (timeout, maxRetries, samplingParams, etc.).

object; default undefined

Enables logging of OpenAI API calls for debugging and analysis.

boolean; default false

Custom directory path for OpenAI API logs; defaults to logs/openai.

string; default undefined

Model used for generating prompt suggestions and speculative execution; empty uses the main model.

string; default ""

Model used by /advisor for second-opinion reviews of the conversation.

string; default ""

Image-capable model used as the vision bridge when a text-only main model receives an image.

string; default ""

Model used for chat compression (auto-compaction). Leave empty to fall back to the main model.

string; default ""

Model used by the built-in image_gen tool.

string; default ""

Model used for voice transcription; voice dictation stays disabled until one is selected.

string; default ""

Ordered fallback model IDs (comma-separated, max 3) tried on capacity errors (429/503/529).

string; default ""

Optional per-model pricing for cost estimation in /stats model.

object; default undefined

The name of the context file(s).

string or array of strings; default undefined

Target fraction of the context window at which auto-compaction triggers.

number; default undefined (uses internal 0.85)

Additional directories to include in the workspace context.

array; default []

Controls whether /memory refresh loads QWEN.md files from all added directories.

boolean; default false

Respect .gitignore files when searching.

boolean; default true

Respect .qwenignore and configured custom ignore files when searching.

boolean; default true

When true, enables fuzzy search capabilities when searching for files.

boolean; default true

Sandbox execution environment (can be a boolean or a path string).

boolean or string; default undefined

Sandbox image URI used by Docker/Podman when --sandbox-image and QWEN_SANDBOX_IMAGE are unset.

string; default undefined

Use node-pty for an interactive shell experience.

boolean; default mode-based

Deprecated. Will be removed in next version.

array of strings; default undefined

Deprecated. Use permissions.deny instead.

array of strings; default undefined

Deprecated. Use permissions.allow instead.

array of strings; default undefined

Sets the default approval mode for tool usage.

string; default auto

Command to run for tool discovery.

string; default undefined

Command to run for calling a discovered tool.

string; default undefined

Use ripgrep for file content search instead of the fallback implementation.

boolean; default true

Enable the Workflow tool, which lets the model author and run scripts that orchestrate subagents.

boolean; default false

Truncate tool output if it is larger than this many characters.

number; default 25000

Enable background extraction of memories from conversations.

boolean; default true

Enable automatic consolidation (deduplication and cleanup) of collected memories.

boolean; default true

Enable a project memory tier shared with collaborators via the git-tracked .qwen/team-memory/ directory.

boolean; default false

Rules for auto-approved tool calls (no confirmation needed).

array of strings; default undefined

Rules for tool calls that always require user confirmation. Takes priority over allow.

array of strings; default undefined

Rules for blocked tool calls. Highest priority - overrides both allow and ask.

array of strings; default undefined

Slash command names to hide and refuse to execute.

array of strings; default undefined

Hard-disabled skill names.

array of strings; default undefined

Explicit skill opt-ins; cancels a matching skills.defaultDisabled entry.

array of strings; default undefined

Command to start an MCP server.

string; default undefined

An allowlist of MCP server names to make available to the model; supports glob patterns.

array of strings; default undefined

A denylist of MCP servers to exclude; a server in both lists is excluded.

array of strings; default undefined

Idle timeout in milliseconds for MCP tool calls (10000 to 3600000).

number; default 300000

Setting to track whether Folder trust is enabled.

boolean; default false

The currently selected authentication type.

string; default undefined

The required auth type (useful for enterprises).

string; default undefined

Environment variables to exclude from project context.

array of strings; default ["DEBUG","DEBUG_MODE"]

Configuration for the bug report command; overrides the default URL for /bug.

object; default undefined

Custom directory for approved Plan Mode files (top-level key).

string; default undefined

Enable in-session cron/loop tools (cron_create, cron_list, cron_delete). Requires restart.

boolean; default true

Enable agent-team collaboration tools for multi-agent coordination. Requires restart.

boolean; default false

The command to execute to start the MCP server via standard I/O.

string; optional

Arguments to pass to the command.

array of strings; optional

Environment variables to set for the server process.

object; optional

The working directory in which to start the server.

string; optional

The URL of an MCP server that uses Server-Sent Events (SSE) for communication.

string; optional

The URL of an MCP server that uses streamable HTTP for communication.

string; optional

A map of HTTP headers to send with requests to url or httpUrl.

object; optional

Timeout in milliseconds for requests to this MCP server.

number; optional

Trust this server and bypass its tool call confirmations in a trusted workspace.

boolean; optional

List of tool names to include from this MCP server (allowlist behavior).

array of strings; optional

List of tool names to exclude from this MCP server.

array of strings; optional

Whether or not telemetry is enabled.

boolean

The endpoint for the OTLP Exporter.

string

The protocol for the OTLP Exporter (grpc or http).

string

Whether or not to include user prompt content and API request/response text in the logs.

boolean

Path to write telemetry to a file. When set, overrides OTLP export.

string

Declares which models are available and how to connect to them; keys are API protocols (openai, anthropic, gemini).

Stores API keys directly in settings.json as a lowest-priority fallback (shell export and .env take precedence).