FAQ・トラブルシューティング

Claude Codeは、コードベースを読み、ファイルを編集し、コマンドを実行して検証まで進められるエージェント型のコーディングツールです。ターミナルを中心に、対応するIDEやWebの実行環境からも利用できます。

Guide: 初心者向け学習パス→

OSと管理方法に合う手順を公式のAdvanced setupで選び、インストール後に `claude --version` で実行ファイルを確認します。起動できない場合は、別の方法を重ねて入れる前に公式トラブルシューティングでPATHとインストール方式を確認してください。

Guide: 初心者向け学習パス→

まず `claude --version` と `claude doctor` で現在の実行ファイルと導入方式を確認します。更新方法は導入方式ごとに異なるため、公式のAdvanced setupにある該当手順で更新し、ターミナルを開き直して版を再確認します。

対象プラン、地域別料金、利用枠、API従量課金は変更されるため、このFAQでは固定値を掲載しません。契約前は公式Pricing、利用中はClaude Codeの `/status` と契約画面で、現在使っている認証方式と利用状況を確認してください。

CLAUDE.mdは、実行コマンド、規約、構成など、Claude Codeに繰り返し伝えるプロジェクト指示を保存するMarkdownファイルです。抽象的な希望ではなく、リポジトリで確認できる事実と短い手順を記載し、共有範囲に応じて配置します。

Guide: CLAUDE.md 完全ガイド→

新しいターミナルで実行し直し、シェルが参照するPATHと導入先を公式のインストール診断に沿って確認します。複数のインストール方式を重ねると原因が増えるため、利用する方式を一つに決めてから修復または再導入します。

`claude --version` に加えて、macOS/Linuxでは `which -a claude`、PowerShellでは `Get-Command claude -All` で候補を確認します。複数候補があれば、実際に起動している導入方式を特定し、その方式の公式更新手順だけを実行します。

`/permissions` でルールの内容と出所を確認し、繰り返し使う安全な操作だけを狭いパターンで許可します。Ask、Allow、Denyの適用順と設定スコープを確認し、すべての確認を外す設定を通常環境の近道にしないでください。

Reference: 設定とコマンド→

`/permissions` で一致したルールと読み込み元の設定ファイルを確認します。より強いDenyやAsk、異なるスコープの設定、ツール名・引数パターンの不一致がないかを見て、広いAllowを足す前に既存ルールを狭く修正します。

MCP（Model Context Protocol）は、Claude Codeから外部のデータソースやツールへ接続するためのオープンな規格です。接続先を追加する前に提供元を確認し、必要な操作だけを許可して、`/mcp` で接続状態と認証状態を確認します。

Guide: MCP サーバー→

`claude mcp list` と `/mcp` で、失敗しているサーバーと認証状態を特定します。ローカル接続は実行コマンドと環境変数、HTTP接続はURLとOAuthを確認します。プラグイン由来のサーバーはプラグイン側で管理し、手動設定との二重登録を避けます。

Guide: MCP サーバー→

`/hooks` でイベント、matcher、handler、設定元を確認し、Hook内のコマンドを同じ作業ディレクトリから単独実行します。解決しない場合は `claude --debug-file <path>` でログの出力先を指定し、matcherの一致と終了状態を確認します。

Guide: Hooks で作業を自動化→

まず `/status` で実際に使われている認証方式を確認します。購読アカウントで使うつもりでも環境変数のAPIキーが優先されていないかを見て、必要なら `/logout` 後に再起動してログインし直します。クラウド経由の場合は、そのクラウドの資格情報も同じシェルから確認します。

Skillは、説明と手順をファイル群としてまとめ、必要な場面で読み込ませる再利用単位です。スラッシュコマンドは対話画面から機能を呼び出す入口です。利用できる名前は導入済みの構成で変わるため、現在のセッションのメニューやヘルプで確認します。

Guide: 中級者向け学習パス→

プラグインは、Skills、エージェント、Hooks、MCPサーバーなどをまとめて配布できる単位です。`/plugin` で導入元、インストール済み項目、読み込みエラーを確認し、信頼できるマーケットプレイスから必要なものだけを有効にします。

Guide: 上級者向け学習パス→

`/plugin` のInstalledとErrorsで有効な構成を確認し、同じ役割を持つプラグインを一つずつ無効化して原因を切り分けます。変更後は `/reload-plugins` を実行し、名前空間付きのSkill名、重複するHook、二重起動したMCPサーバーを順に確認します。

上限は選択中のモデル、提供経路、プランなどで変わるため、単一の固定値では案内できません。現在のセッションは `/context` で内訳を確認し、長い作業では `/compact` に残したい焦点を添えるか、無関係な作業へ移る前に `/clear` を使います。

Reference: コマンド一覧→

長いセッションではコンパクションが行われます。`/context` で現在の内訳を確認し、重要な焦点を添えて `/compact` を実行します。継続して必要なプロジェクト指示はルートのCLAUDE.mdへ、作業中だけ必要な判断は進捗メモへ分けて保存します。

Reference: セッション管理→