claude doctorと/doctor診断コマンドの使い方と結果の読み方
Claude Codeの診断コマンド claude doctor と /doctor の違いと使い方、診断結果の読み方を、公式ドキュメントで整理します。更新や設定の確認にも使えます。
公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて
claude doctorと/doctorとは
Claude Code の調子が悪いとき、最初に試すとよいのが診断コマンドです。公式のトラブルシューティングには、「どこから手をつけるか分からないときは、Claude Code の中で /doctor を実行する。インストール、設定、拡張、コンテキストの使用状況を自動で調べ、直せるものは確認後に直す」と書かれています。Claude Code がまったく起動しない場合は、シェルから claude doctor を実行します。
この記事では、2つのコマンドの違い、何が分かるか、結果の読み方を整理します。
基本（2つのコマンドの違い）
| コマンド | 実行する場所 | 内容 |
|---|---|---|
claude doctor |
端末（シェル） | 読み取り専用の診断。セッションを始めず、インストールと設定の問題を表示する |
/doctor |
Claude Code の中 | 設定の点検。直せるものについて、修正案を示し、確認のあとで適用する |
公式のセットアップには、claude doctor の出力に、インストールの健全性、設定ファイルの検証エラー、警告と対処の提案が含まれると書かれています。/doctor は、それに加えて、使われていない拡張、同じフォルダ内で重複するサブエージェント名、コードから分かる内容が CLAUDE.md に重複していないかなども確認します。
具体例（診断で分かること）
公式のドキュメントから確認できる、診断で分かる項目です。
| 診断の項目 | 分かること |
|---|---|
| インストールの状態 | 複数のインストールの混在、独自の起動スクリプトの有無 |
| 自動更新 | 直近の更新の結果、Auto-updates の行に enabled か disabled か |
| 設定ファイル | 不正な設定（matcher が配列になっているなど）の検出 |
| 検索ツール（Search） | 同梱の ripgrep が使われているか（OK (bundled)）。システムの ripgrep を指すこともある |
| macOS のキーチェーン | 書き込みできない場合の警告（macOS Keychain is not writable）と対処の提案 |
ログインの問題で、macOS のキーチェーンが原因のときは、claude doctor で警告を確認し、security unlock-keychain を実行する手順が、公式に示されています。
claude doctorと/doctorの実践ステップ
- Claude Code が起動するなら、中で
/doctorを実行する。 - 起動しない、または端末から先に調べたいときは、
claude doctorを実行する。 - 警告や提案を読み、自分で直せるものを直す。
/doctorの修正案は、確認のあとで適用される。 - 設定の影響を切り分けたいときは、
claude --safe-modeで、拡張や設定を無効にして起動する。 - 診断が止まる（出力が出ない）場合は、シェルの設定ファイルの場所にフォルダがないか確認する。
- 解決しないときは、
/feedbackで報告するか、公式の GitHub を確認する。
claude doctorと/doctorの注意点
claude doctorは、読み取り専用です。何も変更しません。/doctorは、確認のあとで変更を加える場合があります。- 古い版では、
claude doctorやclaude updateが、シェルの設定ファイル（~/.zshrcなど）の場所にフォルダがあると、止まる問題がありました。v2.1.214 以降で解消されています。 - 診断結果は、設定ファイルのエラーなど、環境の状態を示します。内容を、そのまま公開の場に貼る場合は、個人情報やパスが含まれていないか確認してください。
- 診断のあとは、必ず元の問題が直ったか、実際の操作で確かめてください。
claude doctorと/doctorでよくあるミス
- 診断の警告を読まず、すぐ再インストールする。
/doctorとclaude doctorの違いを知らず、起動できない状態で/doctorを探す。- 診断の結果で、直った部分と直っていない部分を区別しない。
- 設定の問題を、安全モード（
--safe-mode）で切り分けずに、個別の設定を手探りで直す。
claude doctorと/doctorのチェックリスト
- 起動できる状態に合わせて、
/doctorかclaude doctorを選んだか。 - 警告や提案を、1つずつ読んだか。
- 更新の状態（Auto-updates の行）を確認したか。
- 設定ファイルのエラーがないか確認したか。
- 修正のあと、元の問題が直ったか確認したか。
claude doctorと/doctorのFAQ（よくある質問）
Q. /doctor は、勝手に設定を変えますか。
A. 公式は、修正案を提案し、確認のあとで適用すると説明しています。
Q. claude doctor は何も表示しません。
A. v2.1.214 より前の版で、シェルの設定ファイルの位置（~/.zshrc など）にフォルダがあると、止まることがあります。そのフォルダを別の場所に移すか、版を上げます。該当の版では claude update も止まるため、公式はインストールスクリプトの再実行で更新するよう案内しています。
Q. どの診断コマンドを最初に使うべきですか。
A. 起動できるなら /doctor、起動できないなら claude doctor です。
筆者の見解（claude doctorと/doctor）
私見では、claude doctor と /doctor は「変更するかどうか」で使い分けるのが分かりやすいと考えます。まず読み取り専用の claude doctor で現状を控え、そのあと /doctor の修正案を一つずつ読んで適用すれば、何を変えたかを後から追えるからです。見落としやすいのは、診断が設定やインストールの問題には強い一方で、回線、プロキシ、契約や権限の問題は守備範囲外だという点です。診断で異常が出ないのに症状が続くときは、claude --safe-mode で拡張の影響を外すか、エラーの文言から公式のエラー一覧を引く方向へ早めに切り替えるのが効率的だと考えます。
claude doctorと/doctorの関連項目
出典（一次情報）
本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。