[BUG] `theme` property in settings.json not recognized despite being documented

Resolved 💬 4 comments Opened Sep 1, 2025 by liby Closed Jan 10, 2026

Environment

  • Platform (select one):
  • [ ] Anthropic API
  • [ ] AWS Bedrock
  • [ ] Google Vertex AI
  • [x] Other: Max Plan
  • Claude CLI version: 1.0.98 (Claude Code)
  • Operating System: macOS 15.6.1
  • Terminal: VS Code integrated terminal

Bug Description

The theme property in ~/.claude/settings.json is not recognized, despite being documented in the official documentation.

Steps to Reproduce

  1. Try to set theme using CLI command: claude config set -g theme "dark" - this doesn't modify ~/.claude/settings.json
  2. Manually edit ~/.claude/settings.json and add "theme": "dark" at line 50
  3. Open the file in VS Code with Claude Code for VSCode extension enabled
  4. VS Code shows error: "Property theme is not allowed"

<img width="428" height="105" alt="Image" src="https://github.com/user-attachments/assets/dbc37aa9-761c-46f9-a858-033cf8c47ce4" />

Expected Behavior

According to the documentation, the theme property should be a valid configuration option in ~/.claude/settings.json for setting the global theme preference.

Actual Behavior

  • The CLI command claude config set -g theme "dark" doesn't modify the settings file
  • When manually adding "theme": "dark" to the settings.json, VS Code reports it as an invalid property
  • The theme setting appears to be unsupported despite being documented

Additional Context

Screenshot showing VS Code error message when theme property is added to settings.json.

This suggests either:

  1. The documentation is outdated and theme setting is no longer supported
  2. There's a bug in the configuration schema validation
  3. The theme setting has been moved to a different location or uses a different syntax

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