付録B

Claude Code CLIガイド

この付録では、Claude Code CLI（コマンドラインインターフェース）のインストール、基本的な使い方、主要なコマンドについて説明します。本ハンドブックのメインツールはClaude Desktop Appですが、CLIを使うとより強力な自動化が可能になります。

この付録で扱う内容
  • CLIとDesktop Appの比較
  • Claude Code CLIのインストール
  • 基本的な使い方（ターミナルでの対話）
  • 主要なコマンド
  • プロジェクトモード
  • 実践的なヒント

1. CLIとDesktop Appの比較

Claudeの使い方には2つあります。1つはClaude Desktop App（デスクトップアプリケーション）、もう1つはClaude Code CLI（コマンドラインインターフェース）です。両者は目的も使い方も異なり、それぞれに長所と短所があります。

項目 Claude Desktop App Claude Code CLI
インターフェース GUI（グラフィカル） ターミナル（コマンドライン）
難易度 簡単 中級
自動化 限定的 強力（スクリプト統合）
ファイルアクセス プロジェクトフォルダ システム全体
エージェント対応 Claudeのみ Claude + サードパーティバックエンド
おすすめ対象 初心者 中級以上
Desktop Appは「車のオートマチックモード」、CLIは「マニュアルモード」です。CLIはより細かく制御できる代わりに習得が必要です。オートマチックで運転を覚えて、慣れてきたらマニュアルに乗り換えるようなものです。
本ハンドブックのすべての実習はClaude Desktop Appで行えます。CLIは任意です。CLIが必要になった場合は、この付録でインストール方法と使い方を案内します。
Desktop AppとCLIの比較 Claude Desktop App ✓ マウスクリックで簡単に使える ✓ 別途インストール不要 ! 自動化機能は限定的 ! Claudeモデルのみ使用可能 VS Claude Code CLI ★ スクリプトによる自動化が可能 ★ サードパーティバックエンド対応 ★ システム全体のファイルアクセス ! ターミナルの使用経験が必要

2. Claude Code CLIのインストール

Claude Code CLIをインストールするには、いくつかの前提条件があります。準備ができたら順番に進めていきましょう。

前提条件

  • Node.js 18以降 — Claude Code CLIはNode.js環境で動作します
  • Claude ProまたはMaxサブスクリプション — Anthropic Claudeの有料サブスクリプションアカウントが必要です
  • ターミナルアプリ — macOS Terminal、Windows PowerShell、Linux Bashなど
ステップ1: Node.jsのインストール確認

ターミナルを開き、次のコマンドを入力してNode.jsがインストールされているか確認します:

node --version

期待される結果: v18.x.x 以上のバージョン番号が出力されます。バージョンが18未満の場合や「コマンドが見つからない」というメッセージが出る場合は、nodejs.orgから最新のLTS版をインストールしてください。

ステップ2: Claude Code CLIのインストール

Node.jsが確認できたら、npmを使ってClaude Code CLIをグローバルインストールします:

npm install -g @anthropic-ai/claude-code

期待される結果: パッケージがダウンロードされ、インストールが完了します。数分かかることがあります。

ステップ3: インストール確認

インストールが完了したら、バージョンを確認して正常にインストールされたか検証します:

claude --version

期待される結果: Claude Codeのバージョン番号が出力されます（例: 1.0.x）。エラーが出た場合はステップ2をやり直してください。

ステップ4: Claudeアカウント認証

ターミナルで claude を初めて実行すると、Anthropicアカウントでのログインを求められます:

claude

ブラウザが開き、Anthropicのログインページに移動します。Claude ProまたはMaxサブスクリプションのアカウントでログインしてください。認証が完了すると、ターミナルからClaude Codeを使えるようになります。

OSごとの注意点

Windows:

  • PowerShellを管理者権限で実行してください
  • Node.jsのインストール時は「Add to PATH」オプションに必ずチェックを入れてください
  • インストール後は新しいPowerShellウィンドウを開かないとPATHが反映されません

macOS:

  • 標準のTerminalアプリまたはiTerm2を使用してください
  • Homebrewが入っていれば brew install node でもNode.jsをインストールできます

Linux (Ubuntu/Debian):

  • sudo apt install nodejs npm またはnvm（Node Version Manager）を使用してください
  • グローバルインストールには sudo が必要な場合があります: sudo npm install -g @anthropic-ai/claude-code
