Claude Codeの/doctorとは｜環境点検と修正の使い方
「Claude Codeの調子がなんとなく悪い」「設定が増えすぎて、どこが効いているのか分からない」——導入から数ヶ月たつと、誰もがこの感覚を抱えます。
結論から言うと、その点検は /doctor という1つのコマンドに任せられます。2026年7月の刷新で、単に状態を表示するだけでなく、たまった不要物を見つけて修正まで提案するようになりました。
株式会社Fyveは、常時起動のMac miniでClaude Codeを無人運用しています。この記事では、私が実際に「無人ジョブが壊れる前の点検」として /doctor をどう使っているかを、刷新点とあわせて解説します。
Claude Codeの/doctorとは｜環境を点検して直すコマンド
/doctor は、Claude Codeのインストール状態・設定・接続・権限などをまとめて点検する診断コマンドです。数秒でレポートが出て、各項目が緑（正常）・黄（警告）・赤（エラー）で色分けされ、何が問題で、どう直せばよいかまで示してくれます。
私は「動いてはいるが、なんとなく重い・不安定」というときに、まずこれを走らせます。原因をコミュニティのフォーラムやIssueページで探し回る前に、手元の環境が自分で自己申告してくれるイメージです。
/doctorが点検する主な項目
- インストール種別：npmグローバル／ローカル／ネイティブのどれか（アップデート経路や権限管理が変わる）
- ripgrepの状態：全文検索が正しく効くか
- サンドボックスの状態：コマンド実行の隔離設定
- MCPサーバーの設定：外部ツール連携が生きているか
- 環境変数の検証：APIキーなどが正しく渡っているか
- アップデート情報：新しいバージョンが出ていないか
なお /checkup は /doctor の別名（エイリアス）です。どちらを打っても同じ点検が走ります。
v2.1.205での刷新｜「健康チェック」から「点検＋修正」へ
もともと /doctor は、インストール・設定ファイル（settings JSON）・MCP設定・コンテキスト使用量を確認し、合否をアイコンで並べ、fキーで簡単な修正を当てられる——という狭い健康チェックでした。
これが2026年7月のv2.1.205で、たまった「散らかり」を見つけて直すところまでやる、フルのセットアップ点検に作り直されました。/doctor がリポジトリを走査し、次の7種類について修正を提案します。
- 重複したCLAUDE.mdの内容
- 使っていないskill・MCP・plugin（消費するコンテキスト量と引き換えに）
- 分割されていない、肥大したルートのCLAUDE.md
- 実行が遅いhook
- 古いバージョンのClaude Code
- オートモードがオフのままになっている
- 毎回再承認しているread-onlyコマンド（許可リストに入れ忘れているもの）
大事なのは、勝手に書き換えないことです。/doctor は自分のリポジトリに実際に当てはまるものだけを挙げ、プランを提示して確認を求めます。「全部片付ける」「カテゴリを選ぶ」「何も変えない」から選べて、設定変更は1行のトグル、CLAUDE.mdの編集は作業ツリーに落ちるので、通常のgit diffでレビューしてからコミットできます。
読者特典・無料ダウンロードClaude Codeを「素のまま」使うな無料でダウンロード →私が/doctorを「無人運用の前の点検」に組み込んだ理由
ここからは実運用の話です。私はMac miniを常時起動の自動化サーバーにして、claude -p のヘッドレス実行を毎日回しています。SEO記事の下書き、ニュースのまとめ投稿、ネタ出しといった定型ジョブが、深夜や早朝に無人で動いています。
無人運用の怖いところは、壊れても画面の前に誰もいないことです。たとえばMCPサーバーの認証が切れたり、外部APIのクレジットが尽きたりしても、エラーは静かにログの奥に沈んでいきます。実際に私の環境でも、あるMCP検索ツールがクレジット枯渇（HTTP 402）で無言のまま失効していたことがありました。
だから私は、新しいジョブを無人化する前や、環境をいじった後に /doctor を必ず一度走らせます。MCPサーバーの起動可否や環境変数の受け渡しを「無人で動かす前に、人がいる場所で」確認しておくためです。この自動化サーバーの作り方そのものは、別の記事で詳しくまとめています。
/doctorの使い方｜4ステップで点検から修正まで
手順そのものはとてもシンプルです。私は次の流れで使っています。
- 信頼できるディレクトリで実行する：Claude Codeのセッション内で
/doctor（または/checkup）と打つだけです。 - レポートを読む：緑・黄・赤の色分けで、正常・警告・エラーが一覧になります。数秒待つと、非同期の項目（MCPのトークン数やバージョン確認）も埋まります。
- プランを確認する：修正候補がまとまって提示されます。全部やる／一部だけ／何もしない、を自分で選びます。
- 差分をレビューして反映する：設定は1行トグル、CLAUDE.mdの変更はgit diffで確認してからコミットします。
1点だけ注意があります。/doctor は点検のためにワークスペースの信頼ダイアログをスキップし、MCPサーバーを実際に起動して健全性を確かめます。つまり、素性のわからないディレクトリで走らせると、信頼していないMCP設定まで起動してしまう恐れがあります。必ず自分が信頼しているプロジェクトの中でだけ実行してください。
実際に効いた点検ポイント
刷新後の /doctor で、私の環境に特に刺さったのは次の3つです。
1. 肥大したルートCLAUDE.mdと重複内容
私はモノレポ（全プロジェクトを1つのリポジトリで管理する構成）で運用しているため、ルートのCLAUDE.mdにルールが積み上がりがちです。/doctor は「分割されていないルートCLAUDE.md」「子の設定と重複した内容」を見つけて、整理を促してくれます。設定ファイルの役割分担を理解しておくと、この指摘への対処が早くなります。
2. 使っていないMCP・skill・plugin
連携を増やすほど、起動のたびに消費するコンテキストは膨らみます。/doctor は「読み込んでいるが使っていない」連携をコンテキストコストと対比で洗い出してくれるので、棚卸しの起点になります。認証情報を扱うMCPほど、生きているかどうかを定期的に確認しておきたい部分です。
3. 毎回再承認しているread-onlyコマンド
読み取りだけの安全なコマンドを毎回手で承認しているなら、それは許可リストに入れ忘れているサインです。/doctor はこうした「承認の取りこぼし」を拾ってくれるので、無人運用で承認待ちに詰まる事故を減らせます。
使うときの注意点と限界
- 信頼したディレクトリでのみ実行する：MCPサーバーを起動するため、素性不明のプロジェクトでは走らせない。
- 一部の点検は非同期：MCPのトークン数やバージョン確認はネットワーク待ちで、初回は結果が欠けて見えることがある。数秒待つ。
- 修正は必ず自分で確認してから当てる：
/doctorは提案までで、実行前に確認を挟む設計。差分を読まずに「全部片付ける」を選ばない。
点検を自動化に近づけたくなりますが、私は /doctor だけは人がいる場所で手を動かす工程として残しています。修正を確認する一手間が、無人運用の安全弁になるからです。
まとめ｜/doctorは「散らからせない」ための定期点検
Claude Codeの /doctor（別名 /checkup）は、v2.1.205でただの状態表示から、CLAUDE.mdの重複・肥大、使っていない連携、遅いhook、承認の取りこぼしまで見つけて直す、フルのセットアップ点検に進化しました。
私自身は、無人で回すジョブを増やす前の「人がいる場所での最終点検」として使っています。設定が増えてきたと感じたら、まず一度 /doctor を走らせてみてください。散らかりを溜め込む前に片付ける習慣が、Claude Codeを長く安定して使う近道になります。株式会社Fyveでも、この点検を運用の定番工程に組み込んでいます。
Claude Codeを「素のまま」使うな
設定で差がつく——CLAUDE.md・権限・スキルの実物を公開（全24ページ）
素のClaude Codeは"優秀な新入社員"。仕事を教えるほど、自分専用になります。覚えさせる4点セット——会社の説明書（CLAUDE.md）・権限の柵・手順書（スキル）・フォルダの地図——を、1人会社の実運用からコピペで使える型つきで公開します。
- そのまま書き換えて使えるCLAUDE.mdの型
- お金と送信をAIに触らせない「3段階の柵」
- 1回教えたら何度でも動く、手順書のコピペ雛形
- AIが迷子にならないフォルダ構造の3原則
毎週金曜の無料ニュースレター「ひとりAI経営」の購読特典です。メール登録後すぐ、ダウンロードページのご案内が届きます。あわせて、AI活用に関するお知らせやお役に立てそうなご案内をお送りすることがあります。解除はいつでも1クリック。
御社の業務に合わせたClaude Code導入支援
「AIツールを導入したが、現場で使われない」を終わらせる。
業務課題のヒアリングから設計、ハンズオン実践、運用定着まで一貫して支援します。