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 Flags

3. Slash Commands

Custom commands: .claude/commands/my-command.md（プロジェクト）または ~/.claude/commands/my-command.md（個人）を作成し、/my-command で呼び出します。Commands は、説明、許可ツール、モデル上書き、$ARGUMENTS または位置引数 $1、$2 による引数補間のための YAML frontmatter に対応しています。

---
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. Keyboard Shortcuts

一般操作

Quick Prefixes

複数行入力

キーバインドは /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.118+）:

完全な設定 schema については、フルガイドの Configuration Deep Dive をご覧ください。

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

ざっと読める状態にしておきましょう。密度の高い長文は、毎セッションで context tokens を消費します。箇条書き、表、短い code blocks を使ってください。長い段落は避けましょう。Claude は各セッションの開始時に CLAUDE.md を読むため、すべての単語が context を消費します。

Pro tips: - CLAUDE.md を編集せずに auto-memory へ追加するには、REPL で # プレフィックスを使います: # Always use TypeScript strict mode - サブディレクトリ内の CLAUDE.md は、Claude がそのディレクトリ内のファイルを読むときに読み込まれます - チーム共有のルールは、モジュール化しやすいように .claude/rules/*.md に置きます

8. 権限モード

Auto Mode（v2.1.85+）は、--dangerously-skip-permissions の推奨代替です。読み取り専用操作とファイル編集は自動承認されます。カスタムの許可/拒否ルールが先に解決されます。それ以外は safety classifier に送られます。デフォルトで自動ブロックされるもの: curl | bash、main への force-push、本番 deploy、大量の cloud 削除、IAM 変更、機密データの外部送信。¹

Circuit breaker: 1 セッション内で 3 回連続ブロック、または合計 20 回ブロックされると、手動確認に戻って一時停止します。

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

PowerShell 自動承認（v2.1.119+）: PowerShell ツールコマンドは、Bash コマンドと同じように permission mode で自動承認されます。PowerShell(Get-*:*) のような許可ルールを使うと、読み取り専用操作の確認を省略できます。PowerShell を多用する workflow では v2.1.149+ を使ってください。組み込み cd の permission bypass、prefix/wildcard allow-rule matching、古い directory variable tracking が修正されています。

9. Hook Events

| InstructionsLoaded | CLAUDE.md が読み込まれたとき | いいえ | | ConfigChange | セッション中に設定ファイルが変更されたとき | はい | | WorktreeCreate | Worktree が作成されるとき | はい | | WorktreeRemove | Worktree が削除されるとき | いいえ | | PreCompact | context compaction の前 | いいえ | | PostCompact | context compaction の後 | いいえ | | Elicitation | MCP が構造化入力を要求したとき | はい | | ElicitationResult | ユーザーが MCP dialog に応答したとき | はい | | StopFailure | API error により turn が終了したとき | いいえ | | PermissionRequest | 権限 dialog が表示されたとき | はい | | PermissionDenied | Auto mode がアクションを拒否したとき（v2.1.88+） | いいえ | | CwdChanged | 作業ディレクトリが変更されたとき（v2.1.83+） | いいえ | | FileChanged | 監視対象ファイルが外部で変更されたとき（v2.1.83+） | いいえ | | TaskCreated | 新しい task が作成されたとき（v2.1.84+） | いいえ | | TeammateIdle | Agent team member が idle になったとき | はい | | TaskCompleted | Task が完了としてマークされたとき | はい |

完全な hook protocol（input/output JSON、matchers、exit codes）については、フルガイドの Hooks Deep Dive をご覧ください。

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

Matcher 構文:

Exit codes:

Async hooks はブロックせずにバックグラウンドで実行されます。hook object に "async": true を追加してください。²

Hook output / input fields:

• PostToolUse / PostToolUseFailure hook input の duration_ms（v2.1.119+）— permission prompts と PreToolUse hooks を除いたツール実行時間です。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）— 任意のツールの tool output を置き換えます（v2.1.118 では MCP のみに導入され、v2.1.121 で全ツールに拡張されました）。
• hookSpecificOutput.sessionTitle（v2.1.96+）— UserPromptSubmit hook から session title を設定します。
• command hooks の args: string[]（v2.1.139+）— shell quoting なしで構造化 argv を渡します。
• PostToolUse hooks の continueOnBlock（v2.1.139+）— block reason を Claude に戻し、turn を続行します。
• agent hook input の subagent_type（v2.1.140+）— 実行中の agent type を識別します。
• hook JSON output の terminalSequence（v2.1.141+）— notifications、window titles、bells 用の terminal-control sequences を出力します。

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+）: カスタム URI スキームで OAuth を完了するために必要です。デスクトップアプリと claude.ai connector フローが対象です。

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

Custom subagents は、YAML frontmatter を持つ markdown ファイルとして .claude/agents/（プロジェクト）または ~/.claude/agents/（個人）に定義します。最大10個の subagents を並列実行できます。⁴

claude agents は現在のリリースで Agent View を開きます。これは、実行中、ブロック中、完了済みの Claude Code セッションを扱う research-preview の運用画面です。claude agents --cwd <path> はビューを1つのディレクトリにスコープします（v2.1.141+）。v2.1.142 では background sessions 用の dispatch flags が追加され、v2.1.143 ではそれらの flags が dashboard と background sessions に一貫して適用されます: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions。v2.1.144 では background sessions の /resume サポートが追加され、bg でマークされます。v2.1.145 では claude agents --json、awaiting-input タブ数、Agent View の reply-pane 修正が追加されます。v2.1.147 では、アイドル時も生存し続け、更新時に同じ場所で再起動する pinned background sessions が追加されます。Agent View は監視に使うものであり、作業が品質ゲートを通過した証拠としては使わないでください。⁶

Custom agent frontmatter フィールド:

Custom 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

Model 設定

Cloud Providers

動作制御

Tool 設定

Network と Proxy

完全な一覧は、完全版ガイドの Environment Variables をご覧ください。

14. コスト参照

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

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

プラン別のデフォルトモデル（2026年4月16日時点のClaude Code）：

• Max、Team Premium → Opus 4.7
• Pro、Team Standard、Enterprise、Anthropic API → Sonnet 4.6（Enterprise + API は2026年4月23日にOpus 4.7へ切り替わります）
• Bedrock、Vertex、Foundry → Sonnet 4.5（新しいモデルは ANTHROPIC_DEFAULT_OPUS_MODEL で固定します）

Opus 4.7にはClaude Code v2.1.111以降が必要です。固定のthinking budgetはなく、adaptive reasoningのみを使用します。Opus 4.7では、コーディングやagentic workload向けのデフォルトとして、新しい xhigh effortレベルが使われます。

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

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

判断ルール： シンプルな探索はHaikuを使います。コストを抑えたい日常的なコーディングはSonnetです。難しい推論、アーキテクチャ、agentic loop、セキュリティ分析にはOpusを使います。複雑なリファクタリングでは opusplan を使います（Opusが計画し、Sonnetが実行します）。

15. 主要ファイルの場所

16. 変更履歴

17. 参照

このチートシートは、完全版 Claude Code CLI ガイドのクイック参照用コンパニオンです。セットアップの手順は、Claude Code quickstartをご覧ください。iOS と macOS プロジェクトについては、iOS Agent Development ガイド、XcodeBuildMCP 連携パターン、Apple Ecosystem Seriesも参照してください。最終更新日: 2026年5月24日。