第6章 Claude Code（CLI）— 実践ガイド

概要

本章では、Claude Code CLI の日常的な操作パターンを実務に即して解説します。

6.1 基本操作

セッションのライフサイクル

claude                        # 新規セッション開始
claude "refactor auth module" # プロンプト付きで開始
claude -c                     # 最新セッションを再開
claude -r "auth-refactor"     # 名前付きセッションを再開
claude -n "feature-payments"  # セッションに名前を付けて開始
/rename api-migration         # セッション中に名前を変更

セッション名は /tasks やRemote Control でのセッション識別に使われるため、複数セッションを運用する場合は命名を習慣化しましょう。

6.2 対話モードの活用

ファイル参照

@ を使ってファイルやディレクトリをプロンプト内で参照できます。

@src/auth/login.ts このファイルのバリデーションロジックを確認して
@src/components/ このディレクトリ内のコンポーネントを一覧して

シェルコマンド直接実行

! プレフィックスでシェルコマンドを直接実行します。
Claude の解釈を経由しないため、結果がそのままコンテキストに入ります。

! git status          # Claudeの解釈なしで直接実行
! npm run test        # テスト結果をコンテキストに注入

通常のプロンプトで「git statusを実行して」と指示すると、Claude が解釈→実行→説明という3ステップを踏みますが、! を使うとコマンドが直接実行され、出力のみがコンテキストに入ります。

6.3 Plan Mode と Fast Mode

Plan Mode

Plan Mode では Claude は読み取り専用でコードを分析し、変更計画を提案します。
ファイルの直接編集は行いません。

/plan                     # Plan Mode に切り替え
Shift+Tab                 # Normal → Auto → Plan をサイクル

複雑なタスクでは「まず Plan Mode で計画 → 計画を確認・修正 → Normal Mode で実行」というフローが安全です。

Fast Mode

Fast Mode は Opus 4.6 の出力生成を高速化するモードです。
同じモデルを使用しますが、API の速度最適化設定が適用されます。

/fast                     # Fast Mode のON/OFF切り替え

高速な対話的開発やライブデバッグに適していますが、標準レートの6倍のコストがかかります。
コスト効率を重視する場合はOFFにしてください。

6.4 コード読解・リファクタリング・デバッグ

推奨ワークフロー

flowchart TD
    EXPLORE["`**① Explore**
    コードベースの理解
    @でファイル参照`"] --> PLAN["`**② Plan**
    Plan Modeで
    変更計画を策定`"]
    PLAN --> CODE["`**③ Code**
    Normal Modeで
    変更を実行`"]
    CODE --> COMMIT["`**④ Commit**
    /diff で確認
    git commit`"]

    style EXPLORE fill:#e3f2fd,stroke:#2196f3
    style PLAN fill:#fff3e0,stroke:#f59e0b
    style CODE fill:#e8f5e9,stroke:#4caf50
    style COMMIT fill:#f3e5f5,stroke:#9c27b0

この Explore → Plan → Code → Commit の4ステップが Claude Code の基本ワークフローです。

6.5 Git 連携

Claude Code は Git 操作を直接実行できます。

# ブランチ作成とチェックアウト
claude "create a new branch for the login feature and switch to it"

# ワークツリーを使った並列作業
claude -w feature-branch    # 隔離されたworktreeで起動

# 変更の確認とコミット
/diff                       # 現在の変更差分を表示

--worktree（-w）フラグを使うと、隔離された Git ワークツリーで Claude Code が起動します。
メインの作業ディレクトリに影響を与えずに並列で作業できるため、大規模モノレポでの運用に有効です。

6.6 セッション管理

コンテキスト制御

コマンド	用途
`/compact`	会話を圧縮して要約（保持する情報を指定可能）
`/clear`	会話履歴を完全にクリア
`/rewind`	直前の操作を巻き戻し（会話のみ / コードのみ / 両方を選択可）

/compact はコンテキスト使用率が80%を超えたら実行するのが目安です。
v2.0.64以降は即座に完了します。
タスクを切り替える場合は /clear が適切です。

6.7 非対話モード（-p）とCI/CD統合

Print Mode

# 単一プロンプトを実行して結果を出力
claude -p "Explain this codebase structure"

# JSON出力（CI/CDパイプライン向け）
claude -p --output-format json "List all TODO comments"

# 予算とターン数の制限
claude -p --max-budget-usd 2.00 --max-turns 3 "fix failing tests"

CI/CD 統合例（GitHub Actions）

- name: Claude Code Review
  run: |
    claude -p --output-format json \
      --max-budget-usd 5.00 \
      --max-turns 10 \
      "Review the changes in this PR for security issues"

--bare フラグを使うと、Hooks・LSP・プラグイン同期・スキルディレクトリ走査をスキップして最小限の環境で実行されます。
スクリプト化された -p 呼び出しに最適です。

6.8 コスト確認とリソース制御

/cost                         # 現在のセッションのコスト表示
/status                       # セッション状態の確認
claude -p --max-budget-usd 2.00 "task"  # 予算上限
claude -p --max-turns 3 "task"          # ターン数上限

/cost でトークン使用量と概算コストをリアルタイムに確認できます。--max-budget-usd はセッション全体の予算上限を設定し、超過するとセッションが停止します。

6.9 トラブルシューティング

/doctor コマンド

/doctor

環境の健全性をチェックし、認証状態、ネットワーク接続、設定の整合性、ツールの可用性などを診断します。
問題が発生した場合はまず /doctor を実行してください。

よくある問題

症状	対処
レートリミットに頻繁に到達	モデルを Sonnet に切り替え / `/compact` で使用量削減
OAuth 再認証が繰り返される	最新版にアップデート（複数セッションの競合修正済み）
コンテキスト制限到達	`/compact` で圧縮、保持情報を明示的に指定
MCP サーバー接続失敗	`/mcp` でサーバー状態確認、`claude mcp list` で設定検証

まとめ

CLI の実践では、Explore → Plan → Code → Commit の基本フローを軸に、/compact によるコンテキスト管理、-p による CI/CD 統合、--max-budget-usd によるコスト制御を組み合わせます。

次章では、カスタマイズと自動化を解説します。