01. Claude Codeとは？

パソコンのファイルを直接読み込み、整理し、成果物として仕上げてくれるAIエージェント。プログラミングの知識は不要です。

ひとことで言うと

Claude Codeは、パソコンのフォルダに直接アクセスして作業するAIです。数十個のファイルをまとめて読み込み、内容を整理し、求める成果物を作成します。

ブラウザ上で会話するClaude.aiとは異なり、Claude Codeはパソコンの中で直接作業します。

Claude.ai（Web版）との違い

最大の違い: Claude.aiはチャット画面に回答を表示します。Claude Codeはフォルダの中に直接入り込み、成果物を作って保存します。

どう動くの？── 実例で確認

例1: ドキュメントの一括整理（マーケター／企画担当者）

「Downloadsフォルダにある議事録30件を読んで、
 日付順に整理し、今月の決定事項だけ抽出して。
 月次_決定事項.md として保存して」

→ Claude Codeがやること:
1. フォルダ内の30ファイルをすべて読み込み
2. 日付を特定して並び替え
3. 決定事項のみを抽出
4. 新しいファイルとして自動保存

例2: データ分析（研究者／アナリスト）

「dataフォルダにあるアンケート結果のCSVを分析して、
 主要指標の要約レポートを作って」

Pythonを知らなくても大丈夫。言葉で説明すれば処理してくれます。

例3: コード開発（開発者）

「テストが失敗してるから原因を見つけて直して」
→ テスト実行 → エラー特定 → コード修正 → 再実行

どんな人に向いている？

こんな方にぴったり

こんな方にもおすすめ

• 「PythonやExcel関数なしでデータ整理がしたい」
• 「何十件ものドキュメントをいちいち開かず、まとめて処理したい」
• ターミナルに不慣れでも問題ありません ── デスクトップアプリでも使えます

こんな方にはClaude.ai（Web版）が最適

• 文章作成、翻訳、質問への回答だけが必要な方
• 特定のIDE内だけで作業したい開発者 → CursorやVS Code拡張機能を検討

どこで実行する？

どの環境から始めても同じエンジンが動くので、CLAUDE.md・設定・MCP接続はそのまま共有されます。

まとめ

Claude Code = 「パソコンのフォルダに直接入り込み、ファイルを読み込み、整理し、成果物を作成してくれるAI」

プログラミングを学ぶ必要はありません。Pythonを知らなくても大丈夫です。やりたいことを言葉で伝えるだけで始められます。

プラン選択からインストールまで、次のセクションに続きます。

02. Claude Codeでできること

コードを一行も書かずにこのサイト（CC101）を作りました。Claude Codeはコーディング専用ツールではありません。

まず: Web UI（Claude.ai）とは何が違うの？

一言で言えば: Claude.aiが会話相手なら、Claude Codeは自分のパソコンで働くAIの同僚です。

できること

開発作業

コード作成、バグ修正、リファクタリング、テスト、コードレビュー → このガイドの多くのセクションで取り上げます

リサーチ＆分析

• 複数のWebページを同時に読み込んでMarkdownで整理
• 競合分析、市場調査、技術トレンドの把握
• PDF・ドキュメント数十件の一括要約

💡 insane-researchプラグインを使用すると、マルチエージェントが複数のソースを並列で調査・クロス検証し、総合レポートを自動生成します。

ドキュメント＆コンテンツ制作

• ブログ記事、ニュースレター、SNSコンテンツの下書き
• 提案書、レポート、プレゼン資料
• 日本語 ↔ 英語の翻訳後、ファイルとして自動保存

💡 docs-guideプラグインで公式ドキュメントに基づいた正確なコンテンツを作成できます。

データ処理

• CSV、Excel分析および変換 — Pythonを知らなくても大丈夫です
• 数百個のファイルの一括処理（名前変更、形式変換、フォルダ整理）
• JSON、XMLデータのパースおよび加工

学習サポート

• 講義資料、書籍の内容を構造化して整理
• クイズ、フラッシュカードの自動生成
• 概念説明 + 例題 + 練習問題

ビジネスワークフロー

• ミーティング録音テキスト → 要約 + 決定事項 + 担当者別アクションアイテム
• 週次・月次レポートの自動化
• メール下書き、顧客対応テンプレート

パーソナルAIワークスペース

CLAUDE.mdで役割とルールを定義すれば、単なるAIチャットではなく自分だけのAIエージェントシステムになります。 → Advanced 18セクション（自分だけのAIワークスペースを設計する）で詳しく取り上げます

バイブコーディング

コーディングを知らなくてもAIへの指示だけでソフトウェアを作るバイブコーディングの中核ツールです。

• 企画書の自動生成（show-me-the-prdプラグイン）
• Gitバージョン管理の自動化（バルダ Git先生プラグイン）
• AI使用パターン分析＆コーチング（バ先生プラグイン） → バイブコーディングとは？ セクションで詳しく取り上げます

実際の事例: CC101はどうやって作られたか

コードを一行も自分で書いていません

企画 「Codex 101のような日本語版Claude Codeガイドを作りたい」 → アイデアワークスペースで3つのAI（Claude・Codex・Gemini）がセクション構成、UX、技術スタックを議論 → 20セクションの構成を決定

コンテンツ制作 公式ドキュメント57件を収集 → Claudeが要点を抽出 → 韓国語・英語のMarkdownとして構造化

開発 Next.jsサイト全体のコード → Claude Codeが作成 ダーク/ライトモード、多言語切り替え、モバイル対応 → すべて会話で処理

デプロイ Vercelデプロイ、Cloudflare DNS設定、ドメイン接続 → Claude Codeが直接処理

運用＆改善 初稿以降、ユーザーが内容を確認し「この部分を追加して」「これは別の書き方にして」と 会話を通じて継続的に改善中 — 今この会話もCC101アップデートセッションです

非開発者の実際の使用例

状況: 毎週のチームミーティング後に議事録を整理する必要がある

従来の方法:
  ミーティング終了 → メモ整理30分 → メール作成10分 → 共有

Claude Codeの方法:
  ミーティング録音テキストを貼り付け
  → 「要約、決定事項、担当者別アクションアイテムを整理して」
  → Markdownファイルとして保存 + メール下書きを自動生成
  所要時間: 3分

今すぐ体験

インストールが完了していれば、今すぐ始められます:

1. ドキュメント要約
   フォルダにPDFやテキストファイルを入れて:
   「このドキュメントの要点を3行で要約して」

2. メール下書き
   「次の状況でメールの下書きを作成して: [状況の説明]」

3. データ処理
   CSVファイルをフォルダに入れて:
   「このデータを[カラム名]基準でソートして要約して」

コーディング経験がまったくなくても大丈夫です。

このガイドの残りのセクションは「どうすればもっとうまく使えるか」についての内容です。まずはインストールして始めてみましょう。

03. バイブコーディングとは？

コードを知らない人がAIに自然言語で指示してソフトウェアを作る新しい方法論

バイブコーディング（Vibe Coding）とは？

「雰囲気（vibe）でコーディングする」という意味です。Andrej Karpathy（元Tesla AI責任者）が2025年に名付けた概念で、コードを自分で書かずにAIに自然言語で指示してソフトウェアを作る方式です。

従来のコーディング: 文法を覚え、エラーを自分で修正し、ライブラリを学習する必要がある バイブコーディング: 「ログイン機能を作って」→ AIがコードを生成 → 結果を見てフィードバック

Claude Codeはバイブコーディングに最も適したツールの一つです。 ターミナルでファイルを直接読み込み、修正し、実行し、テストするところまですべてAIが処理します。

バイブコーダー vs 開発者

バイブコーディングで最も重要なのはコーディングスキルではなく、**「何を作りたいのかを明確に説明する能力」**です。

バイブコーディングの現実: メリットと限界

本当にできること

• プロトタイプ、MVPの素早い作成
• 個人用ツール、自動化スクリプト
• Webサイト、シンプルなアプリ
• データ処理、ドキュメント自動化
• このサイト（CC101）もバイブコーディングで作りました

正直な限界

• 大規模な商用サービスには専門の開発者によるレビューが必要
• セキュリティ、決済などのセンシティブなロジックには必ず専門家のレビューが必要
• AIが生成したコードを理解できないとデバッグが難しい
• 「作った」と「保守する」は別の問題

ヒント: バイブコーディングで始めつつ、サービスが大きくなったら開発者と協業するのが賢明です。

バイブコーディングを上手にやるコツ

1. 企画が半分

「アプリ作って」よりも「写真を日付別に整理するWebアプリを作って。ドラッグ＆ドロップでアップロードしたらEXIF情報で自動分類」の方がはるかに良い結果が出ます。

→ show-me-the-prdプラグイン: 一文だけ渡せば4種の企画書の草案を先に作り、確認が必要な前提だけをまとめて質問します。

2. 小さく始めて大きく育てる

一度に完成品を求めないでください。「ログイン画面をまず」→「次はリスト画面」→「検索機能を追加」の順で段階的に作れば、はるかに安定します。

3. 結果を自分で確認する

AIが作った成果物を必ず実行して確認してください。「うまくいった」「この部分は違う感じにして」というフィードバックが品質を高めます。

4. 失敗を恐れない

Gitで保存しておけばいつでも元に戻せます。失敗しても損することはありません。

→ バルダ Git先生プラグイン: Gitを知らない方でも「保存して」の一言でバージョン管理が可能

バイブコーダーのためのGPTakuプラグイン

Claude Codeにインストールするとバイブコーディングがずっと簡単になるプラグインです:

インストール方法はプラグインインストールセクションで取り上げます。

バイブコーディングのワークフロー例

「タスク管理アプリを作りたい」

Step 1: 企画
/show-me-the-prd タスク管理アプリを作りたい
→ PRD + データモデル + フェーズ分割 + プロジェクトスペックの草案 → いくつかの前提だけ確認

Step 2: 実装
「Phase 1から作って」
→ Claude Codeがコード生成、ファイル保存、実行まで

Step 3: 確認＆フィードバック
「画面を見せて」→ ブラウザで確認
「ボタンの色を変えて」「日付ソートを追加して」→ 会話で修正

Step 4: 保存
/git-teacher 保存して
→ Gitコミットを自動生成

一言まとめ

バイブコーディング = コードを知らない人がAIに指示してソフトウェアを作る方法。大切なのは「何を作るのかを明確に説明すること」。Claude Code + GPTakuプラグインがそのプロセスをサポートします。

04. 製品ラインナップ＆価格

Claude Codeを使う方法は3つあります。入門者ならMax $100プランから始めましょう。

Claude Codeを使う3つの方法

方法1. Claude.aiサブスクリプション（Pro / Max）— 個人の入門者におすすめ

最もシンプルな方法です。Claude.aiでサブスクリプションに登録すれば、Claude Codeをすぐに使えます。トークン（使用量）をいちいち気にする必要なく、定額の月額料金を支払うだけです。

方法2. Anthropic APIの直接利用 — 開発者 / 自動化目的

Anthropic ConsoleでAPIキーを発行して接続する方式です。使用した分だけトークン（文字数単位）で課金されます。自動化パイプライン、CI/CD連携などに適しています。

方法3. エンタープライズクラウド — 企業のセキュリティ要件があるチーム

Amazon Bedrock、Google Vertex AI、Microsoft Foundryなどの企業向けクラウドを通じてClaude Codeを使用します。データが自社のクラウド内に留まります。

Pro vs Maxプラン比較

以下の価格は2026年10月時点のものです。最新の価格はclaude.com/pricingでご確認ください。

無料（Free）プランではClaude Codeを利用できません。 Pro、Max、Team、EnterpriseまたはConsole（API）アカウントが必要です。

チーム利用なら、Team（Standard席は月$25、年間契約で$20 / Premium席は月$125、年間契約で$100、使用量5倍）やEnterprise（年間契約で1席あたり月$20から、20席以上、使用量はAPI料金）にもClaude Codeが含まれます。

プランの上限は5時間単位と週単位でリセットされます。上限を超えても使い続けたい場合は、追加使用量（usage credits） を有効にすると、使った分だけ追加で支払えます（/usage-credits）。

入門者におすすめ: Max $100

Claude Codeを本格的に使うならMax $100プランをおすすめします。その理由:

• Pro（$20）は使用量の上限にすぐ達し、Claude Codeを集中的に使うのが難しいです。
• APIの直接利用はトークン課金方式のため、予想外のコストが発生する可能性があります。
• Max $100は1日あたりの平均使用量を基準にすると、ほとんどの個人開発者に十分です。

公式ドキュメント（2026年10月時点）によると、APIユーザーの平均コストは開発者1人あたり利用日1日約$13、月$150〜$250程度で、90%のユーザーは1日$30以下です（使用頻度により差が大きい）。

コスト構造の説明

サブスクリプションプラン（Pro / Max）

月額決済 → 決められた使用量の上限内で自由に使用
上限超過時 → 追加の応答制限（追加課金なし）

• トークン数を気にする必要なし
• 上限に達した場合、一定時間後にリセット

APIの直接利用

使用したトークン分だけ課金（入力トークン + 出力トークン）
モデルによって単価が異なる（Sonnet < Opus）

• /usageコマンドで現在のセッションのコストを確認可能（/costは/usageのエイリアス）
• 自動化/チーム利用時はConsoleで支出上限の設定が可能
• モデル別の単価（100万トークンあたり 入力/出力）: Haiku 5.5 $0.10/$0.50、Sonnet 5.5 $2/$10、Opus 5.5 $4/$20、Fable 5.1 $10/$50

⚠️ コストに関する注意事項

API利用時の注意点

⚠️ API利用は使用した分だけ請求されます。

• 大規模プロジェクトで長時間作業するとトークンが急速に消費されます。
• Agent Teams（複数のAIを同時実行）機能はトークン消費が約7倍多くなります。現在は実験的機能でデフォルトは無効です（CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1で有効化）。
• バックグラウンド作業（会話の要約など）にも少量のトークンが使用されます。

コスト削減のヒント

どのプランで始めるべき？

初めて試してみたい       → Pro ($20) で体験
本格的に使いたい         → Max $100（強くおすすめ）
チーム/自動化目的        → APIまたはエンタープライズ
セキュリティ要件がある企業 → Bedrock / Vertex / Foundry

料金ページ

最新の価格およびプラン比較: https://claude.com/pricing

05. インストール & 認証

ターミナルでコマンド1つでインストール、ブラウザでログインすれば完了です。

💡 ターミナルが初めての方へ 以下のコマンドをそのまま**コピー＆ペースト（Cmd+VまたはCtrl+V）**してEnterを押すだけです。コマンドの意味を理解する必要はありません。

• macOS: Cmd+Space → 「terminal」と検索 → Enter
• Windows: Win+R → 「powershell」と入力 → Enter

ターミナル自体に抵抗がある場合は、Claudeデスクトップアプリ（macOS / Windows / Ubuntu・Debianはベータ）をインストールしてCodeタブを押すだけで使えます。アプリの中にClaude Codeが組み込まれているのでCLIを別途インストールする必要がなく、変更内容を画面上ですぐ確認できます。

インストール前の確認事項

対応OS

ハードウェア要件

• RAM: 4GB以上
• CPU: x64またはARM64
• シェル: Bash、Zsh、PowerShell、CMDのいずれか
• インターネット接続が必要

Node.jsは必要？

いいえ。 Claude Codeはネイティブインストール方式を採用しています。Node.jsを別途インストールする必要はありません。

💡 npmによるインストールも引き続きサポートされています。 npm install -g @anthropic-ai/claude-code は以下のネイティブインストールと同じバイナリをインストールします（Node.js 22以降が必要）。ただし公式推奨は以下のネイティブ方式なので、特別な理由がなければそちらを使ってください。

インストール方法

macOS / Linux / WSL（Windows Subsystem for Linux）

ターミナルを開き、以下のコマンドを貼り付けてください：

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

Homebrewを使っている場合：

brew install --cask claude-code          # 安定（stable）チャンネル: 約1週間遅れるが、大きなリグレッションのある版はスキップ
brew install --cask claude-code@latest   # 最新（latest）チャンネル: 新バージョンが出たらすぐ

Windows

方法1 — PowerShellを使用（推奨）：

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

方法2 — WinGetを使用：

winget install Anthropic.ClaudeCode

方法3 — CMDを使用：

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

WindowsでのGit for Windowsは任意ですが推奨です。インストールするとClaude CodeがGit BashでBashツールを使い、ない場合はPowerShellツールで代替動作します。

Alpine Linux 追加パッケージ

apk add bash curl libgcc libstdc++ ripgrep

インストール後の認証（ログイン）

インストールが完了したら、ターミナルで以下のコマンドを実行してください：

claude

初回起動時にブラウザが自動的に開き、OAuthログイン画面が表示されます。Claude.aiアカウントでログインすると自動的に認証が完了し、ターミナルに Login successful と表示されます。

⚠️ 無料（Free）プランではClaude Codeを利用できません。 Pro、Max、Team、EnterpriseまたはConsole（API）アカウントが必要です。

ブラウザが自動的に開かない場合は、ターミナルで c を押してログインURLをコピーし、ブラウザに直接貼り付けてください。WSL2、SSH、コンテナのように、ブラウザからターミナルへ戻れない環境ではブラウザにログインコードが表示されるので、そのコードをターミナルの Paste code here if prompted の欄に貼り付けてください。

認証フローの概要

ターミナルでclaude を実行
       ↓
ブラウザが自動で開く（OAuthページ）
       ↓
Claude.aiアカウントでログイン
       ↓
ターミナルに自動で戻る → 認証完了

資格情報のセキュリティ

• macOS: APIキーとOAuthトークンは**macOS Keychain（暗号化ストレージ）**に安全に保存されます。
• Linux / Windows: ~/.claude/.credentials.json（Windowsは %USERPROFILE%\.claude\.credentials.json）に、自分のアカウントだけが読める権限で保存されます。
• 再ログインが必要な場合: claude を実行後、/login と入力。アカウントを切り替えるには /logout の後に再ログイン
• ログインの期限切れ3日前から、起動時に run /login to renew という警告が表示されます。事前に /login を実行して更新してください。

初回起動の確認

インストールと認証が完了しているか確認するには：

claude --version

バージョン番号が表示されれば、正常にインストールされています。インストール状態の診断には：

claude doctor

このコマンドで、インストールタイプ、バージョン、環境の状態を一度に確認できます。

自動アップデート

Claude Codeは自動的に最新バージョンへアップデートされます。起動時にアップデートを確認し、バックグラウンドでダウンロードします。次回起動時に新しいバージョンが適用されます。

Homebrew、WinGet、Linuxのパッケージマネージャーでインストールした場合は自動アップデートされません。brew upgrade claude-code、winget upgrade Anthropic.ClaudeCode などを自分で実行してください。（Homebrew・WinGetは、設定に CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 を入れておくと、Claude Codeが代わりにアップグレードコマンドを実行してくれます。）

手動でアップデートする場合：

claude update

アップデートチャンネルを選ぶ

新機能をすぐ受け取れるlatest（デフォルト）と、約1週間遅れるものの大きなリグレッションのあるバージョンはスキップするstableから選べます。/config → Auto-update channelで変更するか、~/.claude/settings.jsonに書きます：

{
  "autoUpdatesChannel": "stable"
}

リリース直後のモデルは、stableチャンネルより新しいバージョンを要求することがあります。新しいモデルをすぐ試したい場合はlatestのままにしてください。

よくあるインストールの問題と解決法

問題1: curl: command not found（curlが見つからないエラー）

原因: curlがインストールされていない場合（まれですが、一部のLinux環境で発生）。

解決法:

# Ubuntu/Debian
sudo apt-get install curl

# Alpine
apk add curl

その後、インストールコマンドを再度実行します。

問題2: claude: command not found（インストール後にコマンドが見つからない場合）

原因: インストールパスがシェルのPATHに登録されていない場合。

解決法:

