💻 Claude Code入門 📖 約20分で読めます

Claude Codeのコマンドラインオプション完全リファレンス

全CLIオプションを網羅。起動時に使える引数を徹底解説

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

無料で学習を始めるクロガイドとは？

Claude Code CLIの基本構文

Claude Codeはコマンドラインから起動するツールです。基本構文は以下の通りです。

基本構文

claude [オプション] [初回プロンプト]

オプションなしで起動するとインタラクティブモード（対話モード）になります。初回プロンプトを指定すると、そのプロンプトから会話が始まります。

全オプション一覧

オプション	短縮形	カテゴリ	概要
`--help`	`-h`	情報	ヘルプを表示
`--version`	`-v`	情報	バージョンを表示
`--print`	`-p`	動作モード	非インタラクティブモード
`--output-format`		出力	出力形式の指定
`--model`	`-m`	モデル	使用モデルの指定
`--max-turns`		動作制御	最大ターン数
`--system-prompt`		プロンプト	システムプロンプトの設定
`--append-system-prompt`		プロンプト	システムプロンプトに追記
`--allowedTools`		権限	許可するツール
`--disallowedTools`		権限	拒否するツール
`--permission-mode`		権限	権限モード
`--input-format`		入力	入力形式の指定
`--continue`	`-c`	セッション	直前セッションの継続
`--resume`	`-r`	セッション	過去セッションの再開
`--verbose`		デバッグ	詳細出力の有効化
`--api-key`		認証	APIキーの指定

各オプション詳細

--print（-p）― 非インタラクティブモード

Claude Codeを対話なしで実行するモードです。スクリプトやCI/CDパイプラインでの自動化に必須のオプションです。

使用例

# 1回の質問だけ実行して結果を表示
claude -p "このプロジェクトのディレクトリ構造を説明して"

# パイプで入力を渡す
cat error.log | claude -p "このエラーログを分析して原因を特定して"

# ファイルの内容を渡す
claude -p "このコードをレビューして" < src/main.py

--output-format ― 出力形式の指定

出力の形式を指定します。--printモードとの組み合わせで使用します。

利用可能な形式

# テキスト形式（デフォルト）
claude -p --output-format text "質問"

# JSON形式（プログラムからの利用に最適）
claude -p --output-format json "質問"

# ストリーミングJSON形式（リアルタイム処理向け）
claude -p --output-format stream-json "質問"

各出力形式の使い分け

形式	用途	特徴
`text`	人間が読む・シェルスクリプト	プレーンテキスト出力
`json`	プログラムからの利用	完了後にJSON一括出力
`stream-json`	リアルタイム処理	イベントごとにJSONを逐次出力

--model（-m）― 使用モデルの指定

使用例

# フルモデル名で指定
claude --model claude-sonnet-4-20250514

# 短縮名で指定（利用可能な場合）
claude -m sonnet

--max-turns ― 最大ターン数の制限

Claude Codeが自律的に行動できるターン数の上限を設定します。--printモードで暴走を防ぐために特に重要です。

使用例

# 最大3ターンで終了
claude -p --max-turns 3 "バグを見つけて修正して"

# 1ターンのみ（質問→回答で終了）
claude -p --max-turns 1 "このファイルの問題点は？"

--system-prompt ― システムプロンプトの設定

デフォルトのシステムプロンプトを上書きします。Claude Codeの振る舞いを根本から変えたい場合に使用します。

使用例

claude -p --system-prompt "あなたはセキュリティ専門のレビュアーです。コードのセキュリティ脆弱性のみを指摘してください。" "src/auth.pyをレビューして"

--append-system-prompt ― システムプロンプトに追記

デフォルトのシステムプロンプトに追加の指示を付け加えます。既存の動作を維持しつつ、追加の制約やルールを設定したい場合に便利です。

使用例

claude -p --append-system-prompt "回答は必ず日本語で行ってください。コード内のコメントも日本語にしてください。" "関数を追加して"

--permission-mode ― 権限モードの設定

使用例

# デフォルトモード
claude --permission-mode default

# プランモード（読み取り専用）
claude --permission-mode plan

# バイパスモード（全権限を自動許可）
claude --dangerously-skip-permissions

--continue（-c）と --resume（-r）― セッション管理

使用例

# 直前のセッションを継続
claude -c
claude --continue

# 過去のセッション一覧から選んで再開
claude -r
claude --resume

# 継続しつつ新しいプロンプトを追加
claude -c "先ほどの続きでテストを書いて"

--verbose ― 詳細出力

デバッグ用の詳細情報を出力します。問題調査やAPI通信の確認に使用します。

使用例

claude --verbose

API通信の詳細、トークン数、処理時間などの追加情報が表示されます。

--api-key ― APIキーの直接指定

環境変数やログインの代わりに、APIキーを直接指定して認証します。CI/CD環境での利用に適しています。

使用例

# APIキーを直接指定
claude --api-key "sk-ant-xxxxx" -p "質問"

# 環境変数と組み合わせ
ANTHROPIC_API_KEY="sk-ant-xxxxx" claude -p "質問"

セキュリティ注意: APIキーをコマンド履歴に残さないよう、環境変数ANTHROPIC_API_KEYを使用する方法を推奨します。

オプションの組み合わせ例

CI/CDでの自動コードレビュー

claude -p \
  --model claude-sonnet-4-20250514 \
  --output-format json \
  --max-turns 5 \
  --append-system-prompt "セキュリティとパフォーマンスの問題を重点的に指摘してください" \
  "git diffの内容をレビューして"

シェルスクリプトでのバッチ処理

#!/bin/bash
for file in src/*.py; do
  echo "Reviewing: $file"
  claude -p --max-turns 1 \
    --output-format text \
    "このファイルの問題点を3つ以内で指摘して: $(cat $file)"
done