# クイックスタート

> ⚡ まだ未接続？コマンド 1 行で設定完了：`curl -fsSL https://qcode.cc/install/claude-code.sh | bash`（Windows：`irm https://qcode.cc/install/claude-code.ps1 | iex`）。詳細は [ワンクリック設定スクリプト](/docs/getting-started/one-click-install)。

インストールと環境変数の設定が完了したら、5 分で Claude Code の基本機能を習得しましょう。

## Claude Code の起動

ターミナルでプロジェクトディレクトリに移動して実行：

```bash
cd /path/to/your/project
claude
```

Claude Code のインタラクティブインターフェースが表示され、会話を開始できます。

## 基本的な操作

### 1. コードを理解する

```
> このプロジェクトのアーキテクチャは？
> src/auth/login.ts の仕組みを説明して
> データベースを呼び出している箇所をすべて見つけて
```

### 2. コードを生成する

```
> ユーザー登録の API エンドポイントを作成して
> UserService クラスのユニットテストを追加して
> React ログインフォームコンポーネントを作成して
```

### 3. 既存のコードを編集する

```
> utils.js をリファクタリングして可読性を向上させて
> handleSubmit 関数のメモリリークを修正して
> すべてのパブリック関数に TypeScript 型を追加して
```

### 4. 問題をデバッグする

```
> ログイン後にユーザーが 404 にリダイレクトされるのはなぜ？
> このエラーを分析して：TypeError: Cannot read property 'id' of undefined
> API レスポンスが遅い原因を調査して
```

### 5. Git 操作

```
> 変更したファイルを表示して
> これらの変更を適切なコミットメッセージでコミットして
> PR の説明を作成して
```

## @ でファイルを参照

`@` シンボルを使用して特定のファイルを正確に参照し、Claude に内容を直接読み込ませることができます：

```
> @src/components/Header.tsx をレビューしてパフォーマンスを最適化して
> @src/v1/api.js と @src/v2/api.js を比較して
> @package.json に基づいてプロジェクトの依存関係を分析して
```

**ヒント**：`@` を入力後に `Tab` キーを押すとファイルパスを自動補完できます。

## パイプ入力

他のコマンドの出力を Claude Code に渡して分析できます：

```bash
# git の変更を説明
git diff | claude "これらのコード変更を説明して"

# ログエラーを分析
cat error.log | claude "これらのエラーを分析して解決策を提供して"

# PR の変更をレビュー
gh pr diff 123 | claude "この PR のコード品質をレビューして"
```

## よく使うスラッシュコマンド

セッション中に `/` コマンドを使用：

| コマンド | 説明 |
|----------|------|
| `/help` | ヘルプ情報と利用可能なコマンドを表示 |
| `/clear` | 現在の会話履歴をクリア |
| `/compact` | トークンを節約するために会話履歴を圧縮 |
| `/model` | モデルを表示または切り替え（opus、sonnet など） |
| `/memory` | プロジェクトメモリファイル CLAUDE.md を編集 |
| `/init` | プロジェクト設定を自動生成 |
| `/commit` | メッセージを生成してスマートコミット |
| `/review` | コードレビュー |
| `/cost` | 現在のセッションの費用とトークン使用量を表示 |
| `/doctor` | 設定問題を診断 |
| `/config` | 設定を開く |
| `/mcp` | MCP サーバー接続を管理 |
| `/loop` | 自律ループでタスクを実行 |
| `/bug` | 問題を報告 |

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

| ショートカット | 機能 |
|----------------|------|
| `Tab` | ファイルパスを自動補完 |
| `Esc` | 現在の出力を中断 |
| `Ctrl+C` | 現在の操作をキャンセル |
| `↑` / `↓` | コマンド履歴を参照 |

## プロジェクト設定の初期化

初回使用時に `/init` を実行して、Claude にプロジェクトを分析させ設定を生成させます：

```
> /init
```

これにより `CLAUDE.md` ファイルが作成され、以下が含まれます：

- プロジェクトの技術スタックとアーキテクチャ概要

- よく使うビルドとテストコマンド

- コードスタイルガイドライン

- プロジェクト固有の規約

**CLAUDE.md の目的**：Claude Code は起動時にこのファイルを自動的に読み込み、AI がプロジェクトのコンテキストをより良く理解できるようになります。

## 実践例

### 例 1：新機能を追加

```
> ユーザーアバターアップロード機能を追加したい：
  1. JPG/PNG 形式をサポート
  2. ファイルサイズ制限 2MB
  3. アップロード後に 200x200 に自動クロップ
  4. S3 に保存
```

### 例 2：バグを修正

```
> ユーザーからのフィードバック：「保存」ボタンをクリックするとページがフリーズする
> @src/pages/EditProfile.tsx の問題を調査して
```

### 例 3：コードレビュー

```
> /review
> セキュリティの問題とパフォーマンスのボトルネックに焦点を当てて
```

### 例 4：スマートコミット

```
> /commit
```

Claude は自動的に：

1. すべての変更を分析

2. 適切なコミットメッセージを生成

3. コミットを完了

## 効率的な使い方のヒント

1. **具体的に**：制約を含めて何が欲しいか明確に説明

2. **分割する**：複雑なタスクを小さなステップに分割

3. **早めに中断**：出力が期待どおりでない場合はすぐに `Esc` を押す

4. **参照を活用**：AI に推測させるのではなく `@` でファイルを指定

5. **コンテキストを維持**：Claude は同じセッション内の以前の会話を記憶

## 次のステップ

Claude Code の基本を習得しました！次は：

1. [CLI テクニック](/docs/usage/cli-tips) で 34 の実践的なヒントを探索

2. [ワークフロー](/docs/usage/workflow-tips) で生産性を向上

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