# 現在のシェルセッションにPATHを即時反映
source ~/.bashrc
# zshの場合
source ~/.zshrc

それでも解決しない場合は、ターミナルを完全に閉じて再度開いてください。

問題3: WindowsでBashツールがない、またはGit Bashが見つからないという案内が出る

原因: Git for Windowsがないと、Claude CodeはBashの代わりにPowerShellツールでコマンドを実行します。動作自体に問題はありませんが、一部のシェルスクリプトの例やプラグインはBashを前提にしています。

解決法: git-scm.comからGit for Windowsをインストール後、再起動してください。インストールしても見つからない場合は、~/.claude/settings.jsonにパスを指定します：

{
  "env": { "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" }
}

問題4: claude --version が古いバージョンを表示する

原因: npm、Homebrew、ネイティブインストールが混在していて、別のインストール版が先に参照されている場合。

解決法: claude doctor でインストールタイプを確認し、使っていないインストール版は削除してください（npm uninstall -g @anthropic-ai/claude-code、brew uninstall --cask claude-code など）。

次のステップ

インストールと認証が完了したら、作業フォルダに移動してすぐに始めましょう：

# 作業フォルダに移動して実行
claude

どんなフォルダでも構いません。 コードプロジェクトに限らず、ドキュメントフォルダ、リサーチフォルダ、業務資料フォルダなど、どこからでもClaude Codeを起動できます。

Claude Codeがフォルダを解析し、何をお手伝いするか待機します。

06. おすすめプラグインのインストール

Claude Codeの機能を拡張するプラグインをインストールして活用します。

プラグインとは？

Claude Codeは基本機能だけでも十分強力ですが、**プラグイン（Plugin）**をインストールすると、さらに多くのことができるようになります。

プラグインとは、簡単に言えばClaude Codeに追加機能パックをインストールすることです。スマートフォンにアプリをインストールするように、Claude Codeに必要な機能をプラグインで追加できます。

1つのプラグインには以下の要素が含まれている場合があります：

有効になっているプラグインは、使っていないセッションでもスキル・エージェントの名前と説明がコンテキストに載り、少しずつトークンを消費します。/plugin のマーケットプレイス一覧でContext costを確認し、使わないプラグインは無効化してください。/skill-doctor で、どのスキルがどれだけ場所を占めているかも確認できます。

公式プラグインマーケットプレイス

Anthropicが運営する公式マーケットプレイス（claude-plugins-official）は、Claude Codeを起動すると自動的に利用可能な状態になっています。

Claude Code内で /plugin と入力すると、Discoverタブからすぐに公式プラグインを閲覧できます。

公式マーケットからプラグインをインストール

/plugin install プラグイン名@claude-plugins-official

公式マーケットで提供されている主なプラグインカテゴリ

/plugin install typescript-lsp@claude-plugins-official
/plugin install pyright-lsp@claude-plugins-official

gptaku_plugins — 入門者向けプラグイン集

GitHub: https://github.com/fivetaku/gptaku_plugins

gptaku_pluginsは、Claude Codeの入門者、非開発者、バイブコーダー向けに特別に作られたプラグイン集です。難しくて馴染みのない開発概念を、Claudeがより親切にガイドしてくれるよう設計されています。

含まれているプラグイン

2026年10月時点で合計19個のプラグインが登録されています。

入門者にまずおすすめ

⚠️ deep-research-kitは提供終了しました。 後継の**insane-research**を使用してください。

その他のプラグイン

インストール方法

ステップ1：マーケットプレイスの登録（初回のみ）

Claude Code内で以下のコマンドを入力してください：

/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git

ステップ2：プラグインのインストール

マーケットプレイスを登録したら、希望のプラグインをインストールします：

/plugin install

リストから希望のプラグインを選択するか、名前を直接指定することもできます：

/plugin install show-me-the-prd@gptaku-plugins

注意：プラグインは一度に1つずつインストールされます。複数インストールする場合は繰り返してください。

ステップ3：インストールの確認

/plugin list

または /plugin と入力後、Installedタブに移動すると、インストール済みのプラグイン一覧を確認できます。

ステップ4：アップデート

新しいバージョンがリリースされたら、以下のコマンドでアップデートできます：

/plugin update

/plugin メニューで変更した内容は、メニューを閉じるとすぐに適用されます。コマンドでインストール・アップデートしたのに新しいスキルが見えない場合は /reload-plugins を実行してください。Claude Codeを再起動する必要はありません。

ステップ5：プラグインを使ってみよう

インストールが完了したら、すぐに使用できます：

# 企画書の自動生成
/show-me-the-prd タスク管理アプリを作りたい

# AIエージェントチームの自動構成
/kkirikkiri リサーチチームを作って

# スキルの自動生成
/skillers-suda 翻訳スキルを作って

# Gitオンボーディング
/git-teacher:what-is-commit

# 公式ドキュメントベースの回答
/docs-guide:explain React hooks

# AI活用パターン分析
/vibe-sunsang 開始

プラグイン管理

インストール時に範囲を選びます。User（自分のPCのすべてのプロジェクト）、Project（このリポジトリで一緒に作業する全員 ── .claude/settings.jsonに記録）、Local（このリポジトリで自分だけ）。ターミナルでインストールしたプラグインは、同じPCのデスクトップアプリやVS Code拡張でもそのまま使えます。

コミュニティプラグインをもっと見る

公式マーケットプレイス以外にも、コミュニティが作成したプラグインをGitHubから直接インストールできます。機能が多様な分、インストール前にコードを確認し、信頼できるリポジトリかどうか事前に確認してください。

oh-my-claudecode

Claude Codeコミュニティで最も使われているサードパーティプラグインです。単なる拡張ではなく、Claude Code自体をオーケストレーターに変貌させてくれます。

主な機能：

• Autopilot：「作って」と言うだけで、計画→実装→検証まで自動実行
• 33の専門エージェント：コードレビュー、セキュリティ分析、テスト、ドキュメント化など役割別AIエージェント
• 外部AI連携：Codex（OpenAI）、Gemini（Google）と協業して多角的に分析
• Skillsシステム：よく使うワークフローを再利用可能なコマンドとして保存

インストール：GitHubリポジトリ（github.com/wshf/oh-my-claudecode）のREADMEを参照

/plugin install typescript-lsp@claude-plugins-official
/plugin install pyright-lsp@claude-plugins-official

supermemory

Claudeの長期記憶を強化するMCPサーバーです。新しい会話を開始しても、以前の作業コンテキスト、プロジェクトの決定事項、よく使うパターンを自動的に読み込みます。同じプロジェクトで長く作業するほど効果が大きくなります。

インストール前の確認事項：コミュニティプラグインはAnthropicの検証を受けていません。GitHubリポジトリのコードとREADMEを事前に確認し、メンテナンスが活発か、Issue対応がされているか確認してください。

⭐ CC101が役に立ったらStarをお願いします！

このガイドが役に立ったら、GitHubでStarを押してください。

Starひとつが、このガイドを発展させ続ける大きな力になります。

→ CC101 GitHubでStarを押す

難しくありません。リンクをクリックして、右上の ⭐ Starボタンを押すだけです！

次のステップ

プラグインのインストールまで完了したら、準備は万端です。次はClaude Codeがどのように動作するのか、仕組みを見ていきましょう。

07. コアコンセプトを理解する

Claude Codeがどのように動作するかを知ると、より上手に使えるようになります。

Claude Codeはどのように動作するのか？

Claude Codeは単なるチャットボットではありません。指示を出すと、自ら計画を立て、ファイルを読み、コードを修正し、結果を確認する**エージェント（Agent）**です。

このプロセスを**エージェントループ（Agentic Loop）**と呼びます。

あなたの指示
     ↓
1. 状況把握（Context収集）
   - ファイル読み込み、コード検索、現在の状態把握
     ↓
2. 行動（Action）
   - ファイル修正、コマンド実行、Web検索
     ↓
3. 結果確認（Verify）
   - テスト実行、エラー確認、再修正
     ↓
作業完了（または1に戻って繰り返し）

例えば「reports/ フォルダのドキュメントを要約して」と言うと、Claude Codeは：

1. フォルダ内のファイル一覧を確認
2. 各ドキュメントを読んで内容を把握
3. 要約・整理を作成
4. 結果を確認し、不足があれば補完

この全プロセスを自動的に実行します。

5つのコアコンセプト

1. Context（コンテキスト） — Claudeの作業記憶

コンテキストとは、Claude Codeが現在記憶しているすべての内容です。会話内容、読んだファイル、実行したコマンドの結果、CLAUDE.mdの指示事項など、すべてがコンテキストに含まれます。

コンテキストにはトークンの上限があります（現在のモデルはすべて100万トークン）。会話が長くなったり、大きなファイルを多く読んだりすると、コンテキストがいっぱいになることがあります。上限に近づくと、Claude Codeが自動的に古い内容を要約します（自動圧縮）。

# コンテキストの状況確認
/context

# 会話の圧縮（古い内容を要約）
/compact

# 特定のテーマに集中して圧縮
/compact API変更点に集中して圧縮して

ヒント：頻繁に参照する重要なルールや情報はCLAUDE.mdに書いておくと、毎回コンテキストを消費せずにClaudeが記憶できます。

2. Tools（ツール） — Claudeが実際にできること

Claude Codeは会話するだけではありません。実際に様々な**ツール（Tools）**を使って作業を実行します。

3. Permissions（権限） — 何を許可するか設定する

Claude Codeは強力なツールであるため、何を許可するかを直接制御できます。

ファイルの読み込みはデフォルトで許可されていますが、ファイルの修正やシェルコマンドの実行はユーザーの確認を求めます。

権限ルールは大きく3種類です：

# 権限設定の確認と管理
/permissions

優先順位：Deny > Ask > Allow の順に適用されます。拒否ルールが常に最優先です。

4. Memory（メモリ） — CLAUDE.mdでプロジェクトを記憶させる

Claude Codeはセッションが終わると会話内容を記憶しません。しかしCLAUDE.mdファイルを作っておくと、毎セッション自動的に読み込んでプロジェクトのコンテキストを維持します。

CLAUDE.mdはClaudeに渡す指示書だと考えてください。

これに加えて**自動メモリ（auto memory）**があります。あなたが修正した内容や好みをClaudeが自らメモしておき、次のセッションで再び読み込む機能で、デフォルトで有効です。/memory でメモの内容を見たり、オフにしたりできます。

CLAUDE.mdの詳細については**08. CLAUDE.md 詳細ガイド**で解説します。

5. Session（セッション） — 会話の始まりと終わり

セッションとは、Claude Codeを起動してから終了するまでの1つの作業単位です。

• 新しいセッションを開始すると、以前の会話内容はなくなります（CLAUDE.mdは維持）
• セッション中に行った作業は保存されます

# 最新のセッションを引き継いで開始
claude --continue

# 以前のセッション一覧から選んで再開
claude --resume

# 最初から名前を付けて開始（後で claude --resume 名前 で再開）
claude -n 競合調査

# 別の方向を試すためにセッションを複製（フォーク）
claude --continue --fork-session

会話の途中では /rename 名前 で名前を付けたり、/branch で現在の地点から会話を分岐したりできます。

「なぜ時々止まって確認を求めるのですか？」

Claude Codeが作業中に止まって確認を求めるのは、意図された安全装置です。

ファイルを修正したりコマンドを実行する前に、ユーザーが意図した操作かどうか確認しているのです。特に元に戻しにくい操作（ファイル削除、デプロイなど）ほど重要です。

初心者が知っておくべき4つの権限モード

Shift+Tab を押すと権限モードを切り替えることができます。プロンプト下のステータスバーに auto mode on、manual mode on のように現在のモードが表示されます。

補足（2026年10月時点）：Claude Code v2.1.283から、ターミナルセッションはすべてのプランでAutoモードで開始します。Autoモードは「何も聞かないモード」ではなく、人の代わりに分類器が審査するモードです。リクエストの範囲を外れる行動、見慣れないサーバーへのアクセス、読み込んだ外部コンテンツに引きずられた行動はブロックし、それでも判断が難しい場合はあなたに確認します。安全を保証する仕組みではないので、慎重を要する作業はManualモードに切り替えて自分で確認してください。

モデルがAutoモードに対応していない場合や、組織の設定でオフになっている場合はManualモードで開始します。

モード切り替え方法

# ターミナルでShift+Tabを押すとモードが順番に切り替わります
# Auto → Manual → Accept Edits → Plan Mode → Auto → ...

# またはPlan Modeに直接切り替え（説明を付けると、その作業の計画からすぐ開始）
/plan
/plan 認証システムをOAuth2に切り替える計画を立てて

# 最初から特定のモードで開始
claude --permission-mode plan
claude --permission-mode manual

シェルコマンドの確認ダイアログに "Yes, and switch to auto mode" という選択肢が表示されたら、そのコマンドを許可すると同時にAutoモードへ切り替えるという意味です。

モード比較の例

「フォルダ内のドキュメントで『旧バージョンの文言』を『新しい文言』に一括置換して」と言った場合：

Autoモード：
  → 分類器が「リクエストの範囲内の安全な作業」と判断すればすぐ実行
  → リクエストと無関係なフォルダを削除しようとしたらブロック

Manualモード：
  → 各ファイルの修正前に「このファイルを修正してもいいですか？」と確認

Accept Editsモード：
  → ファイルは自動で修正、コマンド実行は確認要求

Plan Mode：
  → 「どのファイルのどの部分を変更する予定です」と表示するだけで、実際の修正はしない

「すべてのJavaScriptファイルからconsole.logを削除して」と言った場合：

Autoモード：
  → ファイル修正とテスト実行はそのまま進行、`git push --force` のような行動はブロックまたは確認

Manualモード：
  → 各ファイルの修正前に「このファイルを修正してもいいですか？」と確認

Accept Editsモード：
  → ファイルは自動で修正、コマンド（例：git commit）は確認要求

Plan Mode：
  → 「どのファイルの何行目を修正する予定です」と表示するだけで、実際の修正はしない

おすすめ：最初の数日は Shift+Tab でManualモードに切り替え、Claude Codeが何をしているかを自分の目で見ながら慣れていきましょう。流れがつかめたらデフォルトのAutoモードに戻し、決済・デプロイ・削除のように元に戻しにくい作業だけManualに切り替えれば十分です。

どのモードでも、.git、.claude のような保護パスの変更や、ホームフォルダ・ルートを消す rm -rf のような致命的なコマンドは自動承認されません。

チェックポイント：ミスしても元に戻せます

Claude Codeはファイルを修正する前に自動でスナップショットを保存します。

誤って修正してしまった場合：

• 入力欄が空の状態で Esc キーを2回連続で押すか、/rewind と入力すると巻き戻しメニューが開きます。コードだけ、会話だけ、または両方を以前の地点に戻せます。
• またはClaudeに「今やったことを取り消して」とリクエスト

巻き戻しは、Claudeが編集ツールで修正したファイルだけを追跡します。rm、mv のようなシェルコマンドで変更されたファイルは戻せないので、大きな作業の前にはgitコミットも合わせて行っておきましょう。

これらのコンセプトを理解すれば、Claude Codeの動作が予測可能になります。次は、この中で最も重要なMemory、CLAUDE.mdを正しく使う方法です。

08. CLAUDE.md 詳細ガイド

Claude Codeの長期記憶を設定する最も重要なファイル、CLAUDE.mdの使い方を解説します。

CLAUDE.mdとは？

Claude Codeはセッションが終わると会話内容を忘れてしまいます。次に起動したときには、初対面のように何も覚えていません。

CLAUDE.mdはこの問題を解決します。

Claude Codeは起動するたびにCLAUDE.mdファイルを自動で読み込み、プロジェクトの背景やルールを把握した状態で作業を開始します。

CLAUDE.mdは、Claudeに渡す指示書であり、プロジェクト説明書です。

あなた: 「このプロジェクトはNext.jsで作っていて、TypeScriptを使う。
       タブではなくスペース2つでインデントし、日本語でコミットメッセージを書いて。」

→ これを毎回伝える代わりに、CLAUDE.mdに一度書いておけば永続的に記憶されます。

どこに作る？

CLAUDE.mdファイルの配置場所によって、適用範囲が変わります。

リポジトリにすでに AGENTS.md（他のコーディングエージェント向けの指示ファイル）があり、CLAUDE.mdがない場合、Claude Codeは代わりに AGENTS.md を読みます（v2.1.277+）。サブフォルダのCLAUDE.mdは、Claudeがそのフォルダのファイルを扱うときに必要になった時点で読み込まれます。

最も一般的な場所: プロジェクトルートの CLAUDE.md

# プロジェクトフォルダでCLAUDE.mdを作成
touch CLAUDE.md

# またはClaude Codeに自動生成してもらう
/init

/init コマンドを実行すると、Claude Codeが現在のプロジェクトを分析してCLAUDE.mdの下書きを自動生成してくれます。

何を書けばいい？

CLAUDE.mdに決まったフォーマットはありません。Markdownで自由に書けます。以下の項目を含めると特に効果的です。

💡 ここでいう「プロジェクト」は開発プロジェクトに限りません。リサーチフォルダ、コンテンツ制作フォルダ、業務自動化フォルダなど、あらゆる作業フォルダにそのまま適用できます。Claude Codeはコードがないフォルダでも同じように動作します。

必須項目

1. 作業の概要

Claudeがこのフォルダで何をすべきか把握できるよう、簡潔に説明します。

## 作業の概要
このフォルダは競合他社の市場調査リサーチプロジェクトです。
調査結果は reports/ フォルダにMarkdownで保存します。

2. ツール／環境

使用するツール、資料、保存方式を明記します。

## 作業環境
- **主要ツール**: Notion（企画）、Google Docs（下書き）、Canva（デザイン）
- **資料の保存場所**: docs/ フォルダ（Markdown形式）
- **言語**: 日本語優先、英語資料は要約翻訳

3. 作業ルール

文章のスタイル、ファイル命名規則、出典の基準などを指定します。

## 作業ルール
- 文体: 丁寧かつ明確に（誇張表現は禁止）
- ファイル名: YYYY-MM-DD_テーマ.md 形式
- 出典のない統計・数値は使用禁止
- 常に日本語で記述

4. やってはいけないこと（禁止事項）

ミスを防ぐため、禁止事項を明示しておくと効果的です。

## 絶対にやらないこと
- 出典のない統計の引用
- 未検証の情報を事実として記述
- 顧客・パートナーの実名をドキュメントに記載
- 旧バージョンのファイルを上書き（常に日付入りファイル名を使用）

5. よく使う作業手順

Claudeによく依頼する作業や、繰り返しワークフローを定義します。

## よく使う作業
- リサーチレポート作成: 「要約 → 重要インサイト5つ → 出典リスト」の形式で
- 議事録整理: 「決定事項 → アクションアイテム（担当/期限） → 未解決事項」の形式で
- ドキュメントレビュー: まず要約を提示し、修正が必要な箇所は理由とともに記載

実例: 目的別CLAUDE.mdテンプレート

自分の作業タイプに合ったテンプレートを選び、コピーしてすぐに使えます。

テンプレートA ── リサーチワークスペース

# リサーチプロジェクトのルール（CLAUDE.md）

## プロジェクトの目的
- 目標: [調査テーマと目的を1行で]
- 成果物: report.md（要約）、sources.md（出典）、slides-outline.md（プレゼン用目次）

## 資料／フォルダのルール
- 原文資料は sources/ フォルダに保存、ファイル名: YYYY-MM-DD_出典_タイトル.md
- メモ・仮説は notes/ フォルダに保存（原文と混在させない）

## 出典ルール
- すべての主張に出典を付ける（リンク＋根拠を1行）
- 出典の信頼度: A（公的機関/一次情報）/ B（業界/二次情報）/ C（個人ブログ/意見）
- 不確かな場合は「推定・仮説」と明記

