注目 Fundamentals Claude Code Tutorial

Claude Code 完全ガイド：セットアップから高度なワークフローまで

Claude Code の完全な日本語チュートリアル。インストールから CLAUDE.md、Hooks、MCP、Custom Agents などの高度な機能まで。初心者から上級者まで対応。

2026年1月19日 • 15 min read • 著者：Claude World

これは現在最も包括的な Claude Code 日本語チュートリアルです。AI 支援開発が初めての方も、高度な機能を習得したい方も、このガイドが役立ちます。

Claude Code とは？

Claude Code は Anthropic 公式の AI コーディングアシスタントです。他のツールとの主な違い：

  • ターミナルネイティブ：エディタに依存せず、ターミナルで動作
  • プロジェクトレベルの理解：単一ファイルだけでなく、コードベース全体を理解
  • エージェントアーキテクチャ：質問に答えるだけでなく、タスクを自律的に実行

なぜ Claude Code を選ぶのか？

特徴Claude CodeCursorGitHub Copilot
インターフェースターミナルIDEエディタプラグイン
自律性高い（エージェント）中程度低い
カスタマイズ性非常に高い中程度低い
最適な用途複雑なタスク、自動化GUI 好みシンプルな補完

ターミナルが好きで、最大限のコントロールが必要で、複雑なタスクを処理する必要がある場合、Claude Code が最適です。

インストールとセットアップ

システム要件

  • macOS: 10.15+
  • Linux: Ubuntu 20.04+ / Debian 10+
  • Windows: Windows 10+（WSL または Git for Windows が必要）

インストール方法

方法1：公式インストールスクリプト（推奨）

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

方法2：npm インストール

# Node.js 18+ が必要
npm install -g @anthropic-ai/claude-code

初回セットアップ

インストール後、実行：

claude

初回実行時にガイドされる項目：

  1. 認証：Anthropic アカウントにログインまたは API Key を入力
  2. プラン選択：Free / Pro / Max
  3. 権限設定：Claude が実行できる操作を決定

インストールの確認

claude --version
# バージョンが表示されます（例：claude-code version 2.1.12）

基本的な使い方

会話の開始

任意のプロジェクトディレクトリで実行：

cd /path/to/your/project
claude

Claude は自動的にプロジェクト構造をスキャンして理解を構築します。

基本コマンド

コマンド機能
claudeインタラクティブ会話を開始
claude "何かをする"単一タスクの実行
claude --helpすべてのオプションを表示
/help会話中にヘルプを取得
/clear会話履歴をクリア
Ctrl+C現在の操作を中断
Escape 2回Claude を終了

会話モード

会話では、自然言語でタスクを説明できます：

あなた：src/utils/ に日付フォーマットのユーティリティ関数を作成して

Claude：そのユーティリティ関数を作成します...
[Claude は作成するファイルと内容を表示し、確認を待ちます]

プランモード

Shift+Tab を押してプランモードに入る：

あなた：[Shift+Tab] ユーザーログイン機能を実装して

Claude：要件を分析して実装計画を立てます...
[Claude はコードベースを調査し、計画を提案しますが、ファイルは変更しません]

プランモードが最適な場面：複雑な機能、どう進めるか不明な場合

CLAUDE.md 設定

CLAUDE.md は Claude Code の最も重要な設定ファイルです。プロジェクトのルールを Claude に伝えます。

CLAUDE.md の作成

プロジェクトルートに CLAUDE.md を作成：

# プロジェクト名

## 技術スタック
- Node.js + TypeScript
- React + Tailwind CSS
- PostgreSQL

## 開発ルール
- pnpm をパッケージマネージャーとして使用
- すべてのコードに TypeScript 型が必要
- コミット前に `pnpm lint && pnpm test` を実行

## ディレクトリ構造
- `src/` - メインソースコード
- `tests/` - テストファイル
- `docs/` - ドキュメント

## 禁止事項
- any 型を使用しない
- 既存のテストを削除しない
- main ブランチに直接プッシュしない

クイック初期化

組み込みコマンドで自動生成：

claude
/init

Claude がプロジェクト構造を分析し、適切な CLAUDE.md を生成します。

CLAUDE.md の配置場所

場所用途
プロジェクトルート/CLAUDE.mdプロジェクト固有のルール
~/.claude/CLAUDE.md個人のグローバルルール

