Claude Code Ultimate Guide

Claude Code 究極ガイド

Florian BRUNIAUX · Méthode Aristote の AI 創業エンジニア @ Méthode Aristote 開発者から CTO／VP Eng まで 13 年 · ブログ ↗ · プロジェクト ↗

Claude Code を学び、信頼性の高いエージェントを構築し、安全に活用を拡大しましょう。ウェブサイトは、閲覧と情報発見のための主要なインターフェースです。このリポジトリには、正規の Markdown ソース、再利用可能なファイル、機械可読なインデックス、貢献履歴が含まれています。

まずはこちら： オンラインで最初のタスクを完了する · ガイドポータルを見る · サイトマップ全体を開く · Markdown ソースを読む

次のステップを選択する

以下の表は、machine-readable/navigation.jsonから生成されています。同じコントラクトが公開サイトマップにも使われているため、リポジトリとウェブサイトで同じインテントモデルが公開されます。

インテント	オンラインで閲覧
開始する	ガイドポータル · クイックスタート · 学習パス · クイックリファレンス · AI の役割
構築する	エージェントハーネスエンジニアリング · ループ＆グラフエンジニアリング · AI 設計パターン · コンテキストエンジニアリング · メモリーシステム · ワークフロー · 方法論 · MCP か CLI か？ · 例
拡張する	セキュリティ · エンタープライズガバナンス · オブザーバビリティ · チーム指標 · チームへの導入 · AI FinOps · LLM 市場の概要 · サブスクリプション戦略 · AI ユニットエコノミクス · チームナレッジ · API ゲートウェイ
リソース	リソースハブ · ダウンロード · チートシート · 電子書籍 · 図 · エコシステム · 比較 · 用語集 · よくある質問 · MCP サーバーガイド · 関連プロジェクト
更新情報	ガイドの変更履歴 · Claude Code のリリース · RSS フィード

このガイドがある理由

Claude Code のドキュメントは製品について説明しています。このガイドでは、製品の動作をエンジニアリング上の判断と結び付けます。コンテキストに何を含めるか、スキルではなくエージェントを使うのはどのような場合か、生成された成果物をどう検証するか、そして利用が一人の開発者を超えたときにどの管理策が重要になるかを扱います。

ニーズ	まず読む
Claude Code の内部を理解する	アーキテクチャとツールリファレンス
エージェントシステムを設計する	エージェントハーネスエンジニアリング、ループ＆グラフエンジニアリング、AI 設計パターン
AI 支援によるデリバリーを構成する	方法論とワークフローガイド
セキュリティ境界を確立する	セキュリティ強化とサンドボックス分離
理解度を確認する	理解度クイズと復習カード

このガイドでは、トレードオフを明示し、手順を検証できるようにすることを重視しています。根拠が不十分な場合は、1つのワークフローを普遍的なものとして提示するのではなく、該当ページでその限界を明確に示す必要があります。

開始する

Claude Code をインストールする

インストール方法を選択します：

# npm, macOS, Linux, or Windows
npm install -g @anthropic-ai/claude-code

# macOS with Homebrew
brew install claude-code

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

Windows PowerShell でも次の方法を利用できます：

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

インストールを確認して認証します：

claude --version
claude doctor
claude auth login

クイックスタートの章では、インストール方法の選択肢、認証、更新、権限モード、初日に起こりやすい問題について説明しています。

最初のタスクを完了する

Git の状態がクリーン、または把握できている小規模なリポジトリを開き、Claude Code を起動します：

cd your-project
claude

期待する結果と検証方法を含め、範囲を限定した依頼を Claude に伝えます：

Explain how this project runs its tests. Do not modify files.
Name the relevant commands and cite the files that define them.

Claude にコードの編集を依頼する前に、Claude が従うべきコマンドと制約を記録したプロジェクトレベルの CLAUDE.md を追加します：

# Project instructions

## Commands
- Test: `npm test`
- Lint: `npm run lint`

## Boundaries
- Do not edit generated files.
- Do not change dependencies without approval.
- Run the relevant tests before claiming completion.

最初のワークフローを続けるか、CLAUDE.md のスターターテンプレートを利用してください。

