Claude Codeチートシート：コマンド、設定、ショートカット

CLIのフラグ、スラッシュコマンド、キーボードショートカット、設定キー、フックイベント、環境変数を一か所にまとめました。詳しい解説はClaude Codeガイド全文をご覧ください。初めてセットアップする方はクイックスタートを参照してください。

1. インストール

推奨順に、3つのインストール方法があります。

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

特定のバージョンをインストールします。

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

インストールを確認します。

claude doctor
claude --version

認証します。

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLI フラグ

v2.1.212で追加されたサブコマンド： claude auto-mode resetを実行すると、ターミナルからauto-modeの状態をリセットできます。確認プロンプトを省略するには--yesを指定します。⁷

3. Slash Commands

カスタムコマンド： .claude/commands/my-command.md（プロジェクト）または~/.claude/commands/my-command.md（個人）を作成し、/my-commandで呼び出します。コマンドではYAML frontmatterを使用して、説明、許可するツール、モデルの上書き、$ARGUMENTSまたは位置引数$1、$2による引数展開を設定できます。

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

使用例：/fix-issue 123

4. キーボードショートカット

基本操作

クイックプレフィックス

複数行入力

キーバインドは/keybindingsからカスタマイズできます（~/.claude/keybindings.jsonに保存）。

5. 設定ファイル

優先順位（高い順）

最初に一致した設定が適用されます。Enterprise設定を回避することはできません。

6. Settings.json リファレンス

主な設定項目を型と例とともに示します。上記の階層にある任意の設定ファイルに記述できます。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