高度な機能

1. Hooks（自動化トリガー）

Hooks を使用すると、特定のイベントで自動的にスクリプトを実行できます。

一般的なユースケース：

  • ファイル編集後に自動フォーマット
  • 変更ごとにテストを実行
  • 危険なコマンドをブロック

設定例（.claude/settings.json）：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "pnpm lint --fix $CLAUDE_FILE_PATHS"
          }
        ]
      }
    ]
  }
}

👉 詳細ガイド：Claude Code Hooks 完全ガイド

2. MCP（Model Context Protocol）

MCP により、Claude を外部ツールやデータソースに接続できます。

一般的な MCP サーバー：

  • memory - クロス会話メモリ
  • filesystem - 強化されたファイル操作
  • github - GitHub 統合

インストール例：

# メモリサーバーをインストール
claude mcp add memory -- npx -y @anthropic-ai/mcp-server-memory

👉 詳細ガイド：Claude Code MCP セットアップガイド

3. Custom Agents（カスタムエージェント）

特定のタスク専用のエージェントを作成します。

作成方法：

claude
/agents
# "Generate with Claude" を選択
# 欲しいエージェントを説明

一般的なエージェントタイプ：

  • Code Reviewer - コード品質レビュー
  • Debugger - エラー分析
  • Test Writer - テスト作成

👉 詳細ガイド：Claude Code Agents 完全ガイド

4. Custom Skills（カスタムスキル）

Skills は再利用可能なコマンドテンプレートです。

作成方法：

.claude/skills/ に Markdown ファイルを作成：

# my-deploy.md
---
name: deploy
description: "本番環境にデプロイ"
user-invocable: true
---

以下のデプロイ手順を実行：
1. テストを実行
2. プロジェクトをビルド
3. Cloudflare Pages にデプロイ

使用方法：/deploy

👉 詳細ガイド：Claude Code Skills 完全ガイド

ベストプラクティス

1. コンテキストをクリーンに保つ

各タスク完了後に /clear で会話履歴をクリア

古い会話履歴はトークンを消費し、Claude を混乱させる可能性があります。

2. プランモードを活用

複雑なタスクは先にプランモード（Shift+Tab）に入る
Claude に行動前に調査させる

3. 明確な指示を与える

悪い例：「この関数を改善して」

良い例：「calculateTotal 関数を for ループの代わりに reduce を使用するようリファクタリングし、TypeScript 型を追加して」

4. テスト駆動開発を活用

あなた：先にテストを書いて、失敗を確認してから、テストが通る機能を実装して

Claude は明確なテスト目標があるときに最高のパフォーマンスを発揮します。

5. 組み込みツールを活用

コマンド用途
/initCLAUDE.md を初期化
/costトークン使用量を確認
/memoryメモリを管理
/modelモデルを切り替え

よくある質問

Q: Claude がコマンドを実行しない？

A: 権限設定を確認してください。Claude は確認を待っている可能性があります。y または a（すべて許可）を入力してください。

Q: コストを削減するには？

A:

  1. /clear で不要な履歴をクリア
  2. Shift+Tab で実行前に計画
  3. シンプルなタスクには Haiku モデルを使用

Q: Claude が生成したコードにエラーがある？

A:

  1. より多くのコンテキスト（関連ファイル）を提供
  2. テスト駆動開発を使用
  3. エラーを明確に指摘し、Claude に修正させる

Q: チームで使用するには？

A:

  1. CLAUDE.md をバージョン管理に追加
  2. .claude/ ディレクトリをバージョン管理に追加（settings.local.json は除外）
  3. MCP 設定に project スコープを使用

Q: どのプログラミング言語がサポートされている？

A: Claude Code はすべての主要なプログラミング言語をサポートしています：

  • JavaScript/TypeScript
  • Python
  • Go
  • Rust
  • Java/Kotlin
  • C/C++
  • Swift
  • PHP
  • Ruby

次のステップ

Claude Code の基礎を完了おめでとうございます！推奨される次の読み物：

  1. Hooks 完全ガイド - 自動化ワークフローを構築
  2. MCP セットアップガイド - Claude の機能を拡張
  3. Agents 完全ガイド - カスタムエージェントを作成
  4. Director Mode 方法論 - 高度な開発モード

リソース

最終更新：2026-01-19