[DOCS] `/checkup` alias for `/doctor` added in v2.1.205 is not documented in the commands reference

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

The /doctor row of the "All commands" table on the commands reference, and the DISABLE_DOCTOR_COMMAND row in the env-vars reference.

Current Documentation

From the "All commands" table at https://code.claude.com/docs/en/commands (line 74):

| /doctor | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press f to have Claude fix any reported issues |

The same table documents aliases for the other commands it covers. Examples from the same file:

| /background [prompt] | Detach the current session to run as a background agent and free this terminal. Pass a prompt to send one more instruction before detaching. Monitor the session with claude agents. Alias: /bg | | /desktop | Continue the current session in the Claude Code Desktop app. Requires macOS or Windows and a Claude subscription. Alias: /app | | /exit | Exit the CLI. In an attached background session, this detaches and the session keeps running. Alias: /quit | | /resume [session] | Resume a conversation by ID or name, or open the session picker. As of v2.1.144, background sessions appear in the picker marked with bg. Alias: /continue |

A search for /checkup across the entire docs mirror returns a single hit, in the v2.1.205 changelog itself:

/doctor is now a full setup checkup that can diagnose and fix issues; /checkup is its alias

The DISABLE_DOCTOR_COMMAND row in https://code.claude.com/docs/en/env-vars (line 310) is also silent on /checkup:

| DISABLE_DOCTOR_COMMAND | Set to 1 to hide the /doctor command. Useful for managed deployments where users should not run installation diagnostics |

What's Wrong or Missing?

A. The new /checkup alias is missing from the commands reference

The v2.1.205 changelog states:

/doctor is now a full setup checkup that can diagnose and fix issues; /checkup is its alias

The commands.md table consistently documents every other command's alias with an Alias: \/name\` clause at the end of the description cell (see /background → /bg, /config → /settings, /desktop → /app, /exit → /quit, /loop → /proactive, /permissions → /allowed-tools, /remote-control → /rc, /resume → /continue, /schedule → /routines, /cost → /usage, and others). The /doctor row breaks that convention. A user typing /checkup` into a session on v2.1.205 will have the command work, but the canonical command reference does not advertise it.

B. The /doctor description predates the "full setup checkup" framing

The current description ("Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press f to have Claude fix any reported issues") already mentions the f-to-fix behavior, so the "can diagnose and fix issues" half of the v2.1.205 framing is captured. The "full setup checkup" framing, however, is the changelog's term for the broader scope the command now owns, and the row does not call that out. The Debug your config page (line 26) still describes /doctor as "Configuration diagnostics: invalid keys, schema errors, installation health" without acknowledging the broader setup-checkup scope, so the new framing is missing across the reader-facing surface, not just in the command table.

C. The DISABLE_DOCTOR_COMMAND env var does not mention the alias

The env-vars row promises to hide "the /doctor command". After v2.1.205, a managed deployment that wants to hide the diagnostics surface needs to hide both /doctor and /checkup, but the row does not say what it does to the alias. Following the same precedent as DISABLE_LOGIN_COMMAND (which promises to "hide the /login command") and DISABLE_LOGOUT_COMMAND (which promises to "hide the /logout command"), the row should clarify that the alias is hidden along with the canonical command.

Suggested Improvement

A. Add the Alias: \/checkup\` clause to the /doctor` row in the commands table

Replace:

| /doctor | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press f to have Claude fix any reported issues |

with:

| /doctor | {/ min-version: 2.1.205 /}Run a full setup checkup that diagnoses and fixes issues with your Claude Code installation, settings, MCP servers, and context usage. Results show with status icons. Press f to have Claude fix any reported issues. Alias: /checkup |

This brings the row in line with how every other aliased command in the same table documents its alias, and it surfaces the v2.1.205 "full setup checkup" terminology the changelog introduced.

B. Update the "When something is wrong" sentence on the same page

The intro paragraph at line 29 currently says:

/rewind rolls code and conversation back to a checkpoint, or summarizes part of the conversation. /doctor and /debug diagnose install and runtime issues, and /feedback reports a bug with session context attached.

It is not necessary to enumerate the alias in this sentence (the table is the canonical place for aliases), but a parallel pass should keep the diagnostic framing consistent with the v2.1.205 wording.

C. Mention the alias in the DISABLE_DOCTOR_COMMAND env-vars row

Replace:

| DISABLE_DOCTOR_COMMAND | Set to 1 to hide the /doctor command. Useful for managed deployments where users should not run installation diagnostics |

with:

| DISABLE_DOCTOR_COMMAND | Set to 1 to hide the /doctor command and its /checkup alias. Useful for managed deployments where users should not run installation diagnostics |

D. Mirror the "full setup checkup" framing on the Debug your config page

debug-your-config.md line 26 currently describes /doctor as:

/doctor | Configuration diagnostics: invalid keys, schema errors, installation health. As of v2.1.196, also reports duplicate subagent names defined in the same scope and marks which one is active |

Add a v2.1.205 follow-up clause so the row reflects the broader scope:

/doctor | Configuration diagnostics: invalid keys, schema errors, installation health. As of v2.1.196, also reports duplicate subagent names defined in the same scope and marks which one is active. {/ min-version: 2.1.205 /}As of v2.1.205, /doctor is a full setup checkup that can also fix reported issues, and /checkup is its alias |

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 74 | /doctor row in the "All commands" table; no Alias: \/checkup\` clause |
| https://code.claude.com/docs/en/commands | 29 | "When something is wrong" sentence uses the older "diagnose install and runtime issues" framing |
| https://code.claude.com/docs/en/env-vars | 310 | DISABLE_DOCTOR_COMMAND row promises to hide "the /doctor command" without acknowledging the /checkup alias |
| https://code.claude.com/docs/en/debug-your-config | 26 | /doctor row in the "See what loaded into context" table does not mention the v2.1.205 "full setup checkup" scope or the /checkup` alias |

Total scope: 4 page surfaces affected (3 distinct pages: commands.md, env-vars.md, debug-your-config.md).

Related changelog entry (v2.1.205):

/doctor is now a full setup checkup that can diagnose and fix issues; /checkup is its alias

Conventions to follow:

The commands reference already documents aliases for /background (/bg), /config (/settings), /desktop (/app), /exit (/quit), /loop (/proactive), /permissions (/allowed-tools), /remote-control (/rc), /resume (/continue), /schedule (/routines), and others using the Alias: \/name\` clause inside the description cell. The /doctor row should follow the same pattern, and the env-vars row should follow the same precedent as DISABLE_LOGIN_COMMAND and DISABLE_LOGOUT_COMMAND` for hidden-command flags.