## 文章／書式
- 常に日本語、文は短く
- 成果物の基本構成: 1)5行の要約 2)重要インサイト5つ（根拠付き） 3)反論・リスク3つ 4)次のアクション3つ

テンプレートB ── コンテンツ制作ワークスペース

# コンテンツ制作のルール（CLAUDE.md）

## ブランドトーン
- 親しみやすいが誇張しない（「完璧/革命/絶対」は禁止）
- 読者: [ターゲット読者の説明]、専門用語は括弧で簡潔に解説

## チャネル別フォーマット
- ブログ: タイトル3案 → 本文（小見出し4〜6個） → チェックリスト → CTA 1つ
- SNS: 7〜9枚のカード型投稿（1枚につき1文）、最後のカードにまとめ＋リンク
- ニュースレター: 3行の要約 → 本文600〜900文字 → 次回テーマの予告

## 禁止／注意事項
- 競合他社の実名は記載禁止（必要な場合は「A社/B社」と匿名化）
- 統計・数値は出典がなければ「例示」と表示

## ファイル出力ルール
- 下書き: drafts/YYYY-MM-DD_テーマ_チャネル.md
- 最終版: final/ フォルダに保存、先頭にバージョン/レビュアー/公開日のメタデータを記載

テンプレートC ── ビジネス運営ワークスペース

# 運営ドキュメントのルール（CLAUDE.md）

## 会社／プロダクトの背景
- プロダクト: [名称] / 顧客: [ターゲット] / コアバリュー: [1行で]
- よく使う用語の定義: [用語: 定義] の形式で下に蓄積

## コミュニケーションスタイル
- メール/メッセージ: 丁寧語、3段落構成（要約 → 詳細 → 次のステップ）
- クレーム対応: 「共感の1文 → 事実確認の質問2つ → 解決策の選択肢2つ」

## ドキュメントテンプレート
- 議事録: 会議の目的 / 決定事項 / アクションアイテム（担当/期限） / 課題
- 提案書: 問題定義 → 解決策 → スケジュール/範囲 → コスト → リスク

## セキュリティ／機密情報
- 個人情報・決済情報はマスキング（例: 090-****-1234）
- 外部共有前に「機密表記/顧客名」の自動チェックリストを先に出力

# プロジェクト指針

## プロジェクト概要
[ここにプロジェクトの説明を1〜2行で記入]

例: 中小事業者向けの在庫管理SaaSサービス。
Next.js 14 App Router + TypeScript + Supabase ベース。

---

## 技術スタック
- **フレームワーク**: Next.js 14（App Router）
- **言語**: TypeScript（strictモード）
- **スタイル**: Tailwind CSS
- **DB/バックエンド**: Supabase
- **パッケージマネージャー**: pnpm
- **デプロイ**: Vercel

---

## コーディング規約

### ネーミング
- コンポーネント: PascalCase（UserCard.tsx）
- 関数/変数: camelCase（getUserData）
- 定数: UPPER_SNAKE_CASE（MAX_RETRY_COUNT）

### TypeScript
- `any` 型の使用禁止
- すべての関数に戻り値の型を明記

---

## よく使うコマンド
pnpm dev, pnpm build, pnpm test, pnpm lint

---

## 絶対にやらないこと
- `npm` または `yarn` の使用（必ず `pnpm` を使用）
- `any` 型の使用
- 環境変数をコードにハードコード

---

## Gitコミット規約
- 日本語でコミットメッセージを記述
- 形式: `タイプ: 変更内容`
- 例: `feat: ユーザーログインページの追加`

グローバル設定: すべてのプロジェクトに適用する

~/.claude/CLAUDE.md ファイルを作成すると、すべてのプロジェクトに共通で適用されるルールを設定できます。

# グローバルCLAUDE.mdを編集
nano ~/.claude/CLAUDE.md

グローバルCLAUDE.mdに書くとよい内容：

# グローバル設定（全プロジェクト共通）

## 個人の好み
- 説明は常に日本語で
- コード変更前に、何をするか先に説明して
- 重要な変更は実行前にもう一度確認して

## コーディングスタイル（共通）
- 関数はできるだけ短く（20行以内）
- 変数名は意味が明確になるように
- コメントよりも、コード自体を読みやすく

複数のファイルが一緒に読み込まれる順序

複数のCLAUDE.mdファイルがある場合、互いに上書きするのではなく、すべてを連結してコンテキストに入れます。読み込まれる順序は次のとおりです。

読み込まれる順序:
1. 組織管理のCLAUDE.md（会社設定、オフにできない）
2. ~/.claude/CLAUDE.md（グローバル設定）
3. 上位フォルダ → 現在のフォルダの順に ./CLAUDE.md、.claude/rules/、CLAUDE.local.md

Claudeは通常、より具体的な（プロジェクト側の）指示に従いますが、2つのファイルが互いに矛盾する場合、どちらに従うかは保証されません。グローバル設定に「スペース2つ」と書き、プロジェクトに「タブ使用」と書くような衝突は避け、定期的に /doctor prompt-audit で古い指示や矛盾した指示を整理してください。

自動メモリ: Claudeが自分で書くメモ

CLAUDE.mdがあなたの書く指示書だとすれば、**自動メモリ（auto memory）**はClaudeが作業しながら自分で書き留めるメモです。「このプロジェクトはpnpmを使う」「この人は日本語のコミットメッセージを好む」のように、あなたが修正した内容やパターンをリポジトリごとに記録し、毎セッションの開始時に読み直します（MEMORY.md の先頭200行まで）。

• デフォルトで有効で、/memory でオン/オフの切り替えや保存内容の確認ができます。
• 保存場所: ~/.claude/projects/<プロジェクト>/memory/
• ルールとして強制したい内容は、自動メモリに任せずCLAUDE.mdに直接書いてください。どちらも「参考資料」であって強制する仕組みではないので、必ず防ぎたい行動はHooksでブロックします。

便利なTips

/memory コマンドの活用

セッション中にCLAUDE.mdを直接編集したい場合：

/memory

ファイル選択画面が開き、CLAUDE.mdをその場で編集できます。同じ画面で自動メモリのオン/オフや内容の確認もできます。

テーマ別に分ける: .claude/rules/

CLAUDE.mdが長くなってきたら、.claude/rules/ フォルダにテーマ別のファイル（testing.md、writing-style.md など）として分けましょう。ファイルの先頭に paths: を書くと、特定のファイルを扱うときだけ読み込まれるようにでき、普段のコンテキストを節約できます。

---
paths:
  - "drafts/**/*.md"
---
# 下書き作成ルール
- タイトルは3案提示、本文は小見出し4〜6個

CLAUDE.mdは200行以下を目標にしてください。長いほどトークンを多く使い、指示に従いにくくなります。特定の作業でだけ必要な詳細手順はSkillsに移すと、その作業をするときだけ読み込まれます。

ファイルの参照（Import）

CLAUDE.mdから他のファイルを参照できます：

# プロジェクト指針

プロジェクト概要は @README.md を参照してください。
利用可能なnpmスクリプトは @package.json を参照してください。

## 追加ルール
- Gitワークフロー: @docs/git-guide.md

まずはCLAUDE.mdから始めましょう

新しいプロジェクトを始めるなら、最初の作業としてCLAUDE.mdを作りましょう。

# プロジェクト開始時にClaude CodeにCLAUDE.mdの自動生成を依頼
/init

あるいは、Claudeに直接お願いすることもできます：

「このフォルダは競合他社の市場調査リサーチプロジェクト。
 成果物は reports/ フォルダにMarkdownで保存して、
 すべての主張に出典を付けて。日本語で書いて。
 この内容をもとにCLAUDE.mdファイルを作って。」

開発者の場合: 「このプロジェクトはNext.js 14 + TypeScript + Tailwindで作る。パッケージマネージャーはpnpm。CLAUDE.mdファイルを作って。」

まとめ: CLAUDE.md早見表

CLAUDE.md 1つで毎回の説明の手間をなくし、Claude Codeを本当のチームメンバーのように活用できます。

CLAUDE.mdをしっかり書いておくだけで、毎セッションの説明が不要になります。まるで本当のチームメンバーのように使えるようになります。

09. コマンド一覧

Claude Codeを使う際に知っておくべきコマンドを一覧で整理しました。

コマンドの3つの種類

Claude Codeのコマンドは大きく3つに分かれます。

CLIコマンド（ターミナルで入力）

Claude Codeを起動・制御するコマンドです。ターミナルで入力します。

基本実行コマンド

モデルを指定して実行

# 特定のモデルで開始
claude --model claude-opus-5-5

# または短縮形（エイリアス）で
claude --model opus      # 最新のOpus（現在はOpus 5.5） ── すべてのプランのデフォルトモデル
claude --model sonnet    # 最新のSonnet（現在はSonnet 5.5）
claude --model haiku     # 最速・最安（現在はHaiku 5.5）
claude --model fable     # 最難関・長時間タスク向け（現在はFable 5.1、別途アクセス権限が必要）
claude --model opusplan  # 計画はOpus、実行はSonnet

2026年10月時点のモデルラインナップ: Fable 5.1 → Opus 5.5 → Sonnet 5.5 → Haiku 5.5。4モデルすべてコンテキストウィンドウは100万トークンです。 opus・sonnetなどのエイリアスは時間とともに最新版を指すように変わるため、バージョンを固定したい場合はclaude-opus-5-5のような正式なモデル名を使ってください。

思考強度は --effort low|medium|high|xhigh|max で調整します。Opus 5.5 / Sonnet 5.5 / Haiku 5.5のデフォルトは medium です。

便利な起動オプション

# Plan Modeで開始（ファイル修正なしで計画のみ）
claude --permission-mode plan

# 毎回確認を求めるManualモードで開始（デフォルトはAutoモード）
claude --permission-mode manual

# 最初からセッションに名前を付ける
claude -n セッション名

# セッション名で引き継いで開始
claude --resume セッション名

# 以前の会話一覧から選んで引き継いで開始
claude --resume

ヒント：最初はただ claude と入力して始めれば大丈夫です。残りは必要になったときに覚えても遅くありません。

スラッシュコマンド（会話中に入力）

Claude Codeとの会話中に / で始まるコマンドを入力すると、特別な機能を使用できます。

よく使うスラッシュコマンド

/vim は削除されました。Vim編集モードは /config → Editor modeで有効にします。/clone、/half-clone のようなコマンドは存在しません。

スラッシュコマンドの使い方

> /compact
→ 会話内容を要約してコンテキストを削減します

> /compact コード変更点を中心に整理して
→ 圧縮の方向を直接指定できます

> /model
→ モデル選択画面が表示されます

ヒント：会話画面で / だけ入力すると、使用可能なコマンド一覧がオートコンプリートで表示されます。

会話の分岐と実験の戦略

会話の途中で方向を変えたり、リスクのある実験を安全に試したいときに活用できる機能です。

/branch — 元の会話を保持したまま実験する

現在の地点で会話を分岐します。複雑なリファクタリングや構造的な変更を試す前に分岐しておけば、失敗してもそれまでの会話を失いません。

> /branch ストリーミング方式の実験
→ 現在の地点から新しい分岐を開始（名前を省略すると最初のプロンプトから自動命名）
→ 元の会話はそのまま残る → /resume 元の名前 で戻れる

こんなときに使ってみてください

• 複数の実装方法のうち1つをまず試してみたいとき
• 「こう直したらどうなるかな」と思うが失敗が心配なとき
• 同じ問題を異なるアプローチで比較してみたいとき

/fork — コピーをバックグラウンドに渡す

現在の会話をバックグラウンドセッションにコピーし、いまのターミナルではそのまま作業を続けます。片方をバックグラウンドで走らせながら、別の方向を自分で進めたいときに便利です。

> /fork
→ 会話のコピーがバックグラウンドセッションへ移動
→ 現在のウィンドウではそのまま作業を継続

失敗した地点まで完全に巻き戻したい場合は/rewind（または入力欄が空の状態でEsc2回）を使います。メニューでコード+会話 / 会話のみ / コードのみの巻き戻しを選ぶか、特定の地点以降（または以前）の会話だけを要約してコンテキストを空けることもできます。

/context — コンテキスト使用量の確認

> /context
→ [■■■■■■■□□□] 70% (700,000 / 1,000,000 tokens)

現在の会話がコンテキストウィンドウの何%を占めているか視覚的に表示します。80%以上になったら/compactや/clearを検討してください。

現在のモデル（Fable 5.1 / Opus 5.5 / Sonnet 5.5 / Haiku 5.5）はすべて100万（1M）トークンのコンテキストです。上限に近づくと自動的に圧縮され、/autocompact 500k のように、より早く圧縮されるよう調整することもできます。

/rename — セッションに名前を付ける

重要な作業セッションに名前を付けておくと、後から簡単に再開できます。

> /rename 競合調査-2月

# 後でターミナルから引き継いで開始
$ claude --resume 競合調査-2月

キーボードショートカット

会話中にキー操作で素早く制御できます。

主要ショートカット

入力関連ショートカット

モード切り替えショートカット

初心者がよく使うコマンドTOP 5

始めたばかりなら、この5つだけ覚えれば十分です。

1. /compact — 最も重要なコマンド

> /compact

会話が長くなると、Claudeが遅くなったり古い内容を忘れたりします。このとき /compact と入力すると会話を圧縮して速度を回復します。長い作業中は定期的に使う習慣をつけましょう。

2. Ctrl+C — 止めたいとき

Claudeが見当違いの方向に進んでいるとき、または誤って危険なコマンドを許可してしまったときに即座に停止します。

3. /clear — 最初からやり直すとき

> /clear

まったく別のトピックに移るときに使います。以前の会話内容はすべて消去されます。

4. Shift+Enter — 長い指示の入力

1行で書ききれない長いリクエストは Shift+Enter で改行しながら入力してください。Shift+Enter が効かないターミナルでは、代わりに Ctrl+J を押せば改行できます（すべてのターミナルで動作）。

（Shift+Enterで複数行入力の例）
ログインページを作って。
- メールアドレスとパスワードのフィールド
- パスワードの表示/非表示ボタン
- ログインボタン（ローディング状態付き）

5. /usage — 使用量・コスト確認

> /usage

現在のセッションでどれくらい使ったか確認します。（/costと/statsは同じコマンドのエイリアス。サブスクリプションユーザーにはプラン使用量のバーと、どのスキル・サブエージェント・MCPサーバーが使用量を多く占めたかも合わせて表示されます）

使用量の上限に達したら /rate-limit-options で選択肢を確認できます。上限が解除されるまで待って自動的に作業を再開させるか、/usage-credits で追加使用量（usage credits）を有効にできます。

alias cc='claude'
alias ccd='claude --dangerously-skip-permissions'
alias ccr='claude --resume --dangerously-skip-permissions'

source ~/.zshrc

function cc { claude @args }
function ccd { claude --dangerously-skip-permissions @args }
function ccr { claude --resume --dangerously-skip-permissions @args }

クイックリファレンス

ターミナルで入力：
  claude                    → 開始
  claude -v                 → バージョン確認
  claude --help             → ヘルプ
  claude -c                 → 最新セッションを引き継ぎ
  claude -n [名前]          → 名前を付けて開始
  claude --resume [名前]    → 名前を付けたセッションを再開
  claude --add-dir [パス]   → 追加ディレクトリを含める
  claude --permission-mode plan → Plan Modeで開始

Alias（設定後）：
  cc                        → claude（基本）
  ccd                       → 権限自動承認
  ccr                       → 前回セッション再開 + 権限自動承認

会話中に入力：
  /help               → 全コマンドリスト
  /compact            → 会話圧縮（こまめに使おう！）
  /clear              → 会話初期化
  /branch             → 現在の地点で会話を分岐
  /fork               → 会話のコピーをバックグラウンドへ
  /rewind             → コード・会話をチェックポイントへ戻す
  /context            → コンテキスト使用量確認
  /usage (= /cost)    → 使用量・コスト確認
  /model              → モデル変更
  /effort             → 思考強度の調整
  /fast               → Fast Modeのオン/オフ
  /diff               → 変更内容のレビュー
  /rename [名前]       → セッションに名前を付ける
  /bug                → バグレポート送信
  /quit               → 終了

キーボードショートカット：
  Ctrl+C / Esc        → 作業キャンセル
  Ctrl+D              → 終了
  Ctrl+B              → 実行中の作業をバックグラウンドへ
  Shift+Tab           → 権限モードの切り替え
  Shift+Enter, Ctrl+J → 改行
  ↑↓ 矢印キー         → 前のコマンドを参照
  Esc Esc             → 巻き戻しメニュー（入力欄が空のとき）

10. 初心者ワークフロー

初めてClaude Codeを使うとき、どのように始めて、どのように作業すればよいか、ステップごとにご案内します。

初回セッションの流れ（Step-by-Step）

初めての方は、この順番に沿って試してみてください。

Step 1. プロジェクトフォルダに移動

cd myproject

Claude Codeは現在のフォルダを基準にファイルを読み書きします。必ず作業するプロジェクトフォルダに先に移動してください。

フォルダがない場合は mkdir myproject && cd myproject で作成しても構いません。

Step 2. Claude Codeを起動

claude

ターミナルで claude と入力してEnterを押すと、対話モードが開始されます。

Step 3. プロジェクトを把握させる（強くおすすめ）

最初に始めるとき、Claudeにプロジェクトを把握させるか、CLAUDE.mdファイルを作成するよう依頼しましょう。

> このプロジェクト全体を把握してCLAUDE.mdファイルを作ってください

既存のプロジェクトであれば：

> このコードベースの構造を説明してください

CLAUDE.mdが重要な理由：このファイルにプロジェクトのルール、技術スタック、注意事項を書いておけば、Claudeが毎回質問しなくても済みます。チームがある場合はgitにコミットして共有しましょう。

Step 4. 作業を指示

やりたい作業を自然言語で指示します。

> ログイン機能を作ってください
> このコードのバグを見つけてください
> README.mdを日本語に翻訳してください

Step 5. 結果確認とフィードバック

Claudeがファイルを修正すると、変更内容を表示します。気に入らなければすぐにフィードバックしましょう。

> いいですね、ただエラーメッセージは日本語にしてください
> この部分は別の方法でやってください — [説明]

Step 6. セッション終了

> /quit

または Ctrl+D を押すと終了します。

効果的なプロンプトの書き方

具体的に指示するほど良い結果が出ます

一度に一つずつリクエストする

複数の要件を一度にまとめて依頼すると、Claudeが途中で方向を見失うことがあります。

# 非推奨
> ログインを作って、会員登録も追加して、パスワード再設定も作って、
  メール認証も入れて、ソーシャルログインも追加して

# 推奨
> まずメール/パスワードのログイン機能だけ作ってください
（完了後）
> 次に会員登録機能を追加してください

出力形式を明示する

> このコードを説明してください         → 説明文として回答
> このコードをファイルに保存してください   → ファイルとして保存
> このコードを改善して上書きしてください   → ファイルを直接修正
> バグ一覧を表で整理してください         → 表形式で回答

@記号でファイルを指定する

@ の後にファイルパスを付けると、Claudeがそのファイルを直接読み込んで作業します。「このファイルを読んで...」と説明する必要なく、ファイルを会話に直接渡すことができます。

> @議事録.txt からアクションアイテムだけ抽出してください
> @契約書.pdf の重要条項だけ整理してください
> @データ.csv を分析してインサイト3つ抽出してください
> @src/auth/login.js このファイルのバグを見つけてください
> @README.md を見てプロジェクト構造を把握してください

フォルダ全体を渡すこともできます：

> @docs/ このフォルダの文書をすべて読んで目次を作ってください
> @reports/2025/ 月別レポートを比較してトレンド分析をしてください

ヒント: 入力欄で @ を入力するとファイル一覧がオートコンプリートで表示されます。日本語ファイル名でも問題ありません。

実際の使用例

ドキュメント・業務

