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_VIEW: Disables Agent View.CLAUDE_CODE_DISABLE_WORKFLOWSCLAUDE_CODE_EXPERIMENTAL_OBSERVER_AGENTS: Agents that watch a session rather than act in it.CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS
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.