CLAUDE_CODE_DISABLE_AGENTS_FLEET
Updated by Alex Sorokoletov
CLAUDE_CODE_DISABLE_AGENTS_FLEET is a Claude Code environment variable: Kill switch for the entire agent fleet subsystem — no selection, no auto-relaunch, no fleet coordination. Its existence implies the fleet is on by default for some plan tiers. Removed between v2.1.138 and v2.1.143, so current releases ignore it. It is not in the official reference.
| Status | Removed between v2.1.138 and v2.1.143 |
|---|---|
| Added | Added between v2.1.118 and v2.1.123 |
| Category | Agents and subagents |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_DISABLE_AGENTS_FLEET=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_DISABLE_AGENTS_FLEET": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.143 — 27 New Env Vars, /goal, Agent View, and a Free Model Upgrade
- Claude Code v2.1.123 — Background Daemons, Agent Fleets, and CoWork Memory
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
Related variables
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS: Disable built-in agent types.CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTSCLAUDE_AGENTS_AUTO_RELAUNCHED_AT: Timestamp set when the agent fleet was automatically relaunched after a crash.CLAUDE_AGENTS_SELECT: Selects which agents from a fleet configuration are active for this session or job.CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES: Set to 1 to turn off agent progress summaries; when set, the summary timer returns early and the subagent's progress summary is dropped.CLAUDE_CODE_DISABLE_AGENT_VIEW: Disables Agent View.CLAUDE_CODE_DISABLE_SUBAGENT_HANDBACK: When set, turns off subagent handback; when unset, the value falls back to CLAUDE_CODE_SENDMESSAGE_HANDBACK and then to a server-side setting.CLAUDE_CODE_DISABLE_WORKFLOWS
Frequently asked questions
What does CLAUDE_CODE_DISABLE_AGENTS_FLEET do?
Kill switch for the entire agent fleet subsystem — no selection, no auto-relaunch, no fleet coordination. Its existence implies the fleet is on by default for some plan tiers.
Which Claude Code version has CLAUDE_CODE_DISABLE_AGENTS_FLEET?
Removed between v2.1.138 and v2.1.143, so current releases ignore it.
How do I set CLAUDE_CODE_DISABLE_AGENTS_FLEET?
Export it before starting Claude Code (export CLAUDE_CODE_DISABLE_AGENTS_FLEET=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.