Claude JSON Config Cleanup FAQs

Question 1

How do I restore my settings if I encounter an issue?

Accepted Answer

You can restore your configuration by running the command: cp ~/.claude.json.backup ~/.claude.json

Question 2

Does this remove my MCP server configurations?

Accepted Answer

No, the script is designed to prune project metadata. However, if your MCP section is causing the bloat, the skill provides manual analysis tools to help you identify and remove unused servers.

Question 3

Why am I getting a 'maximum allowed tokens' error in Claude Code?

Accepted Answer

This usually occurs when your ~/.claude.json configuration file exceeds 25,000 tokens due to a large number of stored project histories, MCP server settings, or session data.

Question 4

Is it safe to clean up my claude.json file?

Accepted Answer

Yes. This skill creates an automatic backup (~/.claude.json.backup) before performing any operations, allowing you to restore your configuration instantly if needed.

Question 5

What specifically does the cleanup script remove?

Accepted Answer

It targets stale data, specifically configuration entries for project directories that no longer exist on your filesystem and non-existent GitHub repository references.

Claude JSON Config Cleanup

Key Features

Use Cases

Claude JSON Config Cleanup

Key Features

Use Cases