/doctor と claude doctor は異なるコマンドです
ほぼ同じ名前の2つのコマンドがあります：
claude doctor: ターミナルで実行され、診断のみを行います。Anthropic は次のように述べています。「セッションを開始せずに読み取り専用のインストール診断を行うには、代わりにターミナルでclaude doctorを実行してください。」/doctor: セッション内で実行される完全な診断です。コマンドリファレンスでは、「インストール、設定、拡張機能、およびCLAUDE.mdの問題を診断し、確認後に Claude が適用する修正案を提示する」実行として説明されています。
Claude Code の変更履歴には、セッション内バージョンが変更されたタイミングが記されています。「/doctor は問題を診断して修正できる完全なセットアップ診断になりました。/checkup はそのエイリアスです」。つまり、/checkup と /doctor は同じものを実行します。
診断がチェックする項目
Anthropic のスキルに関するドキュメントには、5つの領域が挙げられています。
インストールの健全性。 重複または残存しているインストール、PATH の問題、解析不可能な設定ファイル、およびリリースチャネルで新しいバージョンが利用可能かどうか。
拡張機能。 診断は「未使用のスキル、MCP サーバー、プラグイン」を「それらのコンテキストコスト」と比較し、動作の遅いフックを探します。
CLAUDE.md ファイル。 チェックインされたファイルと重複するローカルの CLAUDE.md ファイル、コードベースから Claude が派生できるチェックイン済みのコンテンツ、および常に読み込まれる残りのガイダンスをチェックします。Claude はこれらをスキルやオンデマンドで読み込まれるネストされた CLAUDE.md ファイルに移行することを提案します。
権限。 auto モードをデフォルトの権限モードにすることや、頻繁に拒否する読み取り専用コマンドを事前に承認することの提案。
使用量。 Pro、Max、Ultra、Team、Enterprise プランにおいて、過去7日間の計測に基づき、プランの使用量を下げるために /usage が推奨する変更。Anthropic は「Claude は自身で実行できる変更を提案し、それ以外は実行すべきコマンドなどのアドバイスとして報告します」と述べています。使用量チェックには Claude Code v2.1.305 以降が必要で、Remote Control 接続中は診断から除外されます。
診断が CLAUDE.md に対して提案する内容
チェックインされた CLAUDE.md のガイダンスは常に読み込まれるため、診断の CLAUDE.md 部分は重要です。
Anthropic の記憶（memory）に関するドキュメントでは、何を削除し、何を残すかが説明されています。診断は「チェックインされた CLAUDE.md のトリミングを提案します。ディレクトリ構造、依存関係リスト、アーキテクチャの概要など、Claude がコードベースから派生できるコンテンツをカットし、落とし穴、根拠、ツールのデフォルトとは異なる慣習を残します」。
この切り分けが有用な部分です。ディレクトリツリーや依存関係のリストは、Claude が必要に応じてリポジトリから読み取れるものです。一方で、なぜ特定のマイグレーションを最初に実行しなければならないのかというメモや、ツールが想定しないチーム独自の慣習は、コードから派生させることはできません。診断は前者を「コスト」、後者を「価値」として扱います。
なぜサイズが重要なのか
Anthropic の CLAUDE.md に関するガイダンスは直接的です。「CLAUDE.md ファイル1つにつき 200 行未満を目指してください。ファイルが長くなるとコンテキストをより多く消費し、指示への準拠率が低下します」。
同じドキュメントにある関連する制限事項：
- 警告。 「指示ファイルのいずれかが推奨される長さを超えている場合、起動時および
/statusを実行したときに警告が表示されます」。 - 合計サイズ。 個々のファイルが制限内であっても、セッション開始時にそれらの合計が制限を超えると警告が表示されます。
- ハードリミット。 「Claude Code は 4 MiB を超えるファイルをスキップします」。
- インポートはサイズ削減に役立たない。
@pathインポートへの分割は「整理には役立ちますが、インポートされたファイルはそれをインポートしている CLAUDE.md と一緒に読み込まれるため、コンテキストは削減されません」。
もし問題が、Claude が途中で無視しているように見えるネストされた CLAUDE.md である場合、それは別のファイルごとの制限です。詳細は、なぜ Claude はサブディレクトリの CLAUDE.md の末尾を無視するのか のガイドをご覧ください。
トリミングされたガイダンスの行き先
診断は単に削除するだけではありません。時々しか重要にならない、常に読み込まれているガイダンスについては、スキルや「オンデマンドで読み込まれる」ネストされた CLAUDE.md ファイルへの移動を提案します。パススコープのルールもドキュメント化された選択肢の一つで、これらは「Claude が一致するファイルを操作するときにのみ」読み込まれます。
prompt-audit がフラグを立てる項目
診断（checkup）がセットアップをレビューするのに対し、prompt-audit はあなたの「書き方」をレビューします。Anthropic は次のように述べています。「セットアップではなく指示を監査するには、Claude Code のプロンプトで /doctor prompt-audit を実行してください」。
記憶に関するドキュメントでは、チェック対象を次のように説明しています。「Claude は、古いモデル向けに書かれた指示、存在しないファイルやコマンドへの参照、および互いに矛盾するファイルなどの問題を探します」。
これらはそれぞれ実際の失敗パターンです：
- 古いモデル向けに書かれた指示。 これを導入した変更履歴では、監査を「古いモデル向けに書かれたプロンプティングパターンのチェック」と説明しています。
- 古くなった参照。 移動したファイルパスや名前が変更されたスクリプトは、Claude に存在しないものを探させる原因になります。
- 矛盾。 Anthropic は「2つの指示が互いに矛盾している場合、Claude はどちらかを任意に選択する可能性がある」と指摘しています。
後のリリースでレポートの順序が変更されました。「古くなったパス、古くなったコマンド、矛盾する指示ファイルがレポートの先頭に表示されるようになり、Claude Code がドキュメント化している思考キーワードは維持されるようになりました」。
対象範囲
「デフォルトでは、監査は CLAUDE.md、CLAUDE.local.md、AGENTS.md ファイルに加え、.claude/ および ~/.claude/ 下のルール、スキル、コマンド、サブエージェント、出力スタイルをカバーします」。
特定のファイルやフォルダを監査するには、そのパスを渡します。Anthropic の例は /doctor prompt-audit .claude/skills/deploy です。
変更される内容
あなたが依頼するまで、何も変更されません。「提案された編集内容を含む調査結果のレポートが届きます。Claude に適用を依頼するまで、ファイルの内容は変更されません」。
要件
監査は「バンドルされた /claude-api スキルを通じて実行されます」。このスキルが skillOverrides や disableBundledSkills でオフになっている場合は利用できません。また、Claude Code v2.1.283 以降が必要です。
/skill-doctor が各スキルのコストをどのように表示するか
スキルには独自のコンテキストコストがあります。Anthropic のスキルに関するドキュメントには次のようにあります。「スキルリストにあるすべてのスキルは、Claude がそれを使用するかどうかにかかわらず、毎ターンあなたのコンテキストに追加されます」。
/skill-doctor はそのためのレポートです。Anthropic によれば、これは「各スキルのコストと使用頻度を表示し、どれをオフにするか判断できるようにする」ものです。
レポートに含まれる内容：
- バンドルされたスキルおよびエンタープライズスキル以外の、セッション内のスキル。
- 「一度も呼び出されたことがない」スキルへのフラグと、それらをオフにする場所。
- 最近使用していないプラグイン。
- Anthropic のアドバイス：「オフにする場所が示されたスキルのうち、コンテキストコストが最も高いものから始めてください」。
対話型セッションでは、レポートは /plugin マネージャーの Stats タブで開きます。-p を付けると、Claude Code はそれをテキストとして出力します。v2.1.252 以降と機能フラグの取得が必要です。スマートフォンやブラウザからの Remote Control 経由では利用できません。セッションが実行されているマシンのターミナルで実行してください。
どれを実行すべきか
- 動作がおかしい、または起動が遅いと感じる場合: ターミナルで
claude doctorを実行し、読み取り専用のインストール診断を行います。 - セッションがすぐに一杯になる、または指示が無視される場合:
/doctorで CLAUDE.md のトリミングを含む完全な診断を行います。 - 指示が古くなっている、または矛盾している可能性がある場合:
/doctor prompt-auditで、書いた内容に関するレポートを確認します。 - 多くのスキルをインストールしている場合:
/skill-doctorで、各スキルのコンテキストコストと使用状況を確認します。
トリミング時に残すべきもの
診断自体のルールが最良のガイドです。Claude がコードベースから派生できるものはカットし、「落とし穴、根拠、およびツールのデフォルトとは異なる慣習」を残します。
残すべき部分は、コードが Claude に伝えることができない部分です。テストが不安定な理由、2つのスクリプトを実行しなければならない順序、レビュアーが常に求める慣習などです。これらは、一つのリポジトリの CLAUDE.md 以外でも重要な部分です。例えば、同様のルールを持つ新しいプロジェクトを開始したり、別のツールで作業したりする場合などです。
Claude 自体がノートを保存する場合、それらは auto memory（自動記憶）に保存され、独自のインデックスと制限を持ちます。Claude Code の auto memory とは何か に関するガイドで、それが CLAUDE.md とどう違うのかを説明しています。
よくある間違い
claude doctor を実行して満足してしまう。 これはインストールのチェックのみです。CLAUDE.md や拡張機能のチェックは /doctor にあります。
コンテキストを節約するために CLAUDE.md をインポートに分割する。 インポートされたファイルは、それをインポートするファイルと一緒に読み込まれます。
200行未満にするために「根拠」を削除する。 診断が根拠や落とし穴を残すのには理由があります。
提案されたすべての編集を一度に受け入れる。 依頼するまで何も変更されないので、一つずつ確認してください。
すべてのスキルをインストールしたままにする。 リストにある各スキルは、毎ターンコンテキストに追加されます。
解決策：Claude が毎セッション読み込む内容をクリーンアップする
ステップ 1: 診断を実行する
セッションで /doctor と入力し、承認する前に各領域の調査結果を読みます。
ステップ 2: 書いた内容を監査する
/doctor prompt-audit を実行し、古くなったパス、古くなったコマンド、および矛盾を最初に修正します。
ステップ 3: 使用していないスキルをオフにする
/skill-doctor を実行し、コンテキストコストが最も高い未使用のスキルから対処します。
ステップ 4: 残した根拠を保存する
残した落とし穴、理由、慣習を、このリポジトリ以外でも再利用できる場所にコピーします。
MemoryLake でのセットアップ
診断は、Claude がコードから読み取れるものと、あなただけが知っているものを分けるのに優れています。落とし穴、理由、チームの慣習などの後者のグループは、複数のプロジェクトや複数のツールで使用できる場所に保管しておく価値があります。
MemoryLake は、慣習、決定事項、およびその背後にある理由など、プロジェクトに関する知識のための記憶レイヤーです。これらを一箇所で管理し、ChatGPT、Claude Code、Codex など、接続したアシスタントから利用できるようにします。
エントリーはあなた自身の言葉で書きます。CLAUDE.md ファイル、ルール、スキル、auto memory、~/.claude フォルダ、またはベンダーのストレージから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。診断と prompt-audit は Anthropic が説明している通りに機能し、どの編集を適用するかは依然としてあなたが決定します。
ステップ 1: API キーを作成する
サインインしてダッシュボードからキーを生成します。他の認証情報と同様に、リポジトリの外に保存してください。
ステップ 2: 最初の記憶をアップロードする
解決策のステップ4で保存したもの、つまり診断で残すように言われた落とし穴、理由、慣習から始めましょう。1エントリーにつき1項目です。
ステップ 3: AI とエージェントを接続する
Claude Code やその他の使用しているアシスタントを接続します。接続したすべてのプロジェクトとツールで同じエントリーが利用可能になります。
実践で何が変わるか
第一の違いは、心配する必要のないスリムな CLAUDE.md です。常に読み込まれるコンテキストから削ぎ落とした「理由」は、依然として記録されています。
第二は、プロジェクト間での再利用です。どこでも従う慣習を各リポジトリにコピーする必要がなくなります。
第三は、他のツールでも同じ知識が使えることです。Codex や ChatGPT もこれらのエントリーを活用できます。
Claude Code における /doctor のベストプラクティス
claude doctor だけでなく /doctor を使用する。 CLAUDE.md と拡張機能のチェックはセッション内で行われます。
CLAUDE.md を 200 行未満に保つ。 長いファイルはコンテキストを消費し、指示への準拠率を低下させます。
根拠を残し、派生可能なものはカットする。 これが診断自体のルールです。
モデル変更後に prompt-audit を実行する。 古いモデル向けに書かれた指示を探します。
矛盾を最初に修正する。 Claude は矛盾する2つの指示から任意に1つを選ぶ可能性があります。
コストに基づいてスキルを整理する。 コンテキストを最も消費する未使用のスキルから始めます。
適用前にレビューする。 あなたが依頼するまで何も変更されません。
結論
Claude Code の /doctor は完全なセットアップ診断です。インストールの健全性、拡張機能、CLAUDE.md ファイル、権限、使用量をチェックし、確認後に適用される修正案を提示します。CLAUDE.md については、コードベースから派生できる内容をカットし、落とし穴、根拠、慣習を残します。ターミナルの claude doctor は読み取り専用のインストールチェックです。
/doctor prompt-audit は指示ファイルをレビューして古いガイダンス、古くなった参照、矛盾を確認し、/skill-doctor は各スキルのコンテキストコストと使用頻度を表示します。これらを組み合わせて使用することで、毎セッション読み込まれる内容をスリムに保ち、残すと決めた推論を再利用可能な場所に保管してください。