Docs: Update settings documentation for live-reloading feature (v1.0.90)

Resolved 💬 4 comments Opened Aug 25, 2025 by coygeek Closed Jan 7, 2026

Title: Docs: Update settings documentation for live-reloading feature (v1.0.90)

Body:

Is your feature request related to a problem? Please describe.
The official documentation for Claude Code does not reflect a recent feature improvement regarding how settings files are handled. According to the changelog for v1.0.90, a significant user experience improvement was added:

- Settings file changes take effect immediately - no restart required

The current documentation does not mention this, which may lead users to unnecessarily restart the application to apply configuration changes. Furthermore, some sections of the documentation now directly contradict this new behavior.

Describe the solution you'd like
The relevant documentation pages should be updated to reflect that settings changes are now hot-reloaded.

Affected Documentation & Suggested Changes:

1. Main Settings Page (en/docs/claude-code/settings)

This page is the primary source of information for settings.json. It should be updated to explicitly state that changes are applied immediately.

  • Location: en/docs/claude-code/settings
  • Suggestion: Add a note or a new section explaining the live-reload feature. For example:

> Applying Changes
>
> Changes made to any settings.json file are automatically detected and applied to your current Claude Code session. A restart is not required.

2. Hooks Reference Page (en/docs/claude-code/hooks)

This page contains information that now appears to be outdated and directly contradicts the v1.0.90 feature.

  • Location: en/docs/claude-code/hooks, under the "Configuration Safety" section.
  • Current Text:

> Direct edits to hooks in settings files don't take effect immediately. Claude Code:
> 1. Captures a snapshot of hooks at startup
> 2. Uses this snapshot throughout the session
> 3. Warns if hooks are modified externally
> 4. Requires review in /hooks menu for changes to apply

  • Suggestion: This section needs to be reviewed and updated.
  • If hooks now also reload immediately, this entire section should be rewritten to reflect the new behavior.
  • If hooks are a specific exception to the live-reload feature for security reasons, this should be clarified. The documentation should explain why hooks behave differently from other settings.

Updating these sections will improve clarity, enhance the user experience, and ensure the documentation is consistent with the latest version of the tool.

Thank you for the great work on Claude Code

View original on GitHub ↗

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