CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME
Updated by Alex Sorokoletov
CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME is a Claude Code environment variable: Passes the current Agent Teams team name (prefixed assistant-) to a spawned child process. Agent Teams surfaces in the UI as "Agent Teams is not yet available on your plan" and "Teammates cannot spawn other teammates." Backs v2.1.114's teammate permission-dialog crash fix. Added in v2.1.108 and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Added in v2.1.108 |
| 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_INTERNAL_ASSISTANT_TEAM_NAME=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.118 — 10 New Environment Variables: Forked Subagents Ship, Subscription Tiering Takes Shape
- Claude Code v2.1.114 — Native Binary Launcher, /fewer-permission-prompts, and 20 New Environment Variables
- Claude Code v2.1.108 — 4 New Environment Variables: REPL Variants, Skill Discovery, and the Limits Reckoning
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
Related variables
CLAUDE_CODE_TEAM_ONBOARDING: Replaced by newer onboarding paths (CLAUDE_CODE_POWERUP_ONBOARDING, /doctor's CLAUDE.md-trimming check).CLAUDE_WORKFLOW_NAME_ONLY: Restricts a remote/headless run to a single named workflow.CLAUDE_AGENT: Short-form identifier for the current agent, used in inter-agent messaging and log attribution.CLAUDE_AGENT_SDK_CLIENT_APP: Client application name.CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS: Disable built-in agent types.CLAUDE_AGENT_SDK_MCP_NO_PREFIX: Don't prefix MCP tool names with server name.CLAUDE_AGENT_SDK_VERSION: Agent SDK version sent in User-Agent header.CLAUDE_AGENTS_AUTO_RELAUNCHED_AT: Timestamp set when the agent fleet was automatically relaunched after a crash.
Frequently asked questions
What does CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME do?
Passes the current Agent Teams team name (prefixed assistant-) to a spawned child process. Agent Teams surfaces in the UI as "Agent Teams is not yet available on your plan" and "Teammates cannot spawn other teammates." Backs v2.1.114's teammate permission-dialog crash fix.
Which Claude Code version has CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME?
Added in v2.1.108 and still present in v2.1.294.
How do I set CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME?
Export it before starting Claude Code (export CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME=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.