/doctor Command

/doctorとは何ですか？他のトラブルシューティングコマンドとどう違いますか？

/doctorはClaudeCodeに組み込まれたスラッシュコマンドで、環境設定の完全なチェックを一度実行し、インストール方法（npmグローバルインストール、ローカルインストール、ネイティブ実行ファイル）、アップデートチャネル、MCPサーバーの接続状態、権限ルールのエラー、CLAUDE.mdファイルの重複といった、よくある目に見えにくい問題をカバーする。エイリアスは/checkupで、二つの名前はまったく同じ効果を持つ。

/statusコマンドとの役割分担は異なる。/statusは現在の対話の一時的なスナップショット（使用中のモデル、アカウント、接続の健全性）を表示するもので、受動的なステータス表示に属する。一方/doctorは能動的に一連のチェック全体を実行し、インストールと設定の問題の根本原因を掘り下げ、さらに修復する能力も備えている。両者は互いに補完し合うものであり、代替し合うものではない。

/doctorはなぜ存在するのですか？どんな問題を解決していますか？

ClaudeCodeの環境設定には「静かに故障する」箇所がかなり多く含まれている——複数のインストール方法（npmグローバル、~/.claude/local、Homebrew）が同時に存在して互いに衝突している、PATH設定が間違っている、MCPサーバーに接続できない、権限ルールの記述が誤っている、SkillやCommandの説明が予算超過で削除されているなど。これらの状況の多くは明確なエラーメッセージを出さず、ユーザーは「何かおかしい」と感じるだけで、どこから調べればいいのかわからない。

/doctorが存在する目的は、こうした本来分散しており、ユーザーが自分で一つずつ調べる必要があったチェック項目を、一つのコマンドに統合し、数秒で実行を終え、「どこに問題がないか、どこに警告があるか、どこにエラーがあるか」を直接教えてくれることにある。本来なら何度も検索したり質問したりして特定するのに時間がかかっていた問題を、一回の診断レポートに圧縮するのだ。

/doctorは実際にはどのように動作しますか？

どのClaudeCodeの対話でも/doctor（またはエイリアス/checkup）を入力すると、チェックパネルが開き、数秒以内に項目ごとにステータスが記されたレポートが表示される——各チェックは緑（正常）、黄（警告）、赤（エラー）で示され、インストールタイプ、インストールパス、バージョン番号、複数インストールの有無、MCP接続状態などをカバーする。チェックを実行するのに稼働中の対話セッションは必要なく、通常のターミナルで直接claude doctorと入力しても同じチェックが実行される。これはClaudeCodeがそもそもセッションを開始できない状況で特に役立つ。

このコマンドが読み取り専用の診断から直接修復を支援できるものへと進化したのは、後のバージョンで追加された機能だ。診断結果画面でfキーを押すと、Claudeが報告された問題の修復に取り組めるが、修復前には必ず変更内容を提示し、ユーザーの確認を待つ——勝手に静かに実行することはない。この「まず報告し、それから同意を得てから動作する」という仕組みも、一般的な自動修復ツールとの最大の違いだ。

/doctorの機能を理解することは、日常的なClaudeCode利用にどう影響しますか？

最も直接的な影響はトラブルシューティングの習慣の調整だ。「何となくおかしいが明確なエラーメッセージがない」という状況に遭遇したとき、まずウェブ検索したりClaudeに直接尋ねたりする前に、最初のステップとして/doctorを使う——多くの環境レベルの問題は、一回のチェックを実行するだけで原因が即座にわかり、根本原因にたどり着くまで大回りする必要がなくなる。これはSkillがトリガーされないといった問題を調査する際の推奨順序とも一致する。まず診断ツールで設定自体に問題がないかを確認し、それからより上位のテキスト内容が十分に書けているかを確認する、という順序だ。

もう一つの実用的な提案は、問題が起きたときにだけ使うのではなく、定期的なチェックのタイミングとして組み込んでおくことだ。大きなバージョンアップの後に毎回一度実行しておく。なぜなら新しいバージョンで導入される新しいチェック項目（新しい設定の推奨事項など）は、アップグレード前から存在していたが旧バージョンのチェックロジックでは見つけられなかった問題だけを検出するからだ。一度実行しておくことで、実際に目に見える障害を引き起こしてから気づくのではなく、潜在的なリスクを早めに発見できる。