Claude Code CLIの実践活用ガイド：ターミナルから始めるAI自動化

Claude Codeは対話的に使うだけのツールではない。CLIとしてターミナルから直接呼び出すことで、シェルスクリプトやCI/CDパイプラインに組み込める。この使い方を知ると、開発の自動化レベルが一段上がる。

Claude Code CLIの基本

インストールと起動

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

対話モードが立ち上がるが、本記事で注目するのは非対話モードだ。

ワンライナー実行（-p フラグ）

-p（print）フラグを使うと、プロンプトを渡して結果だけを受け取れる。

claude -p "このディレクトリのpackage.jsonを読んで、使われていない依存パッケージを教えて"

これだけで、Claude Codeがファイルを読み、分析し、結果をターミナルに出力する。対話セッションを開く必要がない。

実践テクニック

1. パイプラインとの連携

Unixのパイプと組み合わせると強力だ。

git diff --staged | claude -p "このdiffをレビューして。バグの可能性がある箇所を指摘して"

cat error.log | claude -p "このエラーログを分析して、根本原因と対策を提示して"

標準入力からデータを受け取り、AIが分析して結果を返す。従来なら人間が目で読んでいた作業がコマンド一発になる。

2. シェルスクリプトへの組み込み

毎朝のルーティンをスクリプト化した例：

#!/bin/bash
# morning-review.sh - 朝の自動レビュー

# 昨日のコミットを要約
SUMMARY=$(git log --since="1 day ago" --oneline | claude -p "これらのコミットを日本語で簡潔に要約して")

# PRのレビュー待ちを確認
PRS=$(gh pr list --state open --json title,url | claude -p "レビュー待ちのPRをリスト化して、優先度をつけて")

echo "=== 昨日の進捗 ==="
echo "$SUMMARY"
echo ""
echo "=== レビュー待ちPR ==="
echo "$PRS"

cronやTask Schedulerで毎朝実行すれば、出勤時に状況が把握できる。

3. MCP連携でツールを拡張

Claude CodeにMCPサーバーを追加すると、外部ツールを操作できるようになる。

# Playwrightでブラウザ操作を追加
claude mcp add playwright -- npx -y @playwright/mcp@latest

# GitHub連携を追加
claude mcp add github -- npx -y @modelcontextprotocol/server-github

追加後は、Claude Codeが自律的にブラウザを操作したり、GitHub APIを叩いたりできる。

4. カスタム指示の設定

プロジェクトごとにClaude Codeの振る舞いを固定できる。

# プロジェクトルートに設定ファイルを作成
cat > CLAUDE.md << 'EOF'
- TypeScriptで書くこと
- テストはVitestを使うこと
- コミットメッセージはConventional Commitsに従うこと
- 日本語でコメントを書くこと
EOF

このCLAUDE.mdがあると、Claude Codeが常にこのルールに従って動く。チーム全体の開発規約を統一するのにも使える。

実際の自動化事例

コードレビューの自動化

# PR作成時に自動レビューを実行（GitHub Actionsから呼ぶ想定）
claude -p "以下のdiffをセキュリティ・パフォーマンス・可読性の観点でレビューして。
問題がなければ'LGTM'、問題があれば具体的な修正案を出して。

$(git diff origin/main...HEAD)"

テストコードの自動生成

claude -p "src/utils/parser.ts のユニットテストを書いて。
Vitestを使い、正常系・異常系・境界値のケースを含めて。
テストファイルはsrc/utils/parser.test.tsに出力して"

--allowedToolsフラグで書き込み権限を与えれば、ファイル生成まで自動で行う。

注意点

APIコストの管理: CLIから大量に呼び出すとコストがかさむ。--max-turnsフラグでターン数を制限したり、処理の頻度を調整するのが実用的だ。

機密情報の取り扱い: パイプで渡すデータにAPIキーやパスワードが含まれないよう注意する。.envファイルを直接渡すのは避けるべきだ。

まとめ

Claude Code CLIの真価は、対話モードではなく自動化パイプラインの部品として使うところにある。シェルスクリプト、CI/CD、cronと組み合わせることで、開発ワークフロー全体をAIで底上げできる。

まずはclaude -pでワンライナーを試すところから始めてみてほしい。