Claude Code完全攻略：CLIでAI開発を加速させる全コマンドリファレンス

Claude Code は Anthropic が開発したエージェント指向の CLI ツールです。コードの生成・修正・レビュー・テストといった開発プロセスのあらゆる場面で AI の力をターミナルから直接活用でき、IDE を離れることなく AI とペアプログラミングする感覚で作業を進められます。本記事では、基本操作から Hooks による自動化、MCP サーバー連携、トラブルシューティングまで、実務で役立つ情報をチートシート形式で網羅します。

ターミナルで AI と対話してコーディングって、どんなイメージなの？

「このファイルのバグを直して」「テストを追加して」といった自然言語の指示をターミナルで入力すると、Claude がコードを読んで実際にファイルを書き換えてくれます。IDE のプラグインと違ってシェルスクリプトや CI とも組み合わせやすいのが特徴です。

1. セットアップと基本操作

インストールと更新

ネイティブ版はプラットフォームに最適化されたバイナリを直接インストールするため、Node.js 環境に依存せず起動が速い点が利点です。npm 版は既存の Node.js 環境に統一したい場合や、CI 環境でバージョン管理しやすい場面に向いています。

# ネイティブ版（推奨：Node.js 不要、起動が速い）
curl -fsSL https://claude.ai/install.sh | bash

# npm 版（Node.js 環境に統一したい場合）
npm install -g @anthropic-ai/claude-code

# バージョン更新
claude update

# 環境診断（認証・設定・依存関係の問題を一括確認）
claude doctor

起動と終了

実行内容	コマンド	主な用途
対話モードで起動	`claude`	インタラクティブな開発作業
ヘッドレスモード	`claude -p "プロンプト"`	CI / シェルスクリプトへの組み込み
セッションを再開	`claude -r <session-id>`	前回の作業コンテキストを引き継ぐ
終了	`Ctrl+D` または `/exit`	—

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

キー	動作
`Enter`	入力を送信
`Shift+Enter`	改行（複数行の指示を書く場合に使用）
`Ctrl+C`	応答の中断（長い処理を止めたいときに）
`Ctrl+L`	画面クリア
`↑ / ↓`	コマンド履歴を表示
`Tab`	自動補完

2. スラッシュコマンド一覧

対話中に / から始まるコマンドを入力することで、セッション管理や設定の確認・変更を素早く行えます。特に /checkpoint と /compact は長い作業セッションでの必須コマンドです。

大きなリファクタリングに着手する前は必ず /checkpoint を打っています。変更が意図した方向でなかった場合に /revert で即座に戻れるので、安心して実験的な変更を試せます。

セッション管理
- /checkpoint [name]：現在の状態を保存（破壊的な変更前に必ず実行）
- /revert <checkpoint>：保存した状態に戻す
- /branch <name>：セッションを分岐して別アプローチを試す
- /compact：コンテキストを圧縮してトークンを節約（応答が遅くなってきたら実行）
情報表示・設定
- /config / /config show：現在の設定を確認
- /stats / /costs：使用統計とコストの確認（コスト管理に活用）
- /permissions：現在の権限設定を表示・リセット
管理機能
- /mcp <list|add|remove>：MCP サーバーの管理
- /plugin <list|add|remove>：プラグインの管理
- /hooks <list|enable|disable>：Hooks の管理
- /logout：ログアウト（認証エラー時の最初の対処法）

3. CLI フラグ・オプション

起動時のフラグで、使用モデル・権限レベル・使用できるツールを細かく制御できます。CI での自動実行やセキュリティ要件に応じた制限に活用してください。

モデル指定：claude --model <sonnet|opus|haiku>
重い分析には opus、日常的なコード生成には sonnet、軽量タスクには haiku と使い分けるとコスト効率が上がります。
権限モード：claude --permission-mode <default|acceptEdits|plan|bypassPermissions>
acceptEdits はファイル編集を自動承認するモードで、自動化スクリプトに便利。plan は実行前に計画を提示するモードで、慎重に確認したい場面に向いています。
ツール制御：--allowedTools "Read" "Edit" / --disallowedTools "WebSearch"
本番環境や閉じたネットワークでは、使用ツールを明示的に制限することでリスクを下げられます。
認証・デバッグ
- --auth <bedrock|vertex|foundry>：AWS Bedrock・Google Vertex AI・Azure AI Foundry 経由での認証
- --debug：デバッグモード（--debug "api,mcp" のようにカンマ区切りでカテゴリ指定可能）

4. 設定ファイルの構成と優先順位

設定は以下の順序で上書き（後ろが優先）されます。予期しない挙動が起きたときは、どのレイヤーの設定が適用されているかを /config show で確認するのが最初のステップです。

Managed（最優先）：組織管理者による設定。チーム全体に強制適用。
Local：.claude/config.local.yaml。個人の上書き設定。.gitignore への追加推奨。
Project：.claude/config.yaml。プロジェクト共有設定。リポジトリにコミットして管理。
User：~/.config/claude-code/config.yaml。ユーザーのデフォルト設定。

