2026年版Claude Code：セットアップ方法からスラッシュコマンド、MCP、Subagentsの実装まで

最終更新日: June 28, 2026

私は過去1ヶ月間、実際のNext.jsモノレポで毎日Claude Codeを使用しました。この記事では、私が実際に実行したセットアップ方法、コマンド、CLAUDE.md、MCP、サブエージェント、権限、およびフックについて、そしてそれがどの点で不足しているかを解説します。

クイックアンサー：Claude Codeとは何か、そしてそれを使う価値はあるか？

Claude CodeはAnthropicのagentic coding CLIです。これはリポジトリを読み取り、ファイルを編集し、シェルコマンドを実行し、タスクが完了するまでツールをチェーンさせます。私はこれを使って、ターミナルから離れることなく、機能のリリース、バグの修正、diffのレビューを行います。

私にとって機能するセットアップは以下の通りです：CLIをインストールし、CLAUDE.mdを追加し、2〜3つのMCPサーバーを接続し、権限を厳しく保つことです。この組み合わせにより、単なるチャットガジェットから、あなたのコードベースを知っているチームメイトへと変貌します。

これは魔法ではありません。200kファイルのリポジトリでは、APIを幻覚したり、テストを壊したりします。その価値は、タスクの範囲を小さくし、すべての計画を見直し、頻繁にコミットを行うことで得られます。実際の限界については最後に詳しく述べます。

Claude Codeの設定方法は？

私はmacOSにはネイティブインストーラーを、LinuxにはNodeを使用しました。どちらもgithub.com/anthropics/claude-codeのリポジトリで文書化されている公式な方法です。

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

## or via npm
npm install -g @anthropic-ai/claude-code

## verify
claude --version

その後、リポジトリ内でclaudeを実行し、Anthropicアカウントでログインしました。初回起動時、ツリーをスキャンし、ディレクトリへのアクセス確認を求められました。私はプロジェクトのルートのみに「はい」と答え、ホームフォルダ全体には許可しませんでした。

初期段階で設定した、後悔していないいくつかの決定事項があります：

• チームメイトが一致するようにCIでバージョンを固定しました。
• .claude/を.gitignoreに追加しつつ、コミットするsettings.jsonだけは除外していません。
• コンテキストの質が出力を決めるため、実際のプロンプトより先にCLAUDE.mdを書きました。
• 初めの1週間は、「破壊的なアクションを行う前に尋ねる」デフォルトモードをオンに保ちました。

インストールと設定に関する公式なリファレンスはdocs.claude.com/en/docs/claude-codeにあり、これを確認しながら設定を進めています。

毎日使用するスラッシュコマンドは何ですか？

スラッシュコマンドはセッションを誘導するための最も速い方法です。私は/helpを実行し、実際に手を伸ばすものだけにリストを絞り込むことでこれを学びました。

私は他のどのコマンドよりも/clearを実行します。セッションが混乱した場合、クリーンな状態とより厳密なプロンプトが問題の80パーセントを解決してくれます。/compactは、勢いを保ちたいがコンテキストが重くなってきたときに使う、より穏やかなバージョンです。

価値のあるCLAUDE.mdはどのように書くのか？

CLAUDE.mdは、Claudeがすべてのセッションの開始時に読むMarkdownファイルです。これは、迅速だがあなたの決定に関する記憶がゼロの新入社員のためのオンボーディングドキュメントだと考えてください。

私は/initを実行して初稿を生成し、その後手動で書き直します。生成されたバージョンは出発点であり、最終ファイルではありません。私のCLAUDE.mdには、スタック、規約、レイアウト、コマンド、そして二度と再導入したくない3つのバグが記載されています。

## Project

Next.js 14 App Router, TypeScript strict, Prisma + Postgres, pnpm workspaces.

## Layout
- App routes in app/
- Server actions in app/actions
- UI primitives in packages/ui

## Conventions
- Prefer async/await over .then chains
- Never use `any`; type unknown and narrow
- Keep components under 200 lines

## Commands
- Dev: pnpm dev
- Test: pnpm test
- Lint: pnpm lint

## Known traps
- Do not edit prisma/schema.prisma without running migrate
- rate-limit.ts is shared; changes affect all routes

私が犯し、修正した2つのCLAUDE.mdのミスがあります。第一に、信号を薄めたリストではなく段落を書いたことです。第二に、プロジェクトの履歴を入れたことで、何の利益もないトークンを消費させてしまったことです。短く、命令的で、最新の状態に保ってください。

より深いパターンについては、私のClaude Code skills writeupが、CLAUDE.mdと相性の良い再利用可能なプロンプトフラグメントを分解しています。

MCPとサブエージェントは実際どのように機能するのか？