WindowsではPowerShellを管理者権限で起動してインストールしてください。通常のユーザー権限ではグローバルパッケージのインストールに失敗することがあります。PowerShellアイコンを右クリックし、「管理者として実行」を選択してください。
Claude ProまたはMaxサブスクリプションがない場合、CLIは使えません。無料のClaudeアカウントはClaude.aiのWebインターフェースでのみ利用できます。サブスクリプションはclaude.aiで申し込めます。

3. 基本的な使い方

Claude Code CLIの基本的な使い方を見ていきましょう。Desktop Appとは違い、ターミナル上でテキストによる対話を行う方式です。

Claude Codeの起動

ターミナルを開いて次のコマンドを入力します:

claude

Claude Codeが起動するとプロンプト（> 記号）が表示され、そこに質問や指示を入力します。

対話の方法

プロンプトに自然言語で質問を入力するだけです。Desktop Appと同じように、韓国語も英語も使えます。

現在のフォルダにあるファイル一覧を見せて

Claude Codeはファイルシステムにアクセスできるので、「現在のフォルダのファイルを読んで」「このファイルのバグを見つけて」といった依頼も処理できます。

ファイル読み書きの例

ファイルの読み取り:

README.mdファイルの内容を読んで要約して

ファイルの書き込み:

hello.pyファイルを作成して、「Hello, World!」と出力するPythonコードを書いて

Claude Codeはファイルを直接作成・修正できます。作業の前に、必ずどんな変更をするのか説明し、承認を求めます。

終了方法

Claude Codeの終了方法は2つあります:

# 方法1: コマンドで終了
/exit

# 方法2: ショートカットキーで終了
Ctrl + C
Claude Code CLI基本使用フロー 1. ターミナルを開く Terminal.app PowerShell Bash 2. claudeを実行 $ claude 3. 質問を入力 自然言語で質問や 指示をプロンプトに 入力します 4. 応答を受け取る Claudeがコードを実行 したりファイルを修正 したりして応答します 対話は続けられます 5. 終了 /exit または Ctrl+C ★ ヒント: claudeコマンド一発で始めて、/exitできれいに終了しましょう 会話内容は自動保存されるので、次回も続きから作業できます

4. 主要なコマンド

Claude Code CLIで使える主なコマンドを紹介します。これらのコマンドはClaude Codeの会話画面で / から始めて入力します。

コマンド 説明 例
claude Claude Codeを起動 claude
/help ヘルプを表示 /help
/clear 会話内容をリセット /clear
/exit Claude Codeを終了 /exit
/model 使用モデルを変更 /model claude-sonnet-5
/cost 現在のセッション費用を確認 /cost
/compact コンテキスト圧縮（会話の要約） /compact

コマンド使用例

/help — ヘルプ

利用可能なすべてのコマンドの一覧と簡単な説明を表示します:

/help

/clear — 会話のリセット

現在の会話内容をすべて消去し、新しい会話を始めます。コンテキストが長くなって応答品質が落ちてきたときに便利です:

/clear

/model — モデル変更

現在のセッションで使用するClaudeモデルを変更します。利用可能なモデル一覧はClaudeのサブスクリプションレベルによって異なります:

# Sonnetモデルに変更（高速・低コスト）
/model claude-sonnet-5

# Opusモデルに変更（最も強力・高コスト）
/model claude-opus-5

/cost — 費用確認

現在のセッションで使用したトークン数と推定費用を表示します。API使用量のモニタリングに便利です:

/cost

/compact — コンテキスト圧縮

会話が長くなると、Claudeの「記憶容量」であるコンテキストウィンドウがいっぱいになります。/compact はそれまでの会話を要約して空きを作ります:

/compact
/compact はClaude Code使用において最も重要なコマンドの一つです。会話が長くなってきたら定期的に実行してください。そうしないと、Claudeが以前の会話内容を忘れたり、応答品質が低下したりすることがあります。

5. プロジェクトモード

Claude Code CLIの真の強みはプロジェクトモードで発揮されます。プロジェクトフォルダ内でClaude Codeを実行すると、Claudeがプロジェクトのファイル構造や設定を理解し、文脈に合った作業を行えるようになります。

プロジェクトでClaude Codeを実行する

ステップ1: プロジェクトフォルダへ移動

ターミナルで、作業したいプロジェクトフォルダへ移動します:

cd ~/my-project
ステップ2: Claude Codeを実行

プロジェクトフォルダ内でClaude Codeを実行します:

claude
ステップ3: プロジェクトコンテキストの認識

Claude Codeが自動的にプロジェクトのファイル構造を分析します。これでプロジェクトに関する質問ができます:

このプロジェクトの構造を説明して
ステップ4: エージェントのディスパッチ

AGENTS.mdがあるプロジェクトでは、Claude Codeがエージェントを認識し、専門作業を適切なエージェントに委譲（ディスパッチ）します:

このプロジェクトのdesign_spec.mdを作成して

Claude CodeはPMゲートウェイを通じて design エージェントをディスパッチし、作業を実行します。

プロジェクトモードでは、Claude CodeがAGENTS.mdを読んでエージェントを認識します。AGENTS.mdに定義されたエージェントのルール・権限・ワークフローに従って、作業が自動的に割り当てられます。これこそClaude Code CLIを使う最大の理由の一つです。

プロジェクトモードのメリット

  • ファイルコンテキストの理解 — プロジェクトのファイル構造、依存関係、設定ファイルを自動的に分析します
  • エージェントワークフロー — AGENTS.mdに定義されたマルチエージェントシステムをClaudeが自動的に活用します
  • スクリプト統合 — CI/CDパイプラインや自動化スクリプトにClaude Codeを組み込めます
  • サードパーティバックエンド — DeepSeek、GLMなど別のAIバックエンドに切り替えてコストを削減できます（付録C参照）
プロジェクトモードの動作原理 ユーザー ターミナルで claudeを実行し プロンプト入力 Claude Code プロジェクトフォルダ ファイル構造の分析 AGENTS.mdの読み込み PMゲートウェイ エージェントディスパッチ 作業の実行 結果の返却 design デザインエージェント storyline ストーリーラインエージェント html-build HTMLビルドエージェント プロジェクトファイル AGENTS.md design_spec.md slide_deck.md storyline.md lecture.html project_state.json image-manifest.json

6. 実践的なヒント

Claude Code CLIをもっと効果的に使うための5つの実践的ヒントを紹介します。

ヒント1: 必ずプロジェクトフォルダから始める

Claude Codeを実行する前に、cd コマンドでプロジェクトフォルダへ移動してください。プロジェクトフォルダの外で実行すると、Claudeはファイルのコンテキストをつかめません:

# 良い例
cd ~/my-project
claude

# 悪い例 — ホームディレクトリで実行
claude
ヒント2: /compactでコンテキストを管理する

会話が長くなるとClaudeのコンテキストウィンドウがいっぱいになります。/compact を定期的に実行して会話を要約し、空きを確保しましょう。特にファイル分析やコードレビューの後に実行すると効果的です:

# 会話10〜15回ごとに実行
/compact
ヒント3: /costで費用をモニタリングする

Claude Codeの使用中にどれくらい費用が発生しているか確認しましょう。特にClaude Proサブスクリプションの利用制限を管理するときに役立ちます:

# セッション費用の確認
/cost
ヒント4: AGENTS.mdを最新に保つ

プロジェクトのAGENTS.mdファイルはClaude Codeの「取扱説明書」です。エージェントの定義、権限、ワークフローがこのファイルに定義されています。AGENTS.mdが古いままだと、Claudeが誤ったエージェントを呼び出す可能性があります:

# AGENTS.mdの確認
claude
# 「現在のプロジェクトのエージェント一覧を見せて」
ヒント5: Claude Code CLI + 低コストバックエンドの組み合わせ

Claude Code CLI最大の強みは、サードパーティバックエンドを使えることです。DeepSeek、GLM、LiteLLMなどの低コストバックエンドをつなげば、Claude Proサブスクリプションよりも安くClaude Codeを運用できます:

# DeepSeekバックエンドへの切り替え例
export ANTHROPIC_API_KEY="your-deepseek-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
claude

詳しい設定方法は付録C: 低コストAIバックエンド統合を参照してください。

CLIを初めて使うときは、簡単な質問から始めましょう。「現在のフォルダのファイル構成を見せて」「このコードの問題点を見つけて」のような簡単な依頼でClaude Codeの動きに慣れてから、少しずつ複雑な作業へ広げていくのがおすすめです。
Claude Code CLIは、最初はターミナル環境に慣れていないと難しく感じるかもしれません。しかし基本のコマンドをいくつか知っていれば十分に活用できます。覚えておくべきは、claude で始めて、/exit で終了し、/compact で管理することだけです。