Claude Codeの/doctorで設定を点検する方法

この記事の要点
- /doctor は、インストール・拡張機能・CLAUDE.md・権限・使用量の5つを点検し、直し方を提案する(直す前に必ず確認を取る)
- セッションを開かずに読むだけで調べたいときは、ターミナルで claude doctor を使う
- 指示文そのものの古さや食い違いを調べたいときは /doctor prompt-audit(v2.1.283 以降)
Claude Code を使い込むほど、スキル・MCP サーバー・プラグイン・CLAUDE.md が少しずつ増えていきます。気がつくと「なんとなく重い」「前と動きが違う」と感じることがあります。
そんなときに最初に試したいのが /doctor です。この記事は、公式ドキュメント「Extend Claude with skills」の「Check your setup with /doctor」と、コマンド一覧(どちらも2026年11月22日確認)にもとづいて、/doctor で分かることと使い分けをまとめます。
結論:迷ったら /doctor、読むだけなら claude doctor
/doctor は、Claude Code の中で打つ「設定の健康診断」 です。Claude が見つけたことを先に報告し、直すときは必ず確認を取ってから 変更します。勝手に設定が書き換わることはありません。
| やりたいこと | 使うもの | 変更まで行うか |
|---|---|---|
| 設定全体を点検して、直し方も提案してほしい | /doctor(別名 /checkup) | 確認したうえで Claude が直す |
| セッションを開かずに、インストールの状態だけ見たい | ターミナルで claude doctor | 読むだけ |
| CLAUDE.md やスキルの指示文が古くないか調べたい | /doctor prompt-audit | 直し方を提案する |
/doctor は Claude Code に最初から入っているスキルの1つです。スキルの仕組みそのものは Claude Codeのスキルとは? で解説しています。

/doctor が点検する5つの観点
公式ドキュメントでは、点検の範囲が次の5つに分かれています。
1. インストールの状態
- 同じものが2つ入っている・古いものが残っている 状態
PATH(コマンドの探し場所)の問題- 読み込めない設定ファイル
- 自分のリリースの系統(release channel)で、新しい版が出ているか
インストールそのものでつまずいている場合は、Claude Codeのインストールで困ったとき の手順も合わせて見てください。
2. 拡張機能
- 使っていないスキル・MCP サーバー・プラグインを、会話の容量(コンテキスト)をどれだけ使っているかと並べて 見せる
- 時間のかかっている フック
「入れたけれど使っていない物」が、毎回の会話の容量を食っていることがあります。ここで見つかった物は、外すか、必要なときだけ読み込む形に変えると軽くなります。
3. CLAUDE.md
- 手元だけの CLAUDE.md が、共有している CLAUDE.md と 中身が重なっている
- 共有している CLAUDE.md に、コードを読めば分かる内容 が書かれている
- 毎回読み込まれる指示の残りについて、必要なときだけ読み込まれるスキルや、フォルダごとの CLAUDE.md に移す ことを提案する
CLAUDE.md の書き方の基本は Claude CodeのCLAUDE.mdとは にまとめています。
4. 権限
- auto mode を既定の権限モードにする 提案
- よく「いいえ」と答えている読み取りだけのコマンドを、あらかじめ許可する 提案
権限モードの違いは Claude Codeの権限モード で比べています。提案はあくまで提案なので、会社の決まりで手動の確認を残したい場合は、そのまま断って構いません。
5. 使用量
Pro・Max・Ultra・Team・Enterprise のプランでは、/usage が勧める「使用量を減らす変更」を、直近7日の実績で測って 示します。Claude が自分でできる変更は提案し、それ以外は「このコマンドを打ってください」のような助言として伝えます。この点検は v2.1.305 以降 が必要で、Remote Control でつながっている間は省かれます。
費用や使用量の考え方は Claude Codeの料金と使用量 も参考になります。
使う手順
- Claude Code を起動して、入力欄に
/doctorと打つ - Claude が5つの観点で調べ、見つけたことの一覧 を出す
- 直してほしい項目だけ「お願いします」と答える。残したい項目は断る
- 直したあとは、Claude Code を開き直して動きを確かめる
報告が長くなったら、「重さに効く順に3つだけ」のように絞って頼むと判断しやすくなります。
ターミナルの claude doctor との違い
公式ドキュメントによると、セッションを始めずに、読むだけでインストールを診断したい ときは、ターミナルで claude doctor を実行します。
claude doctor:起動しなくても使える。インストールまわりを読むだけで確かめる/doctor:セッションの中で使う。拡張機能や CLAUDE.md まで調べ、確認のうえで直す
「そもそも Claude Code が起動しない」ときは claude doctor、「動くけれど重い・おかしい」ときは /doctor、と覚えておくと迷いません。
指示文を見直す /doctor prompt-audit
設定ではなく 指示文の中身 を見直したいときは、/doctor prompt-audit を使います。Claude が CLAUDE.md・スキル・そのほかの設定を読み、古くなった指示や、互いに食い違う指示 を探します。こちらは v2.1.283 以降 が必要です。
たとえば、昔のモデル向けに「必ず〇〇してから△△すること」と細かく書いた指示が、今のモデルには逆に動きを縛っていることがあります。チームで CLAUDE.md を育てていると起きやすいので、月に1回くらい流すと安心です。
よくある質問
/doctor を打っても勝手に設定が変わりませんか?
変わりません。公式ドキュメントでは、Claude はまず見つけたことを報告し、何かを変える前に確認を求める と説明されています。
/checkup と /doctor は違うコマンドですか?
同じです。コマンド一覧では /checkup が /doctor の別名として載っています。
動きがおかしいのは設定ではなく、作業中の不具合かもしれません
その場合は /debug が向いています。コマンド一覧では、/doctor が設定の点検、/debug が動いている間の問題の診断、/feedback が会話の情報をつけた不具合の報告、と役割が分かれています。主なコマンドの一覧は Claude Codeのコマンド一覧 にあります。
まとめ
/doctorは5つの観点(インストール・拡張機能・CLAUDE.md・権限・使用量)の健康診断。直す前に必ず確認を取る- 起動せずに読むだけなら
claude doctor、指示文の見直しなら/doctor prompt-audit - 使っていない拡張機能や重なった CLAUDE.md を減らすと、毎回の会話が軽くなる
出典
- Claude Code 公式ドキュメント「Extend Claude with skills」(Check your setup with /doctor)
- Claude Code 公式ドキュメント「Commands」
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


