{"name":"\/doctor","slug":"doctor","family":"slash","title":"Slash commands","noun":"slash command","description":"**[Skill](\/docs\/en\/skills#bundled-skills).** Run a setup checkup that diagnoses issues and can fix them. Checks installation health, including duplicate or leftover installs, `PATH` problems, and unparseable settings files. Finds unused skills, MCP servers, and plugins versus their context cost, flags slow [hooks](\/docs\/en\/hooks), and checks for a newer version on your [release channel](\/docs\/en\/setup#configure-release-channel). Deduplicates local `CLAUDE.md` files against checked-in ones, trims checked-in [`CLAUDE.md`](\/docs\/en\/memory#my-claude-md-is-too-large) files by cutting content Claude could derive from the codebase, and migrates the always-loaded guidance that remains into [skills](\/docs\/en\/skills) and nested `CLAUDE.md` files that load on demand. Also offers to make [auto mode](\/docs\/en\/permissions#permission-modes) your default and to [pre-approve](\/docs\/en\/permissions) frequently denied read-only commands. Reports findings first and asks for confirmation before changing anything. From the terminal, `claude doctor` prints read-only installation diagnostics without starting a session. Alias: `\/checkup`. Run `\/doctor prompt-audit` to have Claude [audit your `CLAUDE.md` files, skills, and other configuration](\/docs\/en\/memory#write-effective-instructions) for outdated or conflicting instructions instead of running the checkup. The `prompt-audit` subcommand requires Claude Code v2.1.283 or later. The `CLAUDE.md` trim check requires Claude Code v2.1.206 or later. Before v2.1.205, `\/doctor` opened a read-only diagnostics screen and pressing `f` sent the report to Claude","description_source":"docs","described_by":{"doc":"claude-code\/commands","title":"Commands"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.182","released_at":"2026-06-18 22:06:42","spans":1}},"aliases":[],"entries":[{"version":"2.1.290","anchor":"doctor-lists-extra-diagnostics-before-environment-variable-w","heading":"\/doctor shows an extra block of checks before environment variables","line":"The `\/doctor` report now prints a new block of paired lines, each with an indented detail, ahead of its environment variables section","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text, named in this entry"},{"version":"2.1.287","anchor":"session-restart-to-installed-version-refusal-messages-and-up","heading":"Clearer messages when Claude Code can't restart onto an installed update","line":"Restarting a session onto a newly installed version now explains why it was refused, and confirms an upgrade, a downgrade or a plain resume","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"doctor-prompt-audit-runs-the-claude-api-skills-prompt-au","heading":"\/doctor prompt-audit reviews your project's instruction files","line":"`\/doctor prompt-audit` hands off to the bundled claude-api skill to audit CLAUDE.md, rules, skills and other instruction files","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"doctordiagnostic-output-now-redacts-gateway-bedrock-and-pr","heading":"Doctor\/diagnostic output now redacts gateway, Bedrock and proxy URLs","line":"Diagnostic output now hides the actual Gateway, Bedrock, and proxy URLs behind redaction","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"doctorhooks-list-truncation-now-uses-shared-n-more-compon","heading":"Doctor\/hooks list truncation now uses shared 'N more' component","line":"Doctor's hooks list now shows truncated 'N more' text using the same shared component as other lists","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text, named in this entry"},{"version":"2.1.261","anchor":"doctor-output-now-waits-for-organization-policy-limits-to","heading":"\/doctor output now waits for organization policy limits to load before reporting them","line":"\/doctor now waits for org policy limits to load and shows an updating status line for them.","released_at":"2026-09-04 17:49:34","reason":"found in this entry's text, named in this entry"},{"version":"2.1.257","anchor":"doctor-check-for-stale-sandbox-mask-files-on-linuxwsl","heading":"Doctor check for stale sandbox mask files on Linux\/WSL","line":"A new doctor check finds stale zero-byte sandbox mask files on Linux and WSL that quietly break don't-ask-again.","released_at":"2026-09-01 17:15:33","reason":"named in this entry"},{"version":"2.1.241","anchor":"version-stamped-to-2-1-241","heading":"Version stamped to 2.1.241","line":"The version number moved from 2.1.240 to 2.1.241; nothing else changed.","released_at":"2026-08-22 23:58:33","reason":"found in this entry's text"},{"version":"2.1.239","anchor":"reworded-auth-doctor-and-artifact-messages","heading":"Reworded auth, doctor and artifact messages","line":"Auth, \/doctor and artifact messages now describe what actually happened instead of guessing a fix.","released_at":"2026-08-21 17:18:54","reason":"named in this entry, found in this entry's text"},{"version":"2.1.233","anchor":"doctor-now-checks-skills-for-broken-frontmatter","heading":"\/doctor now checks skills for broken frontmatter","line":"\/doctor now spots skills whose frontmatter fails to parse and offers to repair it.","released_at":"2026-08-14 18:50:44","reason":"named in this entry, found in this entry's text"}],"entries_total":34,"docs":[{"source":"claude-code","path":"commands","title":"Commands","documented":true},{"source":"claude-code","path":"best-practices","title":"Best practices for Claude Code","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":false},{"source":"claude-code","path":"corporate-launcher","title":"Run Claude Code behind a corporate launcher","documented":false},{"source":"claude-code","path":"debug-your-config","title":"Debug your configuration","documented":false},{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":false},{"source":"claude-code","path":"features-overview","title":"Extend Claude Code","documented":false},{"source":"claude-code","path":"how-claude-code-works","title":"How Claude Code works","documented":false},{"source":"claude-code","path":"keybindings","title":"Customize keyboard shortcuts","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/slash\/doctor","family_url":"https:\/\/changelogs.core-directive.com\/reference\/slash.json"}