{"name":"CLAUDE_CODE_CONFIG_LOCK_WAIT_MS","slug":"claude-code-config-lock-wait-ms","family":"env","title":"Environment variables","noun":"environment variable","description":"If adding or removing an MCP server can't save the config, the error now blames a lock and suggests CLAUDE_CODE_CONFIG_LOCK_WAIT_MS=60000","description_source":"entry","described_by":{"version":"2.1.318","anchor":"mcp-config-write-error-now-points-to-claude-code-config-lock"},"presence":{"first_seen":"2.1.318","removed_in":null,"in_current_build":true,"newest_mined":"2.1.318","builds":1,"mined_builds":158,"first_cited":{"version":"2.1.318","released_at":"2026-11-03 21:55:17","spans":2}},"aliases":[],"entries":[{"version":"2.1.318","anchor":"mcp-config-write-error-now-points-to-claude-code-config-lock","heading":"MCP config write errors now suggest waiting longer for a locked file","line":"If adding or removing an MCP server can't save the config, the error now blames a lock and suggests CLAUDE_CODE_CONFIG_LOCK_WAIT_MS=60000","released_at":"2026-11-03 21:55:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.318","anchor":"config-lock-only-saves-and-lock-wait-env-var","heading":"Protection against losing ~\/.claude.json now applies to everyone","line":"Claude Code now always guards your config file when it reads as missing, and `CLAUDE_CODE_CONFIG_LOCK_WAIT_MS` sets how long some saves wait for the lock","released_at":"2026-11-03 21:55:17","reason":"found in this entry's text"}],"entries_total":2,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"CLAUDE_CODE_CONFIG_PROBE","slug":"claude-code-config-probe","description":"When the `CLAUDE_CODE_CONFIG_PROBE` environment variable is set, Claude Code skips two of the routines it normally runs at startup"},{"name":"CLAUDE_CODE_CONFIG_WATCH_EVENTS","slug":"claude-code-config-watch-events","description":"On Linux, setting `CLAUDE_CODE_CONFIG_WATCH_EVENTS` makes Claude Code spot config file changes through system change events"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-config-lock-wait-ms","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}