学習パスを選択する

状況	おすすめのルート
Claude Code を初めて使う	7 モジュールの学習パス
CLI をすでに使っている	コアコンセプト、続いてコンテキストエンジニアリング
シニア開発者またはテックリード	手法、エージェントハーネスエンジニアリング、続いて本番環境の安全性
エンジニアリングマネージャーまたは CTO	導入アプローチ、チーム指標、続いてサブスクリプション戦略
セキュリティまたはプラットフォーム担当	セキュリティ強化、エンタープライズガバナンス、続いて可観測性
プロダクトマネージャーまたはデザイナー	プロダクトマネージャー向けガイドまたはデザインからコードへのワークフロー
開発者以外のナレッジワーカー	Claude Cowork ガイド

自分に合ったルートを選ぶには、リポジトリのオンボーディング用プロンプトを使用します：

claude "Fetch and follow the onboarding instructions from: https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md"

構築

エージェントエンジニアリング

エージェントは、より大きなシステムを構成する一要素です。その周囲のハーネスが、コンテキスト、ツール、権限、状態、停止条件、リカバリー、評価を制御します。

リソース	判断に役立つ内容
エージェントハーネスエンジニアリング	エージェントのループに必要な制御を特定する
ループとグラフのエンジニアリング	範囲を限定したフィードバックループと明示的なワークフローグラフのどちらを選ぶか判断する
AI 設計パターン	開発者になじみのある GoF、統合、レジリエンスのパターンを使ってエージェント設計を説明する
エージェントハーネスの全体像	ランタイム、オーケストレーター、フレームワーク、コントロールプレーン、サポートツールを見分ける
エージェント型ツール	代表的なコーディングエージェントとオーケストレーション製品を比較する
エージェント評価	動作、リグレッション、タスクレベルの成果をテストする
ハーネス用語集	設計とレビューで用語を統一する
AI の概念上の境界	リポジトリの例と理解度チェックを使って、よくある 7 つの混同を解消する

コンテキストとメモリ

コンテキストの品質は、すべてのツール呼び出しと判断に影響します。まずプロジェクトの指示を用意し、繰り返し発生するタスクで必要になった場合にのみ専門的なコンテキストを追加して、追加の資料が動作に変化をもたらすかをテストします。

リソース	焦点
コンテキストエンジニアリング	コンテキストの予算、モジュール化された指示、組み立て、測定
メモリシステム	ネイティブメモリ、セッション間システム、チーム共有、保持に伴うリスク
コンテキストエンジニアリングツール	出力の圧縮、検索、ゲートウェイ、コンテキストの検査
コンテキスト監査	プロジェクトのコンテキストアーキテクチャを測定する
チーム向けAI指示	開発チーム全体で共有する指示を維持する

ワークフロー

目標	ワークフロー
テストを先に書いて実装する	Claude での TDD
実装前に動作を定義する	仕様ファースト開発
計画と実行を分ける	計画駆動開発
独立した候補を比較する	Best-of-N
複数のエージェントを連携させる	エージェントチーム
範囲を限定した自律ループを構築する	エージェント型ソフトウェアファクトリー
コードを体系的にレビューする	コードレビュー
別のチームがレビューできるコントリビューションを準備する	AI 支援によるオープンソースへのコントリビューション
不慣れなリポジトリを調査する	探索ワークフロー

タスク管理、GitHub Actions、本番環境の信頼性、イベント駆動型エージェント、デザインからコードへの変換、PDF 生成、検索、チーム向け指示については、すべてのワークフローを見るをご覧ください。

最小限のインターフェースを選ぶ

Claude Code は、ローカルコマンド、スキル、エージェント、フック、プラグイン、MCP サーバーを呼び出せます。インフラを増やすと、セットアップ、権限、障害要因、メンテナンスが増えます。

タスクに必要なもの	推奨
決定論的なローカルコマンド	CLI またはスクリプト
再利用可能な指示と補助ファイル	スキル
独立したコンテキストと役割	エージェント
ライフサイクルイベントへの応答	フック
機能をまとめたパッケージ	プラグイン
リモートサービスへの型付きインターフェース	MCP サーバー

