できること
設定の診断と修正
/doctor を実行すると、Claude Code のセットアップを点検して問題を診断し、修正もできます。/checkup は /doctor の別名です。
インストールの状態と拡張機能の点検
重複や残存したインストール、PATH の問題、解析できない設定ファイル、リリースチャネルでの新しいバージョンの有無を確認します。使われていないスキル・MCP サーバー・プラグインをコンテキストコストと比べ、遅いフックも特定します。
指示ファイルの監査
/doctor prompt-audit を使うと、チェックアップの代わりに CLAUDE.md ファイル、スキルなどの設定に古い指示や矛盾する指示がないかを Claude が確認します。
機能解説
概要
問題を診断し、修正もできます。Claude は診断結果を先に報告し、何かを変更する前に確認を求めます。点検の対象は、インストールの状態、拡張機能、CLAUDE.md ファイル、権限の設定です。
/doctor のチェックアップは、次の観点で Claude Code のセットアップを点検します。
- インストールの状態: 重複や残存したインストール、
PATHの問題、解析できない設定ファイル、リリースチャネルで新しいバージョンが出ているかどうか - 拡張機能: 使われていないスキル・MCP サーバー・プラグインとそのコンテキストコストの比較、遅いフック
- **
CLAUDE.mdファイル**: チェックイン済みのファイルと重複するローカルのCLAUDE.md、コードベースから導き出せるチェックイン済みの内容。常に読み込まれる残りの指示については、必要時に読み込まれるスキルや入れ子のCLAUDE.mdへ移すことを Claude が提案します - 権限: auto mode を既定の権限モードにすること、よく拒否している読み取り専用コマンドを事前承認することの提案
- 利用状況: Claude が自分で行える変更は提案し、それ以外は実行すべきコマンドなどの助言として報告します。Remote Control の接続中は、この点検は省かれます
セッションを始めずに読み取り専用でインストールの診断だけを行う場合は、ターミナルで claude doctor を実行します。claude doctor は、最後の更新試行の結果も表示します。
起動時の表示から /doctor への集約
いくつかの警告や情報は、起動時の表示ではなく /doctor で確認する形に変わっています。
- スキル一覧の切り詰めは起動時通知に出なくなり、/doctor で詳細な内訳を確認します。
- ロゴ下の起動時の「setup issues」行は削除され、設定の問題は /doctor で確認します (
--debugも使えます)。 - 起動時の「claude command missing or broken」警告は削除され、/doctor と /status に表示されます。
- npm のグローバルインストールが自動更新できない場合、/doctor がその対処法を一覧表示します。
- 自動更新が他のプラグインのバージョン制約によりプラグインをスキップした場合、そのスキップが /doctor と /plugin の Errors タブに表示されます。
提供状況の注意
/doctor を利用できるプランについては、公式のリリースノートには記載がありません。
使い方
- Claude Code のプロンプトで
/doctorを実行し、セットアップのチェックアップを始めます。 - Claude が報告する診断結果を確認します。Claude は何かを変更する前に確認を求めます。
利用シーン
Claude Code の動作に違和感があるときに、インストールの重複や PATH の問題、設定ファイルの不備をまとめて確認する場面に向いています。
導入済みのスキル・MCP サーバー・プラグインを棚卸しし、使われていないものをコンテキストコストと合わせて見直す場面に使えます。
リポジトリにチェックインした CLAUDE.md の内容を見直し、コードベースから導き出せる記述を整理する場面に使えます。
/doctor prompt-audit で、CLAUDE.md やスキル、エージェント、コマンドに旧モデル向けの指示が残っていないかを点検する場面に向いています。
ChatGPT・OpenAI の対応する機能
比較の単位となる業務: CLI 環境の設定診断と問題修正
スキル一覧の切り詰めの扱いに違いがあります。Claude Code では、スキル一覧の切り詰めを起動時通知には出さず、/doctor で詳細な内訳を確認する形です。比較対象の Skills (スキル) では、コンテキスト予算が厳しい場合でもより多くのスキルを保持し、スキルカタログを切り詰める必要がある場合に警告します。
これまでの変更
CLAUDE.md、スキル、エージェント、コマンドに旧モデル向けのプロンプト記述パターンがないかを監査する/doctor prompt-audit(/checkup prompt-audit) が追加されました。強制終了されたセッションが残した古いサンドボックスのマスクファイルについて警告するようになりました。
コードベースから導き出せる内容を削って、チェックイン済みの
CLAUDE.mdの縮小を提案するチェックが追加されました。問題を診断・修正できる包括的なセットアップのチェックアップになり、
/checkupが別名になりました。起動時の「claude command missing or broken」警告が削除され、/doctor と /status に表示されるようになりました。
起動時の「setup issues」行が削除され、設定の問題は /doctor で確認する形になりました。
全セクションで一貫したフラットなツリー表示、分かりやすいセクションのステータスアイコン、コマンド名の強調表示になりました。
npm のグローバルインストールが自動更新できない場合の対処法を一覧表示するようになりました。
claude doctorが最後の更新試行の結果を表示するようになりました。コマンドフックに command フィールドが欠けている場合に exec 形式の例を表示するようになりました。スキル一覧の切り詰めの内訳も /doctor で確認する形になりました。
自動更新が他のプラグインのバージョン制約によりプラグインをスキップした場合、そのスキップが表示されるようになりました。
Claude の応答中でも、現在のターンの終了を待たずに開けるようになりました。
MCP サーバーが複数の設定スコープで異なるエンドポイントとして定義されている場合に警告するようになりました。
表示がステータスアイコン付きになり、f キーで報告された問題を Claude に修正させられるようになりました。