> @議事録-250225.txt
  今日の会議内容を要約して、アクションアイテムを担当者別に整理してください

> @報告書草案.docx
  全体的にレビューしてください。論理的に抜けている部分や
  データが必要な主張があれば指摘してください

> ~/Downloads/meeting-250225.mp3 ファイルがあります。
  会議内容をテキストに変換して要約してください

Claude CodeがSTT変換に必要なツールを自動的にインストールして実行します。Pythonやライブラリの知識は不要です。

データ・分析

> @sales-q1.csv
  第1四半期の売上データを分析してインサイト3つ抽出してください。
  グラフも画像として保存してください

> @競合A.html @競合B.html @競合C.html
  3社の競合ランディングページを比較分析してください。強み/弱みを表で整理してください

開発

> ユーザープロフィールページを作ってください。
  - ニックネーム、メール、登録日を表示
  - プロフィール写真のアップロード可能
  - ニックネームの編集機能

> npm test を実行すると以下のエラーが出るので修正してください：
  TypeError: Cannot read property 'id' of undefined
  at UserService.getUser (src/services/user.js:45)

> @src/payment/ フォルダのコードをレビューしてください。
  セキュリティ上の脆弱性と改善点を教えてください

Plan Modeの活用ヒント

Plan Modeとは？ Claudeがファイルを修正せず、計画だけを立てるモードです。リスクのある作業を行う前に、まず計画を確認できます。

Plan Modeの有効化

> /plan
（またはステータスバーに「plan mode on」と表示されるまでShift+Tabを押す）

# 説明を付けると、その作業の計画からすぐ開始
> /plan 写真整理アプリのデータ構造を設計

どんなときにPlan Modeを使うか

• 複数のファイルを同時に修正する必要があるとき
• データベースマイグレーションのように元に戻しにくい作業
• 初めて見るコードベースを修正する前
• アーキテクチャ変更のような大きな作業

💡 プロジェクトの初期企画段階では、show-me-the-prdプラグインに一文を渡すだけで4種の企画書ドラフトを自動生成できます。

Plan Modeの使用例

# Plan Modeで開始
claude --permission-mode plan

# または会話中に切り替え
> /plan

# 計画策定を依頼
> 認証システムをJWTからOAuth2にマイグレーションする計画を立ててください

# Claudeが計画を表示したら確認
# 承認すると、どのモードで実行するか聞かれます（Autoモード / 編集自動承認 / 自分で確認）

作業前のgit commit習慣

Claude Codeがファイルを修正する前に、現在の状態をgitに保存しておけば、ミスをしても簡単に元に戻せます。

git add .
git commit -m "Claude Code作業前のバックアップ"

💡 Gitコマンドに慣れていない場合は、Claude Codeに「gitで現在の状態を保存して」と依頼するだけでも対応できます。

その後、Claudeが修正した内容が気に入らなければ：

git diff          # 変更内容を確認
git checkout .    # すべての変更を取り消し（注意！）

またはClaude Code内で /diff でこれまでの変更を一覧で確認し、/rewind（入力欄が空の状態で Esc + Esc）で前の状態に巻き戻すこともできます。

⚠️ 絶対にやってはいけないこと

機密情報の入力禁止

# 絶対禁止
> 私のAWSアクセスキーはAKIAXXXXXXXXで...
> DBパスワードはmypassword123で...
> 私のSSH秘密鍵は-----BEGIN RSA...

APIキー、パスワード、個人証明書などは、絶対に入力欄に直接入力しないでください。環境変数や .env ファイルを使用してください。

権限リクエストの無分別な許可禁止

Claudeが sudo コマンドやシステムファイルの修正権限を要求するとき、まず理由を確認してください。

# Claudeがこのような権限を要求した場合、まず理由を確認
> なぜsudoが必要ですか？他の方法はありませんか？

--dangerously-skip-permissions の使用に注意

このオプションはすべての権限確認をスキップします。隔離されたテスト環境（コンテナなど）でなければ使用しないでください。確認ダイアログが煩わしいなら、デフォルトのAutoモード（分類器が審査）で十分です。

重要な作業前にバックアップなしで進行しない

大規模なリファクタリングやデータベースマイグレーションの前には、必ずgit commitやバックアップを先に行ってください。

セッション管理のヒント

長い作業には名前を付けて保存

> /rename auth-refactor

最初から名前を付けて開始することもできます: claude -n auth-refactor

後で続きをするとき：

claude --resume auth-refactor

コンテキストが長くなったら圧縮

作業が長くなるとClaudeの応答が遅くなります。定期的に：

> /compact

関連のない新しい作業は初期化してから開始

> /clear

まとめ

具体的に指示して → 一度に一つずつリクエストして → 結果を確認して → フィードバックを繰り返しましょう。

行き詰まった場合は、次のセクション「トラブルシューティング」をご覧ください。

11. セッション＆コンテキスト管理

Claude Codeを長く、効率的に使う方法。長くなったセッションの圧縮、前回の作業の再開、複雑な作業前の安全策まで。

コンテキストウィンドウとは？

背景知識のない方へ：

Claudeは会話するとき、これまでのやり取りの内容をすべて覚えながら作業しています。しかし、この記憶には限界があるため、会話が積み重なっていくと、古い内容から押し出されていきます。

「さっき確かに言ったのに、なぜ分からないの？」という状況がまさにこれです。Claudeがわざと忘れたのではなく、メモ帳がいっぱいになって古い内容が切り落とされたのです。

背景知識のある方へ：コンテキストウィンドウは、AIモデルが一度に処理できるトークンの最大数です。現在のモデル（Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1）はすべて100万トークンで、上限に近づくとClaude Codeが古い会話を自動的に要約（自動圧縮） して空きを作ります。要約から漏れた細部は、もうClaudeの記憶にはありません。

共通して起こること：

会話が長くなるにつれて：
  序盤の内容が要約でぼやけ始める
  → Claudeが前に行った作業の細部を覚えていないことがある
  → 回答の品質が低下し始める
  → 同じミスを繰り返し始める
  → リクエストのたびに会話全体を送り直すので、使用量も増える

そのまま放置すると、会話がどんどん混乱していきます。たまに整理してあげる必要があります。

/compact — 会話の圧縮

/compact

これまでの会話を要約してコンテキストを削減します。

• 重要な内容は要約に含まれます
• セッションを切らずにそのまま続けられます
• 使うタイミング：会話が長くなったと感じたとき、回答がおかしくなり始めたとき

圧縮の方向性を直接指定することもできます：

/compact リサーチ結果と主な発見事項を中心に要約してください
/compact 作成中のレポートの構成と進捗状況を中心に
/compact 結論/根拠/未解決の質問だけ残してください

一部の区間だけ整理したい場合は、/rewindメニューのSummarize from here / up to hereを使ってください。たとえば、長かったデバッグの区間だけを要約し、最初の指示はそのまま残すことができます。

セッション再開の方法

--continue — 直前のセッションを引き継ぐ

claude --continue

最後に終了したセッションをそのまま引き継ぎます。

• ターミナルを閉じて再度開いたとき
• 途中の作業を翌日続けるとき

--resume — セッションを選択して再開

claude --resume

以前のセッション一覧を表示し、選択して引き継ぎます。

• 複数のプロジェクトを交互に作業するとき
• 数日前の特定のセッションに戻りたいとき

claude -n 名前で始めるか、会話中に/rename 名前をしておけば、claude --resume 名前ですぐに戻ってこられます。会話中に別のセッションに乗り換えるには/resumeを入力してください。

Pro/Maxユーザー：10万トークンを超えるセッションを1時間以上休んでから再開すると、「要約から再開するか」を尋ねるダイアログが表示されます。細部がどうしても必要でなければ、Resume from summaryを選ぶ方が、その後のリクエストごとにかかる使用量がはるかに少なくなります。

/branch — 今の地点から分岐する

/branch 別のアプローチを試す

ここまでの会話をコピーした新しい分岐に移ります。元の会話はそのまま残り、/resume 元の名前で戻ることができます。大きな変更を試す前に「失敗したら戻る地点」を作っておく用途です。ターミナルではclaude --continue --fork-sessionが同じ役割をします。

いつ新しいセッションを始めるべきか

複雑な作業の前にはPlan Mode

複数のファイルを同時に修正したり、大きな変更が予想されるとき、実行前にまず計画を確認してもらうことができます。

/plan  →  Plan Modeに切り替え
（またはステータスバーに「plan mode on」が出るまでShift+Tab）

Plan ModeでのClaudeは：

1. 実行計画のみを表示します（ファイルは変更しません）
2. 「このように進めようと思いますが、よろしいですか？」と先に確認を取ります
3. 承認を得てから実行します

使うタイミング：複数ファイルの同時修正、フォルダ構造の再編、大量の内容置換、元に戻しにくい作業の前

並列セッション

ターミナルを複数開いて、同時に別々の作業を任せることができます。

ターミナル1: claude（競合A社のリサーチ）
ターミナル2: claude（レポート草案の作成）
ターミナル3: claude（プレゼン資料の整理）

各セッションは独立して動作します。

注意：同じファイルを2つのセッションで同時に修正すると競合が発生します。担当ファイル/役割を分けて使いましょう。

よくある状況別の対処法

Claudeの回答が急におかしくなったとき

1. /compact で圧縮を試みる
2. それでもおかしければ → 新しいセッションを開始
3. 新しいセッションで重要なコンテキストだけ再提供：「現在[プロジェクト名]の作業中で、ここまで[要約]を行った。次に[作業]を行う必要がある。」

長い作業を途中で止めなければならないとき

作業中 → Ctrl+Cで中断
→ ターミナルを閉じる
→ 次回: claude --continue

Claudeは中断された地点からの状態を覚えています。

コストにも関係します：コンテキストが長いほど多くのトークンを消費します。/compactを定期的に使えば、速度も上がりコストも削減されます。→ 詳しくはセクション19のコスト管理をご覧ください。

12. GitHub入門

🖥️ このセクションは主にコードを書く開発者向けの内容です。コーディング作業がない場合は、下記の非開発者向けファイルバージョン管理のヒントだけ読んで次のセクションに進んでも構いません。コマンドを知らなくても大丈夫です — 自然言語から始められます。

非開発者の方へ：ファイルバージョン管理の3つの方法

コーディングをしなくても、ファイルが誤って変更されたり消えてしまう状況は誰にでも起こります。簡単な代替手段をご紹介します：

Gitに興味が出てきましたか？ Gitはコード以外にも、あらゆるファイルのバージョン管理が可能です。リサーチファイル、レポート、企画書もGitで安全に管理できます。興味があれば、このセクションを読み進めてください。

なぜGit & GitHubが必要なのか？

Claude Codeでコードを修正していると、ファイルが次々と変わっていきます。Gitがないと：

• 昨日うまく動いていたコードが今日なぜ動かないのか分からない
• Claudeが誤って重要なコードを削除しても元に戻せない
• チームメンバーと同じファイルを修正して、お互いの作業を上書きしてしまう

Git：すべての変更履歴を保存し、いつでも以前の状態に戻せるツール GitHub：その履歴をクラウドにバックアップし、チームと共有するプラットフォーム

Claude Codeユーザーにとって、Git + GitHubは必須です。

Google DriveとGitのたった一つの違い

Gitを初めて使う方が最も混乱するポイントです。

この違いだけ覚えておけば大丈夫です。

Gitには常に2つのステップがあります：

1. 保存（Commit）— 変更内容を自分のパソコンに記録
2. アップロード（Push）— 記録した内容をGitHubにアップロード

なぜ2ステップなのか？ インターネットがなくてもローカルで保存でき、後から準備ができたものだけ選んでアップロードできます。

最初の一歩：git-teacherプラグインで5分セットアップ

Gitコマンドを覚える必要はありません。git-teacherプラグインが自然言語ですべて処理してくれます。

gptaku_pluginsをセクション06（プラグイン）でインストール済みであれば、すでに準備完了です。まだの場合は：

/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
/plugin install git-teacher@gptaku-plugins

インストール後に新しいコマンドが表示されない場合は、/reload-pluginsを実行してください。

初回のみ：セットアップ

「Gitを始めて」

自動的に処理されること：

1. Gitのインストール確認（未インストールの場合はインストール案内）
2. GitHub CLI(gh)のインストール確認
3. GitHubアカウントへのログイン（ブラウザが自動で開きます）
4. プロジェクトフォルダの設定
   • 新規プロジェクト → 新しいフォルダ + GitHubリポジトリを作成
   • 既存プロジェクト → GitHubからクローン
   • 現在のフォルダ → 現在の場所をリポジトリとして設定

すでに完了しているステップは自動的にスキップされます。

毎日行う3つのこと

1. 保存する（Commit）

「保存して」

変更されたファイルの一覧を表示し、説明（コミットメッセージ）の入力を求めます。

例：「ログインページのデザイン修正」
    「バグ修正：パスワード検証エラー」

保存完了後、以下の案内が表示されます：

✅ 保存完了！
まだ自分のパソコンにしかありません。
GitHubにアップするには「アップして」と言ってください。

2. GitHubにアップロードする（Push）

「アップして」

保存した内容をGitHubにアップロードします。完了するとリポジトリのリンクが表示されます。

自動エラー処理：

• チームメンバーが先にアップした内容と重複する場合、自動的にマージしてアップ（--rebase）
• SSH認証エラーの場合はHTTPSに自動切り替え

3. レビューを依頼する（Pull Request）

チームメンバーに自分の変更をレビューしてもらいたいとき：

「レビュー依頼して」

自動的に処理：Branch作成 → 保存＆アップロード → PR作成 → リンク提供 → 元の状態に復帰

自然言語コマンド一覧

やりたいこと                      こう言ってください
─────────────────────────────────────────────────
初期設定                         「Gitを始めて」
現在の変更ファイル確認              「今どんな状態？」
                                「何が変わった？」
保存する（Commit）                「保存して」
                                「セーブして」
GitHubにアップする（Push）         「アップして」
                                「アップロードして」
レビューを依頼する（PR）           「レビュー依頼して」
                                「チームに見せたい」
用語の説明を依頼                  「commitって何？」
                                「pushとcommitの違いを教えて」

スラッシュコマンドでも使用できます：

Git用語クイックガイド

初めて見る単語が出てきたときの参考にしてください。

分からない用語があればいつでも聞いてください：

「pushとcommitの違いは何？」

Claude Codeと一緒に過ごす一日のルーティン

作業開始：
  claude起動 → 「Gitを始めて」（初日のみ）

作業中：
  コード修正 → 「保存して」 → 「アップして」
  （大きな作業の前に：「今どんな状態？」で確認）

作業終了：
  「保存して」 → 「アップして」（必ず両方のステップ）

チーム協業：
  機能完成 → 「レビュー依頼して」 → PRリンクを共有

このルーティンを守れば、Claude Codeで作業した内容が常に安全に保管されます。誤ってコードが壊れても、いつでも以前の状態に戻ることができます。

.gitignore — APIキーがGitHubにアップされないように

Gitを初めて使うときに最もよくあるミスが、.env ファイルに含まれるAPIキーをGitHubにアップロードしてしまうことです。

git-teacherプラグインは「保存して」の際にプロジェクトタイプを自動検出して .gitignore を生成します。すでに存在する場合はスキップします。

自分で作成したい場合は：

# .gitignore の例
.env
.env.local
node_modules/
.DS_Store

Gitコマンドを直接使いたい場合：Claude Codeにそのまま言えばOKです — git commit、git push を直接実行してくれます。git-teacherプラグインは、非開発者向けのガイダンス、自動エラー処理、日本語でのステータス説明が追加されたレイヤーです。Gitに慣れていない方はgit-teacherから始めてみてください。

13. よくあるミスと解決法

初心者がClaude Codeを使う際によく遭遇する問題をQ&A形式でまとめました。

Q1. claude コマンドが見つからないと表示される（command not found）

症状

$ claude
zsh: command not found: claude

原因と解決法

インストールはされたが、ターミナルが claude コマンドの場所を認識していない状態です。

方法1：ネイティブインストールを使用（最も確実）

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

インストール後、ターミナルを完全に閉じて新しく開いてください。

方法2：PATHの確認

# claudeがどこにインストールされたか確認
which claude

# PATHの確認
echo $PATH

~/.local/bin がPATHに含まれていない場合、シェル設定ファイル（.zshrc または .bashrc）に追加：

export PATH="$HOME/.local/bin:$PATH"

追加後 source ~/.zshrc を実行。

方法3：インストール状態の点検

claude doctor

Q2. ログインできない

症状

• ブラウザが開かない
• 認証画面でフリーズする
• ログイン後も認証エラーが出る

解決法

ブラウザポップアップが開かないとき

claude 実行後に c を押して認証URLをコピーし、ブラウザに直接貼り付けてください。

ブラウザにログインコードだけが表示されるとき（WSL2、SSH、コンテナ）

ブラウザからターミナルに戻れない環境です。画面に表示されたコードをコピーして、ターミナルの Paste code here if prompted の欄に貼り付けてください。

ログアウト後に再認証

# Claude Code内で
> /logout
> /login

# または保存された認証情報を直接削除（Linux/Windows）
rm ~/.claude/.credentials.json
claude

macOSはKeychainに保存されるため /logout を使ってください。サブスクリプションアカウントがあるのに環境変数 ANTHROPIC_API_KEY が設定されていると、APIキーが優先されて認証エラーになることがあります。/status でどのログイン方式が有効か確認し、必要なら unset ANTHROPIC_API_KEY で削除してください。

それでもダメな場合

# すべての設定をリセットして再起動
rm ~/.claude.json
rm -rf ~/.claude/
claude

注意：この操作を行うと、すべての設定とセッション履歴が削除されます。

Q3. 動作が遅い / 応答が遅い

原因

会話が長くなるにつれて、Claudeが処理すべき内容（コンテキスト）が蓄積され、遅くなります。これは正常な動作です。

解決法

方法1：/compact でコンテキストを整理（最も効果的）

> /compact

会話内容を圧縮して速度を回復します。

方法2：/clear で初期化

完全にやり直しても問題ない場合：

> /clear

方法3：より高速なモデルや低い思考強度に変更

複雑な作業でなければ、HaikuやSonnetはOpusよりはるかに高速です。

> /model
> /effort low

モデル選択画面で変更するか、モデルはそのままで /effort low にして考える量だけ減らしても体感速度が上がります。Opusの応答速度そのものが必要なら /fast（追加課金）をオンにできます。

方法4：MCPサーバーを減らす

不要なMCPサーバーが多いと遅くなることがあります。

> /mcp

使用していないサーバーを無効化してください。

Q4. 思い通りに修正してくれない

原因

指示が曖昧、Claudeがプロジェクトの文脈を理解していない、または同じ話を繰り返してClaudeが混乱している場合です。

解決法

方法1：より具体的に指示する

# 曖昧な指示
> コードを改善して

# 具体的な指示
> auth.jsのlogin関数でメールのバリデーションが抜けています。
  正規表現でメール形式を確認するコードを42行目の後に追加してください

方法2：CLAUDE.mdにルールを追加

繰り返し発生する要件はプロジェクトルールとして保存しましょう。

> /memory

またはCLAUDE.mdファイルに直接追加：

# コードスタイル
- エラーメッセージは常に日本語で記述
- 関数ごとにJSDocコメント必須
- varの使用禁止、const/letのみ使用

方法3：同じミスが2回繰り返されたら初期化

> /clear

新しく始めて、より明確な指示で再度リクエストしてください。

Q5. ファイルを修正したがミスだったようだ

解決法

方法1：Claude Code内で巻き戻し（最も速い）

Escキーを2回連続で押す
または
> /rewind

以前の状態に会話とコードをまとめて戻します。

方法2：gitで復旧

# 変更内容の確認
git diff

# 特定のファイルだけ元に戻す
git checkout -- src/auth/login.js

# すべての変更を取り消し
git checkout .

方法3：作業前のgit commit習慣を身につける

