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

公開 更新 著者 永上裕之導入とルール
聴診器を当てるように、パソコンの設定を1つずつ点検しているイメージ

この記事の要点

  • /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. インストールの状態

インストールそのものでつまずいている場合は、Claude Codeのインストールで困ったとき の手順も合わせて見てください。

2. 拡張機能

「入れたけれど使っていない物」が、毎回の会話の容量を食っていることがあります。ここで見つかった物は、外すか、必要なときだけ読み込む形に変えると軽くなります。

3. CLAUDE.md

CLAUDE.md の書き方の基本は Claude CodeのCLAUDE.mdとは にまとめています。

4. 権限

権限モードの違いは Claude Codeの権限モード で比べています。提案はあくまで提案なので、会社の決まりで手動の確認を残したい場合は、そのまま断って構いません。

5. 使用量

Pro・Max・Ultra・Team・Enterprise のプランでは、/usage が勧める「使用量を減らす変更」を、直近7日の実績で測って 示します。Claude が自分でできる変更は提案し、それ以外は「このコマンドを打ってください」のような助言として伝えます。この点検は v2.1.305 以降 が必要で、Remote Control でつながっている間は省かれます。

費用や使用量の考え方は Claude Codeの料金と使用量 も参考になります。

使う手順

  1. Claude Code を起動して、入力欄に /doctor と打つ
  2. Claude が5つの観点で調べ、見つけたことの一覧 を出す
  3. 直してほしい項目だけ「お願いします」と答える。残したい項目は断る
  4. 直したあとは、Claude Code を開き直して動きを確かめる

報告が長くなったら、「重さに効く順に3つだけ」のように絞って頼むと判断しやすくなります。

ターミナルの claude doctor との違い

公式ドキュメントによると、セッションを始めずに、読むだけでインストールを診断したい ときは、ターミナルで claude doctor を実行します。

「そもそも 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のコマンド一覧 にあります。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事