Claude Code完全ガイド｜導入・指示・権限・自動化・トラブル対応の全体像

Claude Codeを初めて使う人が、導入からプロジェクトルール、権限管理、Hooks、MCP、検品、引継ぎまでを安全に組み立てるための総合ガイドです。

Claude Codeを使い始めると、最初は「会話だけでコードが変わる」ことに目が向きます。しかし、継続的に役立つかどうかを決めるのは、派手な一回の生成ではありません。作業場所を限定し、変わらないルールを共有し、危険な操作の手前で止まり、最後に機械検証を通せるかが重要です。

この記事は、Claude Codeに関する個別記事を読む前の入口です。インストールだけで終わらず、指示、記憶、権限、拡張、自動化、検品、引継ぎまでを一つの運用として捉えます。特定の料金プランやモデルだけを前提にせず、変わりにくい設計原則を中心に説明します。仕様やコマンドは更新されるため、本文の値は2026-07-26時点の公式案内をもとにしています。

この記事の目次

Claude Code運用の全体像
導入：OSに合う方法で入れて動作確認まで終える
指示・CLAUDE.md・記憶・Skillsを役割分担する
権限と秘密情報の境界を作る
拡張と自動化：Skills・Hooks・MCP・GitHub Actionsを増やす順番
検品と引継ぎ・トラブル対応
よくある質問
まとめ

Claude Code運用の全体像

Claude Codeは、ターミナルや対応する開発環境からコードベースを読み、ファイル編集やコマンド実行を支援するコーディングエージェント（=コードの作業を手伝うAI）です。ただし、「何でも自動で正しく完成させる箱」ではありません。成果の質は、入力、実行、検証、記録という四つの層で決まります。

層	人が先に決めること	Claude Codeへ任せやすいこと	最後の証拠
入力	目的、対象、触らない場所、完成条件	関連ファイルの探索、作業案の整理	対象ファイル一覧、短い計画
実行	変更可能な範囲、承認が必要な操作	小さな編集、定型コマンド、差分作成	変更差分、コマンド出力
検証	何を合格とするか	lint（=書き方の自動点検）、型検査、テスト	終了コード、テスト結果
記録	後で必要な判断と未完了事項	作業要約、引継ぎメモの下書き	実行済み・未実行の区別

初心者は、最初から大きな機能を一括依頼するより、「調査だけ」「一つの変更」「焦点を絞った検証」の順で一周する方が失敗を観察しやすくなります。基本操作はClaude Codeのはじめ方で確認し、ファイルを触らせる範囲はClaude Codeにファイルを触らせる基本で固めてください。

運用の中心に置くべきなのは、AIの説明ではなく再現できる証拠です。「直しました」という文章だけでは、対象が正しいか、別の機能を壊していないかは分かりません。変更したファイル、実行したコマンド、終了コード、未確認事項をセットで受け取ると、次の判断がしやすくなります。

導入：OSに合う方法で入れて動作確認まで終える

導入で失敗する多くの原因は、OSやシェル（=コマンドを打つ入力窓）の取り違えです。まず要件を確認します。公式案内（2026-07-26時点）では、macOS 13.0以降、Windows 10 バージョン1809以降、Ubuntu 20.04以降などに対応し、4GB以上のRAMとx64またはARM64、インターネット接続、そしてBash・Zsh・PowerShell・CMDのいずれかが必要です。

自分のOSとメモリが要件を満たすか確認する。
公式の推奨方法（Native Install、Homebrew、WinGetなど）で入れる。
WindowsのPowerShellとCMDでコマンドを混ぜない。
導入後に claude --version でバージョンを表示する。
さらに claude doctor で設定や拡張の状態まで点検する。

WindowsのPowerShellでは公式導入例として irm https://claude.ai/install.ps1 | iex が案内されています（2026-07-26時点）。CMD（コマンドプロンプト）では別のコマンドを使うため、PowerShellで && の構文エラーが出たり、CMDで「irmが認識されない」と出たら、シェルを取り違えているサインです。