Claude Codeで大きな作業を始める前に必ず：

git add .
git commit -m "作業前バックアップ $(date +%Y%m%d-%H%M)"

Q6. 突然コストが高くなった

原因

• 会話が長くなりすぎた（コンテキストが大きいほどトークン消費が増加）
• ファイルの多いプロジェクト全体の分析を依頼
• Opusモデルを使い続けた
• エージェントチーム機能の使用

解決法

現在のコストを確認

> /usage

/costは同じコマンドのエイリアスです。サブスクリプション利用者はここでプラン使用量のバーも確認できます。

コストを削減する方法

1. /compact を頻繁に使ってコンテキストを管理
2. 単純な作業にはSonnetやHaikuを使用（/model で変更）
3. 大きなファイル/フォルダ全体を文脈なく読み込ませない
4. 関連のない作業の間には /clear で初期化

予算の上限設定（自動化使用時）

claude -p --max-budget-usd 1.00 "質問"

Q7. 権限リクエストが多すぎる

状況

Claudeがファイルを修正したりコマンドを実行するたびに許可を求めてきます。

解決法

方法1：よく使うツールは常に許可に設定

> /permissions

権限管理画面で特定のツールをAlways Allowに設定します。

方法2：Autoモードになっているか確認する

Shift+Tabを押してステータスバーが「auto mode on」になるように切り替え

v2.1.283以降、新しいセッションはデフォルトでAutoモードで始まります。分類器が代わりに検討するので、ほとんどの確認ダイアログが消えます。シェルコマンドの確認ダイアログに 「Yes, and switch to auto mode」 が表示されたら、それを選んでも構いません。Manualモードで始まった場合は、モデルがAutoモードに対応していない（旧世代モデル）か、組織の設定で無効化されています。

方法3：各権限モードを理解する

--dangerously-skip-permissions の使用に注意

このオプションはすべての権限確認をスキップします。隔離されたコンテナ環境でなければ使用しないでください。誤ってシステムファイルを修正・削除するリスクがあります。

Q8. 日本語が文字化けする / 文字が正しく表示されない

原因

ターミナルがUTF-8エンコーディングを使用していない場合に発生します。

解決法

macOS / Linux

シェル設定ファイル（.zshrc または .bashrc）に追加：

export LANG=ja_JP.UTF-8
export LC_ALL=ja_JP.UTF-8

追加後 source ~/.zshrc を実行。

ターミナルアプリの設定確認

• iTerm2：Preferences → Profiles → Terminal → Character Encoding → UTF-8
• macOS標準ターミナル：環境設定 → プロファイル → 詳細 → 文字エンコーディング → Unicode(UTF-8)
• VS Codeターミナル：自動的にUTF-8を使用（ほとんどの場合問題なし）

Windows（WSL）

# WSLで実行
sudo locale-gen ja_JP.UTF-8

Q9. コンテキストを失った（セッションが初期化された）

状況

• Claudeが以前の作業を覚えていない
• セッションが突然切れた
• ターミナルを閉じて再度開いた

解決法

方法1：前回のセッションを引き継いで開始

# 最新のセッションを引き継ぐ
claude --continue

# セッション一覧から選択
claude --resume

# 名前で引き継ぐ（事前に名前を保存した場合）
claude --resume 競合リサーチ-2月

方法2：セッションに名前を付けておく（予防策）

重要な作業を始めるとき：

> /rename 競合リサーチ-2月

方法3：CLAUDE.mdに重要情報を保存

セッションが切れても維持すべき情報はCLAUDE.mdに：

> /memory

# 現在進行中の作業
- 目標：Q1市場競合分析レポートの完成
- 完了：A社、B社の分析
- 進行中：C社の分析、最終比較表の作成
- 参考ファイル：research/competitors/ フォルダ

Q10. コードが大幅に変わってしまった（予期しない大規模変更）

状況

「簡単に修正して」と言ったのに、Claudeが関係ないファイルまで大量に修正してしまうケース。

解決法

方法1：すぐに止める

Claudeが作業中であれば：

Ctrl+C

または Esc を押して現在の作業を中断。

方法2：以前の状態に巻き戻す

Escを2回連続
または
> /rewind

方法3：gitで確認して復旧

# 変更されたファイル一覧を確認
git status

# 変更内容の詳細確認
git diff

# 特定のファイルだけ復旧
git checkout -- ファイルパス

# すべて取り消し
git checkout .

方法4：Plan Modeで事前確認（予防策）

大きな作業の前にはPlan Modeで計画を先に確認しましょう。

> /plan

または

claude --permission-mode plan

方法5：指示をより具体的に

# 範囲を明確に指定
> auth.jsファイルのlogin関数だけ修正して。他のファイルは触らないで

# 禁止事項を明示
> リファクタリングはせず、バグだけ修正して

Q11. Claudeがドキュメントの一部だけでなく全体を書き直してしまった

状況

「3段落目だけ直して」と言ったのに、Claudeがドキュメント全体を最初から書き直してしまうケース。

解決法

方法1：すぐに巻き戻す

Escを2回連続
または
> /rewind

方法2：範囲をより明確に指定する

# 曖昧な指示
> 3段落目を直して

# 具体的な指示
> 「導入部の2番目の段落で『しかし』で始まる文だけをもう少し柔らかい表現に変えてください。
  それ以外は触らないでください」

方法3：Plan Modeで事前確認

/plan でPlan Modeに入る → Claudeが「どこをどのように変更する予定か」を先に表示します。確認後に承認。

Q12. 日本語だけで検索したら情報が不足している

状況

Claudeにリサーチを依頼したが、日本語の資料しか探さず結果が乏しいケース。

解決法

検索言語を明示的に指示してください：

「英語、日本語の資料を両方検索して整理してください」

「主に英語の資料を探して、重要な内容は日本語で要約してください」

「グローバルトレンドは英語資料ベースで、国内の状況は日本語で調査してください」

Claudeは言語を指定しないと、日本語での会話の文脈から日本語資料を中心に検索する傾向があります。

Q13. AIが推奨したパッケージをインストールしたが怪しい 🖥️ 開発者向け

スロップスクワッティング（Slopsquatting）とは？

AIモデルが実際には存在しないパッケージを自信たっぷりに推奨（ハルシネーション）した際に、攻撃者がその名前で悪意のあるコードを含むパッケージをnpm/PyPIに事前に登録しておく攻撃手法です。

Claudeが react-auth-helper というパッケージを推奨したが、実際には存在しないか、同じ名前の悪意あるパッケージが登録されている可能性があります。

インストール前に必ず確認する方法

npmパッケージ情報を先に確認

# インストール前にパッケージ情報を確認
npm info パッケージ名

# ダウンロード数、最終更新日、依存関係を確認
# → 公開されて数日しか経っていない、またはダウンロード数が極端に少ない場合は注意

Claudeに出典も一緒に聞く

「このパッケージが本当に存在するか、npmjs.comのリンクと
GitHubリポジトリのURLも一緒に教えてください」

見慣れないパッケージよりも有名なものを優先

• 似た機能であればGitHub starが多く、歴史の長いパッケージを選択
• Anthropic、Microsoft、Vercel、Metaなど信頼できる組織のパッケージを優先
• 初めて見るパッケージはREADMEとソースコードを直接確認

インストール後のコードレビュー

# インストールされたパッケージのエントリーポイントを確認
cat node_modules/パッケージ名/index.js | head -100

💡 docs-guideプラグインを使用すると、Claudeが公式ドキュメントを直接参照するため、存在しないパッケージを推奨する可能性が大幅に減少します。

Q14. Claude作業後にセキュリティが心配 / 予期しない変更が発生した 🖥️ 開発者向け

AIコードをマージする前に確認すべき8つのチェックポイント

Claudeが作成または修正したコードをコミットする前に確認してください。

セキュリティチェックリスト：
□ 1. ハードコードされたシークレットはないか？（APIキー、パスワード、トークン）
□ 2. ユーザー入力が適切に検証されているか？（SQLインジェクション、XSS防止）
□ 3. 動的コード実行関数を使用していないか？（eval系）
□ 4. ファイルパスがユーザー入力をそのまま使用していないか？（パストラバーサル）
□ 5. エラーメッセージに内部構造が露出していないか？
□ 6. 外部URLリクエスト時にドメイン検証があるか？（SSRF防止）
□ 7. 依存関係（パッケージ）が突然追加されていないか？
□ 8. 既存の認証・権限ロジックがバイパスされていないか？

git add -p で変更内容を行単位でレビュー

git add . はClaudeが変更したすべてを一括でステージングします。代わりに git add -p を使えば、変更のチャンク（hunk）ごとに含めるかどうかを選択できます。

git add -p

# 各変更チャンクで：
# y → この変更を含める
# n → この変更を除外
# s → さらに小さく分割して表示
# d → このファイルの残りをすべて除外
# q → 終了

疑うべきAI作業パターン

原則：Claudeが生成したコードも、外部から受け取ったコードと同様にレビューしてください。AIが作成したからといって安全が保証されるわけではありません。

Q15. 「You've hit your session limit」— 使用量の上限に達した

状況

サブスクリプションプランの5時間単位または週単位の上限を使い切って、リクエストがブロックされた状態です。モデルを変えても解除されません（すべてのモデルが同じ上限を共有）。

解決法

> /rate-limit-options

• 待ってから自動で再開する：上限がリセットされると、途中だった作業を自動的に続行します（v2.1.234+）。メッセージにリセット時刻が表示されます。
• 追加使用量をオンにする：/usage-credits で設定ページを開き、使った分だけ追加で支払うusage creditsをオンにできます。月の支出上限を設定しておくと安心です。
• 予防：/usage でプラン使用量のバーと「何が使用量を多く消費したか」を確認してください。/clear せずに長いセッションを使い続けるのが最も多い原因です。

まとめ：よくあるミス防止チェックリスト

Claude Code開始前：
□ プロジェクトフォルダに移動したか？（cd myproject）
□ 重要な作業ならgit commitしたか？
□ CLAUDE.mdにプロジェクトルールがあるか？

作業中：
□ 指示が十分に具体的か？
□ 一度に多くを要求しすぎていないか？
□ 会話が長くなったら/compactを使ったか？
□ 何かおかしければCtrl+Cですぐに止めたか？

作業後：
□ 変更内容を確認したか？（git diff）
□ テストが通っているか？
□ 重要なセッションなら名前を保存したか？（/rename）

問題が解決しない場合は、Claude Code内で /doctor を実行してインストール状態を点検するか、/bug を入力してAnthropicに直接問題を報告できます。プラグインやフックの設定がおかしくなっていると思われる場合は、claude --safe-mode ですべてのカスタマイズを無効にして起動し、原因を絞り込めます。

14. MCP & 外部ツール連携

Notion、Slack、Google Sheets、GitHub、DBなどの外部ツールをClaudeが直接操作できるようにする標準プロトコル

MCPとは？

MCP（Model Context Protocol） は、Claudeが外部ツールやデータソースに接続できるようにするオープン標準です。

簡単に言えば、Claude Codeは基本的にファイルとターミナルしか扱えません。MCPを接続すると、ClaudeがNotionのドキュメントを直接読んだり、Slackメッセージを要約したり、Google Sheetsを更新するなど、外部ツールとやり取りできるようになります。

開発者であれば、GitHub PRレビュー、データベースへの直接クエリ、Sentryエラー分析なども可能です。

たとえ: MCPはClaudeにUSBポートを取り付けるようなものです。どんなツールでも接続すれば使えるようになります。

MCPでなくなる手間

MCPがなければ、こうした作業をすべて手動で行う必要があります：

業務・リサーチユーザー

MCPでできること

GitHub — PR/Issueの直接操作

# GitHub MCPサーバーの接続
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 接続後、このようなリクエストが可能になります
> "PR #456をレビューして改善点を提案して"
> "さっき見つけたバグのIssueを新規作成して"
> "自分にアサインされているオープンPRの一覧を見せて"

Sentry — プロダクションエラー分析

# Sentryの接続
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# /mcp コマンドで認証完了後
> "過去24時間の主要エラーは何？"
> "エラーID abc123のスタックトレースを見せて"
> "これらのエラーはどのデプロイで発生した？"

PostgreSQL — DBへの直接クエリ

# DB接続（読み込み専用推奨）
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

# 接続後
> "今月の総売上はいくら？"
> "ordersテーブルのスキーマを見せて"
> "90日間購入していない顧客を探して"

Slack — メッセージの読み書き

Slack連携により、SlackチャンネルのコンテキストをそのままClaudeに渡すことができます。チームの会話でバグレポートが上がったら、Claudeが該当スレッドの内容を読み込み、すぐにコーディング作業を開始できます。

Notion、Asana、Figmaなど

Anthropicが審査したコネクターディレクトリ（claude.ai/directory）で、Notion、Asana、Figmaなど数百種類のMCPサーバーを見つけることができます。

MCPサーバーのインストール方法

方法1: リモートHTTPサーバー（推奨）

# 基本構文
claude mcp add --transport http <名前> <URL>

# 例: Notionの接続
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 認証ヘッダーが必要な場合
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

従来のSSEトランスポート（--transport sse）はもう推奨されていません。HTTPを先に試し、ダメなら自動的にSSEにフォールバックするので（v2.1.265+）、特別な理由がなければ --transport http を使ってください。

方法2: ローカルstdioサーバー

自分のコンピュータで実行されるサーバーです。システムへの直接アクセスやカスタムスクリプトに適しています。

# 基本構文
claude mcp add [オプション] <名前> -- <コマンド> [引数...]

# 例: Airtableの接続
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

MCPサーバー管理コマンド

# 設定済みサーバー一覧の確認
claude mcp list

# 特定サーバーの詳細確認
claude mcp get github

# サーバーの削除
claude mcp remove github

# Claude Desktopアプリに設定済みのサーバーを取り込む（macOS / WSL）
claude mcp add-from-claude-desktop

# Claude Code内でステータス確認・認証・オン/オフ
/mcp

MCPサーバーを多く接続しても、ツール定義は実際に使うまでコンテキストに読み込まれません（ツール名とサーバーの説明だけが読み込まれます）。それでも gh や aws のようなCLIツールがあるなら、MCPよりコンテキストの消費が少ないので、どちらも使えるならCLIを優先してください。何がコンテキストを占めているかは /context で確認できます。

設定ファイルの場所（スコープ）

MCPサーバーの設定は、使用範囲に応じて3箇所に保存されます：

# チーム共有用のプロジェクトスコープで追加
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

# すべてのプロジェクトで使うユーザースコープで追加
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

チームプロジェクトでは、.mcp.jsonをGitにコミットすることで、チームメンバー全員が同じMCPサーバーを使用できます。

入門者におすすめのMCP 3選

実用性を基準に、最初に試してみるべきMCPサーバーです：

1. Notion MCP

claude mcp add --transport http notion https://mcp.notion.com/mcp

なくなる手間: 議事録やリサーチ結果の手動コピー、ページ内容の貼り付け、データベースの逐一更新

活用例:

• 「Notionの『議事録』DBから過去7日間の項目を取得して、決定事項・アクションアイテムだけをまとめてweekly.mdを作って」
• 「このリサーチ結果をNotionの『競合分析』ページに追加して」

2. Slack MCP

claude.aiアカウントでログインしていれば、claude.ai/customize/connectorsで接続したコネクターがClaude Codeにも自動的に表示されます（/mcp でclaude.aiの表示が付きます）

なくなる手間: チャンネルスレッドの手動閲覧、要約依頼のためのコピペ、お知らせ草案の手動作成

活用例:

• 「#マーケティングチャンネルの今日のスレッドを読んで、論点3つと合意された次のアクションを整理してSlackお知らせ草案を作って」

3. Claude in Chrome（Webリサーチ）

MCPサーバーではなくChrome拡張機能です。拡張機能をインストールした後、claude --chrome で起動するか /chrome で設定すると、Claudeが自分のブラウザ（ログイン状態のまま）でページを開き、読み、クリックします

なくなる手間: Webサイトを訪問しての手動情報収集、複数サイト比較のための繰り返しタブ切り替え、ログインが必要なページの確認

活用例:

• 「指定した5社の競合サイトを巡回して、今日の主な変更・新機能・価格変更だけを表にまとめて」

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://user:pass@localhost:5432/mydb"

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

claude.aiコネクターの自動連携

Claude.aiアカウントでClaude Codeにログインしている場合、claude.ai/customize/connectorsで接続しておいたコネクター（Notion、Slack、Google Drive、Gmailなど）がClaude Codeに自動的に接続されます。/mcp でclaude.aiの表示が付いている項目がそれで、個別にオフにしたり、設定に "disableClaudeAiConnectors": true を入れてすべてオフにしたりできます。

• APIキーでログインしている場合や、Bedrockのような外部プラットフォームを使っている場合は取り込まれません。
• 同じURLのサーバーをローカルで直接追加している場合は、ローカル設定が優先されます。

OAuth認証が必要なサーバーの接続方法

Sentry、GitHubなどのクラウドサーバーはOAuth認証が必要です：

# ステップ1: サーバーの追加
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# ステップ2: Claude Code内で認証
> /mcp

# ブラウザが開く → ログイン → 完了

認証トークンは自動的に保存・更新されます。

MCPプロンプトをコマンドとして使う

MCPサーバーがプロンプトを提供している場合、Claude Codeで/mcp__サーバー名__プロンプト名の形式で直接実行できます：

> /mcp__github__list_prs
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "ログインバグ" high

⚠️ 注意事項

信頼できないMCPサーバーを安易にインストールしないでください。

• MCPサーバーはClaudeを通じてファイルシステム、DB、外部サービスにアクセスできます
• 特に外部コンテンツを取得するMCPサーバーはプロンプトインジェクションのリスクがあります
• claude.ai/directoryにはAnthropicが審査したコネクターが集まっています。それ以外のサーバーはインストール前にソースコードと運営主体を必ず確認してください

# プロジェクトスコープ（.mcp.json）のサーバーは、初めて使うときにチームメンバー各自に承認ダイアログが表示されます
# （セキュリティレビューのための安全装置）。選択をリセットするには：
claude mcp reset-project-choices

GPTakuプラグインとMCP

皆さんがすでにインストールしたGPTakuプラグインも、内部的にMCPを活用しています：

💡 プラグインをインストールすると、MCP設定が自動的に追加されます。別途MCPを設定する必要はなく、プラグインが自動で処理します。

一言まとめ

MCP = Claudeに外部世界を接続するプラグイン。GitHub、DB、SlackをClaudeが直接操作できるようにして「コピー＆ペースト」の手間をなくす。

MCPが「外部世界との接続」だとすれば、次のHooksは「Claude Code自体の動作を自動化」するものです。

15. Hooks — 作業を守る安全装置

AIがrm -rfを実行したり、git push --forceで履歴を消してしまったら？ Hooksを設定すればそのようなことは絶対に起きません。

なぜHooksが必要なのか？

Claude Codeは強力です。ファイルを作成し、修正し、削除し、Gitコマンドを実行します。しかしバイブコーディング中に、実際にこのようなことが起こります：

• rm -rfの一撃でプロジェクトフォルダが消える
• git reset --hardでコミットしていない作業がすべて消える
• git push --forceでチームメンバーのコードが上書きされる
• DROP TABLEでデータベースが消える

Hooksはこのような危険なコマンドをClaudeが実行する前に自動的にブロックします。 LLMの「判断」に頼るのではなく、コードで100%確実に防ぎます。

Hooksとは？

Hooksは、Claude Codeの特定のイベントが発生した時に自動的に実行されるシェルコマンドです。イベントは30種類ほどありますが、入門者が知っておくべきものは以下の程度です。

重要: exit 2 = ブロック（stderrメッセージがClaudeに伝達されます）、exit 0 = 正常終了後、通常の流れで続行。exit 1 のような他のコードは「ブロック」ではなくHookのエラーとして表示されるだけで作業は続くので、止めたいなら必ず exit 2 を使ってください。