MCP (Model Context Protocol) は、Claude Codeがあなたのリポジトリの外（データベース、ブラウザ、GitHub、Linearなど）に到達する方法です。私は3つのMCPサーバーを実行しており、これで十分です。サーバーが増えるということは、トークンが増え、承認プロンプトが増えるということです。

私の現在のMCPセットアップは毎週実際に作業を行います：

• GitHub serverがPRを開き、レビューコメントを読み取ります。
• Postgres serverが、私にSQLを書かせることなく「何行のレコードが一致するか」に回答します。
• Playwright serverが、ステージングURLに対してUI変更を検証します。

これらを.claude/settings.jsonで設定し、実際のタスクで信頼する前に、それぞれ1行のプロンプトで検証しました。構成とサーバーの選択については、Claude Code MCP integration guideおよびより広範なMCP model context primerで詳しく解説しています。

サブエージェントは、もう一つの乗数です。独立した部分を持つ機能の場合、Claudeに並列なサブエージェントをディスパッチするよう依頼し、それぞれを1つのファイルまたはモジュールにスコープさせ、リードエージェントに結果のマージを任せます。これは大規模な変更における実時間（wall-clock time）を削減します。

サブエージェントは、作業が真に並列である場合に輝きます。タスクが状態を共有する場合、マージステップが乱雑になるため失敗します。私が信頼する並列化パターンについては、Claude Code subagents and team automationを参照してください。

権限とフックはどう機能するか？

権限は、尋ねることなくClaudeができることを決定します。私はデフォルトを保守的に保ち、プロジェクトごとに拡張します。承認プロンプトは、何か破壊的なアクションの前に表示されるため、これは決して無効にしない唯一の安全網です。

フックは、Claudeのイベント（コマンド前、編集後、セッション開始時）で実行されるユーザー定義スクリプトです。私はpost-editフックを使用してリンターと型チェッカーを自動的に実行し、何も実行することなくClaudeに迅速なフィードバックを得ています。

このフックが先週私を助けてくれました。私のpre-commandフックが、プロジェクト外のパスに対するrm -rfをブロックし、Claudeはスコープ化された削除に調整しました。これは、設定する10分という労力に見合うまさにガードレールです。

2026年になってもClaude Codeは価値があるか？

はい、すでにターミナルで生活している開発者にとっては価値があります。コストはトークン単位で現実であり、タスクがスコープされ、リポジトリがCLAUDE.mdによって適切に記述されている場合に報われます。

これは私にとって3つのツールを置き換えました：別のAIチャット、CLI検索アシスタント、そして手動でのgrep＆リードによる探索のほとんどです。ターミナルネイティブなループは、ブラウザへのタブ切り替えよりも速いです。

まだ劣る点もあります：大規模で曖昧なリファクタリング、ドキュメントが薄い全く新しいフレームワーク、そして全体的なコードベースにわたってセンスが必要なものなどです。これらについては、まずプレーンテキストで計画を立て、その後シャープな仕様書をClaudeに渡します。

本番環境のコードを信頼してもよいか？

監視なしではだめです。私はClaude Codeの出力を、優秀だが経験の浅いジュニアの開発者のPRと同じように扱います：すべてのdiffを読む、テストを実行する、そして決して信頼だけでマージしない。自律性はスイッチではなくダイヤルです。

正直な注意点として、Claude Codeは、特にエラー処理とasync cleanupに関して、正しく見えるが微妙に間違っているコードを自信を持って生成します。失敗パス自体を見直し、迅速なロールバックを用意すれば、災害なしで真剣な生産性向上を得られます。Anthropic docsには、私がここで繰り返さなかった設定が記載されています。

要点まとめ

• CLIをインストールし、最初の実際のプロンプトの前にCLAUDE.mdに投資する。
• /clear、/compact、/permissionsをマスターする。他はオプション。
• 2〜3つのMCPサーバーから始め、ワークフローが要求する場合のみ追加する。
• 並列で独立した作業にはサブエージェントを使用し、共有状態のタスクは逐次的に保つ。
• 権限を厳しく保ち、リンター、型チェック、破壊的コマンドガードのためにフックを追加する。
• すべてのdiffをPRのようにレビューする。レビューなしの自律性がプロジェクトにダメージを与える場所です。

画像クレジット

• 開発者のモニターで輝くカラフルなソースコード — photo by Mikhail Nilov on Pexels
• 画面に表示されたカラフルなプログラミングコードのぼかしたクローズアップ — photo by Pixabay on Pexels
• デスクでデュアルモニターを使いコーディングするヘッドフォンをかけたプログラマー — photo by Christina Morillo on Pexels
• モダンなオフィスでコードを書き、レビューするソフトウェアエンジニア — photo by ThisIsEngineering on Pexels