Claude Codeの機能がうまく動作しない時は「/doctor」コマンドを使ってみよう
はじめに
みなさん Claude Code で/doctorというスラッシュコマンドを使ったことがあるでしょうか。
デフォルトで Claude Code に用意されているスラッシュコマンドで、Claude Codeが健全な状態になっているかをチェックしてくれるコマンドです。
これまで使ってなかったのですが、今回助けられたので共有します。
Claude Code 使っていてスキルや hook がうまく動かないなーって時に実行してください。もしかしたら解消できるかもしれません。
プラグインでインストールしたスキルが使えない
私が遭遇したのは、プラグインでインストールしたスキルが使えなかったことでした。
example-skills というプラグインをマーケットプレイスからインストールしました。
example-skillsは Anthropic 公式が公開してくれているプラグインです。/pluginコマンドからインストールすることで、手軽に利用できます。
今回はskill-creatorというスキルを作成するためのスキルを利用するためにインストールしました。
> /plugin marketplace add anthropics/skills
⎿ Successfully added marketplace: anthropic-agent-skills
> /plugin install example-skills@anthropic-agent-skills
⎿ ✓ Installed example-skills. Restart Claude Code to load new
インストールは無事完了したようです。
Claude Code を再起動後、skill-creator スキルを使おうとしたのですが、以下のエラーが発生してしまいました。
> skill-creatorというスキルがプラグインでインストールされているので、それを使ってプルリクエスト作成スキルを作成してください
⏺ skill-creatorを使ってプルリクエスト作成スキルを作成します。
⎿ Error: Unknown skill: skill-creator
⏺ スキル名を確認させてください。利用可能なスキルのリストを確認します。
⏺ Bash(ls -1 ~/.claude/skills/)
⎿ hogehoge
hugahuga
⏺ skill-creatorが見つかりませんでした。現在インストールされているスキルは以下の2つです：
- hogehoge
- hugahuga
自分で作成した既存のスキルは見つかるのですが、インストールしたexample-skillsに含まれるスキルは認識してくれませんでした。~/.claude/plugins/のフォルダを確認すると、インストールされたexample-skillsのフォルダはちゃんとあるようです。
/Users/suzuki.jun/.claude/plugins/
├── marketplaces/
│ └── anthropic-agent-skills/
│ ├── algorithmic-art/
│ ├── brand-guidelines/
│ ├── canvas-design/
│ ├── document-skills/
│ ├── frontend-design/
│ ├── internal-comms/
│ ├── mcp-builder/
│ ├── skill-creator/
│ ├── slack-gif-creator/
│ ├── template-skill/
│ ├── theme-factory/
│ ├── web-artifacts-builder/
│ └── webapp-testing/
試行錯誤しましたが Claude Code が認識してくれず、プラグインでインストールしたスキルは利用できませんでした。
/doctor コマンドを実行する
何が悪いのか分からなかったので、とりあえず /doctor コマンドで現状を確認してみました。
> /doctor
Diagnostics
└ Currently running: npm-global (2.0.47)
└ Path: /opt/homebrew/Cellar/node/24.5.0/bin/node
└ Invoked: /opt/homebrew/bin/claude
└ Config install method: global
└ Auto-updates: default (true)
└ Update permissions: Yes
└ Search: OK (vendor)
Invalid Settings
/Users/suzuki.jun/.claude/settings.json
└ permissions
├ allow
│ └ "WebSearch(*)": WebSearch does not support wildcards. Use exact search terms without * or ?. Examples: WebSearch(claude ai), WebSearch(typescript tutorial)
└ deny
├ "Bash(sudo:*passwd*)": The :* pattern must be at the end. Move :* to the end for prefix matching. Examples: Bash(npm run:*), Bash(git commit:*)
├ "Bash(sudo:*shadow*)": The :* pattern must be at the end. Move :* to the end for prefix matching. Examples: Bash(npm run:*), Bash(git commit:*)
└ ...
Invalid Settings という警告が出ています。settings.json の設定方法が誤っているようです。
これが原因はわかりませんが、とりあえず修正していきます。
問題の修正
エラーメッセージをよく見ると、複数の問題が指摘されていました。
いつ触ったのか覚えていませんが、以前に設定していた内容が正しくなかったようです。
修正後、再度 /doctor を実行して確認します。
> /doctor
Diagnostics
└ Currently running: npm-global (2.0.47)
└ Path: /opt/homebrew/Cellar/node/24.5.0/bin/node
└ Invoked: /opt/homebrew/bin/claude
└ Config install method: global
└ Auto-updates: default (true)
└ Update permissions: Yes
└ Search: OK (vendor)
警告が消えました。設定ファイルの問題は解決できたようです。
スキルが動作するか確認
ターミナルを再起動後、改めてスキルを使ってみます。
> skill-creatorというスキルがプラグインでインストールされているので、それを使ってプルリクエスト作成スキルを作成してください
⏺ 了解しました。プルリクエスト作成スキルを作成します。
> The "skill-creator" skill is loading
**skill-creator スキルが正常に認識されるようになりました。**直接的な原因はわかりませんが、settings.jsonの問題を解消したことで正しく動作するようになったようです。
まとめ
/doctorコマンドのおかげで Claude Code の問題を特定し修正したことで、プラグインのスキルが使えない問題を解決しました。
今回はプラグインのスキルが使えないことで表面化しましたが、他にもうまく動作していない機能があったかもしれません。
こうした 「Claude Code がなんかうまく動かないな〜」ということがあれば、とりあえず/doctorを実行してみましょう。
もしかしたら解決するかもしれません。
以上、鈴木純がお送りしました。