シェルコマンド（command）のほかに、Webhookに送信する http、MCPツールを呼び出す mcp_tool、モデルに判断を任せる prompt、ファイルを読んで判断する agent（実験的）のタイプがあります。

設定場所

/hooksコマンドは現在登録されているHookを見るためのメニューです（読み取り専用）。設定は以下の例をsettings.jsonにコピー＆ペーストするか、Claudeに「こういうHookを追加して」と依頼すれば（/update-config）代わりに書いてくれます。

💡 Claude Code自体にも基本的な安全装置があります。ホームフォルダやルートのような致命的なパスを削除するrm -rfはどの権限モードでも自動承認されず、Autoモードの分類器もリクエストの範囲を超える破壊的な行動を止めます。以下のSafety Hookは、その上に自分の基準（例：プロジェクト内のrmも禁止）をコードで固定するためのものです。

必須Hook 1: Safety Hook — 危険なコマンドの自動ブロック

このHook一つを設定するだけで、ほとんどの事故を防ぐことができます。

Step 1: スクリプトファイルの作成

~/.claude/hooks/block_dangerous.pyファイルを作成してください：

#!/usr/bin/env python3
"""危険なコマンドを自動ブロックするSafety Hook"""
import json, re, sys

BLOCKED_PATTERNS = [
    # ファイル削除ブロック — rmの代わりにtrashを使用（ゴミ箱に移動、復元可能）
    (r"\brm\s+", "rmの代わりにtrashを使用してください (brew install trash)"),
    (r"\bunlink\s+", "unlinkの代わりにtrashを使用してください"),

    # Git履歴破壊ブロック
    (r"git\s+reset\s+--hard", "git reset --hardはコミットしていない作業を削除します"),
    (r"git\s+push\s+.*--force", "git push --forceはリモート履歴を上書きします"),
    (r"git\s+push\s+.*-f\b", "git push -fはリモート履歴を上書きします"),
    (r"git\s+clean\s+-.*f", "git clean -fは追跡されていないファイルを永久削除します"),
    (r"git\s+checkout\s+\.\s*$", "git checkout .はすべての変更を削除します"),
    (r"git\s+stash\s+drop", "git stash dropはスタッシュを永久削除します"),
    (r"git\s+branch\s+-D", "git branch -Dはブランチを強制削除します"),

    # データベース破壊ブロック
    (r"DROP\s+(DATABASE|TABLE)", "DROPはデータを永久削除します"),
    (r"TRUNCATE\s+TABLE", "TRUNCATEはすべてのデータを削除します"),
]

data = json.load(sys.stdin)
if data.get("tool_name") != "Bash":
    sys.exit(0)

command = data.get("tool_input", {}).get("command", "")
for pattern, reason in BLOCKED_PATTERNS:
    if re.search(pattern, command, re.IGNORECASE):
        print(f"ブロック: {reason}", file=sys.stderr)
        sys.exit(2)

sys.exit(0)

Step 2: 実行権限の付与

ターミナルで実行してください：

chmod +x ~/.claude/hooks/block_dangerous.py

Step 3: Hookの登録

~/.claude/settings.jsonに追加してください：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/block_dangerous.py"
          }
        ]
      }
    ]
  }
}

動作の仕組み

Claudeがrm -rf node_modulesを実行しようとすると：

1. PreToolUseイベント発生 → block_dangerous.pyが実行
2. コマンドがrmパターンにマッチ
3. exit 2でブロック + 「rmの代わりにtrashを使用してください」というメッセージを伝達
4. Claudeがメッセージを受け取り、trash node_modulesで代替実行

trashはファイルをゴミ箱に送るので、間違えても復元できます。brew install trash（macOS）またはnpm install -g trash-cliでインストールしてください。

ブロックパターンを追加したい場合

BLOCKED_PATTERNSリストに追加したいパターンを加えるだけです：

# 例: chmod 777のブロック
(r"chmod\s+777", "chmod 777はセキュリティ上危険です"),

# 例: 本番サーバーSSHのブロック
(r"ssh\s+.*prod", "本番サーバーへのアクセスがブロックされました"),

必須Hook 2: 完了通知

Claudeが作業を終えるとサウンドで通知します。バイブコーディング中に他のウィンドウを見ていても見逃しません。

macOS — システムサウンド

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Frog.aiff"
          }
        ]
      }
    ]
  }
}

StopとNotificationに異なるサウンドを使うと、「完了」vs「確認が必要」をサウンドだけで区別できます。

利用可能なmacOSシステムサウンドの確認：

ls /System/Library/Sounds/

macOS — デスクトップ通知ポップアップ

サウンドの代わりに（または併用して）画面に通知ポップアップを表示することもできます：

{
  "type": "command",
  "command": "osascript -e 'display notification \"作業が完了しました\" with title \"Claude Code\"'"
}

Linux

{
  "type": "command",
  "command": "notify-send 'Claude Code' '作業が完了しました'"
}

2つのHookを統合して設定する

Safety Hook + 完了通知を1つのsettings.jsonにまとめるとこのようになります：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/block_dangerous.py"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Frog.aiff"
          }
        ]
      }
    ]
  }
}

すでにsettings.jsonに他の設定がある場合は、hooksキーのみ追加またはマージしてください。/hooksコマンドで確認できます。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "FILE=\"$(jq -r '.tool_input.file_path // empty')\"; if [[ \"$FILE\" == customers/* || \"$FILE\" == invoices/* ]]; then echo \"ブロック: 機密フォルダです\" >&2; exit 2; fi"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "cat ~/業務ルール.txt"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "すべてのタスクが完了したか確認してください。未完了の項目がある場合は作業を続けてください。"
          }
        ]
      }
    ]
  }
}

トラブルシューティング

デバッグ: /debug（またはclaude --debug）でデバッグログをオンにし、Ctrl+Oの詳細記録画面でHookが実行された流れを確認

Windowsでpython3コマンドがない場合はpythonに置き換え、Git for Windows（Git Bash）をインストールしておけばシェルベースのHook例がそのまま動作します。

一行まとめ

Safety Hook + 完了通知 — この2つを設定するだけでバイブコーディングがはるかに安全で快適になります。rmの一撃でプロジェクトが消える事故を未然に防ぎましょう。

次のセクションでは、繰り返し作業をSkillsで自動化する方法を学びます。

16. Skills & プラグイン作成

よく行う作業をレシピとして保存 — /コマンド一つで呼び出して、チームとも共有できます

Skillsとは？

SkillsはClaude Codeに新しい能力を追加する再利用可能なワークフローです。SKILL.mdファイルを作成すると、Claudeがそれをツールとして認識し、/スキル名コマンドで直接実行したり、状況に応じて自動的に起動します。

簡単に言うと、よく使う作業手順をドキュメント化しておけば、次からは一言で実行されます。

参考: 既存の.claude/commands/フォルダのカスタムスラッシュコマンドはSkillsに統合されました。既存ファイルはそのまま動作します。

Skills vs 通常の会話の違い

Skillsで不要になる手作業

自分のSkillsを作る方法

Step 1: ディレクトリの作成

# すべてのプロジェクトで使用する場合（個人用）
mkdir -p ~/.claude/skills/commit

# 現在のプロジェクトでのみ使用する場合
mkdir -p .claude/skills/commit

Step 2: SKILL.mdの作成

.claude/skills/commit/SKILL.md:

---
name: commit
description: 変更内容を分析して良いコミットメッセージを作成し、コミットします。コミット時に使用。
disable-model-invocation: true
---

現在のstaged変更内容を分析して、Conventional Commits形式でコミットしてください：

1. `git diff --staged`を実行して変更内容を確認
2. 変更タイプを特定（feat/fix/docs/refactor/test/chore）
3. 50文字以内のタイトルを作成
4. 必要に応じて本文に詳細説明を追加
5. `git commit -m "..."`を実行

Step 3: 実行

# 直接実行
/commit

# または自然言語で → Claudeが自動検出
"変更内容をコミットして"

Skillsファイルの構造

my-skill/
├── SKILL.md           # メインの指示内容（必須）
├── template.md        # Claudeが埋めるテンプレート（任意）
├── examples/
│   └── sample.md      # 出力例（任意）
└── scripts/
    └── validate.sh    # Claudeが実行するスクリプト（任意）

ヒント: SKILL.mdは500行以内に抑え、詳細な内容は別ファイルに分離してください。

主要なFrontmatterオプション

---
name: my-skill           # スキル名（ディレクトリ名がデフォルト）
description: 説明        # Claudeがいつこのスキルを使うか判断する基準（推奨）
when_to_use: 会議の後に整理するとき  # トリガー状況の補足説明（descriptionの後ろに付く）
argument-hint: [ファイルパス]  # 自動補完に表示する引数のヒント
arguments: [file, lang]  # 名前付き引数 → 本文で $file, $lang として使用
disable-model-invocation: true  # trueならユーザーのみ実行可能（Claude自動実行不可）
user-invocable: false    # falseならメニューに非表示（Claudeのみ自動実行可能）
allowed-tools: Read, Grep, Glob  # このスキルを実行したターンの間、確認なしで使えるツール（制限ではなく事前許可）
disallowed-tools: Write  # このスキルが有効な間、完全に外すツール
context: fork            # 独立したサブエージェントコンテキストで実行（デフォルトはバックグラウンド）
model: sonnet            # このスキルで使用するモデルを指定
effort: low              # 思考強度（low / medium / high / xhigh / max）
paths:                   # このパスのファイルを扱うときだけ自動有効化
  - "src/**/*.ts"
---

実用例 4つ

例1: 議事録の自動整理

.claude/skills/meeting/SKILL.md:

---
name: meeting
description: 会議の録音ファイルを受け取り、テキストに変換して議事録とアクションアイテムを整理します。会議後の整理に使用。
argument-hint: [録音ファイルパス]
disable-model-invocation: true
---

$ARGUMENTS ファイルを処理して議事録を作成してください：

1. 音声変換ツール（whisperなど）がなければインストール
2. $ARGUMENTS ファイルをテキストに変換
3. 以下の形式で議事録を作成：
   - 日付 / 参加者
   - 主な議論内容（3〜5行の要約）
   - 決定事項
   - 担当者別アクションアイテム（名前: タスク、期限）
4. 元のファイル名と同じ名前で.mdファイルとして保存

実行：

/meeting ~/Downloads/meeting-250225.mp3

Pythonや変換ツールを知らなくても大丈夫です。Claude Codeが必要なものを自動で準備します。

例2: SNSコンテンツの自動化

.claude/skills/sns-post/SKILL.md:

---
name: sns-post
description: 指定された内容をSNS投稿に変換します。ブログ、Instagram、LinkedInへの投稿が必要な時に使用。
argument-hint: [テーマまたは原稿内容]
---

$ARGUMENTSをSNS投稿に変換してください：

1. Instagram版（ハッシュタグ10個、絵文字入り、親しみやすい口調、300文字以内）
2. LinkedIn版（プロフェッショナルな口調、インサイト重視、500文字以内）
3. Twitter/X版（140文字以内、要点のみ簡潔に）

各バージョンを区切り線で分けて出力してください。

実行：

/sns-post 私たちのチームが新製品のリリースに成功しました。6ヶ月の開発を経て...

---
name: review
description: コードをレビューします。コード品質、セキュリティ、パフォーマンスの観点での検討が必要な時に使用。
---

以下の順序でコードをレビューしてください：

1. `git diff HEAD~1`または`$ARGUMENTS`で指定されたファイルを分析
2. 以下の項目をチェック：
   - コードの可読性と命名規則
   - エラー処理の漏れ
   - セキュリティ脆弱性（SQL injection、XSS、ハードコードされたシークレット）
   - 重複コード
   - テストカバレッジ
3. 優先度別に整理：
   - 🔴 Critical（必ず修正）
   - 🟡 Warning（修正推奨）
   - 🔵 Suggestion（検討事項）

/review src/auth/login.ts

---
name: fix-issue
description: GitHubイシューを実装します。イシュー番号を渡すと分析→実装→テスト→コミットまで進行。
disable-model-invocation: true
allowed-tools: Bash(gh *), Read, Edit, Write
---

GitHubイシュー $ARGUMENTS を処理してください：

1. `gh issue view $ARGUMENTS`でイシュー内容を確認
2. 要件を把握して実装計画を策定
3. 関連ファイルを探してコードを実装
4. テストの作成と実行
5. `gh issue close $ARGUMENTS`後にコミットを作成

/fix-issue 123

例3: 翻訳の自動化

.claude/skills/translate/SKILL.md:

---
name: translate
description: ファイルやテキストを翻訳します。
argument-hint: [ファイルパスまたはテキスト] [対象言語]
arguments: [source, lang]
---

$source を $lang に翻訳してください。

- 技術用語は原文のまま維持（コード、コマンド、固有名詞）
- マークダウン構造を保持
- 翻訳結果は元のファイル名に言語コードを追加して保存

実行：

/translate README.md ko

引数の渡し方は、$ARGUMENTS（全体）、$0/$1（または$ARGUMENTS[0]、順序別）、そして上のようにarguments:で名前を付けて$sourceのように使う、の3通りがあります。スペースを含む値は引用符で囲んでください：/translate "my notes.md" ko

動的コンテキスト注入（上級）

! + バッククォート構文で、スキル実行前にシェルコマンドを実行し、結果をコンテキストに注入できます：

---
name: pr-summary
description: PR要約を作成します。
context: fork
allowed-tools: Bash(gh *)
---

## PRコンテキスト
- 変更内容: !`gh pr diff`
- PRコメント: !`gh pr view --comments`
- 変更ファイル: !`gh pr diff --name-only`

上記の内容に基づいて明確なPR要約を作成してください。

Claudeがこのスキルを実行すると：

1. バッククォート内のコマンドが先に実行される
2. 実際のデータがプロンプトに挿入される
3. Claudeが実際のPR内容を見てサマリーを作成

コマンドが1つでも失敗すると、スキルの実行全体が中断されます。失敗しても構わないコマンドには|| trueを付けてください：!gh pr view --comments || true

Skillsの保存場所

同じ名前のスキルが複数の場所にある場合、エンタープライズ > 個人 > プロジェクトの順に優先されます。プラグインのスキルは/プラグイン名:スキル名で名前空間が分かれているため衝突しません。

セッションの途中でスキルファイルを追加・修正した場合は/reload-skillsで再読み込みし、/skillsで今使えるスキルの一覧を確認できます。スキルが増えてきたら/skill-doctorで各スキルが占めるコンテキストと実際の使用頻度を見て、使っていないものを整理してください。

スキル作成が難しい場合：スキラーズの雑談

直接SKILL.mdを書くのが難しいと感じたら、**スキラーズの雑談（skillers-suda）**プラグインが代わりに作成してくれます。

/skillers-suda 翻訳スキルを作って

4人の専門家（企画者/ユーザー/専門家/検収者）が内部で議論した後：

1. インタビュー — 3〜5個の質問で重要な情報を収集
2. ワークフロー設計 — 6種類のステップタイプ（プロンプト/スクリプト/API・MCP/RAG/レビュー/生成）を組み合わせ
3. ファイル生成 — SKILL.md + scripts/ + references/の全体構造を自動生成
4. テスト + 改善 — 作成したスキルをすぐにテストし、対話で継続的に改善

コードを知らなくても「翻訳スキルを作って」「議事録整理スキルを作って」のように言えば、プロレベルのスキルが生成されます。

スキラーズの雑談のインストール：プラグインインストールセクションのgptaku_pluginsを参照

プラグインとしてパッケージ化する

チーム全体に配布したり、コミュニティと共有するにはプラグインとしてパッケージ化します。

プラグインの構造

my-plugin/
├── .claude-plugin/
│   └── plugin.json        # プラグインメタデータ
├── skills/
│   ├── review/
│   │   └── SKILL.md
│   └── commit/
│       └── SKILL.md
└── hooks/
    └── hooks.json         # プラグイン専用Hooks

plugin.json

