SIMPLE

/ log

Claude Code ターミナル版のカスタマイズガイド:CLAUDE.md、Hooks、Skills、MCP

Claude Code ターミナル版の強みは自由度の高いカスタマイズと自動化対応にあります。CLAUDE.md、settings.json の Hooks、Skills、MCP の設定方法から、CI/CD への組み込み方まで解説します。

Claude Code ターミナル版の強み

Claude Code ターミナル版のいいところは、デスクトップ版と違いカスタマイズの自由度が高く、自動化・スクリプトに強いところではないかと思います。

CLAUDE.md でのカスタマイズ

ターミナル版をカスタマイズするには、CLAUDE.md というファイルを編集するのが手っ取り早いです。Claude Code は claude コマンドで起動される際にそのファイルを読んで、インストラクションをコンテキストウィンドウに追加します。

あとは settings.json で「hooks」を設定したり、skills フォルダを作って skill.md にどんなことができるか、どんなツールが使えるかを書くことができます。Claude はこれらのファイルも自動で読み込みます。

MCP(Model Context Protocol)

MCP をセットアップするには、claude mcp add を使います。

claude mcp add mcpサーバーの名前 -- 起動コマンド

これをすると、~/.claude.json に MCP が追加されます。セッションが始まった時に起動コマンドが実行されて MCP が使えるようになります。

MCP の設定状態を確認するには、.claude.json を直接触らずに、Claude を開いている状態で /mcp と入力すると一覧が表示されます。そこで API 認証や状態確認ができます。

Hooks

フックは Claude Code がアクションを実行する前後にシェルコマンドを走らせる仕組みです。例えばファイル編集後の自動フォーマットなどができます。

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit",
      "hooks": [{
        "type": "command",
        "command": "prettier --write $FILE"
      }]
    }]
  }
}

タイミングは4種類あります:

  • PreToolUse:ツール実行前
  • PostToolUse:ツール実行後
  • PreCompact:コンテキストの圧縮前
  • Notification:通知時
  • Stop:セッション終了時

Hooks は settings.json に書きますが、MCP のようにコマンドで操作できないため、Claude に指示して書いてもらうか手動で編集する必要があります。

Skills

Skills は、Claude に特定の知識や手順を覚えさせる仕組みです。.claude/skills/スキル名/SKILL.md というファイルを作成することで追加できます。

.claude/
└── skills/
    └── my-skill/
        └── SKILL.md

SKILL.md はフロントマターと指示内容で構成されます:

---
name: my-skill
description: どんな時に使うかをここに書く。Claudeはこれを見てskillを使うか判断する
---

実際の指示内容...

description が重要で、Claude はこれを見て「このスキルを使うべきか」を判断します。説明が曖昧だと適切なタイミングで使われないので、具体的に書くのがポイントです。

Skills はプロジェクト単位(.claude/skills/)でも、全プロジェクト共通(~/.claude/skills/)でも設定できます。また、/スキル名 で手動で呼び出すこともできます。

自動化・スクリプトへの組み込み

Claude Code は Unix の思想に従って設計されており、他のコマンドと組み合わせて使えます。

パイプで繋げる:

# ログを流し込んで分析させる
tail -200 app.log | claude -p "異常があったらSlackに通知して"

# 変更ファイルをセキュリティレビュー
git diff main --name-only | claude -p "セキュリティの問題がないか確認して"

CI/CD に組み込む:

# 非インタラクティブモードで実行(-pフラグ)
claude -p "新しい文字列をフランス語に翻訳してPRを作って"

-p フラグ(print モード)が重要で、これをつけると応答を返して即終了するので、スクリプトや CI/CD パイプラインに組み込めます。インタラクティブなセッションを開かずに済むのがポイントです。

デスクトップ版にはこの機能がないため、自動化用途ではターミナル版一択になります。

Takaaki Yoneda

環境保全、グラフィックデザイン、マーケティングなどプログラミング以外にも幅広い興味を持ったソフトウェアエンジニアです。 最近の趣味は、ボードゲームと登山