CLAUDE_CODE_AGENT_VIEW_RELAUNCH

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_AGENT_VIEW_RELAUNCH is a Claude Code environment variable: Force-relaunches the Agent View UI component when it gets into a bad state. The Agent View is a separate surface from the main session; this is its dedicated restart trigger. If Agent View freezes or loses sync with active agents, this resets it without killing your session. Added between v2.1.138 and v2.1.143 and still present in v2.1.294. It is not in the official reference.

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_AGENT_VIEW_RELAUNCH=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_AGENT_VIEW_RELAUNCH": "<value>"
  }
}

Release notes that mention it

• Claude Code v2.1.143 — 27 New Env Vars, /goal, Agent View, and a Free Model Upgrade

Related variables

• CLAUDE_CODE_DISABLE_AGENT_VIEW: Disables Agent View.
• 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_CODE_AGENT: Full agent descriptor passed into a spawned agent process — likely the agent's frontmatter (tools, allowed/disallowed lists, system prompt path) so the child can reconstruct its runtime without re-reading disk.
• CLAUDE_CODE_AGENT_COST_STEER: Controls cost-aware behavior for subagent delegation.

Frequently asked questions

All variables, searchable: Claude Code environment variables.