# CLI テクニック

本ガイドでは、基本操作から高度な機能まで、Claude Code を最大限に活用するための 34 の実践的なテクニックをまとめています。

## 基本操作

### 1. Tab キーでファイルパスを自動補完

`@` を入力後に `Tab` キーを押すと、フルパスを覚えなくてもファイルパスを自動補完できます。

### 2. @ でファイルを正確に参照

```
> @src/utils/auth.ts のセキュリティを分析して
> @v1/api.js と @v2/api.js を比較して
```

ファイルの場所を説明するよりも、直接参照する方が正確です。

### 3. パイプ入力で分析

```bash
git diff | claude "これらの変更を説明して"
cat error.log | claude "エラーの原因を分析して"
npm test 2>&1 | claude "テスト失敗の原因を分析して"
```

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

| ショートカット | 機能 |
|----------------|------|
| `Tab` | ファイルパスを自動補完 |
| `Esc` | 現在の出力を中断 |
| `Ctrl+C` | 現在の操作をキャンセル |
| `↑` / `↓` | コマンド履歴を参照 |
| `Shift+Tab`（2回） | プランモードに入る |
| `Alt+Tab` / `Option+Tab` | 思考モードを切り替え |

### 5. ! でコマンドを素早く実行

`!` プレフィックスでシェルコマンドを直接実行：

```
> !git status
> !npm run build
```

## スラッシュコマンド

### 6. /help - すべてのコマンドを表示

```
> /help
```

利用可能なすべてのスラッシュコマンドとショートカットを表示します。

### 7. /clear - 会話をクリア

```
> /clear
```

新しいタスクを開始する前にコンテキストをクリアし、前の会話の干渉を防ぎます。

### 8. /compact - 履歴を圧縮

```
> /compact
```

コンテキストが長くなりすぎた場合に使用。コア情報を保持しながらトークンを節約するために履歴を圧縮します。

### 9. /context - コンテキスト使用量を確認

```
> /context
```

現在のコンテキスト使用率を表示。60% に達したら圧縮または新しいセッションの開始を検討してください。

### 10. /model - モデルを切り替え

```
> /model opus
> /model sonnet
```

- **Opus 4.7 / 4.6**：複雑なタスク、アーキテクチャ設計、難しい問題(4.7 が現行旗艦)

- **Sonnet 4.6**：日常のコーディング、素早い反復（コスト効率が良い）

### 11. /memory - プロジェクトメモリを編集

```
> /memory
```

CLAUDE.md ファイルを開いてプロジェクトの規約と設定を編集します。

### 12. /init - プロジェクト設定を初期化

```
> /init
```

Claude にプロジェクトを分析させ、CLAUDE.md 設定ファイルを生成させます。

### 13. /commit - スマートコミット

```
> /commit
```

変更を自動的に分析し、適切なコミットメッセージを生成してコミットします。

### 14. /review - コードレビュー

```
> /review
```

現在の変更をレビューし、潜在的な問題をチェックします。

### 15. /resume - セッションを再開

```
> /resume
```

前の会話セッションを再開し、未完了の作業を続けます。

## コンテキスト管理

Claude Code には約 200K トークンのコンテキスト制限があります。1つのセッションは1つのタスクに集中し、`/context` で使用量を確認、`/compact` で履歴を圧縮、`/clear` で新しいセッションを開始しましょう。

詳細なコンテキスト管理戦略（長いセッションのオーバーフロー対応を含む）→ [コンテキスト管理](/docs/usage/context-management)

## プランモード

### 19. プランモードに入る

`Shift+Tab` を2回押すとプランモードに入ります。Claude はコードを変更せずに調査と計画を作成します。

### 20. 実行前に計画

複雑なタスクでは、まず Claude に計画を作成させます：

```
> この機能要件を分析して実装計画を作成して、まだコードは書かないで
```

実行前に計画を確認し、やり直しを減らします。

### 21. 複雑なタスクを段階的に実行

大きなタスクを小さなステップに分割：

```
> ステップ1：既存の認証システムを分析
> ステップ2：新しい JWT アプローチを設計
> ステップ3：コア機能を実装
> ステップ4：テストを追加
```

## サブエージェント

### 22. Explore エージェントで高速検索

Explore エージェントはコードベースの高速検索に特化：

```
> Explore エージェントを使って支払い処理コードをすべて見つけて
```

### 23. Plan エージェントで設計

Plan エージェントは実装計画に特化：

```
> Plan エージェントを使ってユーザー権限システムを設計して
```

### 24. バックグラウンドエージェントで並列処理

複数のバックグラウンドエージェントを起動してタスクを並列処理し、効率を向上させます。

## CLAUDE.md 設定

`CLAUDE.md` は Claude が起動時に自動で読み込むプロジェクトレベルの設定ファイルです。`/init` で自動生成するか、手動で作成します。コード規約・よく使うコマンド・プロジェクト構成を記載しておけば、毎回説明する手間が省けます。

完全な設定ガイドとサンプル → [CLAUDE.md 設定](/docs/usage/claude-md)

## Git ワークフロー

### 28. スマートなコミットメッセージ

```
> /commit
```

Claude がすべての変更を分析し、適切なコミットメッセージを生成します。

### 29. PR 説明を作成

```
> 現在のブランチの PR 説明を作成して
```

変更の概要とテスト計画を含む PR 説明を自動生成します。

### 30. PR の変更を分析

```bash
gh pr diff 123 | claude "この PR をレビューして"
```

## テストとデバッグ

### 31. Claude にテストを書かせる

```
> @src/services/UserService.ts のユニットテストを書いて
```

Claude にテストを書かせて、自身のコードの正確性を検証させます。

### 32. テスト失敗を分析

```bash
npm test 2>&1 | claude "失敗を分析して修正して"
```

### 33. エラーをデバッグ

```
> このエラーを分析して：[エラーメッセージを貼り付け]
> @src/pages/Login.tsx の問題をデバッグして
```

## 高度なテクニック

### 34. スクリーンショット/画像を使用

Claude Code は画像理解をサポート：

```
> このスクリーンショット @screenshot.png を見て UI の問題を分析して
```

## 効率比較

| シナリオ | 従来の方法 | Claude Code |
|----------|-----------|-------------|
| コードを探す | grep + 手動ブラウジング | `@ファイル` または Explore エージェント |
| テストを書く | 手動 + デバッグ | `/review` + 自動生成 |
| Git コミット | メッセージを考える + 書く | `/commit` ワンクリック |
| コードレビュー | 1行ずつレビュー | `/review` スマート分析 |
| コードを理解 | ドキュメント + コードを読む | Claude に聞くだけ |

## ベストプラクティスまとめ

1. **具体的に**：制約を含めて要件を明確に説明

2. **参照を活用**：`@` でファイルを指定、推測を避ける

3. **段階的に**：複雑なタスクを小さなステップに分割

4. **早めに中断**：出力が間違っていたらすぐに `Esc`

5. **集中を維持**：1つのセッションで1つのタスク

6. **定期的に圧縮**：コンテキストが長くなったら `/compact`

7. **まず計画**：複雑なタスクの前に計画を作成

8. **AI にテストさせる**：Claude にテストを書かせてコードを検証

## 次のステップ

- [ワークフロー](/docs/usage/workflow-tips) で効率的な開発プロセスを学ぶ

- [コンテキスト管理](/docs/usage/context-management) で長いセッションやトークン超過に対応する

- [CLAUDE.md 設定](/docs/usage/claude-md) でプロジェクトに合わせた Claude の動作をカスタマイズ

- [Codex 統合](/docs/ide/codex) で別の AI ツールを使用