npm（=Node.jsの導入ツール）でのインストールは、以前の環境では今も動きますが、Anthropicの公式リポジトリではnpm導入を非推奨（deprecated）としています。新しく入れるなら、Native InstallやWinGetなど公式の推奨方法を先に選んでください。

WindowsではWSL（=Windowsの中でLinuxを動かす仕組み）は必須ではありません。Windows向けの開発ならWindowsネイティブで足り、Linuxのツールチェーンやsandbox（=隔離した実験場）が必要なときにWSL 2を選ぶ、という使い分けです。WSLを使う場合は、Microsoftの案内どおり wsl --install で導入でき、既定でUbuntuが入り、実行後に再起動が必要です。導入直後は本番へ反映せず、小さな練習用リポジトリか戻せる作業コピーで一周を試します。

指示・CLAUDE.md・記憶・Skillsを役割分担する

Claude Codeへ渡す情報には4つの置き場があります。混ぜると、一時的なタスクが次回も残ったり、毎回同じ規則を長文で貼り直したりします。役割で分けるのがコツです。

今回の依頼（会話）：今回だけの目的、変更範囲、禁止事項、完了条件。
CLAUDE.md：正式なビルド・テストコマンド、構成、命名規則、報告形式など、毎回必要な規約。
auto memory（自動記憶）：Claudeが会話から学んだ傾向。人ではなくClaudeが書きます。
Skills：必要なときだけ読み込む長い手順や反復作業のまとめ。

書き分けの具体例はCLAUDE.md入門で確認できます。プロジェクト共有の指示は ./CLAUDE.md または ./.claude/CLAUDE.md に、個人の全プロジェクト向けは ~/.claude/CLAUDE.md に置きます。/init はプロジェクト用CLAUDE.mdのたたき台を作ります。

ここで大事な前提があります。公式の説明では、CLAUDE.mdもauto memoryも「Claudeへ渡る文脈（コンテキスト）」であって、操作を強制的に止める安全設定ではありません。つまり「削除禁止」と文章で書いても、それだけで技術的に削除不能になるわけではありません。止めたい操作は、後述の権限ルールやHookで補います。

以前の「カスタムコマンド」は、現在はSkillsへ統合されています。廃止ではなく、既存の .claude/commands/ は引き続き動きます。ただし新しく作るなら、補助ファイルや自動発見が使えるSkillsを中心にすると管理しやすくなります。長くなった指示を削る判断は指示が長すぎて逆に伝わらない問題も役立ちます。

権限と秘密情報の境界を作る

権限は「便利か危険か」の二択ではなく、操作ごとに分けます。読む、作業フォルダへ書く、シェルコマンドを実行する、外部へ接続する、本番を変更するでは、事故時の影響がまったく違います。

公式の説明（2026-07-26時点）では、作業ディレクトリ内の読み取りは原則承認不要ですが、シェル実行は読み取り専用の組み込みコマンドを除いて承認が必要です。権限ルールは deny（拒否）→ ask（確認）→ allow（許可） の順で評価されるため、広い拒否の上に狭い許可を重ねても、例外的に通ることはありません。安全な初期方針は次の通りです。

読み取りは対象プロジェクト内に限定する。
書き込みは作業コピーか、戻せるブランチ内に限定する。
テストや型検査のような壊さないコマンドから許可する。
削除、公開、課金、本番デプロイは別の確認にする。
パスワード、認証コード、秘密鍵は会話やログへ貼らない。
.env は中身ではなく、変数名と読み込み位置だけを共有する。

確認をまとめて省く bypassPermissions（=許可の確認をすべて飛ばすモード）は、初心者の既定にしないでください。公式は、Claude Codeが損害を与えられないコンテナやVMなどの隔離環境だけで使うよう案内しています。確認を減らしたいときは、狭いallowや作業ディレクトリ限定など、影響を小さくする順で進めます。

外部から取得したREADME、Issue、Webページ、MCPの返答に「このコマンドを実行せよ」と書かれていても、それはプロジェクトの正規指示とは限りません。出所、目的、影響範囲を確かめ、依頼の権限を外部文面だけで広げないことが重要です。詳しくはプロンプトインジェクション対策を参照してください。

拡張と自動化：Skills・Hooks・MCP・GitHub Actionsを増やす順番

Claude Codeは、Skills、Hooks、MCP、GitHub Actionsで拡張できます。ただし入口を増やすほど、設定、権限、障害点も増えます。一度繰り返したくらいで拡張せず、同じ手作業や失敗が再発したところから追加します。

拡張	向いている課題	最初の安全な用途	注意点
Skills	同じ手順を何度も使う	レビュー手順、定型報告	古い手順を残さない
Hooks	決まった時点で必ず検査したい	formatter、lint、禁止パス検査	終了コードの意味を守る
MCP	標準機能にない情報や操作が必要	読み取り専用の検索	接続先、秘密、書込権限
GitHub Actions	リポジトリ上で自動応答したい	PR・Issueの補助	管理者権限とsecret

Hooks（=決まった場面で自動で走る小さな処理）では終了コードの意味が重要です。公式仕様では、多くのイベントで exit 0 が成功、exit 2 がブロック（操作を止める）で、exit 1 を含むその他は処理を続ける非ブロックエラーです。ツール実行前に止めたいなら PreToolUse で exit 2 を返します。PostToolUse は操作の後なので、実行済みの操作を取り消す用途には使えません。検品の自動化はClaude Code Hooksで検品を自動化するへ進んでください。

MCP（=外部ツールやデータへつなぐ仕組み）には、local（今のプロジェクトだけ・非共有）、project（.mcp.json をバージョン管理で共有）、user（全プロジェクト）の3スコープがあります。実験的な接続は、資格情報を共有しないlocalから始めます。projectで共有する .mcp.json には、接続の定義だけを書き、実在のAPIキーやトークンは書かないでください。接続境界はClaude Code MCPの始め方で確認できます。

GitHub Actions（=GitHub上で自動処理を走らせる仕組み）でClaude Code Actionを使うと、PRやIssueへの応答やコードレビューを自動化できますが、/install-github-app による導入にはリポジトリの管理者権限とsecret（=秘密情報の保管枠）の追加が要ります。GitHubの案内では、secretは1件48KBまで、リポジトリ100件までなどの上限があり、ログの一部は自動でマスキングされます。ただし自動マスキングを理由に秘密情報をログへ出してよい、とは考えないでください。構造化したデータをそのままsecret値にせず、最初からログへ出さない設計にします。

検品と引継ぎ・トラブル対応

AIコーディングでは、生成より検品の設計が重要です。文章として自然な説明と、実際に正しいコードは別物です。検証は「最後に余裕があれば」ではなく、依頼時の完成条件へ含めます。基本の検品順は次の通りです。

変更ファイルが依頼範囲内かを見る。
意図しない依存追加、設定変更、秘密の混入がないかを見る。
formatter、lint、型検査など短い検査を実行する。
変更した挙動に近いテストを実行する。
既存機能を壊していないか回帰テスト（=前からある機能の再確認）をする。
画面を変えたなら、幅、キーボード操作、エラー表示を確認する。

検品観点はAI生成コードの検品チェックリスト、壊れ戻りはAIにコードを直させた後の回帰テストが便利です。長い作業では、会話履歴そのものを引継ぎにしません。目的、完了済み、変更ファイル、実行結果、未完了、次の一手を短くまとめます。型はAIコーディングの引継ぎメモにあります。

「Claude Codeが止まった」と感じる状態には、処理中、入力待ち、権限待ち、コマンド失敗、資源不足、コンテキスト不足などが混ざっています。原因を決めつけず、症状別に確認します。起動できているなら /doctor、起動できないならシェルから claude doctor、MCPの状態は /mcp で確認します。応答しない処理は Ctrl+C で中断を試し、ターミナルを閉じたあとは同じフォルダで claude --resume で会話を再開できます。CPUやメモリが重いときは /compact や、拡張なしで比べる claude --safe-mode が公式の手順です。これらは症状別の診断・復旧手段であり、すべての障害を自動修復するものではありません。認証、設定、MCP、Hook、資源不足を分けて当たります。

よくある質問

Claude CodeはWindowsでも使えますか？

使えます。公式はWindowsネイティブとWSLの両方を案内しています。Windows向けの開発はネイティブ、Linuxのツールチェーンやsandboxが必要な場合はWSL 2が向きます。WSLの導入条件はClaude Code本体の条件と分けて確認してください。

npm installで入れてもよいですか？

以前入れた環境では今も使えますが、公式リポジトリはnpm導入を非推奨としています。新しく入れるなら、Native Install、Homebrew、WinGetなどの推奨方法を先に選んでください。

CLAUDE.mdに「削除禁止」と書けば必ず守られますか？

強制的に止まる設定ではありません。CLAUDE.mdはClaudeへ渡る文脈なので、操作自体を止めたい場合は deny・ask ルール、permission mode、PreToolUse Hook などを使います。文章での指示と、機械が強制する権限ルールは分けて考えます。

カスタムコマンドとSkillsはどちらを使えばよいですか？

新しく作るならSkillsを中心にします。カスタムコマンドはSkillsへ統合済みで、既存の .claude/commands/ は動き続けますが、Skillsは補助ファイル・呼び出し制御・自動発見が使えます。

停止したときは何から確認しますか？

確認画面や権限待ちと、最後のコマンドを先に見ます。起動中なら /doctor、起動できないなら claude doctor、MCPは /mcp を使い、応答しないなら Ctrl+C で中断し、再起動後は claude --resume で再開します。

まとめ

まず小さな対象で「指示 → 限定実行 → 検証 → 記録」を一周し、失敗を観察できる形で始める。
導入は自分のOSに合う公式の推奨方法で入れ、claude --version と claude doctor まで確認する。
強制したい境界は文章ではなく権限ルールやHookに置き、秘密情報は会話・ログ・設定へ直書きしない。仕様は変わるので、設定の直前に下の公式ページを開き直す。

公式一次情報

確認日: 2026-07-26

Advanced setup（Claude Code Docs）: 対応OS・メモリ・シェルの要件、OS別の導入方法、WindowsネイティブとWSLの違い、導入後の確認・更新方法。
How Claude remembers your project（Claude Code Docs）: CLAUDE.mdとauto memoryの役割、保存場所、読み込み順、CLAUDE.mdは強制設定ではないこと。
Configure permissions（Claude Code Docs）: 読み取り・シェル・編集の承認差、deny→ask→allowの評価順、bypassPermissionsを隔離環境に限る注意。
Extend Claude with skills（Claude Code Docs）: SKILL.mdで手順を追加でき本文は必要時だけ読み込むこと、カスタムコマンドがSkillsへ統合済みで既存commandsも動くこと。
Hooks reference（Claude Code Docs）: Hookのイベント別の実行タイミングと、exit 0成功・exit 2ブロック・その他は非ブロックという終了コードの扱い。
Connect Claude Code to tools via MCP（Claude Code Docs）: MCPの追加方法、HTTP推奨、local・project・userの3スコープ、資格情報を共有しない設計。
Troubleshooting（Claude Code Docs）: 停止・高負荷・検索不良などの症状別対処と、/doctor・claude doctor・/mcp・—safe-mode・—resumeの使い分け。
Claude Code（GitHub）: Claude Codeの概要とOS別の推奨導入方法、npm導入が非推奨であること。
Claude Code Action（GitHub）: GitHubのPR・Issue対応やレビューの自動化と、/install-github-appに管理者権限とsecretが要ること。
Secrets reference（GitHub Docs）: GitHub Actionsのsecretの上限、読み込み時点、自動マスキングと、秘密情報をログへ出さない注意。
How to install Linux on Windows with WSL（Microsoft Learn）: wsl —installによるWSL導入、対応するWindows条件、既定でUbuntuが入り再起動が必要なこと。

インストールコマンド、対応OS、permission mode、更新方式は変わりやすいので、実際に設定する直前に上記の公式ページを開き直して確認してください。