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. スラッシュコマンド

カスタムコマンド： プロジェクト用には.claude/commands/my-command.md、個人用には~/.claude/commands/my-command.mdを作成し、/my-commandで呼び出します。コマンドではYAMLフロントマターを使って、説明、許可するツール、モデルの上書きを指定できます。また、$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
  },
  "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 は各セッションの開始時にこのファイルを読み込みます。

配置場所：

AGENTS.md（v2.1.277以降）： CLAUDE.md がないプロジェクトでは、Claude Code が代わりに AGENTS.md を読み込みます。この動作は /config の「Project instructions」で変更できます（Bedrock/Vertex/Foundryではまだ利用できません）。

記載する内容：

# 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以降）は、2026年8月14日以降、Pro、Max、Team プランの新規セッションにおけるデフォルトの権限モードです（自分で設定した defaultMode は、1回限りの切り替えプロンプトを承認するまで維持されます。disableAutoMode で組織全体に対して無効化できます）。--dangerously-skip-permissions に代わる推奨モードです。読み取り専用操作とファイル編集は自動承認されます。v2.1.281以降は分類器による確認がサーバー側で実行されるため、読み取り専用操作とサンドボックス化されたシェルコマンドも判定を待ち、危険と判断されるとブロックされます。カスタムの allow/deny ルールが先に適用され、それ以外はすべて安全性分類器で判定されます。デフォルトで自動ブロックされる操作：curl | bash、main への強制プッシュ、本番環境へのデプロイ、クラウド上での一括削除、IAM の変更、機密データの外部送信。¹

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

無人モードでの危険な rm（v2.1.281）： auto モードと --dangerously-skip-permissions では、危険な rm の確認プロンプトが2分間待機した後、書き換えのヒントとともにコマンドを拒否し、セッションを続行します。rm -rf "$(pwd)" のように、対象がコマンド置換の出力だけで構成される再帰的な rm は、Bash の allow ルールがあっても確認を求めるようになりました。

# 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 Events

| 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 モードが操作を拒否したとき（v2.1.88以降） | いいえ | | CwdChanged | 作業ディレクトリが変更されたとき（v2.1.83以降） | いいえ | | FileChanged | 監視対象のファイルが外部から変更されたとき（v2.1.83以降） | いいえ | | TaskCreated | 新しいタスクが作成されたとき（v2.1.84以降） | いいえ | | TeammateIdle | Agent team のメンバーがアイドル状態になったとき | はい | | TaskCompleted | タスクが完了としてマークされたとき | はい |

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

10. Hook の設定

Hook は 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"
          }
        ]
      }
    ]
  }
}

Matcher の構文：

終了コード：

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

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

• PostToolUse／PostToolUseFailure の hook 入力に含まれる duration_ms（v2.1.119以降）— 権限プロンプトと PreToolUse hook を除いたツール実行時間です。
• hookSpecificOutput.updatedToolOutput（v2.1.121以降）— 任意のツールの出力を置き換えます（v2.1.118では MCP のみに導入され、v2.1.121ですべてのツールに拡張されました）。
• hookSpecificOutput.sessionTitle（v2.1.96以降）— UserPromptSubmit hook からセッションタイトルを設定します。
• コマンド hook の args: string[]（v2.1.139以降）— シェルのクォート処理を使わず、構造化された argv を渡します。
• PostToolUse hook の continueOnBlock（v2.1.139以降）— ブロック理由を Claude に返し、ターンを続行します。
• Agent hook 入力の subagent_type（v2.1.140以降）— 実行中の Agent タイプを識別します。
• 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以降）： 信頼できるサーバーを Tool Search の遅延読み込み対象から除外します。そのサーバーのすべてのツールがセッション開始時に読み込まれ、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以降）： デスクトップアプリや claude.ai のコネクターフローなど、カスタム URI スキームで 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年9月時点）。⁵

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

Claude Codeのデフォルトモデル（プラン別）： v2.1.280（2026年9月22日）以降、すべてのプランでOpusがデフォルトです。ProとTeam StandardがSonnetからOpusへ移行し、Max、Team Premium、Enterpriseと統一されました。デフォルトのOpusモデルはOpus 5.5（claude-opus-5-5）で、現在はopusエイリアスもこのモデルを参照します。v2.1.251での分割（プレミアムプランはOpus 5、Pro/Team StandardはSonnet 5）や、v2.1.197ですべてのプランがSonnet 5をデフォルトとしていた構成は過去のものです。管理者は組織全体のデフォルトを設定でき、/modelには「Org default」と表示されます（v2.1.196以降）。AWS上のClaude Platform、Amazon Bedrock、Google CloudのAgent PlatformもOpus 5.5がデフォルトです。唯一の例外はMicrosoft Foundryで、デフォルトはSonnet 4.5となり、opusがOpus 4.6を参照する唯一の環境です。特定のモデルを固定するには、ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODELを使用します。

Opus 5.5、Sonnet 5、Opus 5、Opus 4.8、Fable 5、Fable 5.1では、適応型推論のみを使用します（固定の思考バジェットはありません）。最も難しいコーディングやエージェント型タスクには、/effort xhighを使用します。これらのモデルではeffortのデフォルトがhighですが、Opus 5.5だけはmediumがデフォルトです。また、v2.1.280以降、/effortがモデルごとの設定になる前に保存したeffortレベルは、Opus 5.5のような新しくリリースされたモデルには引き継がれません。レベルを選択するまでは、そのモデル固有のデフォルトで開始します。Opus 5.5およびFableモデルでは思考を無効にできません（MAX_THINKING_TOKENS=0も効果がありません）。Opus 4.8と比較したOpus 5の破壊的変更： thinkingフィールドを省略したリクエストでは、思考がデフォルトで有効になります。また、effortがxhighまたはmaxのときにthinking: {type: "disabled"}を指定すると、400エラーが返されます。

Fast mode（/fast）は、Opus 5.5、Opus 5、Opus 4.8で利用できます。v2.1.280以降はOpus 5.5がデフォルトです。料金は、Opus 5.5でMTokあたり$8 / $40、Opus 5と4.8で$10 / $50（いずれも基本料金の2倍）で、1秒あたりの出力トークン数が最大2.5倍になります。Opus 4.7は削除されました。claude-opus-4-7とspeed: "fast"を組み合わせると、標準速度へフォールバックせずエラーになります。Research previewであり、Claude APIとサブスクリプションでのみ利用できます（Bedrock/Vertex/Foundry、およびAWS上のClaude Platformでは利用できません）。速度を切り替えると、プロンプトキャッシュが無効になります。v2.1.271以降、fast modeはClaude Code Remoteセッション（クラウドおよびセルフホスト型ランナー）でも利用できます。組織で許可されている場合、ホスト側のfast-mode設定またはセッション内で入力した/fastが適用されます。

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

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/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 Development ガイド、XcodeBuildMCP 連携パターン、Apple Ecosystem シリーズもご参照ください。最終更新日：2026年7月17日。