新たな連携を導入する前に、MCP と CLI の選択ガイドとトレードオフのフレームワークを利用してください。

スケール

信頼性とセキュリティ

懸念事項	主なリソース	運用を補完するリソース
権限とプロンプトインジェクション	セキュリティ強化	権限監査
信頼できない実行の分離	サンドボックスの分離	ネイティブサンドボックス
本番環境の変更とロールバック	本番環境の安全性	本番環境の信頼性
機密データと保持	データプライバシー	エンタープライズガバナンス
許可されたアプリケーションの積極的なテスト	エージェントによるペネトレーションテスト	DarkMoon と Strix の評価
MCP と拡張機能のサプライチェーン	MCP エコシステム	脅威データベース
委任の準備状況	仕様の完全性監査	エージェントの評価

セキュリティに関する主張や脅威の件数は、情報源の追加や修正に応じて変わります。件数をプロジェクトのドキュメントに転載するのではなく、リンク先のデータベースとガイドを最新の情報源としてご利用ください。

評価と運用

ニーズ	リソース
エージェントの動作と障害を追跡する	オブザーバビリティ
AI 支援による変更を特定する	AI のトレーサビリティ
チームの成果を評価する	チームの指標
タスク単位のコストを計算する	AI のユニットエコノミクス
インフラストラクチャのワークフローを運用する	DevOps と SRE
ガバナンスが適用された API トラフィックをルーティングする	API ゲートウェイ

構造チェックに合格しても、検査した範囲が確認されただけです。実行時の動作、タスクの受け入れ、セキュリティ境界、ビジネス上の成果については、別途エビデンスが必要です。

組織と経済性

判断事項	リソース
チーム全体に Claude Code を導入する	導入アプローチ
利用ティアと承認を定義する	エンタープライズガバナンス
チームのナレッジを維持する	チームのナレッジベース
サブスクリプション、API、ゲートウェイを比較する	サブスクリプション戦略
ホスト型推論とローカル推論を比較する	ローカル推論とクラウド推論の比較
変化する AI の役割を整理する	AI の役割

経済性に関するページでは、実測コストと推定値やシナリオを分けています。ご自身のワークロード、受け入れ基準、レビューの工数、リスク制約に基づいて再計算してください。

タスクに合った形式を使う

形式	用途	オンラインで読む	ソースまたはダウンロード
完全版リファレンス	詳細な解説とリンク付きセクション	完全ガイド	Markdown
デイリーリファレンス	コマンド、ショートカット、チェック項目	クイックリファレンス	Markdown
ガイド付きコース	学習内容を段階的に進め、証拠を記録する演習	学習パス	コースのソース
実行可能な資料	エージェント、スキル、フック、ワークフロー、スクリプト	例	ファイル
視覚的な解説	アーキテクチャ、コンテキスト、セキュリティ、ワークフローのマップ	図解	図のソース
理解度チェック	ドキュメントへのリンク付きの質問	クイズ	質問のソース
印刷用リファレンス	フランス語と英語で、1ページにつき1つの概念	チートシート	カードのソース
長編版	オフラインで利用できるPDFとEPUB	電子書籍	ダウンロード
機械可読インデックス	AI アシスタントによる検索と取得	MCP ガイド	llms.txt と reference.yaml

MCP サーバー：あらゆるコーディングクライアントからガイドを使う

ガイドを stdio MCP サーバーとしてインストールし、Claude Code、Codex、Cursor、VS Code、その他の MCP クライアントからクエリを実行できます。

claude mcp add --scope user claude-code-guide -- npx -y [email protected]
codex mcp add claude-code-guide -- npx -y [email protected]

プロジェクト単位の Claude Code 設定は .mcp.json に記述します。