主なファイルの保存先：

認証情報：~/.config/claude-code/auth.json
ログ：~/.local/share/claude-code/logs/（問題調査時に参照）

5. 高度な活用：カスタムエージェント・Hooks・MCP 連携

カスタムエージェントの定義

特定の役割に特化したエージェントを .claude/config.yaml に定義することで、毎回指示を書かずにコンテキストを使い回せます。「コードレビュー専用」「ドキュメント生成専用」など、チームで共有するエージェントを定義しておくと一貫性が生まれます。

agents:
  code-review:
    description: "コードレビュー専用エージェント"
    model: "opus"
    systemPrompt: |
      可読性・パフォーマンス・セキュリティの3観点でレビューしてください。
      問題点は severity（high/medium/low）付きで列挙し、
      改善コードの例も示してください。
    allowedTools: ["Read", "Grep"]  # 読み取り専用に制限してファイル変更を防ぐ

呼び出し：> @code-review このPRの差分をレビューして

Hooks による自動化

Hooks はツールの使用前後（PreToolUse / PostToolUse）にシェルコマンドを自動実行する仕組みです。「編集したら自動でフォーマット」「本番ファイルへの書き込みをブロック」といった運用ルールをコードで強制できます。

hooks:
  # TypeScript ファイル編集後に自動フォーマット＆テスト実行
  PostToolUse:
    - matcher:
        tool: "Edit"
        path: "*.ts"
      hooks:
        - "npx prettier --write {{path}}"
        - "npm test -- {{path}}.test.ts || true"  # テスト失敗でも処理を継続

  # 本番環境ファイルへの書き込みを事前にブロック
  PreToolUse:
    - matcher:
        tool: "Edit"
        path: "production/*"
      hooks:
        - "echo 'Error: Cannot edit production files directly' && exit 1"

MCP（Model Context Protocol）サーバー連携

MCP は Claude Code に外部のコンテキストやツールを統合する仕組みです。GitHub・データベース・社内 API など、Claude が直接操作できる対象を拡張できます。認証情報は環境変数で渡すことで、設定ファイルに平文で書くリスクを避けられます。

mcpServers:
  github:
    transport: "http"
    url: "https://api.github.com/mcp"
    auth:
      type: "bearer"
      token: "${GITHUB_TOKEN}"  # 環境変数で参照（設定ファイルにトークンを直書きしない）

  # ローカル DB との連携例（stdio トランスポート）
  database:
    transport: "stdio"
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      DATABASE_URL: "${DATABASE_URL}"

6. トラブルシューティング

症状	原因	対処法
認証エラーが出る	トークンの期限切れ・破損	`/logout` 後に `claude` で再ログイン
応答が遅い・重い	コンテキストが長くなりすぎた	`/compact` で圧縮、または新規セッションを開始
WebSearch が使えない	ネットワーク設定が無効	設定ファイルで `network: { enabled: true }` を確認
権限エラーが頻発する	権限設定が意図しない状態	`/permissions reset` でリセット
原因不明の動作異常	設定の競合・環境の問題	`claude doctor` で診断、ログを `~/.local/share/claude-code/logs/` で確認

7. 運用のベストプラクティス

日常的な利用で意識しておきたいポイントを3つに絞って整理します。

コスト管理：プロンプトキャッシングと /compact の活用
enablePromptCaching: true を設定ファイルに追加することで、大規模なコードベースでの繰り返し参照コストを大幅に削減できます（2026年2月現在、デフォルトで有効）。セッションが長くなったタイミングで /compact を使いコンテキストを圧縮することも習慣にしましょう。コストは /costs で定期的に確認を。
安全性の確保：チェックポイントで実験を怖くなくす
リファクタリングや大きな変更に着手する前には必ず /checkpoint を作成してください。/revert でいつでも戻れる状態を保つことで、「この変更が正しいか確信が持てない」という場面でも積極的に試せるようになります。
効率的な指示：グロブパターンで複数ファイルを一度に渡す
src/**/*.ts のようなグロブパターンを使うと、複数ファイルをまとめて解析対象として渡せます。「このディレクトリ全体の命名規則を統一して」のような広範な指示が1回の操作で完結します。

まとめ・クイックリファレンス

最速スタート：curl -fsSL https://claude.ai/install.sh | bash → claude
生産性向上：acceptEdits モード＋ Hooks による自動フォーマットで、確認ダイアログなしに開発を加速。
安全運用：変更前は /checkpoint、長いセッションは /compact、異常時は claude doctor。
コスト管理：プロンプトキャッシングを有効化し、/costs で定期的にモニタリング。
チーム展開：カスタムエージェントと MCP 設定を .claude/config.yaml で共有し、開発体験を統一。

Claude Code の真価は、使い込むほどに設定が育っていく点にあります。まず基本の対話から始めて、Hooks とカスタムエージェントを少しずつ整備していくことが、無理なく恩恵を受けられる最短ルートです。