Agents and Remote Settings
These keys control subagents, workflows, background work, and Remote Control. Use them to start a session as a named agent or to turn off a feature you do not want. Rows marked as undocumented can change in any release.
disableRemoteControl, disableAgentView, and disableWorkflows turn features off.
Keys
Source: Settings Reference for rows marked
Documented: An official docs page names this item.
. For rows marked Undocumented: Only the program shows this item. It can change without notice.
, Source: the program (its bundled settings schema).
Where to Set It tells you which files may set the key. See Settings Files and Scopes.
| Key | Status | Type | Default | What It Does | Where to Set It |
|---|---|---|---|---|---|
agent | Documented: An official docs page names this item. | string | - | Start every session as a named subagent with its prompt, tools, and model. | Any settings file |
agent | Documented: An official docs page names this item. | boolean | - | Let Claude send a push notification to your phone when it decides to. | Any settings file |
ask | Documented: An official docs page names this item. | enum: 60s, 5m, 10m, never | never | Let an unanswered question auto-continue after idle time. Auto-continue runs only when you set 60s, 5m, or 10m. | User or managed settings |
auto | Documented: An official docs page names this item. | boolean | - | Wait in the open session and continue the task automatically after a claude.ai usage limit resets. | User or managed settings |
auto | Undocumented: Only the program shows this item. It can change without notice. Caution: It deletes data, skips a safety check, or sends data off your machine. | boolean | - | Mirror local sessions to claude.ai as view-only, with no remote control. | Settings files |
cross | Documented: An official docs page names this item. | string | - | Choose what happens to messages from your other sessions. accept delivers them. hold parks them for review. refuse opts out. | Any settings file |
daemon | Undocumented: Only the program shows this item. It can change without notice. | enum: transient, ask | - | Choose what happens when no background service runs: transient starts one for this login session. ask offers a permanent install. | Settings files |
dialog | Documented: An official docs page names this item. | enum: 60s, 5m, 10m, never | 5m | Set how long Claude Code waits for Remote Control or an SDK host to answer a forwarded dialog before it cancels the dialog. never removes the deadline. CLAUDE_ wins. | User or managed settings |
disable | Documented: An official docs page names this item. | boolean | - | Turn off background agents and agent view. Matches CLAUDE_. | Any settings file |
disable | Documented: An official docs page names this item. | boolean | - | Turn off Remote Control everywhere it can start. | Any settings file |
disable | Documented: An official docs page names this item. | boolean | - | Turn dynamic workflows off for everyone. Use enable for yourself. Code Review on pull requests and / run in the cloud and stay on. | Any settings file |
done | Undocumented: Only the program shows this item. It can change without notice. | boolean | - | Keep Claude working until the pull request is ready to merge, a timer is set to resume, or it hands you a self-contained next step. | Settings files |
enable | Documented: An official docs page names this item. | boolean | - | Turn dynamic workflows on or off against your plan's default. | Any settings file |
input | Documented: An official docs page names this item. | boolean | - | Get a push notification when Claude is waiting on you. | Any settings file |
isolate | Documented: An official docs page names this item. | boolean | - | Ask you before Claude messages one of your sessions on another machine. | Any settings file |
model | Undocumented: Only the program shows this item. It can change without notice. | string | auto | Control whether the model may propose session goals. auto (the default), always, or disabled. Claude Code ignores project and local settings. | Settings files |
process | Documented: An official docs page names this item. | string | - | Run Claude Code's background processes through a corporate launcher on macOS and Linux. It is the same as CLAUDE_, which wins. Claude Code ignores project and local files. | User or managed settings |
remote | Documented: An official docs page names this item. | object | - | Configure cloud sessions. | Any settings file |
remote | Undocumented: Only the program shows this item. It can change without notice. | object | - | Set options for claude remote-. | Settings files |
remote | Documented: An official docs page names this item. | boolean | - | Connect Remote Control automatically when a session starts. | Any settings file |
remote | Undocumented: Only the program shows this item. It can change without notice. | object | - | Choose how this computer serves tool calls to cloud sessions. | Settings files |
skip | Undocumented: Only the program shows this item. It can change without notice. | boolean | - | Record that you accepted the multi-agent workflow usage warning. Until you set it, auto mode asks before it runs a workflow. | Settings files |
ssh | Documented: An official docs page names this item. | array of object | - | Add SSH connections to the Desktop environment dropdown. | User or managed settings |
ssh | Undocumented: Only the program shows this item. It can change without notice. | array of object | - | SSH connections in the desktop app on macOS and Linux whose host comes from a command. Each entry has id, name, and command, and can have ssh and start. The command runs with no shell and must print only the host (host, user@host, or a JSON object with ssh). Claude Code itself does not use it. New in 2.. Source: the settings schema | User or managed settings |
subagent | Documented: An official docs page names this item. | object | - | Rewrite rows in the subagent task display with your own command. | Any settings file |
teammate | Documented: An official docs page names this item. | string | - | Choose how agent team teammates display. | Any settings file |
ultracode | Documented: An official docs page names this item. | boolean | - | Have Claude plan a workflow for each substantive task without you asking. It lasts one session. It needs workflows on and a model that supports it. | Any settings file |
workflow | Documented: An official docs page names this item. | boolean | true | Let the word ultracode in a prompt start a workflow. Set false to type it without starting one. | Any settings file |
workflow | Documented: An official docs page names this item. | enum: unrestricted, small, medium, large | medium | Set the agent count Claude aims for in dynamic workflows. small aims for fewer than 5 agents, medium fewer than 10, large fewer than 50. This is a hint, not a limit. | Any settings file |
Example
Turn Off Remote Control for Everyone
An administrator puts this in the managed settings file. Remote Control and agent view stay off on that machine.
managed-settings.json
{
"disableRemoteControl": true,
"disableAgentView": true
}
Related Pages
- Settings Files and Scopes explains the scopes, precedence, and managed settings.
- Settings Reference is the official page for each key.
- Subagents covers custom agents.
- Remote Control is the official page for that feature.
- Agents and Teams Variables and Remote and Cloud Session Variables list the matching variables.