{
  "name": "my-plugin",
  "description": "チーム共通ワークフロー集",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

ローカルテスト

# プラグインディレクトリで実行
claude --plugin-dir ./my-plugin

# スキル実行（プラグインネームスペース付き）
/my-plugin:review
/my-plugin:commit

Standalone vs プラグインの選択基準

Skillsの自動検出の仕組み

Claudeはdescriptionフィールドを見て、どのような状況でスキルを使うべきか判断します：

# 良いdescriptionの例
description: コードをレビューします。PRレビュー、コード品質検査、セキュリティ分析が必要な時に使用。

# 不十分なdescriptionの例
description: review tool

• 「どのような状況で使うのか」を明確に記述するほど、Claudeがより正確に検出します
• disable-model-invocation: trueを設定すると、Claudeが自動的に実行しなくなります

トラブルシューティング

一行まとめ

Skills = よく行う作業を/コマンド一つにまとめるもの。チームに配布するにはプラグインとしてパッケージ化すればよい。

Skillsを作ったら、Sub-agentsでそのSkillsを複数のClaudeが同時に実行できるようになります。

17. Sub-agents & Agent Teams

Claudeが別のClaudeに作業を委任 — 複雑な作業を並列処理する方法

Sub-agentsとは？

Sub-agents（サブエージェント） は、メインのClaudeが特定の作業を専門化された別のClaudeインスタンスに委任する機能です。

簡単なたとえ: チームリーダーがプロジェクトを受け取ったら、一人で全部やるのではなくメンバーに分担します。「リサーチはAに、翻訳はBに、最終校正はCに」 — Sub-agentsはClaudeがこのように作業を分担する仕組みです。

各サブエージェントは：

• 独立したコンテキストウィンドウを持ちます（メインの会話と分離）
• カスタムシステムプロンプトで特定の役割に集中します
• 制限されたツールのみ使用します（必要なものだけ）
• 作業完了後、要約結果のみをメインに返します

概念図

メインClaude（オーケストレーター）
    │
    ├──► サブClaude A: 探索担当（Explore）
    │         └── ファイル読み込み、コード検索のみ可能
    │
    ├──► サブClaude B: 実装担当（general-purpose）
    │         └── ファイル読み込み+修正可能
    │
    └──► サブClaude C: テスト担当（custom）
              └── Bash実行のみ可能

各サブエージェントは独立コンテキストで実行
→ メインコンテキストをクリーンに保つ
→ 結果の要約のみメインに返す

いつ役立つか？

Sub-agentsを使うと良い場面

Sub-agentsより通常の会話が良い場面

組み込みサブエージェント

Claude Codeには、すぐに使えるサブエージェントが組み込まれています：

Claudeがコードを探索する必要がある時は、自動的にExploreサブエージェントを使います。探索結果（数千行のファイル内容）がメインの会話を汚染せず、要約だけがメインに返されます。

会話全体を引き継ぐフォーク（fork） サブエージェントもあります。/subtask ここまで変更したパーサーの単体テストの下書きを書いてのように使うと、ここまでの会話をそのまま知っているサブエージェントがバックグラウンドで脇の作業を処理し、結果だけを返してくれます。

独自のサブエージェントを作る

方法1: Claudeに作ってもらう（推奨）

"リサーチ専用のサブエージェントを作って。
 sources/ フォルダを読んで5行の要約と次の質問5つを整理する役割で、
 読み込み専用ツールだけ使えるようにして。このプロジェクトにだけ適用されるよう .claude/agents/ に保存して"

Claudeが以下の形式に合ったファイルを代わりに書いてくれます。（以前の/agentsインタラクティブメニューはv2.1.198でなくなり、今/agentsを入力するとこのように依頼するよう案内が出るだけです。）

方法2: ファイルの直接作成

以下の例を.claude/agents/フォルダに保存すれば、すぐに使用できます。

リサーチ要約エージェント（.claude/agents/researcher.md）：

---
name: researcher
description: 資料フォルダを読み、要点の要約・インサイト・次の質問を整理します。リサーチが必要な時に自動で使用。
tools: Read, Grep, Glob
model: sonnet
---

あなたはリサーチアシスタントです。
- 結論を先に5行で要約
- 根拠となる文章・出典ファイル名を併記
- 「推測/仮定」は明確にラベリング
- 最後に次の調査質問5つを提案

翻訳エージェント（.claude/agents/translator.md）：

---
name: translator
description: ファイル/文章を指定言語に翻訳し、マークダウン構造を維持します。
tools: Read, Write
model: sonnet
---

翻訳ルール：
- 固有名詞/製品名/コード/コマンドは原文のまま維持
- 文章のトーンは「丁寧だが大げさにしない」
- 表/目次/リンク構造は維持

最終チェック（QA）エージェント（.claude/agents/editor-qa.md）：

---
name: editor-qa
description: 最終ドキュメントの誤字脱字・表記統一・禁止語・リンク漏れを点検します。
tools: Read, Grep, Glob
model: haiku
---

点検チェックリスト：
- 日付/数値表記の統一（例: 2026-02-26）
- 禁止語（完璧/革命/絶対）の検出
- リンク（https://）の漏れ・破損が疑われる箇所の指摘
- 「次のアクション」が抜けている場合は追加提案

---
name: code-reviewer
description: コードをレビューします。コード変更後の品質、セキュリティ、パフォーマンスの検討に自動で使用。
tools: Read, Grep, Glob, Bash
model: sonnet
---

あなたはシニアコードレビュアーです。

実行時：
1. `git diff`で最近の変更内容を確認
2. 修正されたファイルに集中

レビューチェックリスト：
- コードの可読性と命名規則
- エラー処理の適切さ
- セキュリティ脆弱性（露出したシークレット、入力バリデーション）
- テストカバレッジ

フィードバック形式：
- 🔴 Critical（必ず修正）
- 🟡 Warning（修正推奨）
- 🔵 Suggestion（検討事項）

サブエージェントの設定オプション

---
name: my-agent           # 小文字 + ハイフン（必須）
description: 説明        # Claudeがいつ委任するか判断する基準（必須）
tools: Read, Grep, Glob  # 許可ツール一覧（省略時はすべてのツールを継承）
disallowedTools: Write   # 除外するツール
model: haiku             # haiku / sonnet / opus / fable / inherit（デフォルト）
effort: low              # 思考強度: low / medium / high / xhigh / max
permissionMode: default  # default / acceptEdits / auto / dontAsk / bypassPermissions / plan
maxTurns: 20             # 最大実行ターン数
memory: user             # 永続メモリ: user / project / local
background: false        # trueなら常にバックグラウンド実行
isolation: worktree      # worktreeなら隔離されたGitワークツリーで実行
skills:                  # 起動時にあらかじめ読み込んでおくスキル
  - api-conventions
---

サブエージェントの保存場所

実用例

例1: 並列リサーチ（競合の同時分析）

"競合A、B、Cをそれぞれ別のエージェントで同時に分析して。
 各エージェントはWebサイト、価格、レビューを調査して
 結果を一つの比較表に統合して"

→ 3つのリサーチエージェントが同時に作動 → 結果を1つの比較表に統合 → 順番に処理した場合と比べて3倍速

例2: ドキュメントの一括処理（PDF20個の並列要約）

"Downloadsフォルダの20個のPDFを5個ずつ分けて
 4つのエージェントが同時に要約し
 結果を1つのレポートにまとめて"

→ 4つの要約エージェントが並列実行、処理速度4倍 → 膨大な要約ログがメインの会話を汚染しない

例3: 役割分担 — リサーチ → 編集の連鎖

"researcherエージェントでsources/フォルダを読んで1ページの要約を作って"
"editor-qaエージェントでfinal/フォルダのドキュメント品質を点検し、修正が必要な項目だけリストアップして"
"translatorエージェントでdrafts/post.mdを英語に翻訳してdrafts/post.en.mdとして保存して"

→ 各担当エージェントが順番に作業 → メインのClaudeは流れの調整のみ

"認証、DB、APIモジュールをそれぞれ別のサブエージェントで並列分析して"

"code-reviewerエージェントでパフォーマンス問題を見つけ、optimizerエージェントで修正して"

"サブエージェントで全テストを実行して、失敗したものだけ報告して"

永続メモリ機能

サブエージェントにmemoryフィールドを設定すると、セッションをまたいでも学習内容が維持されます：

---
name: code-reviewer
description: コードをレビューします
memory: user
---

コードをレビューしながら発見したコードベースのパターン、アーキテクチャ決定、繰り返し発生するイシューを
メモリに記録してください。次のレビュー時に以前の学習内容を活用してください。

フォアグラウンド vs バックグラウンド実行

• フォアグラウンド: 完了まで待機。権限リクエストがユーザーに伝達される
• バックグラウンド: バックグラウンドで同時実行。引き続き他の作業が可能。権限リクエストはメインセッションにサブエージェント名と一緒に表示される

ターミナルの対話型セッションでは、サブエージェントはデフォルトでバックグラウンドで実行されます。プロンプトの下のパネルに実行中のサブエージェントが表示され、結果は完了するとメッセージとして届きます。

# 実行中のコマンド・エージェントをバックグラウンドに切り替え
Ctrl+B

# バックグラウンドのサブエージェントをすべて停止（3秒以内に2回）
Ctrl+X の次に Ctrl+K

# 実行中・完了済みのバックグラウンド作業を見る
/tasks

バックグラウンドのサブエージェントもMCPツールをそのまま使えます。（以前のドキュメントにあった「バックグラウンドではMCP使用不可」という説明はもう正しくありません。）

Agent Teamsとは？

Agent Teamsはサブエージェントの一歩先を行く概念です。複数のエージェントがそれぞれ完全に独立したセッションで実行され、協力します。

サブエージェントではコンテキストウィンドウが足りない場合や、作業が複数セッションにわたって持続する必要がある場合にAgent Teamsを検討します。

⚠️ Agent Teamsは実験的機能で、デフォルトでは無効です。 使うには~/.claude/settings.jsonに以下を追加してください：

{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

設定しない場合、チームは構成されず、Claudeがチームメイトを生成したり提案したりすることもありません。セッション再開（/resume・/rewind）でチームメイトが復元されないなどの既知の制約もあります。

チームメイトはデフォルトで現在のターミナルの中で実行されます（in-process）。プロンプトの下のパネルで↑/↓でチームメイトを選びEnterを押すと、そのチームメイトの会話を見ながら直接指示できます。tmuxやiTerm2を使えば、チームメイトごとに分割ペインで見ることもできます。インストール済みのエージェント・チームメイトの一覧は/list-agentsで確認します。

プラグインで簡単に始める：キリキリ

Agent Teamsを直接設定するのが難しければ、キリキリ（kkirikkiri） プラグインが代わりにやってくれます。

/kkirikkiri リサーチチームを作って

自然言語の一言で：

1. 意図の把握 — リサーチ/開発/分析/コンテンツの中からマッチング
2. インタビュー — 2〜3個の質問で詳細な要件を収集
3. 環境スキャン — インストール済みCLI（Codex、Geminiなど）を自動検出
4. チーム構成の提案 — 役割別エージェント + 予想コスト/時間を案内
5. 実行 — Agent Teamsを自動生成・実行
6. 品質検証 — 結果を自動判定、不足があればリトライ

リーダーは常に最も賢いモデル（Opus）が担当し、コードは書かず計画・分配・検証のみ行います。

キリキリのインストール：プラグインインストールセクションのgptaku_pluginsを参照

⚠️ コストに注意

サブエージェントはそれぞれ独立したClaudeインスタンスです。エージェントごとにトークンを消費します。

• サブエージェント3つの並列実行 = トークン使用量が大幅に増加
• 結果がメインコンテキストに返る際に追加トークンを消費
• 不必要なサブエージェントの乱用はコスト増加につながる

コスト削減のヒント：

• 読み込み専用の探索や単純な作業にはHaiku 5.5のサブエージェントを使用（model: haiku、必要ならeffort: low）
• サブエージェントが返す結果の量を明確に指定
• 単純な作業はメインの会話で処理

初心者へのアドバイス

最初は単一のClaudeで十分です。

サブエージェントは以下の状況が発生した時に導入してください：

1. メインコンテキストが頻繁にあふれて圧縮が繰り返される時
2. 同じ探索作業を何度も繰り返す時
3. 特定のツールだけを使う安全なレビュアーが必要な時

一言まとめ

Sub-agents = Claudeが別のClaudeに作業を委任。独立コンテキストで実行されるため、メインの会話をクリーンに保ちながら並列処理が可能。ただし、トークンコストはエージェント数に比例して増加。

18. 自分だけのAIワークスペースを設計する

CLAUDE.md、Skills、Hooksを学んだら、次は組み合わせる番です。単なるAIツールではなく、自分のための自動化オフィスを作る方法。

ワークスペースとは？

一般的なAIの使い方：「質問 → 回答」（毎回ゼロから）

ワークスペース：役割が決められたAIが、自分だけのルールで、一貫した方式で動作するシステム

構成要素：

CLAUDE.md     → AIの役割、ルール、知識（長期記憶）
フォルダ構造   → 成果物が体系的に蓄積される構造
Skills        → 繰り返し作業の自動化（/コマンド）
Hooks         → 品質保証のための自動検証

基本の設計思想

「すべてのルールをCLAUDE.mdに入れないでください。Skillsで分散し、Hooksで強制してください。」

• CLAUDE.md：変わらない役割と原則
• Skills：繰り返される作業フロー
• Hooks：見落としてはいけない品質基準

用途別ワークスペースの例

リサーチワークスペース

CLAUDE.md の要点:
  - 出典のない主張は禁止
  - すべての情報に出典グレードを表記（A〜E）
  - リサーチ結果は/reportsフォルダに自動保存

フォルダ構造:
  inbox/      → 参考資料の保管
  reports/    → 完成したリサーチ
  sources/    → 出典一覧

Skills:
  /research [テーマ]  → ウェブ検索 → 整理 → 保存
  /summary [ファイル]   → ドキュメント要約

コンテンツ制作ワークスペース

CLAUDE.md の要点:
  - ブランドトーンの定義（例：親しみやすく実用的、専門用語は最小限）
  - ターゲット読者の定義
  - コンテンツ形式テンプレート

フォルダ構造:
  drafts/     → 草案
  published/  → 公開済み
  templates/  → 再利用形式

Skills:
  /blog [テーマ]       → ブログ記事の草案
  /newsletter [内容] → ニュースレター形式に変換
  /sns [内容]        → Instagram・X（Twitter）版

💡 リサーチワークスペースを構成する際、insane-researchプラグインを活用すれば、別途Skillsを作成せずにすぐにマルチエージェントリサーチが可能です。コンテンツ作業にはdocs-guideで公式ドキュメントベースの正確な資料を確保できます。

ビジネスワークフロー

CLAUDE.md の要点:
  - 会社/チーム情報、主要プロジェクトの現状
  - メールスタイル（フォーマル/カジュアルの度合い）
  - レポート形式テンプレート

Skills:
  /meeting [録音]    → 要約 + 決定事項 + アクションアイテム
  /report [テーマ]     → 週次レポート草案
  /email [状況]      → メール草案

実際の事例公開：アイディエーションワークスペース

CC101（このサイト）が生まれたワークスペースを公開します。

CLAUDE.md の要点

# アイディエーションワークスペース

## 役割
アイデアの発掘、検証、実行をサポートするAIパートナー

## 基本原則
- 日本語専用
- リサーチなしの主張は禁止（ハルシネーション防止）
- すべての出典にグレード表記（A〜E）
- 検証なしに「うまくいきそう」という発言は禁止
- アイデアは必ずドキュメント化（揮発防止）

## 検証方式
4つのペルソナCouncil:
- Visionary: 潜在力・ビジョン
- Pragmatist: 実現可能性・リソース
- Critic: リスク・弱点
- User Advocate: ユーザー価値

## フォルダ構造
10-inbox/      → 参考資料
20-sparks/     → アイデアの捕捉
30-research/   → リサーチ結果
40-foundry/    → 検証結果
50-blueprints/ → MVP設計
60-ventures/   → 実行中
70-playbook/   → 経験の蓄積
90-shelf/      → 保留アイデア

使用中のSkills

/spark [アイデア]   → アイデアの捕捉 + ICEスコア評価
/research [テーマ]    → 7段階ディープリサーチ
/validate           → 4ペルソナCouncil検証
/insight [内容]     → 教訓Playbook保存

このワークスペースで生まれたもの

• CC101のアイデア捕捉と検証
• 3つのAIセクション構成ディスカッション（agent-council）
• 公式ドキュメント57件のリサーチ
• Next.jsサイトの開発とデプロイ
• その後の対話を通じた継続的な改善

自分だけのワークスペースを作る -- 4ステップ

ステップ1：目的を定義する

自問してください：
□ どんな作業を繰り返しているか？
□ AIにどんな役割を任せたいか？
□ どんなルールを一貫して守ってほしいか？
□ 成果物がどこに蓄積されるのが良いか？

ステップ2：CLAUDE.mdを作成する

最小構成テンプレート（コピーして始めてください）。長くなったらテーマ別に.claude/rules/ファイルに分け、繰り返しの手順はSkillsに移してください。作業中に分かった好みはClaudeが自動メモリに自分で書き留めておくので、すべてをCLAUDE.mdに書き切る必要はありません。

# [ワークスペース名]

## 役割
[AIに与える役割と目的 -- 1-2文]

## 基本ルール
- [絶対に守ること 1]
- [絶対に守ること 2]
- [絶対にやってはいけないこと]

## フォルダ構造
- [フォルダ名]/  → [用途]
- [フォルダ名]/  → [用途]

## 主な作業方式
[繰り返されるワークフローの説明]

ステップ3：フォルダ構造を設定する

番号プレフィックスを使うと順序が維持されます：

mkdir -p 01-inbox 02-work 03-output 04-archive

ステップ4：繰り返し作業 → Skills化

同じ作業を3回以上するようになったらSkillにしましょう。 → Skillsの作成方法は16セクションで解説しています

MCPとの組み合わせ

ワークスペースにMCPを接続すると、さらに強力になります：

→ MCP接続は14セクションで解説しています

ワークスペースは一度で完成するものではありません。使いながら不便な点が出てきたらCLAUDE.mdを修正し、繰り返し作業が見つかったらSkillを追加してください。時間が経つほど、自分に合った形に進化していきます。

19. コスト管理 & 節約のヒント

Claude Codeをよりスマートに、より安く使う方法を学びます。

コスト構造の概要

Claude Codeの料金体系は大きく2種類あります。

Claude.ai Pro/Maxサブスクリプション利用者は、サブスクリプション料金にClaude Codeの利用が含まれているため、API費用は別途請求されません。/usage（/costはエイリアス）が表示するドル金額はAPIユーザー向けのものなので、サブスクリプション利用者は参考程度にご覧ください。同じ画面でプラン使用量のバーを確認できます。

APIユーザーは使用量に応じて料金が発生します。公式ドキュメント（2026年10月時点）によると、平均して開発者1人あたり利用日1日約$13、月$150〜$250で、90%のユーザーは1日$30以下です。

サブスクリプション利用者も、プランの上限を使い切ったら追加使用量（usage credits） をオンにして従量制で使い続けることができます。/usage-creditsで設定ページが開き、月の支出上限を決めておくことができます。

トークンとは？

**トークン(token)**はClaudeがテキストを処理する単位です。

• 英語の場合：約1単語 = 1〜2トークン
• 日本語の場合：約1〜2文字 = 1トークン
• 大まかに：英語4文字 ≈ 1トークン

簡単に言えば、Claudeにファイルを読ませたり、質問したり、回答を受け取るたびにトークンが消費されます。コンテキスト（会話の文脈）が長くなるほど、より多くのトークンが使用されます。

コストが高くなる状況

1. 長いファイルを繰り返し読む場合

Claudeが同じファイルを何度も読むと、そのたびにトークンが消費されます。10,000行のログファイルをまるごと読ませると、1回で数万トークンが使用されます。

2. コンテキストを長時間維持する場合

会話が長くなるほど、以前の内容をすべてコンテキストに含める必要があります。関連のない作業を同じセッションで続けると、不要な情報が蓄積されコストが増加します。

3. 高性能モデル・高い思考強度を使用する場合

OpusモデルはSonnetより強力ですが、トークンあたりのコストも高くなります。簡単な作業にOpusを使うのは非効率的です。思考強度（/effort）をxhighやmaxに上げると、考えるためのトークン（出力トークンとして課金）もその分増えます。

4. 自動化（CI/CD）で無制限に実行する場合

GitHub Actionsなどで自動化すると、人の介入なしに大量のトークンが消費される可能性があります。

節約のヒント5選

ヒント1：/compactでコンテキストを整理する

会話が長くなったとき、/compactコマンドを実行すると、以前の内容を要約してコンテキストサイズを削減してくれます。

/compact コード変更とテスト結果を中心に要約して

これにより重要な情報は維持しながら、不要な会話内容が圧縮されます。

CLAUDE.mdに圧縮方法をあらかじめ指定することもできます：

# Compact instructions

When you are using compact, please focus on test output and code changes

ヒント：/clearを使うとコンテキストを完全にリセットできます。まったく別の作業を始めるときに便利です。

ヒント2：不要なファイル参照を避ける

曖昧なリクエストは、Claudeに不必要に多くのファイルを読ませてしまいます。

具体的なリクエストほど、Claudeが必要なファイルだけを読むためトークン消費が減ります。

ヒント3：Haikuモデルを活用する

すべての作業に高性能モデルを使う必要はありません。

モデルの切り替えはセッション中でも可能です：

/model haiku

または起動時に指定：

claude --model haiku

opusplanモード：計画段階ではOpus、実行段階ではSonnetに自動で切り替わるハイブリッドモードです。

/model opusplan

思考強度を下げる：モデルを変えなくても、/effort lowまたは/effort mediumで考える量を減らせます。Opus 5.5 / Sonnet 5.5 / Haiku 5.5のデフォルトはmediumで、単純な繰り返し作業ならlowでも十分な場合が多いです。（これらのモデルは拡張思考を完全にオフにすることはできず、強度だけを調節します。）

ヒント4：Fast Modeを理解して活用する

/fastコマンドでFast Modeをオンにすると、Opusが最大2.5倍速く応答します。現在はOpus 5.5、Opus 5、Opus 4.8で利用できます（Claude Code v2.1.280以降はOpus 5.5がデフォルト）。Sonnet、Haikuでは使えません。

/fast

ただし、Fast Modeはトークンあたりのコストが高くなります（Opus 5.5の場合、入力$8 / 出力$40 per MTok＝通常のOpus 5.5の2倍）。速度が重要な場面（素早い反復作業、リアルタイムデバッグ）でのみ使用し、長時間の自律作業ではオフにするのがおすすめです。オンになっているとプロンプトの横に↯アイコンが表示され、/fastをもう一度入力すると、現在のオン/オフ状態を確認できます。会話の途中でオンにすると、その時点までのコンテキスト全体をFast Mode料金で一度読み直すため、使うならセッション開始時にオンにする方が安く済みます。

注意：Fast Modeはサブスクリプションプランの基本使用量には含まれず、追加使用量（usage credits） から差し引かれます。追加使用量をオンにしていない状態では、/fastが「Fast mode requires usage credits」と案内します。まだ研究プレビュー段階のため、価格や条件が変わる可能性があります。

ヒント5：/usageで定期的に確認する

現在のセッションのトークン使用量を確認できます（/costは同じコマンドのエイリアス）：

/usage

出力例：

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

サブスクリプション利用者は同じ画面でプラン使用量のバーと使用先の分析（スキル・サブエージェント・プラグイン・MCPサーバー別の割合、長いコンテキストやキャッシュミスのような使用量を増やす習慣）を確認できます。/statsは同じ画面の統計タブを直接開きます。

ステータスバー（status line）を設定すると、コンテキスト使用量をリアルタイムで確認することもできます（/statusline）。トークン数ではなく「どう使っているか」が知りたいときは、/insightsで最近のセッションの分析レポートを作成できます。

長いセッションは静かに高くつきます。 1行の質問でも、リクエストのたびに会話全体を送り直すからです。1時間以上休んでから戻るとキャッシュが期限切れになり、コンテキスト全体を再処理するため、Pro/Maxでは大きなセッションを再開するときに「要約から再開するか」を尋ねるダイアログが表示されます。作業が終わったなら/clear、続けるなら/compactが正解です。

ヒント6：CLAUDE.mdをダイエットする

CLAUDE.mdはClaudeが毎回の応答ごとに読むファイルです。長ければ長いほど、毎回より多くのトークンを消費します。

実際の効果：過度に記述されたCLAUDE.md（約19,000トークン）を要点だけ残したバージョン（約9,000トークン）に整理すると、同じ作業にかかるコストがほぼ半分に減ります。

ダイエットの基準

削除してよいもの：
- 長い背景説明（「このプロジェクトは2023年から...」）
- 繰り返される当たり前の内容（「常にベストを尽くしてください」）
- 複数のサンプルコードブロック（1つだけ残すか削除）
- 曖昧なルール（「良いコードを書いてください」）

必ず残すもの：
- 禁止事項（絶対にやってはいけないこと）
- プロジェクトの技術スタック（1〜3行の要約）
- よく参照するファイルパス
- 言語/フォーマットのルール（具体的なもののみ）

ほとんどのCLAUDE.mdは整理すると50%以上削減できます。

ヒント7：権限のdenyルールで不要なファイルを除外する

node_modules、ビルド成果物、.envなどをClaudeが読まないようにすると、誤って大容量ファイルや秘密情報を読み込むのを防げます。

⚠️ .claudeignoreファイルはClaude Codeに読み込まれません。 ネット上で広まっている方法ですが、実際には効果がありません。代わりにプロジェクトの.claude/settings.jsonに権限のdenyルールを書いてください。

// .claude/settings.json
{
  "permissions": {
    "deny": [
      "Read(node_modules/**)",
      "Read(dist/**)",
      "Read(build/**)",
      "Read(coverage/**)",
      "Read(**/*.log)",
      "Read(.env)",
      "Read(.env.*)"
    ]
  }
}

ReadのdenyルールはEditツールや、Claude Codeが認識するcat・headなどのBashファイルコマンドにも適用されます。ただしPythonやNodeのスクリプトが直接ファイルを開く場合までは防げないため、OSレベルの遮断が必要ならサンドボックスを使ってください。

特に効果的な場面

• モノレポのようにファイル数が多いプロジェクト
• 「このプロジェクト全体を分析して」というリクエストを頻繁に行う場合
• GitHub Actionsなどで Claudeを繰り返し実行する場合

モデル別コスト比較（概要）

（2026年10月時点のAPI定価、100万トークンあたり 入力 / 出力）

前世代（Opus 5 $5/$25、Sonnet 5 $2/$10、Haiku 4.5 $1/$5、200K）も引き続き使えますが、エイリアス（opus、sonnet、haiku）はすべて5.5世代を指します。 最新の正確な価格はAnthropic料金ページとAPI料金ドキュメントをご参照ください。

Claude.ai Maxプランのメリット

Claude.ai ProまたはMaxサブスクリプション利用者は、API従量制の費用なしでClaude Codeを使用できます。

• 月額料金にClaude Codeの使用が含まれる
• 追加のAPIキーが不要
• コストを気にせず様々な実験が可能
• Maxプランの場合、より高い使用量上限

ただし、Fast Modeはサブスクリプションの上限とは別に追加使用量（usage credits）から差し引かれます。 プランの上限（5時間単位・週単位でリセット）を超えたら、リセットを待つか、/usage-creditsで追加使用量をオンにして使い続けることができます。

チームのコスト管理

APIをチーム単位で使用する場合：

• Workspaceの支出上限を設定：Anthropic Consoleでチーム全体の支出上限を設定できます。
• 使用量ダッシュボード：Consoleでメンバーごとのコストと使用量を確認できます。
• エージェントチームに注意：Agent Teams（複数のClaudeインスタンスを同時実行）機能は、標準セッションの約7倍のトークンを消費します。現在は実験的機能でデフォルトは無効であり、settings.jsonにCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1を設定すると有効になります。

まとめ：コスト節約チェックリスト

✅ 作業が終わったら/clearでコンテキストをリセット
✅ 関連のない作業は新しいセッションで開始
✅ 具体的なファイル名と関数名を明示
✅ 簡単な作業にはHaikuモデルを使用、または /effort low・medium で思考強度を下げる
✅ Fast Modeは必要なときだけオンにする（追加使用量から差し引き）
✅ /usage（= /cost）で定期的に確認
✅ CLAUDE.mdにcompact指示を設定
✅ CLAUDE.mdは重要なルールだけ残して定期的にダイエット
✅ permissions.denyのReadルールでnode_modules、ビルド成果物、.envを除外

20. Headlessモード & GitHub Actions自動化

Claude Codeを人の手を介さず自動で実行する方法を学びます。

📌 このセクションは2つのパートに分かれています

• Headlessモード（基本的な使い方）：非開発者でも活用できる自動化 -- ニュース要約、週次レポート、ファイル一括処理など
• GitHub Actions連携（開発者向け応用）：ソフトウェア開発チーム向けCI/CD自動化

Headlessモードとは？

通常、Claude Codeはターミナルで対話的に使用します。ユーザーが直接質問し、Claudeが回答し、またユーザーがフィードバックを返す方式です。

Headlessモードは、人の手を介さずにClaude Codeを自動で実行する方式です。スクリプトやCI/CDパイプラインからClaude Codeをプログラムのように呼び出せます。

Headless = 人の手を介さず自動実行

以前は「headless mode」と呼ばれていましたが、公式ドキュメントではAgent SDKをCLIで使う方式（非対話型モード）と説明されています。-pフラグとすべてのCLIオプションは同様に動作します。

いつ使うのか？

基本的な使い方

-p（または--print）フラグを付けると、非対話型（non-interactive）モードで実行されます。

最もシンプルな形

claude -p "このプロジェクトが何をしているか説明して"

ツール権限を許可する

Claudeがファイルを読み書きできるようにツールを許可します：

claude -p "~/DownloadsのPDFをすべて読んで要約集.mdにまとめて" --allowedTools "Read,Write,Bash"

ツールを一つずつ列挙する代わりに、権限モードで基準線を決めることもできます：

# 分類器が検討しながら進行（対話型セッションと同じAutoモード）
claude -p "依存関係のバージョンを上げてテストを実行して" --permission-mode auto

# 確認が必要な行動はすべて拒否（ロックされたCI環境用）
claude -p "..." --permission-mode dontAsk

# 誰も確認ダイアログに答えられない無人実行：確認が必要になる行動は拒否して続行
claude -p "..." --permission-mode auto --permission-prompts none

スクリプト・CIでは--bare

--bareを付けると、フック、プラグイン、MCPサーバー、自動メモリ、CLAUDE.mdの自動探索をすべてスキップするので起動が速く、どのコンピュータで実行しても同じ結果になります。公式ドキュメントがスクリプトとCIに推奨している方式で、今後-pのデフォルトになる予定です。サブスクリプションのログインは読まないため、ANTHROPIC_API_KEYが必要です。

claude --bare -p "README.mdを要約して" --allowedTools "Read"

JSON出力を受け取る

スクリプトで結果をパースしやすいようにJSON形式で出力できます：

claude -p "このプロジェクトを要約して" --output-format json

出力形式オプション：

• text（デフォルト）：プレーンテキスト
• json：JSON構造体で結果を返す（セッションID、メタデータ含む）
• stream-json：リアルタイムストリーミングJSON

実用的な例：非開発者向け自動化3選

デイリーニュース・業界動向の要約：

claude -p "inputs/links.txtを読んで今日の業界ニュース要約をdaily/brief_今日の日付.mdに保存して" \
  --allowedTools "Read,Write"

週次アクションアイテムの集約：

claude -p "meetings/フォルダの過去7日分の議事録を読んで未完了のアクションアイテムだけ表にまとめてweekly/this-week.mdに保存して" \
  --allowedTools "Read,Write"

コンテンツカレンダー草案の作成：

claude -p "ideas/フォルダを読んで来週の平日5日分のコンテンツカレンダーを作成してdrafts/next-week.mdに保存して" \
  --allowedTools "Read,Write"

claude -p "ステージングされた変更をレビューして適切なコミットメッセージでコミットして" \
  --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

会話を継続する

# 最初のリクエスト
claude -p "このフォルダのドキュメントを分析して"

# 前の会話を引き継いで
claude -p "その中から重要な結論部分だけまとめて" --continue

/install-github-app

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # サブスクリプショントークンを使うなら上の行の代わりに：
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          # promptを指定しなければ@claudeメンションに自動で応答

@claude このPRのセキュリティ脆弱性をレビューして
@claude この関数にエッジケースがないか確認して
@claude このIssueに基づいて機能を実装して

name: コードレビュー
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

name: デイリーレポート
on:
  schedule:
    - cron: "0 9 * * *"  # 毎日午前9時

jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "昨日のコミットとオープンIssueを要約して"
          claude_args: |
            --model claude-sonnet-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}  # 必須
    prompt: "タスクの指示内容"        # オプション（なければ@claudeメンションに反応）
    claude_args: "--max-turns 10"  # オプション（追加CLI引数）

stages:
  - ai

claude:
  stage: ai
  image: node:24-alpine3.21
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
  before_script:
    - apk add --no-cache git curl bash
    - curl -fsSL https://claude.ai/install.sh | bash
  script:
    - claude -p "${AI_FLOW_INPUT:-'変更をレビューして改善点を提案して'}"
      --permission-mode acceptEdits
      --allowedTools "Bash Read Edit Write"

⚠️ コストに関する注意事項

自動化はトークン消費が非常に大きくなります。

• CI/CDパイプラインは人の監視なしに実行されるため、コストが予想以上に早く膨らむ可能性があります。
• --max-turnsオプションで最大繰り返し回数を、--max-budget-usdで1回の実行のドル上限を制限してください。
• ワークフローにタイムアウトを設定し、同時実行（concurrency）を制限してください。
• 不要なトリガーを減らしてください。

claude_args: "--max-turns 5 --model claude-sonnet-5-5"

API費用に加えて、GitHub Actionsの実行時間コストも発生します（GitHub Actionsの無料枠を超過した場合）。

セキュリティに関する注意事項

• **APIキーをコードに直接記述しないでください。**必ずGitHub Secretsを使用してください。

# 正しい方法
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

# 絶対にやってはいけないこと
anthropic_api_key: "sk-ant-api03-..."

• Claudeの提案をマージする前に必ずレビューしてください。
• Actionの権限は必要なものだけ許可してください。

入門者の方へ

この機能は今すぐ必要ではありません。

HeadlessモードとGitHub Actions連携は、Claude Codeをある程度使いこなしてから導入するのがおすすめです。基本的な使い方、CLAUDE.mdの設定、そしてMCP連携をまず身につけてから自動化を検討してください。

今は「こういうこともできるんだ」と知っておくだけで十分です。

まとめ

Headlessモード: claude -p "タスク内容" --output-format json
スクリプト/CI:   --bare で環境の影響を排除、--permission-prompts none で無人実行
GitHub Actions: anthropics/claude-code-action@v1（APIキーまたはサブスクリプショントークン）
トリガー: @claudeメンションまたは自動プロンプト
コスト制御: --max-turns、--max-budget-usd、タイムアウト、モデル選択
セキュリティ: キー・トークンは必ずSecretsを使用

ターミナルの中で簡単に繰り返すだけでよければ、/loop 30m 新しいIssueがないか確認して要約してのように**/loop** で同じプロンプトを定期的に実行でき、コンピュータを閉じていても動かす必要があるなら/scheduleでクラウドルーチンを作成できます。

21. 次のステップ & リソース

CC101を完了したあなたへ。ここからが本当のスタートです。

ここまでお疲れ様でした

Claude Codeの基礎から高度な自動化まで、全過程を走破しました。簡単な道のりではなかったと思いますが、これでAIベースの自動化ツールを実際の業務に活用できる基盤が整いました。

少し振り返ると、以下のことを学びました：

• Claude Codeとは何か、どのように動作するか
• インストールと認証の設定
• CLAUDE.mdによるプロジェクトのカスタマイズ
• 基本コマンドとワークフロー
• MCPによる外部ツールの接続
• HooksとSkillsによる自動化
• プラグインエコシステムの探索
• コスト管理と最適化
• Headlessモードと CI/CD連携

この知識は単にツール1つを学んだということではありません。AIと協業する新しいワークスタイルを身につけたのです。

次の学習パス

入門完了（今ここ）

✅ Claude Codeのインストール & 認証
✅ CLAUDE.mdの作成
✅ 基本コマンド（/help, /usage, /compact, /model）
✅ ファイルの読み込み、内容の修正、ドキュメント生成
✅ プラグインの基本的な使用

中級：実践応用

CC101で学んだ基礎を組み合わせて、実際の業務に適用します。

自分だけのワークフロー自動化

• CLAUDE.md + Hooks + Skillsを組み合わせて繰り返し作業をワンコマンドに短縮
• 例：毎週のレポート自動生成、コードレビュー自動化、議事録整理パイプライン

プラグインの活用を最大化

• show-me-the-prdで企画 → チーム構成プラグインでリサーチチーム編成 → Claude Codeで実装 -- アイデアからプロトタイプまで1日で
• insane-researchで市場調査後、docs-guideで技術検証 -- 意思決定にAIを活用
• メンタリングプラグインのフィードバックを反映してプロンプト品質を段階的に改善

マルチセッション & 並列作業

• 複数のターミナルでClaude Codeを同時実行してタスクを分担
• タスク分担プラグインで並列開発を体験

上級：CC101の先の世界

このガイドでは扱わなかった発展的なトピックです。

Agent SDKで自分だけのAIアプリを作る

• AnthropicのClaude Agent SDKを使えば、Claudeをエンジンとした独立したAIアプリケーションを開発できます
• Python/TypeScriptでカスタムエージェントを構築 -- Claude Codeなしでも動作する自動化システム

Model Context Protocol (MCP) サーバーを自分で作る

• CC101ではMCPサーバーを「使う」方法を学びましたが、MCPサーバーを自分で「作る」こともできます
• 社内API、社内DB、社内Wikiを MCPサーバーでラップすれば、Claude Codeから直接アクセス可能に
• MCP公式仕様

Claude Codeプラグイン開発

• 自分だけのプラグインを作ってコミュニティに共有
• Skills、Hooks、Agents、MCPサーバーを1つのパッケージにまとめる構成

チーム単位での導入 & ガバナンス

• チーム全体がClaude Codeを使用する際の権限管理、コスト配分、セキュリティポリシー
• Enterpriseプランの管理者機能（Admin Controls、Audit Logs）
• 社内コーディング標準をCLAUDE.mdで強制する方法

プロダクション自動化パイプライン

• GitHub Actions + Headless Claude CodeでPR自動レビュー、自動テスト生成
• 夜間バッチ処理：毎日深夜にデータ処理、レポート生成、コード品質検査
• モニタリング + アラート連携（Slack、Discord）

公式リソース

公式ドキュメント

Claude Codeの中でも学べます。/powerupはアニメーションデモ付きの短い講座を、/release-notesはバージョンごとの新機能を表示します。分からないことがあれば/btw この機能は何？のように、会話に痕跡を残さずに質問することもできます。

CC101 & gptaku_pluginsコミュニティ

このガイドが役に立ったらStarを押してください！更新と改善の大きな励みになります。

Claude Codeをうまく使う方法 & 避けるべきパターン

ツールを学んだら、次はいつ、どう使うかが重要です。

相性の良い作業（どんどん活用しましょう）

注意が必要な作業（レビューを徹底してください）

常に守る5つの原則

1. 作業前にgit commit → いつでもロールバック可能な状態を維持
2. 範囲を明確に → 「このファイルのこの関数だけ」のように具体的に
3. 生成されたコードは自分で読む → 理解できないコードは使わない
4. セキュリティ/決済コードは必ず別途レビュー
5. 大きな作業はPlan Modeで計画を先に確認（Shift+Tab）

初めての実践プロジェクト提案

CC101を終えたら、すぐに実践に飛び込んでみましょう。コーディングの有無に関わらず、すぐ始められるプロジェクトです。

1. 議事録自動整理ワークフロー

毎週繰り返される会議の整理作業をClaude Codeに任せてみましょう。

"~/Downloads/meeting-250225.mp3 ファイルがあるよ。
 会議内容を変換して、要約 + 担当者別アクションアイテムを整理して
 meeting-250225.md に保存して"

録音ファイルのテキスト変換ツールのインストールから整理まで、すべて自動で行います。

2. 自分の業務用Skillsを作る

毎週繰り返す作業を/コマンド1つに短縮します。

"毎週月曜日に先週の作業内容を整理するSkillsを作って。
 GitHubのコミット履歴とメモファイルをベースに週次レポート草案を生成する方式で"

3. 競合分析レポート

興味のある分野の競合を分析します。

"競合A、B、Cのウェブサイトを分析して
 主要機能、価格、ターゲット顧客、差別化ポイントの比較表を作って。
 competitor-analysis.md に保存して"

4. ポートフォリオサイトの作成 🖥️ 開発者向け

"HTML/CSS/JSでポートフォリオサイトを作って。
セクション：自己紹介、技術スタック、プロジェクト、お問い合わせ。
ミニマルでダークテーマにして。"

5. 既存コードのリファクタリング 🖥️ 開発者向け

"このファイルのコードをレビューして改善して。
可読性、パフォーマンス、エラー処理に集中して。
@src/utils/dataProcessor.js"

困ったときはどうすればいい？

ステップ1：公式ドキュメントを確認

ほとんどの答えは公式ドキュメントにあります。

https://code.claude.com/docs

Claude Codeの中でもヘルプを得ることができます：

/help

ステップ2：Claude Codeに直接聞く

Claude Code自体が最も強力なヘルプです。

"Claude CodeでMCPサーバーを追加する方法を教えて"
"このエラーメッセージの意味を説明して: [エラー内容]"

ステップ3：コミュニティ

• GitHub Issues：github.com/anthropics/claude-code/issues
• CC101：github.com/im-jaehong/cc101jp

ステップ4：Anthropicサポート

アカウントや請求に関する問題はAnthropicコンソールからサポートをリクエストしてください。

最後に

Claude Codeは急速に進化しているツールです。今日学んだことが数か月後には変わっているかもしれません。重要なのは基本原理を理解することです。

AIと共に働くということは、単にタスクを速く処理することではありません。AIの強み（幅広い知識、繰り返し作業、パターン認識）と人間の強み（判断力、創造性、ドメイン知識）を組み合わせる新しいコラボレーション方式です。

CC101を終えた皆さんは、その第一歩を踏み出しました。これからの旅路が楽しみです。

クイックリファレンスカード

公式ドキュメント:   https://code.claude.com/docs
GitHub:            https://github.com/anthropics/claude-code
プラグイン:        https://github.com/anthropics/claude-plugins-official
gptaku_plugins:    https://github.com/fivetaku/gptaku_plugins
CC101:             https://github.com/im-jaehong/cc101jp
コンソール:        https://platform.claude.com

次の目標:
  バイブコーダー → gptaku_pluginsをインストール、show-me-the-prdで企画
  中級 → MCP設定（Notion/Slack/GitHub）、Hooksカスタマイズ、プラグイン探索
  上級 → 自分だけのSkills制作、Agent Teams
  (開発者) → CI/CD完全自動化、並列開発