Claude Codeの使い方完全ガイド【2026年最新】：基本操作・CLAUDE.md・VSCode・サブエージェントまで徹底解説

Claude Codeの使い方完全ガイド【2026年最新】：基本操作・CLAUDE.md・VSCode・サブエージェントまで徹底解説

Claude Codeの基本的な起動と初期操作

# プロジェクトディレクトリに移動してから起動
cd /path/to/your-project
claude

ターミナルから直接コマンドを実行する方法

# コマンドラインから直接指示を渡す（非インタラクティブモード）
claude "このリポジトリの構造を説明してください"

# ファイルをパイプで渡す
cat error.log | claude "このエラーの原因と解決方法を教えて"

# 出力をファイルに保存
claude "README.mdを書いて" > README.md

知っておきたいビルトインコマンド一覧

CLAUDE.mdの使い方：Claudeに自分のルールを覚えさせる

CLAUDE.mdを作成する場所

効果的なCLAUDE.mdの書き方

# PROJECT CONTEXT
このプロジェクトはNext.js + TypeScript + Supabaseで構築されたSaaSアプリです。

## ARCHITECTURE
- フロントエンド: Next.js 15 (App Router)
- データベース: Supabase (PostgreSQL)
- 認証: Supabase Auth

## CODING STANDARDS
- TypeScriptのstrict modeを有効にすること
- コンポーネントはServer Componentsを優先
- APIルートはZodでバリデーションを入れる

## WORKFLOW RULES
- コードを変更したら必ずテストを実行すること
- コミットメッセージは日本語で書くこと
- 新しいファイルを作るときはインポートパスを確認すること

## COMMON COMMANDS
- 開発サーバー起動: npm run dev
- テスト実行: npm run test
- ビルド: npm run build

.claude/rules/ でルールをパス別に管理する

Auto memoryとの使い分け

Plan Modeを使った安全なコード変更

Plan Modeの起動方法

# ターミナル起動時にPlan Modeで始める
claude --permission-mode plan

Plan Modeを活用した4ステップワークフロー

コードベース調査での使い方

新しいコードベースの把握方法

# 1. プロジェクトルートで起動
cd /path/to/project
claude

# 2. 全体構造の把握
> このプロジェクトの構造と主要なコンポーネントを説明して

# 3. 特定の機能の調査
> 認証の仕組みはどう実装されているか教えて

# 4. 依存関係の確認
> このプロジェクトの主要な外部ライブラリと、それぞれの役割を説明して

Gitとの連携

# Claude Codeにコミットを頼む
> 今の変更内容を見て、適切なコミットメッセージでコミットを作って

# PRの作成もお任せ
> 今のブランチをdevelopにマージするPRを作って。変更内容を説明するPR本文も書いて

VSCodeでのClaude Codeの使い方

VSCode拡張機能のインストール方法

VSCode拡張機能 vs CLIターミナルの違い

CursorでのClaude Codeの使い方

サブエージェントの使い方

サブエージェントの確認・使い方

# サブエージェント一覧を確認
/agents

# サブエージェントに作業を依頼（Claudeが自動でルーティング）
> セキュリティの観点から最近のコード変更をレビューして

Git Worktreeを使った並列作業

# 新しいworktreeを作成
git worktree add ../feature-auth -b feature/auth

# 別ターミナルで別のセッションを起動
cd ../feature-auth
claude

# 元のディレクトリでも別のセッションを維持

Hooksの使い方：Claude Codeに自動処理を追加する

Hooksの設定方法

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm test"
          }
        ]
      }
    ]
  }
}

Hooksの活用パターン

Skillsの使い方：Claude Codeに専門能力を追加する

Skillsの作り方と使い方

# PDF Converter Skill

Use this skill when the user asks to convert documents to PDF.

## Steps
1. Check if the file exists
2. Run the conversion command: `convert {input} {output.pdf}`
3. Verify the output file was created
4. Report success or errors

初心者・非エンジニアのためのClaude Code使い方

非エンジニアでも使えるユースケース

• 既存コードの動作説明（「このコードは何をしているの？」）
• エラーメッセージの解釈（ログファイルをpipeで渡す）
• ドキュメント生成（READMEや仕様書を自動生成）
• 設定ファイルの変更（JSON・YAMLの書き換え）
• CSVやJSONの変換・加工

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

• 具体的にゴールを伝える: 「修正して」より「〇〇というエラーが出ているので直して」
• 成功基準を伝える: 「テストが通ること」「〇〇の動作が確認できること」
• 参照ファイルを指定する: 「@auth.ts を参照して」
• 変えてほしくないことを書く: 「既存のAPIの互換性は維持して」

MacとWindowsでの使い方の違い

Mac（macOS）での使い方

# Macでの起動（ターミナルで）
cd ~/projects/my-app
claude

Windowsでの使い方

# WSL2のセットアップ（管理者PowerShellで）
wsl --install

# WSLでclaudeを起動
wsl
cd ~/projects/my-app
claude

Extended Thinking（思考モード）の使い方

# Extended Thinkingを使った質問
claude --thinking "このアーキテクチャの設計上の問題点を深く分析して"

料金を抑えたClaude Codeの使い方

実践的なClaude Code活用ワークフロー

新機能開発のワークフロー

• Step 1（探索）: Plan ModeでAPIの現状を把握させる
  • 「認証周りのコードを読んで、現状のアーキテクチャを理解して」
• Step 2（計画）: 変更箇所の洗い出し
  • 「新しい/api/users/profileエンドポイントを追加するとしたら、どのファイルを変更する必要があるか計画して」
• Step 3（実装）: Normal Modeに切り替えて実装
  • 「計画に従って実装して。完成したらテストを実行して確認して」
• Step 4（コミット）: PRの作成
  • 「コミットを作ってPRを作成して」

バグ修正のワークフロー

• エラーログ・スタックトレースをコピーしてClaudeに渡す
• 「このエラーの原因を特定して、修正してください」
• 修正後に「テストを実行して確認して」とお願いする

よくある質問（FAQ）

Claudeが間違えたときはどうすればいい？

コンテキストが長くなると精度が落ちる？

日本語での指示と英語での指示、どっちがいい？

まとめ：Claude Codeの使い方をマスターするための順番

1. 基本操作（起動・日本語指示・ビルトインコマンド）
2. CLAUDE.mdの設定（プロジェクトのルール・コマンドを書く）
3. Plan Modeの習慣化（大きな変更は計画してから実行）
4. VSCode連携（拡張機能でdiffを確認しながら作業）
5. サブエージェント・Hooks・Skills（高度な自動化・専門化）

出典

• Claude Code - Common Workflows（Anthropic公式）
• Claude Code - Memory（Anthropic公式）
• Claude Code - Best Practices（Anthropic公式）
• Claude Code - Hooks Reference（Anthropic公式）
• Claude Code - VS Code Integration（Anthropic公式）