Claude Code 入門ガイド

インストールから拡張機能・全コマンドまで

01Claude Code とは

Anthropic 社が提供する Claude シリーズの AIコーディングアシスタント。ターミナルや IDE で動作し、自然言語で「○○を作って」「このバグ直して」と頼むとファイルを実際に編集・実行してくれる。OpenAI 社の Codex と並んで急速にシェアを伸ばしとる存在。

最近はコーディング以外の使い方も増えとる：

• Gmail / Google カレンダー連携で「急ぎのメール教えて」「予定入れといて」
• 業務データを置いたフォルダで「売上を分析して」「販売改善策を立案して」
• ドキュメント整備、リサーチ、原稿執筆、Excel 処理など

利用形態

本ガイドは CLI 版を中心に書いとる。

02インストール

本体

公式のネイティブインストーラ（Node.js 不要・自動更新あり）が推奨。

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

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

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

Homebrew (brew install --cask claude-code)、npm (npm install -g @anthropic-ai/claude-code)、apt / dnf / apk なども使える。

PATH が通っていない警告が出たら：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

周辺ツール

ネイティブ版は ripgrep を内蔵しとるので必須やないけど、シェルから直接叩く用に git / fd / rg を入れておくと便利。GitHub 連携なら gh も。

# RHEL系
sudo dnf -y install epel-release
sudo dnf -y install git fd-find ripgrep

# Debian/Ubuntu系
sudo apt -y install git fd-find ripgrep
sudo ln -s /usr/bin/fdfind /usr/local/bin/fd

# Windows
winget install Git.Git sharkdp.fd BurntSushi.ripgrep.MSVC

初回起動

mkdir myapp
cd myapp
claude

順に聞かれる：

1. テーマ選択（Dark / Light / カラーブラインド対応など7種）
2. ログイン方法（固定プラン / API 従量 / Bedrock等の3rd party）
3. 使用上の注意確認（Claude は間違える、プロンプトインジェクション注意）
4. このフォルダを信頼するか

通れば「Try "fix lint errors"」と書かれたプロンプト欄が出て利用開始。

03フォルダ構成

ホームディレクトリ側

~/.claude/（Windows は C:\Users\<user>\.claude\）配下：

~/.claude/
├── CLAUDE.md                — 個人レベルの基本ルール
├── agents/                  — サブエージェント定義
├── agent-memory/            — サブエージェント用メモリ
├── backups/                 — 自動バックアップ
├── cache/                   — 内部キャッシュ
├── commands/                — カスタムコマンド置き場
│   └── <name>.md            — 各コマンドの定義ファイル
├── downloads/               — Claude が取得したファイルの保管場所
├── ide/                     — IDE 統合の状態ファイル
├── file-history/            — ファイル編集履歴（/rewind の戻り先）
├── history.json             — プロンプト履歴
├── hooks/                   — フックスクリプト置き場
├── plugins/                 — インストール済みプラグイン
│   └── marketplaces/        — プラグインマーケットプレイス情報
├── projects/                — プロジェクトごとの作業履歴
│   └── -path-to-project/    — 個別プロジェクトのフォルダ
│       ├── uuid.jsonl       — プロンプト/応答ログ
│       └── memory/          — auto memory 用フォルダ
│           └── MEMORY.md    — auto memory 本体
├── session-env/             — セッションごとの環境変数
├── sessions/                — セッションデータ
├── settings.json            — 個人設定
├── shell-snapshots/         — シェル環境のスナップショット（タスク復元用）
└── skills/                  — スキル置き場
    └── <name>/              — 個々のスキルフォルダ
        └── SKILL.md         — スキル定義ファイル

プロジェクト側

<myapp>/ 配下：

myapp/
├── CLAUDE.md                — プロジェクトの基本ルール
└── .claude/
    ├── agents/              — プロジェクト用サブエージェント
    ├── agent-memory/        — プロジェクト用エージェントメモリ
    ├── commands/            — プロジェクト用カスタムコマンド
    │   └── <name>.md        — 各コマンドの定義ファイル
    ├── settings.json        — プロジェクト共通設定（コミット可）
    ├── settings.local.json  — 個人設定（.gitignore に入れる）
    └── skills/              — プロジェクト用スキル

04設定ファイル

settings.json

優先順位は local > project > user：

確認なしで実行を許可するコマンドの設定例：

{
  "permissions": {
    "allow": [
      "Bash(ls *)",
      "Bash(fd *)",
      "Bash(rg *)",
      "Bash(which *)"
    ]
  }
}

CLAUDE.md ── 人間が書く基本ルール

Markdown でルールを書いておくと、セッション開始時に自動で読み込まれる。

書き方の例：

# CLAUDE.md

## 基本方針
- 回答・説明は日本語で可能な限り簡潔に。
- 20行を超える修正は、修正前に対象ファイルと方針を提示して確認する。
- 命じられた指示以外のリファクタリングを行う際は確認する。
- .env ファイルの中身は絶対に参照しないこと。

## 開発ルール
- コーディングスタイルは PEP 8 に従う。
- 既存の設計・命名・フォーマットを優先する。

## テストルール
- 修正コードに pylint で構文チェック、flake8 でスタイルチェック。
- test フォルダ配下にテストコードを作成し pytest でユニットテスト。

## その他
- 勝手に commit / push しない。

MEMORY.md / auto memory ── Claudeが自分で書くメモ

v2.1.59（2026年2月）で導入された auto memory の中核ファイル。Claude は作業中に「build コマンド」「デバッグの発見」「コードスタイルの好み」などを自動的に記録し、次のセッションで読み込む。デフォルト ON。

