# Claude Code クイックリファレンス

*CLI コマンド、ワークフロー、MCP、フック、設定*

> Source: Anthropic Claude Code Documentation (docs.anthropic.com) · MIT

## はじめに

### インストール & 起動

```
npm install -g @anthropic-ai/claude-code
claude            # start interactive session
claude --version  # check version
claude update     # update to latest
```

### 認証

```
claude login              # browser OAuth
export ANTHROPIC_API_KEY="sk-ant-..."
claude logout             # clear session
```

## スラッシュコマンド

### セッションコマンド

| Command | Description |
|---------|-------------|
| `/help` | 利用可能なコマンドを表示 |
| `/clear` | 会話履歴をクリア |
| `/compact` | コンテキストを圧縮してトークンを節約 |
| `/cost` | トークン使用量とコストを表示 |
| `/status` | セッション情報とモデルを表示 |
| `/new` | 新しい会話を開始 |
| `/config` | 設定を開く / 表示 |
| `/doctor` | 設定の問題を診断 |
| `/init` | プロジェクトの CLAUDE.md を作成 |
| `/login` | Anthropic で認証 |
| `/logout` | 認証をクリア |

### ワークフローコマンド

| Command | Description |
|---------|-------------|
| `/bug` | バグレポートを送信 |
| `/review` | コードレビューをリクエスト |
| `/pr` | プルリクエストを作成 / 更新 |
| `/commit` | ステージ済みの変更をメッセージ付きでコミット |

## キーボードショートカット

| Command | Description |
|---------|-------------|
| `Ctrl+C` | 現在の生成をキャンセル |
| `Ctrl+D` | Claude Code を終了（EOF） |
| `Escape` | 現在の入力 / 編集をキャンセル |
| `Tab` | ファイルパスとコマンドをオートコンプリート |
| `Up/Down` | 入力履歴をナビゲート |

## CLI フラグ

### よく使うフラグ

| Command | Description |
|---------|-------------|
| `-p, --print` | 非インタラクティブ（ヘッドレス）モード |
| `--model` | モデルを指定: `opus`、`sonnet`、`haiku` |
| `--output-format` | `text`、`json`、`stream-json` で出力 |
| `--allowedTools` | ツールを制限: `Edit,Read,Bash` |
| `--max-turns N` | 会話ターン数を制限 |
| `--debug` | デバッグログを有効化 |
| `-n, --name` | セッションに名前を付ける |

### ヘッドレス / スクリプト

```
claude -p "explain this error" < log.txt
claude -p "list todos" --output-format json
echo "fix typos" | claude -p
```

## 設定ファイル

### CLAUDE.md の階層

| Command | Description |
|---------|-------------|
| `./CLAUDE.md` | プロジェクトレベルの指示（リポジトリにチェックイン） |
| `./.claude/settings.json` | プロジェクト設定（パーミッション、フック） |
| `~/.claude/CLAUDE.md` | ユーザーグローバルの指示（全プロジェクト共通） |
| `~/.claude/settings.json` | ユーザーグローバル設定 |
| `~/.claude/projects/*/CLAUDE.md` | プロジェクト別ユーザー指示（リポジトリ外） |

### 環境変数

| Command | Description |
|---------|-------------|
| `ANTHROPIC_API_KEY` | 直接認証用の API キー |
| `CLAUDE_MODEL` | デフォルトモデルの上書き |
| `CLAUDE_CONFIG_DIR` | カスタム設定ディレクトリのパス |

## パーミッション

### settings.json

```
{
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": ["Bash(rm *)"]
  }
}
```

### パーミッションモード

| Command | Description |
|---------|-------------|
| `default` | リスクのあるツールの前に確認 |
| `--dangerously-skip-permissions` | 全ツールを許可（CI / スクリプト専用） |
| `--allowedTools` | ツールセットを制限する CLI フラグ |

## MCP サーバー

### MCP サーバーとは？

> Model Context Protocol サーバーはカスタムツール（データベース、API、サービス）で Claude Code を拡張します。CLI または `.mcp.json` で管理します。

### CLI による管理

```
claude mcp add server-name -- cmd arg1 arg2
claude mcp list
claude mcp remove server-name
```

### .mcp.json の設定

```
{
  "mcpServers": {
    "my-db": {
      "command": "python",
      "args": ["-m", "mcp_server_db"],
      "env": { "DB_URL": "${DATABASE_URL}" }
    }
  }
}
```

### スコープ

| Command | Description |
|---------|-------------|
| `.mcp.json` | プロジェクトレベルの MCP サーバー |
| `~/.claude/mcp.json` | ユーザーグローバルの MCP サーバー |
| `claude mcp add -s user` | ユーザースコープに追加 |
| `claude mcp add -s project` | プロジェクトスコープに追加 |

## フック

### フックイベント

| Command | Description |
|---------|-------------|
| `PreToolUse` | ツール実行前に呼び出される |
| `PostToolUse` | ツール完了後に呼び出される |
| `Notification` | Claude が通知を送るときに呼び出される |
| `Stop` | Claude がレスポンスを完了したときに呼び出される |

### settings.json の例

```
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "check-command.sh $INPUT"
      }]
    }]
  }
}
```

### フックの動作

| Command | Description |
|---------|-------------|
| `exit 0` | ツールの実行を許可 |
| `exit 2` | ツールの実行をブロック |
| `stdout` | Claude への JSON フィードバック |

## SDK & 自動化

### ヘッドレススクリプト

```
# Single prompt, get JSON output
claude -p "summarize main.py" \
  --output-format json

# Pipe input
git diff | claude -p "review this diff"
```

### CI / GitHub Actions

```
- uses: anthropics/claude-code-action@v1
  with:
    claude_args: >
      --max-turns 5
      --model claude-sonnet-4-6
```

### ヒント

> 自動化でコストを抑えるには `--max-turns` を使用。結果をプログラムで処理するには `--output-format json`。安全のために `--allowedTools` と組み合わせましょう。

## モデル

### モデルの選択

```
claude --model opus     # most capable
claude --model sonnet   # balanced (default)
claude --model haiku    # fastest, cheapest
```

### モデルのショートカット

| Command | Description |
|---------|-------------|
| `opus` | Claude Opus — 最高性能 |
| `sonnet` | Claude Sonnet — デフォルト、バランス型 |
| `haiku` | Claude Haiku — 高速で経済的 |
| `--model full-name` | 例: `claude-sonnet-4-6` |

## ベストプラクティス

### CLAUDE.md の書き方

> プロジェクトの規約、技術スタック、ビルドコマンド、テスト手順を CLAUDE.md に記述しましょう。簡潔に — Claude は毎回セッションで読み込みます。`/init` でスキャフォールドできます。

### コスト管理

| Command | Description |
|---------|-------------|
| `/cost` | 現在のトークン使用量を確認 |
| `/compact` | コンテキストが大きくなったら圧縮 |
| `--max-turns` | 自動化でターン数を制限 |
| `sonnet / haiku` | シンプルなタスクには安いモデルを使用 |

### 効果的なプロンプト

| Command | Description |
|---------|-------------|
| `具体的に` | "auth.ts:42 の null チェックを修正" > "バグを修正" |
| `コンテキストを与える` | ファイル、関数、エラーメッセージを参照 |
| `@file を使う` | 直接ファイルを参照: `@src/main.ts` |
| `画像を使う` | スクリーンショットをドラッグ & ドロップで視覚的コンテキスト |
| `繰り返し改善` | フォローアップで精度を上げる。リセットには `/clear` |