Skip to content

claude-code-settings incorrectly treats leftArrowOpensAgents as a settings.json property #6126

Description

@liby

Area with issue?

JSON Schema

✔️ Expected Behavior

claude-code-settings.json should only advertise properties that Claude Code reads from the settings files matched by the catalog, such as **/.claude/settings.json.

Because leftArrowOpensAgents is a global-config preference stored in ~/.claude.json, it should not be declared as a settings.json property.

❌ Actual Behavior

The current schema declares leftArrowOpensAgents, while the catalog associates that schema with **/.claude/settings.json.

Confirmed with Claude Code v2.1.218: Claude Code ignores this key when it is added to ~/.claude/settings.json. The shortcut is instead changed through /config, which persists it in ~/.claude.json. The same storage behavior has also been reported in anthropics/claude-code#75899.

This matches the current Claude Code documentation:

The official Anthropic VS Code extension v2.1.218 also bundles a settings schema for .claude/settings.json, .claude/settings.local.json, and managed settings files. That bundled schema does not declare leftArrowOpensAgents, although it does declare the regular disableAgentView setting.

The field appears to have been added to SchemaStore in #5867 by classifying it as a regular settings property. As a result, editors using the published SchemaStore schema offer autocomplete and documentation for a key that Claude Code does not load from the matched files.

JSON, YAML, or TOML file that does not work

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "leftArrowOpensAgents": false
}

The file validates, but the Left-arrow Agent View shortcut remains enabled.

IDE or code editor

Visual Studio Code

Are you making a PR for this?

No, someone else must create the PR.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions