メインコンテンツへスキップ
見出し画像

Claude Code 完全ガイド ― インストールから自動化・チーム運用まで

    はじめに

    「Claude Code は使ってはいるけれど、CLAUDE.md と slash command と subagent と hook と MCP と plan mode の使い分けが結局よく分からない」。
    そういう声をよく聞きます。機能が多く、それぞれが似ているようで役割が異なるため、適当に使うと「全部 CLAUDE.md に書いて肥大化」「全部 hook で縛ってうるさい」といった極端に振れがちです。

    この記事は、2026年6月時点の最新ドキュメント(`code.claude.com/docs`)を踏まえて、Claude Code を過不足なく使い切るための完全ガイドです。インストール・基本操作から、CLAUDE.md/Skills/Subagents/Hooks/MCP の役割分担、CI 連携、複数 surface 間の移動、チーム運用まで、実務で必要な順に並べました。

    長いので、気になる節だけ拾い読みしても構いません。

    • 1. Claude Code とは: 立ち位置・他ツールとの違い

    • 2. インストールと初期設定: macOS / Windows / Linux / WSL

    • 3. 1日目に押さえる基本操作: 起動・許可・ファイル編集

    • 4. CLAUDE.md と auto memory: 永続記憶の正しい設計

    • 5. Skills(旧 custom commands を統合): 手順書を再利用する

    • 6. Subagents: コンテキストを爆発させない

    • 7. Hooks: 強制的な自動化

    • 8. MCP: 外部ツールとの接続

    • 9. Plan mode と permission: 暴走させない安全装置

    • 10. CLI 駆動: パイプ・ヘッドレス・CI

    • 11. 複数 surface: Terminal / VS Code / Desktop / Web / iOS / JetBrains

    • 12. スケジューラ: Routines と /loop

    • 13. チーム運用: 共有とポリシー

    • 14. つまずきポイント: よくある事故の防ぎ方

    • 15. チートシート: 最後にここだけ見れば

    1. Claude Code とは ― 「コードに触る Claude」の本体

    Claude Code はAnthropic 公式のエージェント型コーディングツールです。コードベースを読み、ファイルを編集し、ターミナルでコマンドを実行し、開発ツールと連携する、という一連の操作を Claude モデルに任せられます(公式:Overview)。

    公式ページの定義はシンプルで、「ターミナル・IDE・デスクトップアプリ・ブラウザで使えるエージェント型コーディングツール」。同じ Claude Code エンジンが6つの surface に共通で乗っており、`CLAUDE.md`・設定・MCP サーバなどを surface 間で共有できます。

    他の AI コーディング支援との違いを乱暴にまとめると:

    • 主なUI

      • GitHub Copilot: IDE 補完

      • Cursor: エディタ

      • Codex: App / CLI / IDE / Web / Chrome 拡張

      • Claude Code: Terminal / IDE / Desktop / Web / iOS / JetBrains

    • ファイル横断編集

      • GitHub Copilot: 中(Agent mode)

      • Cursor: 強

      • Codex: 強(Worktrees 対応)

      • Claude Code: 強

    • 永続記憶

      • GitHub Copilot: なし

      • Cursor: rules + memories

      • Codex: AGENTS.md

      • Claude Code: CLAUDE.md + auto memory

    • プロジェクト固有手順の再利用

      • GitHub Copilot: 限定(Custom Instructions)

      • Cursor: rules

      • Codex: slash commands / プロンプトテンプレ

      • Claude Code: Skills

    • 自動レビュー / 整形

      • GitHub Copilot: プラグイン依存

      • Cursor: 弱

      • Codex: Security プラグインあり(hook 相当は限定)

      • Claude Code: Hooks で強制可能

    • 外部ツール接続

      • GitHub Copilot: 限定

      • Cursor: MCP 対応

      • Codex: GitHub / Slack / Linear / MCP

      • Claude Code: MCP(標準)

    Claude Code の特徴を一言で言うなら、「セッションを横断する記憶」「再利用可能な手順」「強制可能な自動化」「外部ツール接続」が標準で揃っていること。これが他ツールとの差別化ポイントです。

    補足:Codex も2026年に入ってApp / CLI / IDE / Web / Chrome 拡張の5サーフェース体制に拡張され、Worktrees / Computer Use / Local Environments / In-app browser など、エージェント機能を多角的に展開しています。本記事で「Codex CLI」と表記しているのはあくまで CLI サーフェースを指す場合で、Codex 全体としては Claude Code と同じく「複数の入口を持つ統合エージェント」と捉えるのが現状に近い理解です。

    対象読者は、すでに開発で AI 補完を日常的に使っていて、「もう一段、自分のプロジェクト固有のルールやワークフローまで AI に覚えさせたい」と感じている方を想定しています。


    2. インストールと初回起動

    2.1 推奨インストール

    公式が一番推しているのはネイティブインストーラです。バックグラウンドで自動更新されます。

    macOS / Linux / WSL

    curl -fsSL https://claude.ai/install.sh | bash

    Windows PowerShell

    irm https://claude.ai/install.ps1 | iex

    Windows CMD

    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

    PowerShell と CMD は区別が必要です。プロンプトが`PS C:`なら PowerShell、`C:`なら CMD。

    ネイティブ Windows では Claude Code の Bash ツールが Git for Windows を使うため、入れておくと安心です。未インストールだと PowerShell を shell ツールとして使う動作になります。WSL では不要です。

    2.2 パッケージマネージャ派

    • Homebrew(推奨 cask): `brew install --cask claude-code`

    • Homebrew(最新追従): `brew install --cask claude-code@latest`

    • WinGet: `winget install Anthropic.ClaudeCode`

    • apt / dnf / apk: 公式手順

    注意:パッケージマネージャ経由は自動更新されません。`brew upgrade claude-code` / `winget upgrade Anthropic.ClaudeCode`を定期実行する習慣を作っておきましょう。

    2.3 初回起動

    プロジェクトディレクトリで`claude`を打つと初回ログインが走ります。

    cd your-project
    claude

    Claude Pro / Max などのサブスクリプション、または Anthropic Console アカウントが必要です。Terminal CLI と VS Code 拡張は サードパーティプロバイダ にも対応しています。

    2.4 IDE / Desktop / Web

    • VS Code / Cursor:拡張機能から「Claude Code」をインストール。インライン差分、`@`メンション、plan レビューが使えます。

    • JetBrains(IntelliJ / PyCharm / WebStorm 等):Marketplace のプラグインを入れて再起動。

    • Desktop アプリ:macOS / Windows / Windows ARM64 用。複数セッション並走、スケジュール、クラウドセッションの起動が GUI でできます。

    • Web:claude.ai/code で、ローカルに無いリポジトリにも触れます。iOS の Claude アプリからも入れます。

    ここがポイント:どの surface でも同じ CLAUDE.md・設定・MCP が使われるので、入り口を増やしても二重管理にはなりません。


    3. 1日目に押さえる基本操作

    CLI で`claude`を起動した後、最初に体に染み込ませたい操作は4つです。

    3.1 普通に話す

    @src/api/users.ts のテストを書いて、npm test を通して、失敗したら直して

    `@ファイル名`で対象ファイルを明示できます。これだけで Claude は Read → 計画 → Edit → Bash を回します。

    3.2 許可の三段階

    ツール呼び出しごとに「許可しますか?」が出ます。

    • このセッションだけ許可:今のセッション内ならもう聞かれない

    • このプロジェクトでずっと許可:`.claude/settings.local.json`に保存

    • 常に許可:`~/.claude/settings.json`に保存

    たとえば`npm test`を毎回許可していたら、`.claude/settings.json`の`permissions.allow`に`Bash(npm test:*)`を入れておけば次回から省略できます。

    3.3 Plan mode

    破壊的な変更を伴うタスクはPlan mode(`Shift+Tab`などで切替)で始めるのが安全。Claude は読み取り専用ツールだけで計画を立て、承認後に編集に入ります。詳細は Permission modes。

    3.4 `/init`でプロジェクト準備

    新しいリポジトリで`/init`を打つと、Claude がコードベースを読んで`CLAUDE.md`の叩き台(ビルドコマンド、テスト、命名規約など)を作ってくれます。`CLAUDE_CODE_NEW_INIT=1`で対話モードになり、Skills や Hooks の雛形まで提案してくれます。


    4. CLAUDE.md と auto memory ― 永続記憶の正しい設計

    画像

    Claude Code のセッションは毎回まっさらから始まりますが、2つの仕組みで知識を横断させます:

    • CLAUDE.md:あなたが書く永続指示

    • Auto memory:Claude が自分で書き残す学習メモ

    公式の整理(Memory)はこうです:

    • 書く人

    • 中身

      • CLAUDE.md: 指示・規約

      • Auto memory: 学習・パターン

    • スコープ

      • CLAUDE.md: プロジェクト / ユーザー / 組織

      • Auto memory: リポジトリ単位

    • ロード

      • CLAUDE.md: 毎セッション

      • Auto memory: 毎セッション(先頭 200行 or 25KB)

    • 主な用途

      • CLAUDE.md: コード規約、ワークフロー、アーキテクチャ

      • Auto memory: ビルドコマンド、デバッグ知見、嗜好

    4.1 CLAUDE.md の置き場所

    優先度の高い順:

    • Managed policy

      • パス: macOS `/Library/Application Support/ClaudeCode/CLAUDE.md`等

      • 用途: 組織ポリシー(IT 配布)

    • User

      • パス: `~/.claude/CLAUDE.md`

      • 用途: 個人の好み(全プロジェクト共通)

    • Project

      • パス: `./CLAUDE.md`または`./.claude/CLAUDE.md`

      • 用途: チームで共有(git 管理)

    • Local

      • パス: `./CLAUDE.local.md`

      • 用途: 個人のプロジェクト固有メモ(gitignore)

    ディレクトリツリーを上に辿りながら見つけたものをすべて結合します。サブディレクトリの CLAUDE.md は必要になった時に on-demand で読まれる(モノリポ向きの挙動)。

    4.2 書き方の鉄則

    公式の推奨は4つに集約されます:

    1. 200行以下:肥大化するとむしろ守られなくなる

    2. 見出し + 箇条書きで構造化

    3. 具体的に書く:「フォーマットを整える」より「2スペースインデント」

    4. 矛盾を残さない:複数 CLAUDE.md 間の矛盾は Claude が任意に選びます

    肥大化したら`@path/to/file.md`でimportに分割できます(最大4階層)。

    4.3 .claude/rules/ ― パス別の指示

    部分的にしか効かせたくないルールは、`.claude/rules/`の下に置いて frontmatter で対象を絞ります:

    ---
    paths:
      - "src/api/**/*.ts"
    ---
    
    # API 開発ルール
    - 全エンドポイントで入力バリデーション
    - エラーレスポンスは標準フォーマット
    - OpenAPI コメント必須

    `src/api/`配下のファイルを Claude が読んだ時だけロードされます。

    4.4 Auto memory

    v2.1.59 以降では Claude が**`~/.claude/projects/<project>/memory/`**に自動でメモを書き残します。`MEMORY.md`がインデックスとして毎セッションロードされ、`debugging.md`など個別ファイルは必要な時に Claude が自分で読みます。

    `/memory`コマンドでブラウズ・編集可能。「`pnpm`を使って、`npm`じゃない」のような細かい嗜好は auto memory に任せ、CLAUDE.md には構造的事実だけ書くのがバランスの取れた使い方です。

    4.5 AGENTS.md 共存

    Codex CLI 等が使う`AGENTS.md`をすでに置いているなら、`CLAUDE.md`で`@AGENTS.md`を import して共存させるのが定石です。


    5. Skills ― 繰り返しを資産化する(旧 custom commands を統合)

    5.1 何が変わったか

    公式ドキュメントの注記がポイントです:

    Custom commands have been merged into skills.
    `.claude/commands/deploy.md`と`.claude/skills/deploy/SKILL.md`はどちらも`/deploy`を作る。既存の`commands/`も動き続ける。

    つまり、これからはSkills が標準です。Skills は Agent Skills という オープン規格 に準拠していて、他の AI ツールとも互換性があります。

    5.2 最小サンプル

    `~/.claude/skills/summarize-changes/SKILL.md`:

    ---
    description: 未コミットの変更を要約し、リスクを指摘する。「何が変わった?」「コミットメッセージほしい」「diff レビューして」と聞かれたら使う。
    ---
    
    ## 現在の変更
    
    !`git diff HEAD`
    
    ## 指示
    
    上の diff を 2-3 個の箇条書きで要約し、エラーハンドリングの欠落、ハードコード値、テスト更新漏れなどのリスクを列挙。diff が空なら「未コミット変更なし」と答える。

    ポイントは2つ:

    • `description`の質が運命を決める:Claude はこれを読んで「自動で使うか」を判断します。具体的なトリガーフレーズを書きましょう

    • `` !`コマンド` ``で動的コンテキスト注入:Claude が見る前に shell コマンドが展開され、結果が本文に差し込まれます

    5.3 置き場所

    • Enterprise

      • パス: Managed settings 配下

      • 適用範囲: 組織全員

    • Personal

      • パス: `~/.claude/skills/<name>/SKILL.md`

      • 適用範囲: 自分の全プロジェクト

    • Project

      • パス: `.claude/skills/<name>/SKILL.md`

      • 適用範囲: このプロジェクトのみ

    • Plugin

      • パス: `<plugin>/skills/<name>/SKILL.md`

      • 適用範囲: プラグイン有効範囲

    5.4 frontmatter の主要フィールド

    • `description`: 必須級。Claude が「いつ使うか」を判定する

    • `disable-model-invocation: true`: 自動発動禁止、`/name`でのみ起動

    • `allowed-tools`: このスキル実行中は許可不要にするツール

    • `disallowed-tools`: このスキル実行中は禁止するツール

    • `model` / `effort`: スキル実行中だけモデル / 思考量を切替

    • `context: fork`: 別 subagent コンテキストで実行

    • `arguments`: `$name`置換できる位置引数

    5.5 バンドル済みスキル

    • `/run`:プロジェクト推測して起動

    • `/verify`:変更が動くか実アプリで確認(テストや型チェックに逃げない)

    • `/run-skill-generator`:プロジェクト固有の起動手順を`.claude/skills/run-<name>/`として記録

    v2.1.145 以降で使えます。`/run-skill-generator`を1回回しておくと、後続のセッションで`/run`がプロジェクト固有の起動手順を再発見せずに済みます。


    6. Subagents ― コンテキストを爆発させない

    画像

    6.1 なぜ必要か

    大きなコードベースの調査や、長いログ解析、複数 PR の横断レビューをメインの会話でやると、Claude のコンテキストウィンドウが調査結果で埋まり、本来やりたい実装が圧迫されます。

    Subagent は独立したコンテキストウィンドウで作業し、サマリだけメインに返します。

    6.2 ビルトイン subagent

    • Explore

      • モデル: Haiku

      • ツール: 読み取り専用

      • 役割: コードベース探索(高速・低コスト)

    • Plan

      • モデル: 親と同じ

      • ツール: 読み取り専用

      • 役割: Plan mode の調査用

    • General-purpose

      • モデル: 親と同じ

      • ツール: 全部

      • 役割: 探索 + 編集の複合タスク

    Explore / Plan は CLAUDE.md とリポジトリ状態を読まない仕様で、探索を高速・安価に保つ設計です。

    6.3 カスタム subagent の最小例

    `.claude/agents/codex-reviewer.md`:

    ---
    name: codex-reviewer
    description: Codex CLI 経由の第三者レビュー代行。差分を投げて指摘を返す。
    tools: Bash, Read
    model: sonnet
    ---
    
    あなたは Codex CLI 経由でレビューを依頼する代行エージェントです。
    渡された diff を `codex exec --output-last-message /tmp/cr.md ...` に投げ、
    応答テキストをそのまま返してください。余計な解釈・要約は加えないこと。

    メインからは:

    Agent({ subagent_type: "codex-reviewer", prompt: "<diff>" })

    あるいは`/agents`の対話 UI(LibraryタブからCreate new agent)で GUI 作成も可能です。

    6.4 CLI から動的定義

    その場限りで使いたい時は`--agents`フラグに JSON を渡せます:

    claude --agents '{
      "code-reviewer": {
        "description": "Expert code reviewer. Use proactively after code changes.",
        "prompt": "You are a senior code reviewer. Focus on quality, security, best practices.",
        "tools": ["Read", "Grep", "Glob", "Bash"],
        "model": "sonnet"
      }
    }'

    CI 上で「この回だけ専用エージェントを足す」用途に便利です。

    6.5 持続メモリ

    subagent にも`~/.claude/agent-memory/`で専用の auto memoryを持たせられます。コードレビュー subagent なら「このリポでよくある指摘パターン」を蓄積していけます。


    7. Hooks ― 強制的な自動化

    Skills / Subagents はClaude の意思に依存します。「絶対にこのタイミングで走らせたい」処理はHooksで固めます。

    7.1 主要イベント

    公式リストは長いですが、頻用するのはこのあたり:

    • セッション

      • イベント: `SessionStart` / `SessionEnd`

      • 用途: 起動時の env 読込・終了時のログ送信

    • セッション

      • イベント: `InstructionsLoaded`

      • 用途: どの指示がロードされたかの確認

    • ターン

      • イベント: `UserPromptSubmit`

      • 用途: プロンプト前処理(マスキング等)

    • ターン

      • イベント: `Stop` / `StopFailure`

      • 用途: 応答完了 / エラー時の後処理

    • ツール

      • イベント: `PreToolUse`

      • 用途: 危険コマンドをブロック

    • ツール

      • イベント: `PostToolUse`

      • 用途: Write / Edit の後に formatter

    • ツール

      • イベント: `PermissionRequest` / `PermissionDenied`

      • 用途: 監査ログ

    7.2 設定ファイルの階層

    • `~/.claude/settings.json`: 全プロジェクト共通

    • `.claude/settings.json`: プロジェクト(git 管理)

    • `.claude/settings.local.json`: プロジェクトの個人設定(gitignore)

    • Plugin 配下: プラグインに同梱

    7.3 PostToolUse で自動 formatter

    `.claude/settings.json`:

    {
      "hooks": {
        "PostToolUse": [
          {
            "matcher": "Edit|Write",
            "hooks": [
              {
                "type": "command",
                "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/format.sh",
                "timeout": 30,
                "statusMessage": "Running formatter..."
              }
            ]
          }
        ]
      }
    }

    `.claude/hooks/format.sh`:

    #!/bin/bash
    input=$(cat)
    file_path=$(echo "$input" | jq -r '.tool_input.file_path')
    
    case "$file_path" in
      *.js|*.ts|*.jsx|*.tsx) npx prettier --write "$file_path" ;;
      *.py)                  python -m black "$file_path" ;;
      *.json)                jq '.' "$file_path" > "${file_path}.tmp" && mv "${file_path}.tmp" "$file_path" ;;
    esac
    
    exit 0

    これだけで Claude が Edit / Write するたびに整形が走ります。

    7.4 PreToolUse でブロック

    危険コマンドを未然に止めたい時は`PreToolUse`で exit せず JSON を返します:

    {
      "hookSpecificOutput": {
        "hookEventName": "PreToolUse",
        "permissionDecision": "deny",
        "permissionDecisionReason": "Destructive command blocked"
      }
    }

    `rm -rf /`や`git push --force main`を絶対拒否、といった用途に最適です。


    8. MCP ― 外部ツールと繋ぐ標準プロトコル

    Model Context Protocol は、AI ツールと外部データソースをつなぐオープン規格。Claude Code は MCP クライアントとして組み込み対応しています。

    MCP を入れると Claude が:

    • Google Drive の設計ドキュメントを読む

    • Jira のチケットを更新する

    • Slack からデータを取る

    • 社内独自ツールを叩く

    といった操作を、普通のツール呼び出しと同じ感覚で使えるようになります。

    `.mcp.json`でプロジェクトに紐付ける形式と、`claude mcp add`で対話的に追加する方法があります。「MCP は重装備」と感じたら、まずは Bash + Skills で代替できないか考えるのが定石です。


    9. Plan mode と Permission ― 暴走を防ぐ安全装置

    9.1 Plan mode

    `Shift+Tab`などで切り替えると、Claude は読み取り専用ツールしか使えなくなり、編集や実行は計画提示のみで止まります。承認すると通常モードに戻って実行を開始。

    「マイグレーションを書かせたい」「設定を大きく変えたい」など、取り返しのつかない変更を含むタスクは Plan mode から入るのを習慣化するとミスが激減します。

    9.2 Permission 設定

    `.claude/settings.json`の`permissions`で`allow` / `deny` / `ask`を細かく指定できます:

    {
      "permissions": {
        "allow": ["Bash(npm test:*)", "Bash(git status:*)", "Read(./**)"],
        "deny": ["Bash(rm -rf:*)", "Bash(git push --force*)"],
        "ask": ["Bash(npm install:*)"]
      }
    }

    組織配布の`managed-settings.json`の`permissions.deny`は個人設定で覆せません。チーム共通のガードレールはここに置きます。


    10. CLI を使い倒す ― パイプ・ヘッドレス・CI

    Claude Code は Unix 哲学に沿った CLI でもあります。`-p`(プロンプト直渡し)と組み合わせると、普通のフィルタコマンドとして使えます。

    # ログ異常を Slack に通知
    tail -200 app.log | claude -p "Slack me if you see any anomalies"
    
    # CI 上で文言翻訳して PR を上げる
    claude -p "translate new strings into French and raise a PR for review"
    
    # 変更ファイルだけセキュリティレビュー
    git diff main --name-only | claude -p "review these changed files for security issues"

    主なフラグ(CLI reference):

    • `-p, --print`: 結果を出力して終了(非対話)

    • `--allowedTools`: 許可ツールを限定

    • `--output-format text|json|stream-json`: 出力形式

    • `--append-system-prompt`: システムプロンプトに追記

    • `--agents '{...}'`: その場で subagent 定義

    • `--add-dir <path>`: 追加ディレクトリの権限付与

    • `--mcp-config <path>`: MCP 設定の差し替え

    • `--teleport`: 別 surface のセッションを引き取る

    CI からのヘッドレス実行 → GitHub Actions / GitLab CI/CD との組み合わせで、PR レビュー・Issue トリアージ・依存更新を自動化できます。GitHub Code Review との統合(Code Review)を入れれば、全 PR で自動レビューが回ります。


    11. 複数 Surface ― どこからでも続ける

    同じセッションを複数の入口から触れます:

    • スマホから続行: Remote Control

    • Telegram / Discord / iMessage / 自作 webhook から流す: Channels

    • ローカルで始めて出先で続行: Web / iOS

    • 定期実行: Routines

    • PR レビュー自動化: GitHub Actions / GitLab CI/CD

    • 全 PR 自動レビュー: GitHub Code Review

    • Slack からバグ報告→PR: Slack

    • ブラウザ操作デバッグ: Chrome

    • 自作エージェント: Agent SDK

    ターミナルで作業を始めて、外出先でスマホから続けて、家に帰ったら Desktop に渡す、ということが普通にできます。

    特にDispatch(Desktop アプリ)は、スマホからタスクを投げると Desktop 上にセッションが立ち上がる仕組みで、長時間タスクの非同期処理に向いています。


    12. スケジューラ ― Routines と /loop

    繰り返し実行は3系統あります:

    • Routines

      • どこで動く: Anthropic 側(PC オフでも動く)

      • 用途: 朝の PR レビュー、夜中の CI 失敗解析、週次依存監査

    • Desktop scheduled tasks

      • どこで動く: あなたの PC

      • 用途: ローカルファイル・ツールへの直接アクセスが必要なジョブ

    • `/loop`

      • どこで動く: 現在の CLI セッション

      • 用途: 短い周期のポーリング

    `/schedule`を CLI から打つと Routines を作れます。GitHub の Webhook や API 呼び出しをトリガーにもできるので、「PR がマージされたらドキュメントを同期」のようなイベント駆動にも使えます。


    13. チーム運用のコツ

    13.1 共有するもの / しないもの

    • `CLAUDE.md` / `./.claude/CLAUDE.md`: ⭕ git で共有

    • `.claude/rules/*.md`: ⭕

    • `.claude/agents/*.md`: ⭕

    • `.claude/skills/<name>/`: ⭕

    • `.claude/commands/*.md`: ⭕(互換のため残存)

    • `.claude/settings.json`: ⭕(チーム共通の hook / permission)

    • `CLAUDE.local.md`: ✕ gitignore

    • `.claude/settings.local.json`: ✕ gitignore

    「自分のノートパソコン固有のパス」を共有ファイルに書くと炎上するので注意。

    13.2 組織配布

    組織として全員に同じガードを掛けたい時は managed settings と managed CLAUDE.md を MDM / Group Policy で配布します。`permissions.deny`と`claudeMd`を組み合わせて、**「常に X はやらせない」「常に Y を守らせる」**を強制します。

    13.3 Plugins

    Plugins として agents / skills / hooks / MCP をパッケージ化し、`claude plugin add <name>`で配布できます。社内ナレッジを丸ごとパッケージ化したい大規模組織向け。


    14. つまずきポイントと対処

    14.1 CLAUDE.md が効いてない気がする

    • `/memory`で実際にロードされているかを確認

    • 200行超えていたら守られにくくなる → `.claude/rules/`への分割

    • 矛盾するルールがないかチェック

    • それでも守られない場合、hook で強制に切り替える

    14.2 hook が走らない

    • `.claude/settings.json`の JSON 構文(カンマ忘れ)

    • macOS/Linux なら`chmod +x`必要

    • `${CLAUDE_PROJECT_DIR}`がフルパス展開されるかを`echo`で検証

    • `InstructionsLoaded` hook を仕込んで実際の読込タイミングを観察

    14.3 subagent が呼ばれない

    • `description`が抽象的すぎる ← 発動条件を具体的に書く

    • frontmatter の YAML 構文エラー

    • `name`衝突(同スコープで2つ同名は警告なしで片方破棄)

    • 直接呼ぶなら`Agent({ subagent_type: ..., prompt: ... })`で明示

    14.4 コンテキストが詰まる

    • 探索を`Explore` / カスタム subagent に逃がす

    • CLAUDE.md を`.claude/rules/`に分割し path-scoped にする

    • 大きな調査結果は subagent に要約だけ返させる

    • `/compact`で対話履歴を圧縮(CLAUDE.md は自動で再注入される)

    14.5 Codex CLI など他エージェントと併用したい

    • `AGENTS.md`を import で同居(`@AGENTS.md`)

    • Claude → Codex のレビュー依頼は`codex exec`を Bash で叩くだけ


    15. チートシート ― ここだけ覚える

    • プロジェクトの永続事実を書く: `CLAUDE.md`

    • パス別の詳細ルール: `.claude/rules/<topic>.md`(`paths:`で絞る)

    • Claude に学習させる: Auto memory(`/memory`で覗ける)

    • 何度も繰り返す手順: Skills(`.claude/skills/<name>/SKILL.md`)

    • コンテキストを汚さない専用ワーカ: Subagent(`.claude/agents/<name>.md`)

    • 絶対走らせたい処理: Hooks(`.claude/settings.json`)

    • 絶対禁止したい操作: `permissions.deny`

    • 外部ツールに繋ぐ: MCP

    • 危ないタスク前の安全運転: Plan mode

    • 一時的なエージェント: `--agents '{...}'`

    • 非対話実行: `claude -p "..."` + `--allowedTools`

    • 定期実行: Routines / Desktop scheduled tasks

    • 短い周期のポーリング: `/loop`

    • Surface を跨ぐ: Remote Control / Dispatch / `--teleport`

    最初の一歩は「`/init`を打って CLAUDE.md を作り、`/run-skill-generator`でビルド手順を Skill 化する」の2つだけです。あとは「同じ指示を二度書きそうになったら CLAUDE.md か Skill に逃がす」「同じ subagent を二度作りそうになったら`.claude/agents/`に固定する」「忘れちゃ困る処理は Hook にする」を繰り返していけば、自然に自分専用のエージェントが育っていきます。


    まとめ

    • Claude Code はインストール直後でも普通に強いが、本領はCLAUDE.md・Skills・Subagents・Hooks・MCP の使い分けから発揮される

    • それぞれの役割は重ならない:事実は CLAUDE.md、手順は Skill、別コンテキスト処理は Subagent、強制は Hook、外部接続は MCP

    • 6つの surface とスケジューラ・CI 統合で、デスクから離れても作業が続く

    • 安全装置はPlan mode と`permissions.deny` ― 重要な制約はここで掛ける

    • チーム運用は`.claude/`配下を git に乗せるだけで成立、組織配布なら managed settings

    公式ドキュメント(code.claude.com/docs)は機能追加が早いので、`/help`と`/memory`を定期的に開いて「新しいものが増えていないか」を眺めるだけでも、自分の使い方が腐りません。


    主要ドキュメントリンク(情報源)

     
     

    Nushi

     
     
    エンジニア9年目。現在はフリーランス。案件でCodexやClaudeCodeを使用。現場や個人開発で得た知識の備忘録Noteです。※たまに関係ないことも記事にしますがお許しください。※アイコンは我が家の主 以下成果物 https://github.com/foxlabo

    あなたへのおすすめ