Summary
When running a cloud session in Claude Code on the web with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 set in committed project-level .claude/settings.json, the team tools (TeamCreate, SendMessage, spawnTeam, TeammateTool) are not injected. Asking the agent to create a team produces the standard "Agent Teams feature is not available on this plan" message. Task tools (TaskCreate, TaskUpdate, etc.) work correctly in the same session, indicating the env var is being read but team-tool gating has additional non-honored conditions in the cloud runtime.
Repro
- On the default branch of a repo, add to
.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
"CLAUDE_CODE_ENABLE_TASKS": "1"
}
}
- Commit and push.
- Start a fresh Claude Code on the web session against that branch.
- In the session, confirm the env var is present in the runtime shell (e.g.,
echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS → 1). Verified set.
- Observe available tools:
- Task tools (
TaskCreate, TaskUpdate, TaskList, TaskGet) are available.
- Team tools (
TeamCreate, SendMessage, spawnTeam, TeammateTool) are not available.
- Asking the agent to create a team returns "Agent Teams feature is not available on this plan."
Expected
With CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 correctly plumbed through to the cloud runtime, team tools should be injected — matching CLI behavior. At minimum, if there is a cloud-specific incompatibility, the user-facing message should be accurate ("not supported in cloud sessions") rather than "not available on this plan."
Environment
- Claude Code on the web (cloud session, default branch)
- Env var confirmed set in cloud runtime
- Same flag works correctly on local CLI
Related
Notes
The agent-teams docs cover display modes (in-process / tmux / iTerm2) but do not document cloud as supported or unsupported. Either supporting team tools in cloud sessions, or explicitly documenting cloud as unsupported with an accurate user-facing message, would resolve the confusion.
Summary
When running a cloud session in Claude Code on the web with
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1set in committed project-level.claude/settings.json, the team tools (TeamCreate,SendMessage,spawnTeam,TeammateTool) are not injected. Asking the agent to create a team produces the standard "Agent Teams feature is not available on this plan" message. Task tools (TaskCreate,TaskUpdate, etc.) work correctly in the same session, indicating the env var is being read but team-tool gating has additional non-honored conditions in the cloud runtime.Repro
.claude/settings.json:{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1", "CLAUDE_CODE_ENABLE_TASKS": "1" } }echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS→1). Verified set.TaskCreate,TaskUpdate,TaskList,TaskGet) are available.TeamCreate,SendMessage,spawnTeam,TeammateTool) are not available.Expected
With
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1correctly plumbed through to the cloud runtime, team tools should be injected — matching CLI behavior. At minimum, if there is a cloud-specific incompatibility, the user-facing message should be accurate ("not supported in cloud sessions") rather than "not available on this plan."Environment
Related
process.stdout.isTTY) for both task and team tools in non-CLI hosts. Tasks now work in cloud, suggesting that gate has been lifted for tasks but not for teams.Notes
The agent-teams docs cover display modes (in-process / tmux / iTerm2) but do not document cloud as supported or unsupported. Either supporting team tools in cloud sessions, or explicitly documenting cloud as unsupported with an accurate user-facing message, would resolve the confusion.