格納場所：

~/.claude/projects/<project-path-hyphenated>/memory/MEMORY.md

主な操作：

• /memory でファイルを開いて確認・編集・auto memory のトグル
• 設定で無効化したい場合は settings.json に "autoMemoryEnabled": false

05拡張機能の6種類

Claude Code には大きく6種類の拡張ポイントがある。プラグインはこれらをまとめて1パッケージにしたもの。

① フック (hooks)

特定イベント発生時にシェルコマンドを実行。~/.claude/settings.json：

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/log.sh" }
        ]
      }
    ]
  }
}

#!/usr/bin/env bash
# ~/.claude/hooks/log.sh
echo "[HOOK] Claude Code executed at $(date)" >> ~/.claude/hooks.log

② カスタムコマンド (commands)

<project>/.claude/commands/<name>.md  ← プロジェクト用
~/.claude/commands/<name>.md          ← 個人用

セッション中に /<name> で呼べる。例：

---
description: 今日行った強化ポイントを説明する
---
今日行った強化や修正のサマリを説明してください。

③ スキル (skills / SKILL.md)

コマンドの上位互換。フォルダ内にスクリプトを置いて SKILL.md から呼べる。Claude が必要と判断すると自動で呼び出すのがコマンドとの最大の違い。

<project>/.claude/skills/<name>/SKILL.md
~/.claude/skills/<name>/SKILL.md

④ サブエージェント (agents)

特定タスク用に切り出した専門 Claude。

<project>/.claude/agents/<name>.md
~/.claude/agents/<name>.md

/agents コマンドで対話的に作成・実行可能。自然言語呼び出しや自動呼び出しにも対応。

⑤ コネクタ (MCP サーバー)

# 対話的に追加
claude mcp add <name>

# JSON で直接指定（v2.1.1+）
claude mcp add-json weather \
  '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# 一覧・削除・確認
claude mcp list
claude mcp remove <name>
claude mcp get <name>

--scope フラグで保存先を切り替え：

設定ファイルを直書きする場合：

{
  "mcpServers": {
    "my-http-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    },
    "my-stdio-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@some/mcp-package"]
    }
  }
}

セッション内では /mcp で接続状況を確認できる。

⑥ LSP サーバー

2016年に Microsoft が提唱した Language Server Protocol。型情報・補完候補・呼び出し関係などを言語非依存で提供する。Claude Code が自前で言語解析するより LSP に問い合わせる方が速く正確で、思考トークンも節約できる。

Python 用 pyright-lsp の導入例：

# 1. nodejs / npm を導入
sudo dnf -y install nodejs npm   # RHEL系
sudo apt -y install nodejs npm   # Debian系

# 2. pyright をインストール
npm install -g pyright

# 3. Claude Code 内で
/plugin                          # 「lsp」で検索
                                 # pyright-lsp を選択してインストール
/reload-plugins
/plugin                          # Installed タブで enabled を確認

⑦ プラグイン (plugins)

①〜⑥をまとめてパッケージ化したもの。

<plugin-name>/
├── .claude-plugin/      — plugin.json（メタ情報）
├── settings.json
├── bin/                 — 呼び出し可能コマンド
├── hooks/
├── commands/
├── skills/
├── agents/
├── .mcp.json            — コネクタ
├── .lsp-json/           — LSP
└── monitors/            — バックグラウンドモニター

06スラッシュコマンド一覧

セッション中、プロンプト欄で / から始まる。環境やプラン、モデルによって表示されないものもある。

終了

会話履歴

セッション管理

注意：rm 等で外部に影響した結果は巻き戻し不可。

設定系

情報表示系

認証・アカウント

コード管理・レビュー

プランニング・タスク管理

クラウド・リモート機能

拡張機能・統合

スケジュール・自動化

学習・サポート

外部連携セットアップ

その他

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

08/config の主な設定項目

09claude コマンドのオプション

10運用 Tips

確認プロンプトを減らす

毎回 Yes を返すのが面倒な時は Shift+Tab で確認モードをトグル：

1. default（毎回確認）
2. accept edits（編集は確認なし）
3. plan mode（計画のみ、編集なし）

/fewer-permission-prompts で過去履歴を分析し、settings.json に追記すべき許可リストを提案してくれる機能もある。

前日の続きから再開

claude -c              # 直前のセッション継続
claude --resume        # 一覧から選択
claude --resume <ID>   # ID 指定

セッション中なら /resume でも可。

タスクの終了をスマホから監視

時間がかかる処理を依頼したら：

/remote-control     # または /rc

URL が発行されるので、claude.ai/code やスマホ Claude アプリからセッション状況を確認できる。スマホアプリは左上 ☰ → コード で一覧表示。

Claude Code on the Web

• ブラウザで claude.ai/code にアクセス
• 左メニュー [カスタマイズ] → [コネクタ] で GitHub 連携必須
• リポジトリは Anthropic クラウド VM 上に展開されて動く
• ローカルマシン非依存なのでスマホからも操作可

auto memory の活用

fast モードの注意点

• /fast は Opus 4.6 / 4.7 専用。Sonnet や Haiku では効かない
• 2.5倍速だが料金は約6倍（$30 / $150 per MTok）
• セッション途中で ON にすると、それまでの全コンテキストに高額レートが適用される。必要ならセッション開始時に ON
• 固定プランの上限消費には含まれず、別途従量課金扱い

詰まったときの参照先

• 公式ドキュメント：https://code.claude.com/docs/en/overview
• リリースノート：/release-notes
• インストール診断：claude doctor
• 不明な挙動：Claude 本人に「○○の使い方教えて」と聞くのが最速