権限ルールの構文： Tool(pattern:*) では前方一致が適用されます。Bash(npm run test:*) は、npm run test、npm run test:unit などを許可します。ファイルパターンには glob 構文を使用します（Edit(src/**)）。v2.1.214 以降、単一セグメントの dir/** allow ルールが一致するのは <cwd>/dir のみです。ツリー内の任意の場所にある dir/ には一致しなくなりました。深さを問わず一致させるには Edit(**/src/**) と記述してください。deny／ask ルールでは深さを問わない一致が維持され、hook の if: 条件にも同じ cwd スコープが適用されます。

新しいキー（v2.1.118 以降）：

設定スキーマの全項目については、完全版ガイドの設定の詳細解説をご覧ください。

7. CLAUDE.md クイックリファレンス

CLAUDE.md は、プロジェクト用の指示ファイルです。Claude は各セッションの開始時にこのファイルを読み込みます。

配置場所：

記載する内容：

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

ひと目で把握できる内容にしましょう。密度の高い文章は、セッションごとにコンテキストトークンを浪費します。箇条書き、表、短いコードブロックを使用してください。長い段落は避けましょう。Claude は各セッションの開始時に CLAUDE.md を読み込むため、すべての単語がコンテキストを消費します。

活用のヒント： - CLAUDE.md を編集せずに自動メモリへ項目を追加するには、REPL で # プレフィックスを使用します：# Always use TypeScript strict mode - サブディレクトリ内の CLAUDE.md は、Claude がそのディレクトリのファイルを読み込む際に読み込まれます - チームで共有するルールは、モジュール単位で整理できる .claude/rules/*.md に配置します

8. 権限モード

Auto Mode（v2.1.85 以降）は、--dangerously-skip-permissions の後継として推奨されるモードです。読み取り専用操作とファイル編集は自動承認されます。カスタムの allow／deny ルールが先に評価され、それ以外はすべて安全性分類器で審査されます。デフォルトで自動ブロックされる操作には、curl | bash、main への force-push、本番環境へのデプロイ、クラウドリソースの一括削除、IAM の変更、機密データの外部送信があります。¹

サーキットブレーカーにより、3回連続または1セッションで合計20回ブロックされると一時停止し、手動確認へ戻ります。

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

PowerShell の自動承認（v2.1.119 以降）： PowerShell ツールのコマンドも、Bash コマンドと同じように権限モードで自動承認されます。PowerShell(Get-*:*) のような allow ルールを指定すると、読み取り専用操作の確認を省略できます。PowerShell を多用するワークフローでは、v2.1.149 以降を使用してください。組み込みの cd による権限回避、プレフィックス／ワイルドカードを使った allow ルールの一致、古いディレクトリ変数の追跡に関する問題が修正されています。

9. Hook イベント

| InstructionsLoaded | CLAUDE.md の読み込み時 | いいえ | | ConfigChange | セッション中に設定ファイルが変更されたとき | はい | | DirectoryAdded | /add-dir または SDK の register_repo_root により、セッション中に作業ディレクトリが追加されたとき（v2.1.219 以降） | いいえ | | WorktreeCreate | Worktree の作成時 | はい | | WorktreeRemove | Worktree の削除時 | いいえ | | PreCompact | コンテキスト圧縮の前 | いいえ | | PostCompact | コンテキスト圧縮の後 | いいえ | | Elicitation | MCP が構造化入力を要求したとき | はい | | ElicitationResult | ユーザーが MCP のダイアログに応答したとき | はい | | StopFailure | API エラーによりターンが終了したとき | いいえ | | PermissionRequest | 権限ダイアログが表示されたとき | はい | | PermissionDenied | Auto mode が操作を拒否したとき（v2.1.88 以降） | いいえ | | CwdChanged | 作業ディレクトリが変更されたとき（v2.1.83 以降） | いいえ | | FileChanged | 監視対象ファイルが外部から変更されたとき（v2.1.83 以降） | いいえ | | TaskCreated | 新しいタスクが作成されたとき（v2.1.84 以降） | いいえ | | TeammateIdle | エージェントチームのメンバーが待機状態になったとき | はい | | TaskCompleted | タスクが完了としてマークされたとき | はい |

hook プロトコルの全仕様（入出力 JSON、マッチャー、終了コード）については、完全版ガイドのHooks の詳細解説をご覧ください。

10. Hook の設定

Hooks は settings.json または専用の hooks.json に記述します。最小構成の例は次のとおりです。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

マッチャーの構文：

終了コード：

非同期 hooks は、処理をブロックせずバックグラウンドで実行されます。hook オブジェクトに "async": true を追加してください。²

Hook の出力／入力フィールド：

• PostToolUse／PostToolUseFailure の hook 入力にある duration_ms（v2.1.119 以降）— 権限確認と PreToolUse hooks を除いたツール実行時間です。
• hookSpecificOutput.updatedToolOutput（v2.1.121 以降）— 任意のツール出力を置き換えます（v2.1.118 では MCP のみに導入され、v2.1.121 で全ツールに拡張されました）。
• hookSpecificOutput.sessionTitle（v2.1.96 以降）— UserPromptSubmit hook からセッションタイトルを設定します。
• コマンド hooks の args: string[]（v2.1.139 以降）— シェルのクォート処理を使わず、構造化された argv を渡します。
• PostToolUse hooks の continueOnBlock（v2.1.139 以降）— ブロック理由を Claude に返し、ターンを続行します。
• エージェントの hook 入力にある subagent_type（v2.1.140 以降）— 実行中のエージェントタイプを識別します。
• hook の JSON 出力にある terminalSequence（v2.1.141 以降）— 通知、ウィンドウタイトル、ベル用の端末制御シーケンスを出力します。

11. MCP クイックセットアップ

1つのコマンドで MCP サーバーを追加できます。

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

スコープの制御：

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

プロジェクトの .mcp.json の例：

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP の月間ダウンロード数は現在1億回に達し、3,000以上のサーバーがインデックス化されています。³ 転送方式、elicitation、ツール検索の設定については、完全版ガイドの MCP セクションをご覧ください。

alwaysLoad（v2.1.121以降）： 信頼できるサーバーをツール検索による遅延読み込みの対象から除外します。そのサーバーのすべてのツールがセッション開始時に読み込まれ、ToolSearch の往復処理は発生しません。

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

自動再試行（v2.1.121以降）： 起動時にエラーが発生した MCP サーバーは、切断済みと判定される前に最大3回再試行されます。

SDK mcp_authenticate の redirectUri（v2.1.121以降）： カスタムURIスキーム（デスクトップアプリやclaude.aiのコネクターフロー）で OAuth を完了するために必要です。

11.5. Plugin CLI コマンド

12. Subagentの種類

Claude はsubagentsへ自動的に処理を委任します。明示的に依頼することもできます。

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

カスタムsubagentsは、YAML frontmatterを含むMarkdownファイルとして .claude/agents/（プロジェクト）または ~/.claude/agents/（個人用）に定義します。最大10個のsubagentsを並列実行できます。⁴

現在のリリースでは、claude agents を実行するとAgent Viewが開きます。これは、実行中、ブロック中、完了済みの Claude Code セッションを管理するためのリサーチプレビュー版画面です。claude agents --cwd <path> では表示対象を1つのディレクトリに限定できます（v2.1.141以降）。v2.1.142ではバックグラウンドセッション用のディスパッチフラグが追加され、v2.1.143では、--add-dir、--settings、--mcp-config、--plugin-dir、--permission-mode、--model、--effort、--dangerously-skip-permissions がダッシュボードとバックグラウンドセッションに一貫して適用されるようになりました。v2.1.144ではバックグラウンドセッションで /resume がサポートされ、bg マークが付くようになりました。v2.1.145では claude agents --json、入力待ちタブの件数表示、Agent Viewの返信ペインの修正が追加されました。v2.1.147では、アイドル時も維持され、更新時にその場で再起動する固定バックグラウンドセッションが追加されています。Agent Viewは監視に使用し、作業が品質ゲートを通過した証拠としては扱わないでください。⁶

カスタムagentのfrontmatterフィールド：

カスタムagentの例（.claude/agents/security-reviewer.md）：

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. 環境変数

認証とAPI

モデル設定

クラウドプロバイダー

動作制御

ツール設定

ネットワークとプロキシ

完全な一覧については、フルガイドの環境変数をご覧ください。

14. コスト一覧

100万トークンあたりの料金（2026年7月時点）。⁵

一般的なセッションでは、入力トークンを50K〜200K、出力トークンを10K〜50K消費します。Haikuのセッションは$0.10〜$0.45、Opusのセッションは$0.50〜$2.25です。

Claude Codeのデフォルトモデル（v2.1.197、2026年6月30日時点）： すべての新規セッションでSonnet 5が使用されます。ネイティブ1Mコンテキストに対応し、$2/$10の導入価格は8月31日まで適用されます。Opusへは/model opusを1回実行するだけで切り替えられ、v2.1.219以降、このエイリアスはOpus 5を指します。管理者は組織全体のデフォルトを設定でき、/modelには「Org default」と表示されます（v2.1.196以降）。Bedrock/Vertex/Foundryでは、ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODELを使って特定のモデルを固定してください。

Sonnet 5、Opus 5、Opus 4.8、Fable 5は、適応的推論のみに対応しています（固定の思考予算はありません）。すべてのモデルでeffortのデフォルトはhighです。特に難しいコーディングやエージェント型の作業には/effort xhighを使用します。Opus 5におけるOpus 4.8からの破壊的変更： thinkingフィールドを省略したリクエストでは、思考がデフォルトで有効になります。また、thinking: {type: "disabled"}にxhighまたはmaxのeffortを組み合わせると、400エラーが返されます。

Fast mode（/fast）はv2.1.219時点でOpus 5とOpus 4.8のみに適用されます。料金はMTokあたり$10 / $50（基本料金の2倍）で、出力トークンの生成速度は最大2.5倍です。Opus 4.7は削除されました。claude-opus-4-7とspeed: "fast"を指定すると、標準速度へフォールバックせずエラーになります。リサーチプレビューであり、Claude API限定です（Bedrock/Vertex/Foundryでは利用できません）。速度を切り替えるとプロンプトキャッシュが無効になります。

セッション中にモデルを切り替える：

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/effort xhigh     # Recommended for the hardest coding/agentic work

判断基準： 単純な調査にはHaiku、コストを重視する日常的なコーディングにはSonnet、難しい推論、アーキテクチャ、エージェント型ループ、セキュリティ分析にはOpusが適しています。複雑なリファクタリングにはopusplanを使用します（Opusが計画し、Sonnetが実行します）。

15. 主要なファイルの場所

16. 変更履歴

17. 参照

このチートシートは、Claude Code CLI 完全ガイドと併用できるクイックリファレンスです。セットアップ手順については、Claude Code クイックスタートをご覧ください。iOSおよびmacOSプロジェクトについては、iOS Agent 開発ガイド、XcodeBuildMCP の統合パターン、Apple Ecosystem シリーズをご覧ください。最終更新日：2026年7月17日。