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 auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLIフラグ

3. Slash Commands

カスタムコマンド: .claude/commands/my-command.md（プロジェクト）または~/.claude/commands/my-command.md（個人）を作成し、/my-commandで呼び出します。コマンドは、説明、許可ツール、モデル上書き、$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. キーボードショートカット

一般操作

クイックプレフィックス

複数行入力

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

完全な設定スキーマについては、フルガイドの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を無駄に消費します。箇条書き、表、短いコードブロックを使ってください。長い段落は避けましょう。Claudeは各セッションの開始時にCLAUDE.mdを読むため、すべての単語がcontextを消費します。

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

8. Permission Modes

Auto Mode（v2.1.85+）は、--dangerously-skip-permissionsの推奨代替です。読み取り専用操作とファイル編集は自動承認されます。カスタムのallow/denyルールが先に解決されます。それ以外は安全性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ツールのcommandsは、Bash commandsと同じようにpermission modeで自動承認されます。PowerShell(Get-*:*)のようなallowルールを使うと、読み取り専用操作の確認をバイパスできます。

9. Hook Events

| InstructionsLoaded | CLAUDE.mdが読み込まれたとき | いいえ | | ConfigChange | セッション中にconfigファイルが変更されたとき | はい | | WorktreeCreate | Worktreeが作成されるとき | はい | | WorktreeRemove | Worktreeが削除されるとき | いいえ | | PreCompact | context compactionの前 | いいえ | | PostCompact | context compactionの後 | いいえ | | Elicitation | MCPが構造化入力を要求したとき | はい | | ElicitationResult | ユーザーがMCP dialogに応答したとき | はい | | StopFailure | APIエラーによりturnが終了したとき | いいえ | | PermissionRequest | Permission 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 Configuration

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オブジェクトに"async": trueを追加してください。²

Hook output / input fields:

• PostToolUse / PostToolUseFailure hook inputのduration_ms（v2.1.119+）— permission promptsとPreToolUse hooksを除いたツール実行時間です。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）— 任意のツールの出力を置き換えます（v2.1.118ではMCPのみで導入され、v2.1.121で全toolsへ拡張されました）。
• 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+）— ブロック理由をClaudeへ戻し、turnを継続します。
• agent hook inputのsubagent_type（v2.1.140+）— 実行中のagent typeを識別します。

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

1つのcommandでMCP serverを追加します。

# 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

Scope control:

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

Project .mcp.json example:

{
  "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は現在、月間download数が1億件、indexed serversが3,000以上あります。³ Transport types、elicitation、tool search設定については、完全版ガイドのMCP sectionをご覧ください。

alwaysLoad（v2.1.121+）: 信頼済みserverをTool Search deferralの対象外にします。そのserverのすべてのtoolsはsession開始時に読み込まれ、ToolSearch round-tripは不要です。

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

Auto-retry（v2.1.121+）: 起動中にerrorになったMCP serversは、disconnectedとマークされる前に最大3回retryされます。

SDK mcp_authenticate redirectUri（v2.1.121+）: Custom URI schemesでOAuthを完了するために必要です。desktop appsとclaude.ai connector flowsで使います。

11.5. Plugin CLI Commands

12. Subagent の種類

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

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

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

現在のリリースでは、claude agents で Agent View が開きます。これは、実行中、ブロック中、完了済みの Claude Code sessions を扱う research-preview の運用画面です。監視には使えますが、作業が品質ゲートを通過した証拠としては使わないでください。⁶

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

モデル設定

Cloud Providers

動作制御

Tool 設定

ネットワークとプロキシ

完全なリストは、フルガイドの Environment Variables をご覧ください。

14. コスト参照

100万 tokens あたりの料金（2026年4月時点）。⁵

典型的な session では、入力 tokens を 50K-200K、出力 tokens を 10K-50K 消費します。Haiku session は $0.10-$0.45、Opus session は $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 以降が必要です。adaptive reasoning のみを使用します（固定の thinking budgets はありません）。新しい xhigh effort level は、Opus 4.7 の coding/agentic workloads で既定です。

session 中にモデルを切り替える:

/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 に任せます。コスト重視の日常的な coding には Sonnet を使います。難しい reasoning、architecture、agentic loops、security analysis には Opus を使います。複雑な refactoring には opusplan を使います（Opus が計画し、Sonnet が実行）。

15. 主要ファイルの場所

16. 変更履歴

17. 参照

この cheat sheet は、完全版 Claude Code CLI ガイドのクイック参照版です。セットアップの手順は、Claude Code quickstartをご覧ください。特に iOS と macOS プロジェクトについては、iOS Agent Development guide、XcodeBuildMCP integration patterns、Apple Ecosystem Seriesを参照してください。最終更新日：2026年5月13日。