{
  "mcpServers": {
    "claude-code-guide": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

機能	数	名前
ツール	17	compare_versions, diff_official_docs, get_changelog, get_cheatsheet, get_digest, get_example, get_release, get_threat, init_official_docs, list_examples, list_threats, list_topics, read_section, refresh_official_docs, search_examples, search_guide, search_official_docs
リソース	7	claude-code-guide://agent-harnesses, claude-code-guide://ai-design-patterns, claude-code-guide://distribution-channels, claude-code-guide://llms, claude-code-guide://reference, claude-code-guide://releases, claude-code-guide://translations
プロンプト	1	claude-code-expert
付属コマンド	5	/ccguide:daily, /ccguide:diff-docs, /ccguide:init-docs, /ccguide:refresh-docs, /ccguide:search-docs

一覧表示操作と検索インデックスでは、同梱コンテンツを使用します。セクション、例、チートシート、変更履歴、ダイジェスト（get_digest）、脅威関連のツールでは、GitHub のコンテンツを取得し、24時間有効のローカルキャッシュに書き込むことができます。公式ドキュメントの初期化ツールと更新ツールでは、Anthropic のドキュメントを取得し、別個のローカルスナップショットに書き込みます。

技術ガイドの正規版、インストール、プライバシー、制限事項、日付付き統計

パッケージの README と診断

リポジトリからレンダリングされる付属コマンド：/ccguide:daily、/ccguide:diff-docs、/ccguide:init-docs、/ccguide:refresh-docs、/ccguide:search-docs。

別のアシスタントにガイドを読み込む

概要を把握するには、簡易インデックスを使います。

curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/llms.txt

アシスタントが、ガイド全体への構造化されたトピック別ルートとリンクを必要とする場合は、reference.yaml を使います。メンテナンス手順は、この README ではなく、機械可読ドキュメントに記載しています。

補完的なエコシステム

学習、インストール、キュレーション、参考資料、あらゆる専門的なインターフェースを、単一のリポジトリですべて網羅する必要はありません。現在のタスクに合ったリソースを選んでください。

必要なこと	リソース	提供内容
Claude Code の動作を確認する	公式 Claude Code ドキュメント	主要な製品ドキュメント
アーキテクチャ、トレードオフ、セキュリティ、ワークフローを学ぶ	Claude Code Guide	解説、判断ガイド、運用チェック、例
コミュニティプロジェクトを見つける	awesome-claude-code	エコシステム全体から厳選したリンク
設定一式をインストールする	everything-claude-code	パッケージ化されたエージェント、スキル、フック、設定
インストール可能なテンプレートを閲覧する	claude-code-templates	テンプレートカタログと CLI による配布
公式のスキル例を使い始める	anthropics/skills	Anthropic が管理するスキルの例
スキルマーケットプレイスを閲覧する	skills.sh	公開されているスキルの検索とインストール方法
Claude Code のフックをキュレーションする	awesome-claude-code-hooks	厳選された Claude Code フックの一覧
ソフトウェア開発以外の業務に取り組む	Claude Cowork Guide	ナレッジワーカー向けのワークフロー
コーディングエージェントの機能を比較する	AI Coding Agents Matrix	エージェント間の機能比較

この短いリストは 2026-08-31 に確認しました。プロジェクトの活動状況、インストール方法、対象範囲は変わる可能性があります。まず、公開されている エコシステム と 比較 のページをご覧ください。AI エコシステムのソース、サードパーティツールのソース、およびリソース評価には、さらに詳しい根拠が掲載されています。

既存のエージェント CLI 上でデスクトップワークスペースを使う場合は、2026 年 10 月のワークスペース比較をご覧ください。Conductor のローカル／クラウドのワークフローと、Vibe Kanban のメンテナンスに関する注記を取り上げています。

更新情報

ガイドの変更と Claude Code 製品のリリースでは、扱う内容が異なります。

フィード	内容	ソース
ガイドの変更履歴	新しいページ、修正、リポジトリの大規模な改訂	CHANGELOG.md
Claude Code のリリース	Claude Code の製品バージョンと運用への影響	リリースソース
RSS フィード	フィードリーダーで確認できる、公開済みのガイドおよび製品の更新情報	ウェブサイトによる生成

最近ガイドに追加された内容：

• Mistral Large 4 の評価：10 月 6 日の発表を裏付ける情報、プロモーション価格、独立した評価結果、地域別の推論、未公開の重みを取り上げています。市場スナップショットとAI エコシステムにも反映されています。
• ループとグラフのエンジニアリング（ソース）：制限付きフィードバック、ワークフローの状態、停止ルール、復旧、判断の割り当てについて説明しています。
• AI デザインパターン（ソース）：従来のパターンを Claude Code の仕組みに対応付け、それぞれの類推が成り立たなくなる点、ネイティブなエージェントパターン、アンチパターンを取り上げています。
• サブスクリプション戦略（ソース）：シート、API、ゲートウェイ、セルフホストのシナリオ、チーム規模に応じた判断基準を取り上げています。
• セッション間メッセージング（ソース）：ピアの検出、配信、セキュリティ境界、相関ドリフトの制御について説明しています。

全履歴については変更履歴をご覧ください。README には、現時点で重要な項目だけを掲載します。

言語と翻訳

英語版が正式版です。フランス語版はこのリポジトリで管理しています。簡体字中国語版、ウクライナ語版、ラテンアメリカスペイン語版は、それぞれ独立したコミュニティ版で、更新スケジュールも異なります。

言語	版
英語	正式ガイド
フランス語	このリポジトリで管理するフランス語ガイド
簡体字中国語	JAYcodr によるコミュニティ版
ウクライナ語	gerasimsergey によるコミュニティ版
ラテンアメリカスペイン語	Richardls によるコミュニティ版

翻訳ステータスページには、メンテナー、ソースコミット、翻訳範囲、測定された遅延、レビュー状況を記録しています。

リポジトリの構成

guide/
├── ultimate-guide.md       Complete reference
├── learning-path/          Guided course
├── core/                   Architecture, tools, context, methods
├── security/               Hardening, isolation, privacy, governance
├── ecosystem/              Agents, MCP, tools, inference, knowledge
├── roles/                  Adoption, learning, evaluation, careers
├── ops/                    Observability, metrics, economics, gateways
├── workflows/              Task-oriented delivery guides
└── diagrams/               Mermaid diagrams with text fallbacks

examples/                   Reusable agents, skills, hooks, and workflows
machine-readable/           Structured indexes and release data
mcp-server/                 Packaged guide access for MCP clients
quiz/                       Local knowledge validation
docs/resource-evaluations/  Reviewed external resources
whitepapers/                French and English long-form sources

各ディレクトリの正式なナビゲーションページは、詳細なガイド索引、サンプルカタログ、ツール索引です。

貢献

誤りの修正、根拠となる情報の追加、リンク切れの修正、サンプル、クイズの質問、ドキュメントの改善を歓迎します。プルリクエストを作成する前に、CONTRIBUTING.mdをお読みください。

貢献する方法：

• 誤りや古くなった記述は、GitHub Issuesから報告してください。
• 外部リソースは、リソース評価プロセスを通じて提案してください。
• 出典、範囲、検証方法を添えて、焦点を絞ったガイドやワークフローを提案してください。
• 既存のセキュリティチェックを弱めずに、サンプルを改善してください。

メンテナー

Florian Bruniaux がこのガイドをメンテナンスしています。

GitHub · LinkedIn · ポートフォリオ

エコシステムを探索する

これらのプロジェクトは、このツールと重複することなくワークフローを拡張します。

• claude-code-plugins でインストールする：解説から、インストール可能なテンプレートへ移行します。
• ctxharness で検証する：文書化されたコンテキストと指示が、現在もリポジトリと一致しているかテストします。
• agentsec-triage でセキュリティを強化する：セキュリティガイダンスを、バージョン管理された運用フィードに接続します。
• Claude Cowork Guide で続ける：ナレッジワーカーや開発者以外のユーザー向けに設計されたワークフローに切り替えます。

オープンソースのエコシステム全体を見る

ライセンス

ガイドにはCC BY-SA 4.0を使用しています。再利用可能なテンプレートにはCC0 1.0を使用しています。異なるライセンスのコンテンツを再配布する前に、リポジトリのライセンスファイルを確認してください。

更新情報はGitHub Releasesを確認するか、RSS フィードを購読してください。

---

バージョン 3.44.1 | 毎日更新 · 2026年10月17日